Setup guide - Documented by Zed
Use Mistral in Zed
Zed has a native Mistral provider for the Zed Agent: an API key in Agent Settings or MISTRAL_API_KEY, plus optional custom models under language_models.mistral with api_url https://api.mistral.ai/v1. Codestral can separately serve as Zed's Edit Prediction provider.
Last verified 4 steps5 official sources
Steps
- Step 1.
Visit the Mistral platform and create an API key (console.mistral.ai/api-keys).
- Step 2.
Open Agent Settings with agent::OpenSettings, go to the Mistral section, and enter your Mistral API key. Zed also reads MISTRAL_API_KEY from the local Zed process environment.
Terminalexport MISTRAL_API_KEY="your_mistral_api_key" - Step 3.
Optionally add custom Mistral models (alternate model ids, limits, tool or image support, custom endpoint). Docs example:
JSON{ "language_models": { "mistral": { "api_url": "https://api.mistral.ai/v1", "available_models": [ { "name": "mistral-tiny-latest", "display_name": "Mistral Tiny", "max_tokens": 32000, "max_output_tokens": 4096, "max_completion_tokens": 1024, "supports_tools": true, "supports_images": false } ] } } } - Step 4.
For Codestral edit predictions: open the Settings Editor, search for "Edit Predictions", click Configure Providers, and enter your key in the Codestral section. Or set it in settings:
JSON{ "edit_predictions": { "provider": "codestral" } }
Caveats
- The custom-model snippet is Zed's verbatim example. mistral-tiny-latest is not a current Mistral model in Mistral's Models Overview, so replace name with a current id such as mistral-medium-latest and set the limits from Mistral's docs (256k context for Medium 3.5).
- Zed's Codestral edit-prediction section links to the Codestral dashboard (console.mistral.ai/codestral) for the key.
- Mistral separately documents running its Vibe agent in ACP-compatible clients. Zed's Agent Client Protocol (ACP) External Agents feature is a different path from the Zed Agent provider set up here.
- Devstral 2 (devstral-2512) was retired 2026-07-31 and replaced by mistral-medium-3-5.
More setup guides
Same tool, other providers
Related reading
- Mistral Large 4: Specs, Pricing, Benchmarks and Weights DateMistral Large 4 is a 1T-parameter multimodal MoE with 52B active, in public preview at $0.68/$2.09 per million tokens, with open weights due end of October.
- Mistral Shieldstral: A 3B Open-Weight Policy-Adaptive Moderation Model That Beats Models 7x Its SizeMistral Shieldstral is a 3B Apache 2.0 multimodal moderation model that takes your policy as a plain-language question at inference and runs on one 16GB GPU.
- Mistral Releases Robostral Navigate: An 8B Robotics Navigation ModelMistral Robostral Navigate is an 8B robotics model that navigates with only a camera and natural language commands. How it works and what the benchmarks mean.
- Leanstral 1.5: Mistral's Open Theorem-Proving Model Hits 100% on miniF2FLeanstral 1.5 is Mistral's open Apache-2.0 model for Lean 4 theorem proving. The benchmark claims, the HN pushback on its bug-finding pitch, and how to use it.
- Mistral OCR 4 and Unlimited OCR Make Document Parsing an Agent Runtime ChoiceMistral OCR 4 and Baidu's Unlimited OCR turn document parsing into a runtime choice for agents - cost per page, layout, confidence scores and self-hosting.
- Codex Custom Model Providers: GLM-5.3, Mistral and OllamaCodex only speaks the Responses API now. Tested config.toml blocks for GLM-5.3, Mistral Large 4 through a gateway, local Ollama and an internal proxy.
FAQ
How do I use Mistral in Zed?
Zed has a native Mistral provider for the Zed Agent: an API key in Agent Settings or MISTRAL_API_KEY, plus optional custom models under language_models.mistral with api_url https://api.mistral.ai/v1. Codestral can separately serve as Zed's Edit Prediction provider.
Which Mistral model ids work in Zed?
The official docs read for this guide list mistral-medium-3-5, mistral-medium-latest, mistral-small-2603, mistral-small-latest, codestral-2508 and codestral-latest. Requests go to https://api.mistral.ai/v1.
Is this an official Mistral and Zed setup?
Zed documents this setup in its own docs. It was last checked against 5 official pages on October 17, 2026.
Sources
Last verified against 5 official pages.
- github.comhttps://github.com/zed-industries/zed/blob/main/docs/src/ai/use-api-access.md
- github.comhttps://github.com/zed-industries/zed/blob/main/docs/src/ai/edit-prediction.md
- zed.devhttps://zed.dev/docs/ai/use-api-access
- docs.mistral.aihttps://docs.mistral.ai/models
- docs.mistral.aihttps://docs.mistral.ai/vibe/code/use-vibe-in-other-ides
Newsletter
New models, set up the day they ship
One email per week. New model releases, the coding tools that support them and how to wire them up.