跳转到内容
全部开发指南

Claude Desktop 接入 AIGoCode:CC Switch 与 Gateway 两条路径怎么配

AIGoCode发布于 更新于

封面:两种配置入口连接同一个桌面对话窗口

先决定从哪一处配置,别把两套界面的选项混起来

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 kindStatic API key
Gateway base URLhttps://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 分组、根地址、是否完成启用或保存,以及新会话回复与用量是否对上。这样下一次排错能找到具体阶段,而不必先切换整套接入方式。