Zed 编辑器接入

在 Zed 编辑器中通过 ACP（Claude Agent）或 settings.json 的 Anthropic / OpenAI 兼容 provider 接入 QCode.cc

需要 API Key？ 前往注册 →·端点与 Base URL →

最后核实：2026-09-18 · 📄 依据官方文档（Zed stable v1.20.2，2026-09-17 发布）

接入速览¶

Zed 是一款用 Rust 编写的高性能现代代码编辑器，2026 Q1 起原生支持 Agent Client Protocol (ACP)——这是一个开放标准，让 IDE 与 AI agent 解耦通信，类似 LSP 之于语言服务器。Zed 通过 ACP 集成 Claude Agent（claude-agent-acp，Claude Agent SDK 的封装），提供 agent panel 来编排多步骤代码任务。本文介绍如何把 QCode.cc 配置为 Zed 中 Claude Code 的 API 端点，以及如何把 QCode 作为 Anthropic 兼容 / OpenAI 兼容 provider 直接填进 Zed 的 settings.json。

QCode 全程使用同一把 API Key（cr_ 开头），同一把 Key 同时支持 Anthropic、OpenAI Chat、OpenAI Responses 与图像协议，并对应 api / asia / us 三个接入域（中国大陆用户优先用 asia.qcode.cc）。

为什么用 Zed¶

• 原生 ACP 集成：agent panel 内开 Claude Code 会话，在编辑器里直接看 agent 推理 + 工具调用
• 1M 上下文：BYOK 模式支持 Opus 5 / 4.8 / 4.7 的全 1M token 上下文窗口
• Rust 性能：冷启动极快、内存占用比 VS Code/Electron 系列小一个量级
• 多面板布局：编辑器 + 终端 + agent panel 三栏并列，工作流紧凑
• 两条接入路径：既可走 Claude Code CLI（保留全部工具），也可在 settings.json 里把 QCode 当作内置 provider

两种接入方式对比¶

Zed 接入 QCode 有两条互补的路径，按需选择：

下文「配置步骤」覆盖路径 A，「在 settings.json 中配置 provider」覆盖路径 B。

前置条件¶

• 已安装 Zed（macOS / Linux）
• 已安装 Claude Code CLI 与 Claude Agent ACP 封装 claude-agent-acp（Zed 的 ACP 集成挂载的是后者，配置继承 CLI 环境变量；仅用路径 B 时可跳过）
• 拥有 QCode.cc API Key（cr_ 开头），在 控制台 获取
• Claude Code CLI 已配置 QCode 环境变量（按 快速上手）

配置步骤（路径 A：ACP / Claude Code）¶

第 1 步：先确保 Claude Code CLI 在终端里能跑通¶

ACP 的 Claude Agent 后端复用 Claude Code 的登录与配置，所以先在终端里验证 CLI 本身：

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_xxxxxxxx"
claude --version   # 应输出版本号（以本机与官方 Releases 为准）
echo "ping" | claude   # 简单回响测试

ANTHROPIC_BASE_URL 末尾不要带斜杠；Anthropic SDK 会自己拼 /v1/messages。在 shell 配置（~/.zshrc / ~/.bashrc）里持久化这两个环境变量，确保 Zed 启动时也能继承。

第 2 步：打开 Zed 的 agent panel¶

• macOS：Cmd + ?
• Linux：Ctrl + ?

第一次打开会要求选择 agent provider，选 Claude Code 即可（不要选 BYOK Anthropic API，那条路径不走 CLI、需要在 Zed 设置里另填 base URL，详见路径 B）。

第 3 步：验证 agent 会话¶

在 agent panel 输入框打："列出当前文件的导出符号"。Zed 会把当前打开的文件作为上下文传给 Claude Code，agent 调用 read / grep 工具解析后答复。

如果 agent panel 起不来（找不到 agent 进程），可在 settings.json 的 agent_servers.<名称>.command / args / env 下显式指定 ACP agent 的启动命令（不存在 agent.path 这个设置键）。具体名称与字段以 Zed 官方文档 为准。

在 settings.json 中配置 provider（路径 B）¶

如果你不想装 CLI，可以把 QCode 填进 settings.json（打开 JSON 本体的默认键位是 Cmd+Alt+, / Ctrl+Alt+,；Cmd+, 打开的是设置编辑器 UI。文件在 ~/.config/zed/settings.json，Windows 为 %APPDATA%\Zed\settings.json；保存即生效，无需重启）。对第三方网关，官方推荐的是 anthropic_compatible / openai_compatible 两个自定义 provider 入口。QCode 同时支持这两种协议，用的是同一把 cr_ Key。

