Claude Code 桌面版接入第三方 API

适用于希望在 Claude 桌面客户端内使用 Vmvia API 的用户。桌面版的「第三方推理」入口仅接受 HTTPS 域名，IP + 端口或 HTTP 地址不能填入。

此入口属于 Claude Code 内部调用：模型调用走桌面客户端内置的 Claude Code 链路，与终端 claude 命令分别独立配置。令牌分组使用 cc_max。

前置条件

• 桌面客户端已升级到支持 Developer Mode 的版本
• 已有 cc_max 分组的 API Key
• 反代用户：直接使用反代域名即可，不要带 /v1 等后缀

配置步骤

1. 下载并安装桌面客户端

从官方下载页获取对应平台安装包：

https://claude.com/download

2. 启用 Developer Mode

1. 启动客户端并完成登录
2. 点击左上角菜单 → Settings
3. 进入 Help → Troubleshooting
4. 勾选 Enable Developer Mode
5. 按提示重启软件

重启后，左上角菜单会新增 Developer 项。点击 Developer → Configure third-party inference 进入配置页面：

3. 填入 Base URL 与密钥

字段	填写内容
Gateway base URL	https://www.vmvia.com
Gateway API key	sk-xxx
Gateway auth scheme	bearer

地址必须是 HTTPS 域名，不接受 IP、端口或 HTTP 协议；不要带 /v1。

4. 应用并重启

1. 点击页面下方 Apply locally
2. 按提示重启客户端
3. 重新进入后在模型选择处选用对应模型即可开始对话

退出第三方推理

如需切回官方渠道，进入 Developer → Configure third-party inference，点击退出/移除按钮即可恢复默认配置。

常见问题

填入地址后提示无效？

确认满足以下条件：

• 协议为 https://
• 是域名而非 IP
• 不带 /v1、/api 等额外路径后缀

应用后模型列表为空？

1. 检查 API Key 是否有效、有余额
2. 确认令牌分组是 cc_max，且关闭了「模型限制」
3. 退出账号重新登录后再试

与 CC Switch / 终端 Claude Code 冲突吗？

不会。桌面客户端的第三方推理配置仅作用于桌面客户端本身，与终端 claude 命令使用的 ~/.claude/settings.json 互不影响。