在 Claude Desktop 中配置 ZetaAPI

通过 Claude Desktop 的第三方推理（Gateway）模式接入 ZetaAPI，无需 Claude 订阅即可在 Cowork 和 Code 中使用 Claude 模型，费用从 ZetaAPI 余额扣除。

更新于 2026-10-15

适用场景

Claude Desktop 是 Anthropic 官方桌面应用。它提供「第三方推理（Third-Party Inference）」模式，可以把推理请求发到兼容 Anthropic Messages API 的网关。ZetaAPI 的 /v1/messages 端点兼容 Anthropic Messages API，配置后即可在 Cowork 和 Code 两个标签页中使用 Claude 模型，按 ZetaAPI 的倍率计费，无需 Claude 订阅。

准备工作

已安装 Claude Desktop（如果后面找不到对应菜单，请先更新到最新版）
已在 ZetaAPI 控制台获取 API Key（以 sk- 开头），且该 Key 所在分组包含 Claude 模型（默认分组即可）

配置步骤

1. 开启开发者模式

在应用菜单栏（以 macOS 为例，菜单栏位于屏幕顶部）选择 Help → Troubleshooting → Enable Developer Mode。

注意：这里说的是应用菜单栏，不是应用内的「设置 → Developer」页面——后者用于管理本地 MCP 服务器，没有第三方推理配置。

2. 打开第三方推理配置

开启后菜单栏会多出 Developer 菜单，选择 Developer → Configure Third-Party Inference…。

3. 填写网关信息

按下表填写（界面上的字段名可能因版本略有不同）：

字段	填写内容
连接方式	Gateway
Base URL	`https://api.staging.cosmos-router.com`（末尾不要加 `/v1`）
API Key	你的 ZetaAPI Key
认证方式	Bearer（默认值，无需修改）

4. 保存并重启

点击 Apply Changes → Save & Restart。应用重启后，在登录页选择以第三方模式进入（无需登录 Anthropic 账号）。左下角账号旁显示 Gateway 即表示已切换成功。

5. 开始使用

切换到 Cowork 或 Code 标签页，在输入框右下角的模型选择器中选择模型（如 Haiku 4.5），发送消息即可。

常见问题

Q: 支持 prompt cache 吗？

支持。Cowork 和 Code 的多轮对话会命中 prompt cache，命中部分按缓存价格计费。