Source: https://aiprimetech.io/zh/learn/use-claude-api-with-zed/

[首页](/zh/) / [学习](/zh/learn/) / 通过网关将 Zed 连接到 Claude 

# 通过网关将 Zed 连接到 Claude 

Zed 速度很快，其助手也很实用，但配置自定义 Claude 端点的位置并不是大多数人首先会想到的地方。原生 Anthropic 提供商不支持覆盖基础 URL，因此连接网关的简便方式是使用 Zed 的 openai_compatible 配置块。 

## 为什么不使用 Anthropic 提供商 

Zed 内置原生 Anthropic 提供商，直觉上会想将它指向网关。问题在于，这个提供商没有 api_url 设置，因此没有受支持的字段可以将请求从默认 Anthropic 主机重定向到其他地址。 

正是这一限制让许多人卡在这里。与其尝试绕过它，不如通过通用的 openai_compatible 机制访问 Claude。该机制提供基础 URL 设置，正是为第三方端点设计的。 

可以将原生提供商理解为固定连接到一个目标，而 openai_compatible 提供商则可以配置。对于多模型网关，可配置的方式本来就是合适的选择，因为同一个配置块可以通过单个 api_url 接入 Claude 以及网关提供的其他模型。这样，编辑器的所有模型配置都集中在同一处，而不必分散到规则不同的两套提供商机制中。这个选择决定了后续的配置方式，因此在编辑任何内容之前，先弄清楚它很有必要。确定 openai_compatible 配置块是受支持的接入方式后，剩下的就是填写字段。 

## 添加 openai_compatible 配置块 

在 settings.json 的 language_models.openai_compatible 下添加一个具名提供商。将其 api_url 设置为网关地址，并在末尾加上 /v1；Zed 会在该地址下访问 /chat/completions，因此响应请求的是网关的 OpenAI 兼容接口。 

名称可以任意选择，它会成为 Zed 模型菜单中的标签。一个配置块可以提供多个 Claude 模型，每个模型都在下一步中声明。 

这里的 /v1 后缀至关重要：Zed 会直接在你提供的 api_url 下构建聊天补全路径，因此缺少 /v1 会将请求发送到错误的位置，而末尾的斜杠可能导致路径重复。将其准确设置为主机地址加 /v1，路由就能正确工作。编辑后快速重新加载设置，可以确认 Zed 已正常解析该配置块。如果提供商没有出现，首先应检查配置块中是否存在 JSON 语法错误。 

## 声明 available_models 

Zed 不会自动发现自定义端点上的模型，因此需要在 available_models 中手动列出。每个条目都需要一个与网关 ID 匹配的 name、用于菜单显示的 display_name，以及根据模型设置的 max_tokens 值。 

使用 claude-sonnet-4-5 处理日常辅助任务，并将 claude-opus-4-8 添加为第二个条目，用于最困难的任务。由于模型由你明确列出，菜单只会显示你指定的模型，不会出现其他模型。 

name 字段必须与网关的 ID 逐字符一致，而 display_name 仅用于显示，可以设置为你希望在菜单中看到的名称。模型出现在菜单中却在使用时报错，通常是因为 name 填写错误，因此应直接从网关复制 ID，而不要凭记忆输入。只列出实际使用的模型，可以让菜单保持简洁，便于日常选择。以后添加模型只需编辑一行，因此无需一开始就声明所有模型。 

## 密钥存放在哪里 

API 密钥不应放在 settings.json 中。Zed 会将其存储在操作系统钥匙串中，或从以提供商命名的环境变量（例如 AIPRIME_API_KEY）中读取，从而避免将密钥放入同步配置。 

保存后，打开助手，从菜单中选择你的提供商，并在提示时输入密钥。此后，Zed 会使用钥匙串中的密钥进行身份验证，而设置文件中不会包含凭据。 

如果你在多台机器之间同步 Zed 设置，或将其提交到 dotfiles 仓库，这种分离方式非常实用：配置不包含密钥，因此可以自由同步，每台机器则通过钥匙串或环境变量提供自己的密钥。相比将密钥直接写入配置文件的工具，这种方式更清晰。这也是可以安全地与同事共享 Zed 配置的原因：他们使用自己的密钥，你的密钥不会随配置一起传递。将设置提交到 dotfiles 仓库时也是如此。 

## 通过 ACP 使用原生方式 

如果你明确需要原生 Anthropic 行为，而不是 OpenAI 兼容接口，Zed 支持通过 Agent Client Protocol 使用 Claude Code。你运行 Claude Code 作为智能体，Zed 则通过 ACP 与它通信。 

在这种配置中，Claude Code 自行使用指向网关的 ANTHROPIC_BASE_URL，因此 Zed 无需配置自己的 Anthropic api_url。这是在编辑器中获得真正原生 Messages 行为的最简便方式。 

需要权衡的是，ACP 提供的是 Claude Code 完整的智能体执行循环，而不是 Zed 较轻量的内置助手，因此功能更强，但使用起来也更重。需要快速的内联帮助时，选择 openai_compatible 方式；希望完整智能体在编辑器内执行多步骤编辑时，选择 ACP 方式。大多数人会先使用较轻量的方式，等到需要在编辑器中使用完整智能体时才采用 ACP。你可以同时保留这两种方式，并根据任务选择使用。 

复制

```
// Zed settings.json
{
  "language_models": {
    "openai_compatible": {
      "aiprime": {
        "api_url": "https://aiprimetech.io/v1",
        "available_models": [
          { "name": "claude-sonnet-4-5",
            "display_name": "Claude Sonnet",
            "max_tokens": 200000 }
        ]
      }
    }
  }
}
// Key goes in the keychain / AIPRIME_API_KEY env var, NOT this file.
```

