登录选套餐
博客 · 接入指南

如何在 Claude Desktop 使用第三方 API:配置 Gateway

不登录 claude.ai,在 Developer 菜单里把推理切到 Gateway,Chat、Cowork 和 Code 按 CodingPass 的套餐额度计量。配置三步。

只想看三步速查,见 Claude Desktop 接入指南。这篇从客户端本身讲起,再走一遍配置。

客户端介绍

Claude Desktop 是 Anthropic 官方的桌面应用,macOS 和 Windows 都有。窗口里有三个标签页:

  • Chat:对话,生成的网页和小工具直接在 Artifacts 里渲染
  • Cowork:读你指定的工作目录,写文档、整理文件、做调研
  • Code:带图形界面的 Claude Code,能读项目代码、改文件、跑命令

Claude Code 另有终端版和 IDE 插件,配置各自独立,这篇只管桌面端。

默认情况下,Claude Desktop 要登录 claude.ai,推理和计费都走 Anthropic 的个人订阅。打开开发者模式(Developer Mode)以后,Developer → Configure Third-Party Inference 里可以把推理交给一个网关(Gateway),不用登录 claude.ai。

官方对网关的要求是实现 Anthropic Messages API:POST /v1/messages 必须支持流式和工具调用,GET /v1/models 可选,实现了就自动列出模型。这个入口今年 4 月起陆续出现在中文教程里,官方文档把这种用法叫 Claude Desktop on 3P。

接上 CodingPass,模型选择器里只出现 Claude 模型:

模型最低档位
Claude Sonnet 5.5Go
Claude Haiku 5.5Go
Claude Opus 5.5Plus
Claude Fable 5.1Pro
Claude Fable 5.2Pro

操作实战

准备

从 claude.com/download 装好 Claude Desktop。再到 CodingPass 控制台的 Key 页建一个 Key,工具选 Claude Desktop,Key 以 cp-live- 开头。

第一次启动会弹出登录页,不用登录,直接去开开发者模式。

第一步:打开 Developer Mode

  • macOS:顶部菜单栏 Help → Troubleshooting → Enable Developer Mode…。
  • Windows:左上角 ☰ → Help → Troubleshooting → Enable Developer Mode…。
Claude Desktop 的 Help 菜单展开到 Troubleshooting 子菜单,其中有 Enable Developer Mode… 一项
Developer Mode 的开关在 Help → Troubleshooting 里。

弹窗里点 Enable 确认。应用不会重启,菜单栏直接多出一个 Developer 菜单。

第二步:填 Gateway 表单

打开 Developer → Configure Third-Party Inference…,左栏选 Connection。顶部的下拉框默认就是 Gateway,不用改。下面按顺序填:

  • Credential kind:先选 Static API key。选了它,下面的 API key 和 auth scheme 两个字段才会出现。
  • Gateway base URL:https://codingpass.ai,不带 /v1,结尾不加 /
  • Gateway API key:整段粘贴 cp-live-…,框里会显示成圆点
  • Gateway auth scheme:保持默认的 bearer

其余字段留空。

Configure third-party inference 窗口的 Connection 页:下拉框选 Gateway,Credential kind 为 Static API key,Gateway base URL 为 https://codingpass.ai,API key 显示为圆点,auth scheme 为 bearer;右上角是 Test connection,右下角是 Apply Changes
填好的 Gateway 表单。

表单右上角有 Test connection,可以先测一下连接。右下角的 Apply Changes 保存后会提示重启。改了还没保存时,旁边还会出现 Discard Changes(放弃改动)和 Save Changes(只保存)。

第三步:Apply Changes,重启

配置只在启动时读取。点 Apply Changes,弹出 Relaunch Claude? 时选 Relaunch now,应用会自己重启。

也可以先 Save Changes,再完全退出、重新打开:macOS 按 Cmd + Q,Windows 从系统托盘退出。只关窗口不算。

重启后不会再出现启动页,直接进主界面,左下角显示“用户名 · Gateway”,说明推理已经走 Gateway,不用登录 claude.ai。

发一条消息试试

点输入框右下角的模型选择器,能看到 Sonnet 5.5(默认选中)、Opus 5.5、Fable 5.2、Haiku 5.5、Fable 5.1,底部是 Effort,就说明配好了。

Claude Desktop 主界面:模型选择器展开,列出 Sonnet 5.5(已勾选)、Opus 5.5、Fable 5.2、Haiku 5.5、Fable 5.1 和 Effort;上方是 Say hi in five words 的提问和回复,左下角显示 coco · Gateway
重启后的模型选择器,左下角标着 Gateway。

用 Sonnet 5.5 发一句“Say hi in five words”,回复正常就跑通了。选择器里只有 Claude 模型,GPT、DeepSeek 等不会出现。

出发

Claude Desktop 照用,账单按月固定。

打开 Gateway 模式,填一个 Key,Sonnet 5.5 每月 起。不用登录 claude.ai,随时取消。

  • 每个响应都带请求 ID
  • 用量不超过 5% 可全额退款
  • 不会意外扣费
选 GoClaude Desktop 指南

每月 $10,直到你取消。