Zed

How to fix Zed reporting Model Not Found or an unknown model

Zed's OpenAI-compatible provider does not auto-fetch the model list. The Agent can only use Model IDs you type in Add Model. The ID must match the AI Code With docs exactly; a typo, a missing character, or a display name yields Model Not Found.

Start with these checks

The requested Model ID does not match a model AI Code With offers, or it was mistyped in Add Model.

  • The request reports Model Not Found or unknown model, or the new model is missing from the Agent Panel dropdown.
  • The Model ID in Add Model was typed by hand, has extra spaces, or used the display name instead of the ID
  • Open Agent Settings β†’ LLM Providers, select the AI Code With provider, and click Add Model
model not foundunknown model

01

Understand how Zed uses the Model ID

The name in the Add Model dialog can be anything, but the Model ID must be a real AI Code With ID such as deepseek-v4-flash, not β€œDeepSeek V4 Flash”. Zed sends that ID unchanged in the OpenAI-compatible model field.

If the dropdown does not show the new model, Add Model was probably not saved, or the Agent Panel is still on built-in OpenAI / Zed-hosted models. Confirm the model entry exists under the provider first.

02

Re-add the exact ID from the integration page

Copy the target ID from the model list on this page and paste it into Add Model. Do not type from memory, and do not add a provider prefix (aicodewith/deepseek-v4-flash is wrong).

Also set a context window. Zed requires max_tokens / context window; 128000 is a common value. A wrong window usually does not cause Model Not Found β€” that error is almost always the ID itself.

  1. 1Open Agent Settings β†’ LLM Providers, select the AI Code With provider, and click Add Model
  2. 2Copy the exact Model ID from this page (e.g. deepseek-v4-flash); do not type it or change casing

03

Check access and select the model in the Agent Panel

If the ID is correct but the error remains, confirm on the AI Code With docs and pricing page that the model is currently available and your key can access it. Some models are plan-gated.

After saving, pick that entry in the Agent Panel dropdown before sending. If you add the model but leave another provider selected, the request never uses the new ID. When replies look normal, match the model name in usage records.

  1. 1Copy the exact Model ID from this page (e.g. deepseek-v4-flash); do not type it or change casing
  2. 2Set a context window (128000 is common) and confirm the current key can access that model

Zed does not sync the AI Code With catalog automatically. Each new model requires another Add Model step.

If it is still not fixed

Sources

Reconfigure

Return to the integration center and continue the setup steps.

Return to the related setup step