Anthropic 兼容 provider¶

自定义 Anthropic 兼容 provider 写在 language_models.anthropic_compatible 下（provider 名任意，示例用 QCode）：

{
  "language_models": {
    "anthropic_compatible": {
      "QCode": {
        "api_url": "https://api.qcode.cc/api"
      }
    }
  }
}

Key 不写进 settings.json（官方明令禁止），用 Zed 生成的环境变量：<PROVIDER名>_API_KEY，上例即：

export QCODE_API_KEY="cr_xxxxxxxx"

base URL 填到 /api 为止，不带 /v1——Zed 自己在后面拼 /v1/messages（源码证实）。内置 language_models.anthropic.api_url 同样存在、也能指到 QCode，但官方给第三方网关的推荐入口是上面的 anthropic_compatible。

OpenAI 兼容 provider¶

OpenAI 兼容 provider 写在 language_models.openai_compatible 下：

{
  "language_models": {
    "openai_compatible": {
      "QCodeOpenAI": {
        "api_url": "https://api.qcode.cc/openai/v1",
        "available_models": [
          { "name": "gpt-5.6-terra" },
          { "name": "gpt-5.6" },
          { "name": "glm-5.3" },
          { "name": "deepseek-v4-flash" }
        ]
      }
    }
  }
}

Key 同理走生成的环境变量：

export QCODEOPENAI_API_KEY="cr_xxxxxxxx"

base 填到 https://api.qcode.cc/openai/v1（Zed 拼 /chat/completions，带 /v1，与 Anthropic 兼容路径相反）。末尾不要带斜杠。available_models 的字段名以 Zed 官方文档为准；国产模型（GLM / DeepSeek 等）也能走这条 OpenAI 兼容路径。

模型选择¶

QCode 的同一把 Key 暴露多家模型。在 agent panel 或 assistant 的模型下拉里按需切换：

走哪个协议：claude-* 只能走 Anthropic provider（https://api.qcode.cc/api）；gpt-* 只能走 OpenAI provider（https://api.qcode.cc/openai/v1）。填反了会收到 model_not_available_on_endpoint。

单价与上下文长度以 qcode.cc/models 实时显示为准（本页不复制数字，避免过时）；claude-sonnet-4-6、claude-opus-4-8 等 4.x 仍在售。

• 走路径 A（Claude Code）时，模型由 Claude Code 自身配置决定（/model 切换或 ANTHROPIC_MODEL 环境变量）。
• 走路径 B 且用 Anthropic provider 时，填 claude-* 模型 ID；用 OpenAI provider 时填 gpt-* 模型 ID。
• 图像（gpt-image-2）协议在 Zed 的 assistant 里不一定原生暴露，可在 CLI / 脚本里直接调用，详见 接入点与 API 格式 与 gpt-image-2 图像生成。

用法示例¶

agent panel：跨文件任务¶

agent panel 适合多步、跨文件的任务。例如：

"把 utils/ 下所有同步 IO 改成 async，并更新调用方。"

agent 会自动 grep 定位、read 读取、edit 修改，并在编辑器里逐步展示 diff，你可以逐条 accept / reject。

把截图喂给 agent（视觉输入）¶

Claude Opus 5 / Sonnet 5 与 GPT-5.x 都是视觉模型。你可以把 UI 稿、报错截图、架构图作为输入交给 agent：

• 粘贴图片（Ctrl+V）或拖拽进 agent panel 输入框
• 或在 prompt 里引用本地图片文件路径

典型场景：照着设计稿生成 UI、看报错截图定位 bug、读架构图/图表。

注意：这里说的是把图片喂给模型（视觉输入），不是生成图片。要生成图片请用 gpt-image-2，见 gpt-image-2 图像生成。

Dynamic Workflows（后台子代理编排）¶

Claude Code 支持 Dynamic Workflows：编排几十到上百个后台子代理，适合全仓评审、迁移、调研类大任务。触发方式是在 prompt 里包含关键词 ultracode 或直接说"跑一个 workflow"；用 /workflows 命令查看运行中的任务。子代理在后台持续跑，你可以继续别的工作。它跑在 Claude Code 当前配置的模型上——所以当 Claude Code 指向 QCode 时同样可用。相关阅读：子代理。

