Every developer has unique needs when it comes to AI assistance. Some prefer the convenience of cloud-managed configurations, while others need the control and privacy of local setups. Continue offers both paths, and this guide will help you choose the right one for your workflow.

​
What Are the Two Paths to AI Assistance?

Continue provides two distinct ways to configure your AI agent: Think of Continue’s configuration options like choosing between a managed service and self-hosting. Both get you to the same destination—powerful AI assistance in your IDE—but the journey and control level differ significantly.

​
How to Access Your Agent Configuration

Before we dive into the specifics, let’s understand how to access your configuration:
  1. Open the Continue Chat sidebar by pressing cmd/ctrl + L (VS Code) or cmd/ctrl + J (JetBrains)
  2. Click the Agent selector above the main chat input
  3. Hover over an agent and click:
    • new window icon for Hub agents
    • gear icon for Local agents
configure an agent

​
What Are Hub Agents: The Managed Experience

Hub Agents represent the “it just works” philosophy. When you sign in to Continue Hub, you gain access to a curated ecosystem of pre-configured agents that sync seamlessly across all your development environments.

​
Why Should You Choose Hub Agents?

The Power of Simplicity
  • Instant Setup: Browse the agent marketplace and add any agent to your account with a single click
  • Web-Based Management: Configure models, add secrets, and customize settings through an intuitive web interface—no JSON editing required
  • Automatic Synchronization: Make a change on the hub, and it reflects immediately across all your IDE instances
  • Team Collaboration: Share custom agents with your team, ensuring everyone uses the same optimized configurations
nextjs agent

​
How to Get Started with Hub Agents

The journey from zero to AI-powered coding takes just four steps:
  1. Select Your Agent: Click the agent selector in your IDE’s Continue panel
  2. Explore or Create: Browse community agents or craft your own specialized helper
  3. Secure Your Keys: Add API keys as User Secrets in the hub—they’re encrypted and never exposed
  4. Sync and Code: Click “Reload config” to pull your latest settings
Pro tip: Hub Agents are perfect for teams. Create a custom agent with your team’s coding standards, preferred models, and context sources, then share it with a simple link.

​
How to Manage Hub Agents

All Hub Agent management happens through the Hub. For detailed customization, see our guide on Editing an Agent.

​
What Are Local Agents: The Power User’s Choice

Local Agents put you in the driver’s seat. Using a config.yaml file, you have complete control over every aspect of your AI agent’s behavior, with all configuration stored directly on your machine.

​
Why Should You Choose Local Agents?

Complete Control and Privacy
  • Your Data, Your Rules: All configuration stays on your machine—perfect for air-gapped environments or strict data policies
  • Version Control Integration: Check your config.yaml into git alongside your code, ensuring reproducible environments
  • Offline Capability: Once configured, no internet connection needed (assuming you’re using local models)
  • Unlimited Customization: Access every configuration option, experimental feature, and advanced setting

​
How to Set Up Local Agents

Local configuration lives in a single YAML file in your home directory: File Locations:
  • macOS/Linux: ~/.continue/config.yaml
  • Windows: %USERPROFILE%\.continue\config.yaml
Quick Access Method:
  1. Open the agents dropdown in your IDE
  2. Click the gear icon next to “Local Agent”
  3. The config.yaml file opens in your editor
local-config-open-steps

​
The Local Agent Experience

When you edit your config.yaml, Continue provides intelligent autocomplete for all available options. Save the file, and Continue automatically reloads your configuration—no restart required. The first time you use Continue, it generates a config.yaml with sensible defaults. From there, you can customize everything from model selection to context providers, slash commands, and more. For the complete configuration reference, see our config.yaml documentation.

​
How to Make the Right Choice

The decision between Hub and Local agents often comes down to your specific needs and constraints. Here’s a framework to help you decide:

​
Choose Hub Agents When You:

Value Convenience Over Control
  • Want to start coding with AI assistance in under 60 seconds
  • Prefer visual interfaces over editing configuration files
  • Need to switch between multiple machines frequently
  • Work in a team that needs standardized AI assistance
Need Advanced Collaboration
  • Want to share custom agents with teammates
  • Need centralized API key management
  • Require quick updates across your entire organization
Are Getting Started
  • New to AI-powered development
  • Want to experiment with different models and configurations
  • Prefer guided setup experiences

​
Choose Local Agents When You:

Require Maximum Control
  • Need to version control your exact configuration
  • Want to customize every aspect of the AI behavior
  • Require reproducible development environments
Have Privacy Requirements
  • Work with sensitive code that requires air-gapped environments
  • Need to ensure all configuration data stays local
  • Have strict compliance requirements about data storage
Are a Power User
  • Comfortable editing YAML/JSON files
  • Want access to experimental features
  • Need to integrate with local tools and scripts

​
How to Use the Hybrid Approach

Here’s a secret: you don’t have to choose just one. Many developers use both approaches:
  • Hub Agents for general development and experimentation
  • Local Agents for production work or client projects with specific requirements
You can switch between them seamlessly using the agent selector in your IDE.

​
Common Patterns and Best Practices

​
For Hub Agent Users

  1. Start with Community Agents: Before creating your own, explore what others have built
  2. Use Secrets Properly: Never hardcode API keys—always use the User Secrets feature
  3. Create Specialized Agents: Make different agents for different contexts (frontend, backend, DevOps)
  4. Share Liberally: If you create something useful, share it with the community

​
For Local Agent Users

  1. Version Control Your Config: Treat your config.yaml like code—commit it, review changes, and maintain history
  2. Use Environment Variables: For sensitive data, reference environment variables instead of hardcoding values
  3. Document Your Setup: Add comments to your config explaining non-obvious choices
  4. Keep a Backup: Before major changes, save a working copy of your configuration

​
Troubleshooting and Tips

​
Hub Agent Issues

Changes Not Reflecting?
  • Click “Reload config” in your IDE
  • Check your internet connection
  • Ensure you’re signed in to the correct account
Agent Not Available?
  • Verify it’s added to your account on the hub
  • Check if it requires specific API keys

​
Local Agent Issues

Config Not Loading?
  • Verify file location matches your OS
  • Check YAML syntax (Continue will show errors)
  • Ensure file permissions allow reading
Autocomplete Not Working?
  • Update to the latest Continue version
  • Check that you’re editing the correct file

​
Next Steps

Now that you understand both configuration approaches, you’re ready to dive deeper: Remember, the best configuration is the one that helps you code more effectively. Start simple, experiment freely, and gradually refine your setup as you discover what works best for your workflow. Happy coding with Continue! 🚀