## 常见问题 

 为什么无法在 Zed 中设置 Claude 的基础 URL？

Zed 的原生 Anthropic 提供商没有 api_url 字段。请使用提供 api_url 设置的 openai_compatible 配置块，并将其指向 https://aiprimetech.io/v1. api_url 应该放在哪里？

放在 language_models.openai_compatible.<name>.api_url 下，并以 /v1 结尾。Zed 会访问该地址下的 /chat/completions。 API 密钥应该放在哪里？

不要放在 settings.json 中。Zed 会将其保存在操作系统钥匙串中，或从以提供商命名的环境变量（例如 AIPRIME_API_KEY）中读取。 如何获得原生 Anthropic 行为？

通过 ACP 使用 Claude Code 作为智能体；Claude Code 使用 ANTHROPIC_BASE_URL 连接网关，因此 Zed 无需配置 Anthropic api_url。  

几分钟内开始使用 Claude

获取 API 密钥，无需 Anthropic 账户，也无需加入候补名单。[获取你的 API 密钥](/register) 

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。    

## 更多 Claude API 指南

[如何获取 Claude API 密钥](/zh/learn/how-to-get-a-claude-api-key/)[Claude API 定价详解](/zh/learn/claude-api-pricing-explained/)[使用 Claude API 最便宜的方式](/zh/learn/cheapest-way-to-use-claude-api/)[通过 Claude API 不限量使用 Cursor](/learn/use-claude-api-with-cursor/)[不限量访问 Claude Code](/zh/learn/use-claude-api-with-claude-code/)[Claude API 网关与 Anthropic 直连对比](/zh/learn/claude-api-vs-anthropic-direct/)[通过兼容 OpenAI 的 API 使用 Claude](/zh/learn/openai-compatible-claude-api/)[Claude 模型详解：Claude Opus、Sonnet、Haiku 与 Fable 的模型对比——全部 Claude API 模型、Anthropic 模型名称与价格（2026）](/zh/learn/claude-api-models-compared/)[使用加密货币支付 Claude API 费用](/zh/learn/claude-api-with-crypto-payment/)[无需候补名单即可访问 Claude API](/zh/learn/claude-api-without-waitlist/)[如何减少 Claude 词元用量](/zh/learn/how-to-reduce-claude-token-usage/)[通过 Claude API 不限量使用 Cline](/zh/learn/use-claude-api-with-cline/)[通过 Claude API 不限量使用 Roo Code](/zh/learn/use-claude-api-with-roo-code/)[在 JetBrains IDE 中不限量使用 Claude](/zh/learn/use-claude-api-with-jetbrains/)[通过 Claude API 无限制使用 Aider](/zh/learn/use-claude-api-with-aider/)[在 VS Code 中不限量使用 Claude](/zh/learn/use-claude-api-with-vscode/)[OpenCode 的 Claude 配置：opencode.json 设置、模型与常见错误](/zh/learn/use-claude-api-with-opencode/)[在 Claude 上运行不受限制的 Hermes 智能体](/zh/learn/run-hermes-agent-with-claude-api/)[使用 Claude 不限量运行 OpenClaw](/zh/learn/run-openclaw-with-claude-api/)[兼容 Anthropic 的 API 意味着什么](/zh/learn/anthropic-compatible-api/)[Claude Code API 密钥 — ANTHROPIC_API_KEY：如何获取、配置，以及何时应改用 claude setup-token](/zh/learn/claude-code-api-key-setup/)[Claude Code API 成本 — 定价与降低成本的方法](/zh/learn/claude-code-api-costs/)[Claude API 错误详解：服务器错误 500、过载 529、速率限制 429、错误请求 400 — 以及各自的修复方法](/zh/learn/claude-api-errors-troubleshooting/)[如何购买 Claude API 额度，以及为什么购买 Claude 额度比任何“购买 Claude 账户”的方案都更好](/zh/learn/buy-claude-api-credits/)[Claude 免费 API：有免费的 Claude API 密钥吗？2026 年究竟有哪些内容免费？](/zh/learn/claude-api-free-trial/)[Claude API 与 Claude Pro/Max 订阅——如何选择](/zh/learn/claude-api-vs-subscription/)[使用 Claude 运行 Codex CLI](/zh/learn/use-claude-api-with-codex/)[将 Claude 连接到 n8n](/zh/learn/use-claude-api-with-n8n/)[通过 LiteLLM 路由到 Claude](/zh/learn/use-claude-api-with-litellm/)[在 Kilo Code 中使用 Claude](/zh/learn/use-claude-api-with-kilo-code/)[将 Claude 接入 GitHub Copilot](/zh/learn/use-claude-api-with-github-copilot/)[将 Cherry Studio 连接到 Claude](/zh/learn/use-claude-api-with-cherry-studio/)[LangChain 中的 ChatAnthropic：导入、base_url、流式传输、工具和错误](/zh/learn/use-claude-api-with-langchain/)[Anthropic Python SDK：安装、设置 base_url、流式传输和错误处理](/zh/learn/anthropic-python-sdk/)[通过 Vercel AI SDK 使用 Claude：createAnthropic baseURL、流式传输和问题修复](/zh/learn/use-claude-api-with-vercel-ai-sdk/)[使用 Claude 运行 Factory Droid](/zh/learn/use-claude-api-with-factory-droid/)[Claude Code API 详解](/zh/learn/claude-code-api/)[将 Claude API 集成到您的应用中](/zh/learn/claude-api-integration/)[如何不受限制地使用 Claude，以及为什么不存在“Claude Code 破解版本”](/zh/learn/get-unlimited-claude-usage/)