AI Quick Start
Use this page to choose the right AI setup path in Zed. If you already know the company, subscription, model provider, agent, or CLI you want to use, start with AI by Company.
Use the Zed Agent
Use Zed Agent when you want Zed's native agent to read, edit, search, and run code in your project.
Zed Agent uses Zed-configured models from LLM Providers. It also uses Zed's built-in tools, Agent Profiles, Skills, Instructions, and MCP servers.
Start in the Agent Panel to prompt the agent, add context, review changes, and manage threads.
Configure the Zed Agent
| If you want to... | Use |
|---|---|
| Control tools and permissions | Agent Profiles |
| Approve or deny individual tools | Tool Permissions |
| Add reusable task instructions | Skills |
| Add always-on personal or project context | Instructions |
| Connect external tools and context | Model Context Protocol |
Use Another Coding Agent in Zed
Use this path for Claude, Codex, OpenCode, Copilot, Cursor, Pi Coding Agent, Gemini CLI, or another coding agent.
| If the agent... | Use |
|---|---|
| Integrates with Zed through ACP | External Agents |
| Runs as a CLI or TUI | Terminal Threads |
External Agents and Terminal Threads usually own their own auth, model configuration, subscriptions, tools, instructions, and MCP configuration.
Choose Which Models the Zed Agent Uses
The Zed Agent and other model-backed Zed AI features use models configured through LLM Providers.
| If you want to... | Use |
|---|---|
| Use models billed through Zed | Zed-Hosted Models |
| Bring your own provider API key, credits, top-ups, or usage billing | Use API Access |
| Use a subscription you already pay for | Use an Existing Subscription |
| Use OpenRouter, Vercel AI Gateway, Amazon Bedrock, or another gateway | Use a Gateway |
| Use Ollama, LM Studio, local OpenAI-compatible servers, or self-hosted models | Use a Local Model |
Provider keys saved through Zed are stored in the system keychain, not in settings.json.
Change AI Settings
| If you want to... | Go to |
|---|---|
| Configure LLM providers, External Agents, or MCP servers | Agent Settings with agent: open settings |
| Disable AI, configure tool permissions, or set up edit prediction providers | Settings Editor with zed: open settings |
| Edit advanced JSON-only settings | Settings file with zed: open settings file |
For general settings mechanics, see Configuring Zed.
Use a Specific AI Feature
| If you want to... | Use |
|---|---|
| Prompt agents, add context, and review changes | Agent Panel |
| Accept AI completions while typing | Edit Prediction |
| Rewrite selected code or terminal text | Inline Assistant |
| Run multiple AI tasks at once | Parallel Agents |
| Generate commit messages | Git commit generation |
Learn More
| If you want to... | Use |
|---|---|
| Understand privacy and data controls | AI Privacy and Feedback and Training Data |
| Understand plans, usage, and billing | Plans & Pricing, Zed-Hosted Models, and Billing |
Turn AI Off
Open the Settings Editor with zed: open settings, search for Disable AI, and enable it.
You can also add this to your settings file:
{
"disable_ai": true
}
When AI is turned off, all AI features are disabled. This includes the Threads Sidebar, Agent Panel, Edit Prediction, and Inline Assistant.