工具教程 · 2026-08-30

Zed 接 OpenAI 兼容端点
Agent Settings 里加 Provider

截至 2026-08-30,Zed 官方文档写明可用 openai_compatible:填 provider 名、api_url、模型 id、context window。下一步是把 https://api.qcode.cc/v1 加进去,模型 id 从 /models 复制。

#zed#openai_compatible#api_url#BYOK

要点

4

接入要填的项

官方 OpenAI-compatible 节:provider 名、API URL、模型 id、context window。key 走设置 UI 或环境变量,不写进 settings.json。

2026-08-30

文档抓取日

zed.dev/docs/ai/use-api-access,本轮 2026-08-30 抓取。

/v1

api_url 形态

官方示例是 https://example.com/v1。QCode 对应 https://api.qcode.cc/v1。不要把 /chat/completions 贴进 URL 栏。

tools

默认能力

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。

2026-08-30

本轮抓取仍是上述口径。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 节。

在 Zed 里加一个 Provider

官方 openai_compatible + QCode 的 /v1。模型 id 以 /models 为准。