Zed 编辑器接入

在 Zed 编辑器中通过 Agent Client Protocol (ACP) 把 QCode.cc 接入 Claude Code，启用 Opus 4.7 1M 上下文 agent panel

Zed 编辑器接入¶

Zed 是一款用 Rust 编写的高性能现代代码编辑器，2026 Q1 起原生支持 Agent Client Protocol (ACP)——这是一个开放标准，让 IDE 与 AI agent 解耦通信，类似 LSP 之于语言服务器。Zed 通过 ACP 集成 Claude Code，提供 agent panel 来编排多步骤代码任务。本文介绍如何把 QCode.cc 配置为 Zed 中 Claude Code 的上游。

为什么用 Zed¶

• 原生 ACP 集成：agent panel 内开 Claude Code 会话，在编辑器里直接看 agent 推理 + 工具调用
• 1M 上下文：BYOK 模式支持 Opus 4.7 的全 1M token 上下文窗口
• Rust 性能：冷启动极快、内存占用比 VS Code/Electron 系列小一个量级
• 多面板布局：编辑器 + 终端 + agent panel 三栏并列，工作流紧凑

前置条件¶

• 已安装 Zed（macOS / Linux）
• 已安装 Claude Code CLI（Zed 的 ACP 集成走 CLI 后端）
• 拥有 QCode.cc API Key（cr_ 开头），在 控制台 获取
• Claude Code CLI 已配置 QCode 环境变量（按 快速上手）

配置步骤¶

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

Zed 通过 spawn claude 进程把 ACP 跑起来，所以先在终端里验证：

export ANTHROPIC_BASE_URL="http://103.236.53.153/api"
export ANTHROPIC_AUTH_TOKEN="cr_xxxxxxxx"
claude --version   # 应输出版本号
echo "ping" | claude   # 简单回响测试

在 shell 配置（~/.zshrc / ~/.bashrc）里持久化这两个环境变量，确保 Zed 启动时也能继承。

第 2 步：打开 Zed 的 agent panel¶

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

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

第 3 步：验证 agent 会话¶

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

如果 agent panel 提示找不到 claude 命令，需要在 Zed 设置（Cmd+,）里加 agent.path 指向 CLI 二进制完整路径：

{
  "agent": {
    "path": "/usr/local/bin/claude"
  }
}

备用节点¶

主推节点访问异常时可切换 ANTHROPIC_BASE_URL：

完整节点列表（含北美 / 欧洲 / 亚洲备用）见 接入点与 API 格式。

共享配额¶

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

限制与注意¶

• Zed 的 BYOK Anthropic 直连模式走的是 Zed 内置的 Anthropic provider，不通过 Claude Code CLI，需要在 Zed 设置里手填 assistant.providers.anthropic.api_url 为 QCode 端点。本文聚焦的 ACP / Claude Code 模式更推荐——保留了 CLI 全部工具（hooks、skills、MCP）。
• ACP 集成处于 Public Beta（2026-04 起），少数 API 可能仍有变动；如发现行为差异以 Zed 官方文档 为准。
• Linux 沙箱用户：若 Zed 通过 Flatpak 安装，spawn claude 子进程可能受沙箱限制。建议直接下载 .deb / AppImage / Homebrew 版本。

常见问题¶

agent panel 报 "Failed to start agent"¶

• 终端里手动 claude 是否能正常启动？先排除 CLI 自身配置问题
• Zed 是否继承了 ANTHROPIC_* 环境变量？从终端 open -a Zed 启动可保证继承（macOS）
• 设置里 agent.path 填的路径是否存在？which claude 验证

与 BYOK Anthropic 模式的区别¶

下一步¶

• Claude Code 完整教程 — CLI 全功能用法
• 接入点与 API 格式 — 五个接入域全表
• VS Code 集成 — 对比 Electron 系编辑器
• 计费说明 — 共享配额规则