跳到主要内容

Claude Code 桌面版接入第三方 API

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

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


前置条件

  • 桌面客户端已升级到支持 Developer Mode 的版本
  • 已有可用的中转 API 地址(HTTPS)和 API Key
  • CPA 反代用户:直接使用反代域名即可,不要带/v1等后缀

配置步骤

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

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

https://claude.com/download

2. 启用 Developer Mode

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

重启后,左上角菜单会新增Developer项。点击DeveloperConfigure third-party inference进入配置页面:

进入开发者模式

3. 填入 API 地址与密钥

字段填写内容
API 地址中转或反代的 HTTPS 域名
API Keysk-xxx

使用本站时:API 地址直接填写https://duoapi.zeabur.app,Claude 桌面版使用default分组(具体分组与模型对应见CC Switch 统一配置)。

地址必须是 HTTPS 域名,不接受 IP、端口或 HTTP 协议。

配置 URL 和 API Key

4. 应用并重启

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

进行聊天


接入第三方模型

桌面版的第三方推理入口调用链路统一通过本站中转。当前令牌分组只有defaultcodex0.3两个;Claude 桌面版日常使用选择default

1. 在配置页填入分组与模型

  • API 地址:https://duoapi.zeabur.app
  • API Key:对应default分组的sk-xxx
  • 模型名:填写可用 Claude 模型名,或按客户端模型列表选择

第三方模型接入

2. Apply locally 后重启

重启客户端后,在模型选择处会出现刚才填入的 GPT 模型,选中即可开始对话。客户端界面仍是 Claude 桌面版,但底层模型已换成 GPT:

第三方模型对话展示

分组与可用模型名的完整对应关系见CC Switch 统一配置


退出第三方推理

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

退出第三方


常见问题

填入地址后提示无效?

确认满足以下条件:

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

应用后模型列表为空?

  1. 检查 API Key 是否有效、有余额
  2. 确认填写的模型名与所用分组匹配
  3. 退出账号重新登录后再试

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

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