
先决定从哪一处配置,别把两套界面的选项混起来
Claude Desktop 接入 AIGoCode 有两条官方路径:通过 CC Switch 添加并启用供应商,或在桌面端自带的第三方推理配置里填写 Gateway。它们最后都要回到 Claude Desktop 新会话验证,但配置入口和选项名称不同。
本文帮助你选定一条路径完成操作。CC Switch 的“直连”与桌面端 Connection 中的“Gateway”属于不同界面的配置项,不应因为名称看起来不同,就互相替换或把两条教程拼成一套。
两条路径共用的准备工作
按官方 Claude Desktop 教程,先从 Claude 官网下载安装桌面端;如果使用 CC Switch,再完成其安装。两条路径使用的 Key 均在 AIGoCode API Key 页面选择 Claude Code(可外接)分组创建。
这里针对桌面端教程核对分组,不把另一个客户端此前成功调用的 Key 当成通用依据。实际填写的密钥留在自己的配置中,排错记录只保留分组名称和字段是否已填写。
路径一:在 CC Switch 的 Claude Desktop 页面添加
打开 CC Switch,点击顶部 Claude Desktop 图标进入对应页面,再点击右上角加号添加供应商。官方明确要求选择“自定义配置”,以便使用 AIGoCode 的 .dev 请求地址,不选其他预设供应商。
填写刚创建的 API Key,请求地址设为 https://api.aigocode.dev,连接方式选择“直连”,然后添加。接着返回 CC Switch 的 Claude Desktop 页面,在 AIGoCode 供应商这一行点击“启用”。
“添加”与“启用”是两个检查点。不要因为在其他工具页面里启用了 AIGoCode,就默认 Claude Desktop 页面也已经选对。本文不推断不同工具之间的配置覆盖或同步规则,核对当前页面即可。
路径二:直接打开桌面端的第三方推理设置
如果不使用 CC Switch,官方步骤是打开 Claude Desktop,先不要登录。进入左上角菜单,选择 Help → Troubleshooting → Enable Developer Mode;然后再次打开菜单,选择 Developer → Configure Third-Party Inference...。
在左侧选择 Connection,把连接方式设为 Gateway,再按官方字段填写:
| 字段 | 选择或填写内容 |
|---|---|
| Credential kind | Static API key |
| Gateway base URL | https://api.aigocode.dev |
| Gateway API key | 刚创建的 Claude Code(可外接)分组 Key |
保存配置后创建新会话并发送消息。这条路径的表单要求 Gateway;不要把 CC Switch 里的“直连”当成这里也应寻找的同名选项。不同界面各按各自文档完成,本文不声称两条路径可以同时叠加或任意混用。
地址都按教程填写服务根地址
两条桌面端路径的官方值都是 https://api.aigocode.dev。不要从直接 API 请求示例里复制完整 /v1/messages 地址来替换该字段,也不要仅凭之前使用过某个 SDK 就自行补上 /v1。
这只是本文所述 Claude Desktop 教程的配置值,不能扩大成所有客户端都只填根地址。不同接入层的区别可参考本站直接 API 请求还是工具接入。
完成配置后,用新会话与用量记录一起验收
打开 Claude Desktop,新建会话,发送一条不含敏感信息的短消息。官方将正常回复,以及 AIGoCode 用量记录中出现这次请求,作为接入完成的判断依据。
记录测试时间,便于对照用量;不要把旧请求或其他工具的历史记录当作本次验证。本文没有代你发起真实请求,也不承诺固定回复、所有模型可用或某种性能表现。
如果模型不可用,官方建议先确认模型名称列表是否支持,再检查 Key 和请求地址;使用 CC Switch 时,还要确认供应商已启用。遇到 401、403、429 时按错误码继续排查,认证与额度问题可衔接本站401 与 403 分开排查。
最后保留一份简短配置记录:选择哪条入口、Key 分组、根地址、是否完成启用或保存,以及新会话回复与用量是否对上。这样下一次排错能找到具体阶段,而不必先切换整套接入方式。