---
title: "如何在 Claude Desktop 使用第三方 API：配置 Gateway"
description: "Claude Desktop 的 Gateway（第三方推理）模式接 CodingPass：客户端能做什么，以及三步配置。"
url: https://codingpass.ai/zh/blog/how-to-use-third-party-api-in-claude-desktop-gateway
language: zh-CN
updated: 2026-11-19
---
# 如何在 Claude Desktop 使用第三方 API：配置 Gateway

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

[CodingPass 团队](https://codingpass.ai/zh/about) 发布于 2026年11月19日 更新于 2026年11月19日 阅读约 10 分钟

只想看三步速查，见 [Claude Desktop 接入指南](https://codingpass.ai/zh/tools/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.5 | Go |
| Claude Haiku 5.5 | Go |
| Claude Opus 5.5 | Plus |
| Claude Fable 5.1 | Pro |
| Claude Fable 5.2 | Pro |

## 操作实战

### 准备

从 [claude.com/download](https://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… 一项](https://codingpass.ai/assets/img/tools/claude-desktop/dev-mode-menu.webp)

*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](https://codingpass.ai/assets/img/tools/claude-desktop/gateway-form.webp)

*填好的 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](https://codingpass.ai/assets/img/tools/claude-desktop/model-picker.webp)

*重启后的模型选择器，左下角标着 Gateway。*

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

作者 CodingPass 团队

CodingPass 由我们运营。每篇指南发布前，都会在对应工具的最新稳定版上实测一遍。发现内容过时了？写信到 [support@codingpass.ai](mailto:support@codingpass.ai)。

## 相关阅读。

指南

### [Claude Desktop 接入指南](https://codingpass.ai/zh/tools/claude-desktop)

三步配好 Gateway 模式，各档位能用的 Claude 模型。

指南

### [CC Switch 接入指南](https://codingpass.ai/zh/tools/cc-switch)

从 Key 页一键导入，在 CodingPass 和官方登录之间切换。

规则

### [额度和上限怎么算](https://codingpass.ai/zh/usage-limits)

每个套餐、每个模型的额度和上限，以及 429 响应。
