Claude Desktop
Claude Desktop 支持对接讲 Anthropic Messages API 的第三方网关。ApiGo 在 https://api.apigo.ai 暴露该协议，因此你可以保留 Claude Desktop 的原生体验，同时走 ApiGo 的计费、路由与调用日志。
前置条件
- 最新版 Claude Desktop（官网下载）
- 在 工作空间 → API Keys 创建的 ApiGo API 密钥
- Base URL 使用
https://api.apigo.ai（不要加/v1）
配置步骤
1. 开启开发者模式
启动 Claude Desktop（无需先登录 Anthropic 账号）。打开菜单：
Help → Troubleshooting → Enable Developer Mode
菜单栏会出现 Developer。
2. 打开第三方推理配置
选择 Developer → Configure Third-Party Inference…。
3. 填写 Gateway 凭证
连接类型选 Gateway，并填写：
| 字段 | 值 |
|---|---|
| Gateway base URL | https://api.apigo.ai |
| Gateway API key | 你的 sk-apigo-... |
| Gateway auth scheme | bearer |
OIDC / SSO IdP 相关字段留空。ApiGo 使用静态 API Key 鉴权，不是 OIDC 登录流。
点击 Apply locally 保存。
4. 重启并以 Gateway 继续
请完全退出 Claude Desktop（不只是关窗口），再重新打开。在启动页选择：
Continue with Gateway（本地配置 / Local configuration）
5. 选择模型
在模型选择器中使用当前工作区可用的模型。可到 模型目录 对照 slug，再回到 Desktop 选择。
发一条短消息后，到 Call Logs 确认请求已到达。
与 Claude Code 的关系
- Claude Desktop：图形界面 + Gateway 面板配置
- Claude Code：终端 Agent + 环境变量 /
settings.json
两者都走 Anthropic Messages 协议。终端工作流见 Claude Code。
故障排除
| 现象 | 处理 |
|---|---|
| 连接错误 | Base URL 必须是 https://api.apigo.ai；auth scheme 为 bearer；Key 未过期 |
| 看不到 “Continue with Gateway” | 先 Apply locally，再完全退出并重启 |
| 没有模型可选 | 确认工作区余额、Key 状态，以及模型在目录中可用 |
| WebFetch 等工具被拦 | 若使用 Cowork 沙箱，到 Gateway 面板的 Sandbox 页把需要访问的域名加入白名单（仅影响沙箱工具） |
