Why Profiles Matter
- Quickly toggle between providers without reconfiguring settings each time
- Experiment with different models for specific tasks
- Save and reuse multiple optimized setups (e.g., “Fast Debugging” vs. “Deep Reasoning”)
What Profiles Can Include
Each profile stores:- API Providers → OpenAI, Anthropic, OpenRouter, Glama, etc.
- API Keys & Auth → Securely stored credentials per provider
- Model Selection → Choose from models like o3-mini-high, Claude 3.7 Sonnet, DeepSeek R1
- Model Parameters → Adjust temperature, max tokens, or provider-specific options
- Thinking Budgets → Control depth of reasoning where supported
- Provider-Specific Features → Settings unique to certain providers/models
Creating & Managing Profiles
1. Creating a Profile
- Open Settings → Providers
- Click the “+” button next to the profile selector
- Enter a name for your new profile
- Configure:
- Select an API provider
- Enter your API key
- Pick a model
- Adjust parameters (temperature, tokens, etc.)
2. Switching Profiles
- From Settings → Use the profile dropdown to switch configurations
- During Chat → Use the API Configuration dropdown in the chat panel
3. Pinning & Sorting Profiles
- Hover over a profile in the dropdown → click the pin icon
- Pinned profiles appear at the top (alphabetical order)
- Unpinned profiles appear below a separator (also alphabetical)
- Click the pin again to unpin
4. Editing & Deleting Profiles
- Select the profile in Settings to update details
- Rename → Click the pencil icon
- Delete → Click the trash icon (cannot delete your last remaining profile)
Linking Profiles to Modes
In the Prompts tab, you can:- Associate specific profiles with different Modes (e.g., Chat, Code Generation, Debugging)
- The system automatically remembers which profile you last used with each mode
Security Note
- All API keys are stored in VS Code’s Secret Storage
- Keys are never saved in plain text
- Credentials remain secure across sessions