为zed工具配置claudecode+自定义模型

目标

为zed 工具配置claudecode方法，模型根据自己需要自定义

你是想在 Zed 里把 Claude Code 当助手用对吧？其实这个问题能拆成两步：① 在 Zed 里接入 Claude Code，② 选你自己想要的模型。倒也不用按顺序做，可以组合着来。

我已经把几种主流的接入方式和对应的自定义模型方法帮你整理好了，你可以直接按下面的方案来操作：

🚀 方案一：官方适配器 (推荐)

这个方法最推荐，它对 Zed 的兼容性最好，也是 Zed 官方博客推荐的。

  1. 安装：在你的电脑上全局安装官方适配器。

    npm install -g @zed-industries/claude-code-acp

    什么是ACP？ 它是Zed和AI助手沟通的协议，让接入变得更标准化，就像通用插件接口。

  2. 配置：打开 Zed，按 Cmd+Shift+P (Mac) 或 Ctrl+Shift+P (Windows/Linux) 打开命令面板，执行 zed: Open Settings。在 settings.json 里加入：

    { "agent_servers": { "Claude Code": { "command": "claude-code-acp" } } }

    这个配置告诉 Zed 去启动你刚装的官方适配器。

  3. 使用：保存设置后，在 Zed 里打开 Agent 面板 (Cmd+? 或 Ctrl+?)，就能看到并选择 "Claude Code" 了。

🛠️ 方案二：社区方案 (灵活)

如果你需要更多控制，比如自己选择模型或自定义 API 地址，可以试试 claude-code-acp-rs。

  1. 安装：这个工具是用 Rust 写的，你需要先装好 Rust。

    cargo install claude-code-acp-rs

  2. 配置：同样，在 settings.json 里添加如下内容。这里的 env 部分就是用来自定义模型的。

    {
  "agent_servers": {
    "Claude Code (Custom)": {
      "command": "claude-code-acp-rs",
      "env": {
        "ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
        "ANTHROPIC_BASE_URL": "https://your-custom-api.com/v1",
        "ANTHROPIC_API_KEY": "your-api-key"
      }
    }
  }
}

    这个配置通过 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 定义了自己的模型源和 API 地址。

👶 方案三：NPX 快速尝鲜

如果你想最快速度体验，不打算长期使用，可以直接用 npx 跑。

  1. 配置：在 settings.json 里加入下面这段。每次打开对话，它都会通过 npx 去临时下载并运行适配器。
    { "agent_servers": { "Claude Code (npx)": { "command": "npx", "args": ["@zed-industries/claude-code-acp"] } } }

⚡ 方案四：一键启动 (最新版 Zed 专属)

如果你是 Zed 的最新版本（包括预览版 Preview） ，那最省事。

  • 直接在 Agent 面板 (Cmd+? 或 Ctrl+?) 里，点击右上角的 加号 + 按钮，通常就能看到 "New Claude Code Thread" 的选项了。

🧪 进阶：用 Zed 的language_models 字段自定义模型

除了上面针对 Claude Code 的配置，Zed 本身也允许你添加和自定义任何 AI 模型。在 settings.json 里通过 language_models 字段来配置，特别适合自己部署或使用第三方代理的模型。

  • 添加 Anthropic 模型：比如你要用 claude-3-7-sonnet-latest 及其思维链功能。

    { "language_models": { "anthropic": { "available_models": [ { "name": "claude-3-7-sonnet-latest", "display_name": "Claude 3.7 Sonnet (Thinking)", "max_tokens": 200000, "mode": { "type": "thinking", "budget_tokens": 4096 } } ] } } }

  • 添加 OpenAI 兼容模型：这样你就能接入几乎所有 OpenAI 格式的服务（比如 DeepSeek、通义千问等）。

    { "language_models": { "openai": { "api_url": "https://api.deepseek.com/v1", "available_models": [ { "name": "deepseek-chat", "display_name": "DeepSeek Chat", "max_tokens": 32000 } ] } } }

💡 模型自定义参数说明

下面这些环境变量（放在 env 里）可以用来精确控制你想要的自定义模型：

环境变量 作用 示例值
CLAUDE_MODEL / ANTHROPIC_MODEL 指定模型名称 claude-sonnet-4-20250514
ANTHROPIC_BASE_URL 指定自定义 API 地址 https://your-api-gateway.com
CLAUDE_CUSTOM_SYSTEM_PROMPT /
CLAUDE_APPEND_SYSTEM_PROMPT		 自定义或附加系统提示词 "You are an expert in Python."
CLAUDE_ALLOWED_TOOLS 允许 AI 使用的工具 "Read, Edit, Bash"
CLAUDE_MAX_TURNS 限制单次任务的推理步数 50

🐞 常见问题排查

  • 模型没出现？ 检查一下 settings.json 的格式，确保 JSON 语法正确，agent_servers 或 language_models 的层级没写错。
  • API 报错？ 确认你的 API Key 和 API 地址是正确的，并且账号有足够余额。
  • 工具执行失败？ 检查一下 CLAUDE_ALLOWED_TOOLS 的设置，看看是不是限制了它必要的工具。
posted @ 2026-05-14 00:00  念槐聚  阅读(436)  评论(0)    收藏  举报