无头 / 自动化输出格式¶

需要在 CI / 脚本里调用 Claude Code 时，用 claude -p 配合 --output-format：

# JSON：单个结构化对象，含 result / total_cost_usd / usage / session_id
claude -p "总结这次改动" --output-format json | jq .result

# stream-json：换行分隔的 JSON 事件流，适合实时管线
claude -p "重构这个模块" --output-format stream-json

# text：默认纯文本
claude -p "解释这段代码" --output-format text

更多用法见 自动化与 CI/CD。

其他接入点¶

当前接入点访问异常时可切换 ANTHROPIC_BASE_URL（或 settings.json 里的 api_url）：

OpenAI 兼容路径把域名同理替换即可，例如亚洲节点的 OpenAI Chat base 为 https://asia.qcode.cc/openai/v1。完整接入点列表见 接入点与 API 格式。

共享配额¶

Zed 中的 Claude Code agent 与 CLI / Claude Desktop / Codex CLI 使用同一个 QCode API Key 共享配额，不会重复扣费。路径 A 与路径 B 也共享同一把 Key 的配额。详见 计费说明。

限制与注意¶

• Zed 的 BYOK Anthropic 直连模式走的是 Zed 内置的 Anthropic provider，不通过 Claude Code CLI，需要在 Zed 设置里手填 api_url 为 QCode 端点（路径 B）。本文聚焦的 ACP / Claude Code 模式（路径 A）更推荐——保留了 CLI 全部工具（hooks、skills、MCP）。
• base URL 末尾不要带斜杠。自检时直接访问 base 路径返回 401 是正常的（说明路径对、只是没带鉴权）。
• ACP 集成处于 Public Beta（2026-04 起），少数 API 可能仍有变动；如发现行为差异以 Zed 官方文档 为准。
• Linux 沙箱用户：若 Zed 通过 Flatpak 安装，spawn claude 子进程可能受沙箱限制。建议直接下载 .deb / AppImage / Homebrew 版本。
• Gemini CLI 已退役（非企业版 EOL 2026-06-18，企业付费 Key 不受影响），其后继为 Google Antigravity CLI。注意 Antigravity CLI 只认 Gemini 兼容端点（环境变量 GOOGLE_GEMINI_BASE_URL），不是 OpenAI 兼容端点；QCode 暂不提供 Gemini 模型，详见 Antigravity CLI 接入。

常见问题¶

agent panel 报 "Failed to start agent"¶

• 终端里手动 claude 是否能正常启动？先排除 CLI 自身配置问题
• Zed 是否继承了 ANTHROPIC_* 环境变量？从终端 open -a Zed 启动可保证继承（macOS）
• claude-agent-acp 与 claude 是否在 PATH 里？which claude-agent-acp 验证；必要时用 agent_servers.<名称>.command 显式指定

settings.json provider 报 401 / 鉴权失败¶

• 确认对应环境变量已设置且为 cr_ 开头的 QCode Key：自定义 provider 用 <PROVIDER名>_API_KEY（如 QCODE_API_KEY / QCODEOPENAI_API_KEY），内置 provider 才是 ANTHROPIC_API_KEY / OPENAI_API_KEY
• Zed 是否继承了该环境变量？从终端启动 Zed 验证
• api_url 末尾是否误带了斜杠？去掉斜杠

模型下拉里看不到想要的模型¶

• 路径 B 的 OpenAI provider 需要在 available_models 里显式列出模型才会出现在下拉
• 路径 A 的可选模型由 Claude Code 决定，用 /model 查看与切换

提示模型名无效 / 404¶

• 核对模型 ID 拼写是否与上表完全一致（如 claude-opus-5）
• 确认 base URL 协议与模型匹配：claude-* 走 Anthropic 端点，gpt-* 走 OpenAI 端点

与 BYOK Anthropic 模式的区别¶

下一步¶

• Claude Code 完整教程 — CLI 全功能用法
• 接入点与 API 格式 — 三个接入域全表
• 子代理 — Dynamic Workflows 与多代理编排
• 自动化与 CI/CD — 无头模式与输出格式
• gpt-image-2 图像生成 — 图像生成（区别于视觉输入）
• VS Code 集成 — 对比 Electron 系编辑器
• 计费说明 — 共享配额规则

想看不同模型的实时价格与上下文规格？前往 qcode.cc/models。

企业团队版 →