Zed 接 OpenAI 兼容端点
Agent Settings 里加 Provider
截至 2026-08-30,Zed 官方文档写明可用 openai_compatible:填 provider 名、api_url、模型 id、context window。下一步是把 https://api.qcode.cc/v1 加进去,模型 id 从 /models 复制。
要点
接入要填的项
官方 OpenAI-compatible 节:provider 名、API URL、模型 id、context window。key 走设置 UI 或环境变量,不写进 settings.json。
文档抓取日
zed.dev/docs/ai/use-api-access,本轮 2026-08-30 抓取。
api_url 形态
官方示例是 https://example.com/v1。QCode 对应 https://api.qcode.cc/v1。不要把 /chat/completions 贴进 URL 栏。
默认能力
openai_compatible 默认 tools: true,images 默认 false。以官方 capabilities 表为准。
Zed 的 API 接入是什么
Zed 是图形化代码编辑器,自带 Agent / Inline Assistant 等 AI 功能。官方把「API access」定义成:你有提供方的 API key 或按量额度时,在 Agent Settings 里接模型。OpenAI-compatible endpoints 是其中一条官方通道,不是破解,也不是改客户端标识。
现在还在被搜什么
2026-08 检索里,Zed 经常和 Cursor、OpenCode 一起出现在「把编辑器指到 OpenAI 兼容网关」的配方里。站内还没有 Zed 专页。本页只回答:官方怎么加自定义端点,以及填 QCode 之后下一步做什么。
时间线
官方 Use API Access 页列出 OpenAI-compatible endpoints,可用 UI(agent: open settings)或 settings.json 的 language_models.openai_compatible。
同一页写明:设置页保存的 key 进系统钥匙串;openai_compatible 的环境变量由 provider id 生成(如 my-gateway → MY_GATEWAY_API_KEY)。不要把 key 写进 settings.json。
本轮抓取仍是上述口径。custom_headers 可用于额外 HTTP 头;官方写明 Authorization 等由 Zed 托管的头若被覆盖会被忽略并警告。
已确认 vs 注意
已确认
Zed 官方支持 openai_compatible:自定义 api_url、模型 id、context window。key 用设置 UI 或环境变量。默认 tools: true。文档抓取 2026-08-30。
注意
官方要求不要把 API key 写进 settings.json。custom_headers 不能用来改写 Authorization。External Agents / Terminal Threads 往往在 agent 自己那边配模型,和 Zed 自带 AI 通道不是同一条路径。
用哪条通道
openai_compatible(本页)
有自定义 base URL 时走这条。QCode 是 OpenAI 兼容网关,填 https://api.qcode.cc/v1。
厂商官方通道
Anthropic / OpenAI / Google AI 等官方账号仍走各自区块。ChatGPT Plus 订阅不是 API key,官方把订阅和 API access 分成两条路径。
下一步怎么做
打开 Agent Settings(命令 agent: open settings),在 LLM Providers 点 Add Provider。填 provider 名、API URL https://api.qcode.cc/v1、/models 上的模型 id、context window。API key 在设置 UI 里输入,或设对应环境变量。保存后在 Agent 面板选这个模型。换模型只改 id。
在 QCode 上
QCode 提供 OpenAI 兼容端点 https://api.qcode.cc/v1。Zed 按官方 openai_compatible 接上即可。可调哪些模型以 /models 实时列表为准,本页不把目录快照写成永久在售。
常见问题
Zed 能接自定义 OpenAI 兼容网关吗?
能。官方 Use API Access 页有 OpenAI-compatible endpoints 一节,UI 和 settings.json 都可以加。
api_url 填到哪一层?
填到 /v1,例如 https://api.qcode.cc/v1。不要把 /chat/completions 贴进 URL。
能不能把 key 写进 settings.json?
官方写不要。用设置 UI(钥匙串)或环境变量。
ChatGPT Plus 能当 API key 用吗?
官方把 ChatGPT 订阅和 OpenAI API access 分成两条路径。本页只讲 API key / 兼容端点。
改 Authorization 头绕过分层可以吗?
官方文档观察:Zed 托管的 Authorization 等头若被 custom_headers 覆盖会被忽略并警告。本页不提供绕过配方。
模型 id 从哪抄?
/models 实时目录。复制 id 填进 available_models.name。
信息来源
Zed 官方 Use API Access(zed.dev/docs/ai/use-api-access),2026-08-30 抓取。OpenAI-compatible endpoints 节、API Keys and Environment Variables 节、Custom Headers 节。
相关阅读
Cline 接 OpenAI 兼容 API
VS Code 插件同样走自定义 Base URL、key 和模型 id。
OpenCode 指南
终端向开源 agent,也支持自定义端点。
Aider 指南
CLI agent 的 OpenAI base URL 写法。
与 Zed Industries 无隶属。功能以 zed.dev 文档为准。本页不是绕过任何厂商订阅鉴权的说明书。