---
title: "Claude Desktop Gateway 模式与 API Key 配置"
description: "Claude Desktop 编程套餐 $10/月起：开启 Developer Mode 并配置第三方推理 Gateway 模式，跑 Sonnet 5.5、Opus 5.5 和 Fable 5.2，MCP、Artifacts 与提示缓存照常可用。"
url: https://codingpass.ai/zh/tools/claude-desktop
language: zh-CN
updated: 2026-11-18
---
# Claude Desktop Gateway 模式接入。

开启 Developer Mode，把第三方推理切到 Gateway 模式，就能在 Claude Desktop 里按固定月费跑 Claude Sonnet 5.5、Opus 5.5 或 Fable 5.2，无需 claude.ai 登录，也不会意外扣费。

- 60 秒接入
- 不会意外扣费
- 用量不超过 5% 可全额退款

Developer → Configure Third-Party Inference

```
Inference provider   Gateway
Gateway base URL     https://codingpass.ai
Gateway API key      cp-live-…
Gateway auth scheme  Bearer
```

你套餐对应的模型 ID

**Go**

claude-sonnet-5-5

**Plus**

claude-opus-5-5

**Pro**

claude-fable-5-2

## Anthropic 官方桌面端，走你的网关。

对话、Artifacts、Projects 和本地 MCP 服务器，全部通过 Claude Desktop 内置的 Gateway 模式运行。

### 原生内置 Gateway 模式

打开 Developer Mode 后，Claude Desktop 可以直接把 Inference provider 设为 Gateway。不用跑本地代理脚本，不用改客户端，也不依赖个人 Claude Pro 或 Max 账号。

### 对话、Artifacts 与 Code 同窗口

保留 Claude Desktop 的原生界面：实时 Artifacts、文件上传、Projects 和 Code 标签页，底层按你的 CodingPass 套餐跑 Sonnet 5.5、Opus 5.5 或 Fable 5.2。

### 本地 MCP 服务器照常可用

`claude_desktop_config.json` 里配置的本地文件系统、Git、数据库等 MCP 服务器，切到 Gateway 模式后依然正常调用。

### 扩展思考与提示缓存

Claude Desktop 通过原生 Anthropic Messages API 接入 CodingPass，扩展思考、图片识别和提示缓存全部开箱即用。

## Claude Desktop 选哪一档？

每一档都能用于 Claude Desktop 的 Gateway 模式。按你想用的 Claude 旗舰模型来选，高档位包含低档位的全部模型。

- [完整套餐详情](https://codingpass.ai/zh/pricing#compare-plans)
- [全部 27 个模型的额度](https://codingpass.ai/zh/models)

### Go: Claude Sonnet 5.5

适合 日常对话、写作、编码与 MCP 工作流

$10/月

每月 $60 额度

**每月请求次数**

≈2,050

**每个 5 小时窗口**

≈342次

**模型 ID**

claude-sonnet-5-5

### Plus: Claude Opus 5.5

适合 大型代码库、复杂 Artifacts、Opus 5.5

$30/月

每月 $200 额度

**每月请求次数**

≈3,420

**每个 5 小时窗口**

≈570次

**模型 ID**

claude-opus-5-5

### Pro: Claude Fable 5.2

适合 高频重度使用与最难的推理任务

$100/月

每月 $500 额度

**每月请求次数**

≈5,090

**每个 5 小时窗口**

≈848次

**模型 ID**

claude-fable-5-2

按 CodingPass 实际流量估算：每次请求约 10 万 token，其中约 5% 输入、1% 输出、94% 缓存读取。带 MCP 工具的长桌面会话会发多次请求。额度按官方 API 价计量。

## 三步，大约一分钟。

打开一次 Developer Mode，把第三方推理设为 Gateway 模式，重启 Claude Desktop 即可。

1. ### 创建 Key
   用 Google、GitHub 或邮箱登录，选一个套餐。然后进入控制台，依次点 Keys → New key。Key 以 `cp-live-` 开头。
2. ### 开启 Developer Mode
   打开 Claude Desktop，在 Help → Troubleshooting 里打开 Developer Mode；如有提示，按提示重启应用。
   `Help → Troubleshooting → Enable Developer Mode`
3. ### 配置 Gateway 模式
   打开 Developer → Configure Third-Party Inference。Inference provider 选 `Gateway`，Gateway base URL 填 `https://codingpass.ai`（不要加 `/v1`），填入 `cp-live-…` API Key，Gateway auth scheme 选 `Bearer`。点击 Apply Changes。
   `Developer → Configure Third-Party Inference`
4. ### 完全退出并重新打开 Claude Desktop
   完全退出 Claude Desktop（macOS 上只关窗口不会退出进程），再重新打开。套餐里的 Claude 模型会出现在模型选择器里。也可以在 CodingPass 控制台 Keys 页用 [CC Switch](https://codingpass.ai/zh/tools/cc-switch) 一键导入。
   `Cmd+Q / 退出 → 重新打开`

Gateway · CodingPass 示例会话 Claude Desktop

```
> 通过 MCP 读取 Postgres 表结构，给 user_sessions 写一份迁移脚本。

● MCP postgres.list_tables (14 tables)
● Thinking 检查外键约束与索引覆盖…
● Artifact 0014_user_sessions.sql · Ready
  已补充 (user_id, expires_at) 复合索引和兼容历史数据的默认值。
```

Sonnet 5.5

$1.90 / $60.00 11 天后重置

## 把每份额度用足。

一份月额度覆盖所有模型，另有 5 小时和每周上限。按任务选对模型，额度能用得更久。

### 在模型选择器里按需切换模型

Gateway 模式下，Claude Desktop 会读取 `/v1/models`，列出你套餐里包含的所有 `claude-*` 模型。简单改写和总结用 **Haiku 5.5**，日常编码和写作选 **Sonnet 5.5**，复杂推理切到 **Opus 5.5**（Plus）或 **Fable 5.2**（Pro）。

```
claude-haiku-5-5    # 响应快，单次消耗最低
claude-sonnet-5-5   # 日常编码与写作
claude-opus-5-5     # 深度推理，Plus 起可用
```

### 用 CC Switch 一键导入和切换

如果你同时用 Claude Code，或者想在 CodingPass 和个人 Claude 账号之间切换，可以在 CodingPass 控制台 Keys 页点 **导入到 CC Switch**。CC Switch 会替你写好 Claude Desktop 的 Gateway 配置，之后一键即可切换。

```
控制台 → Keys → Claude Desktop → 导入到 CC Switch
```

## Claude Desktop，大家常问这些。

**会违反厂商条款吗？会不会被封号？**

你只用 CodingPass 的 Key。不用登录、共享或转发任何人的账号，你自己的 Claude 或 ChatGPT 账号也不牵涉其中。请求需遵守各厂商的使用政策。

**什么是 Claude Desktop 的 Gateway 模式？为什么要开它？**

Gateway 模式（`Developer → Configure Third-Party Inference → Gateway`）是 Claude Desktop 官方内置的第三方推理入口，用来把模型请求转发到你自己的 Anthropic 兼容网关，而不用走个人 `claude.ai` 订阅或 Bedrock / Vertex。把 Gateway 指向 `https://codingpass.ai` 并用 `Bearer` Key 鉴权后，所有用量都在 CodingPass 固定月费内计量，不用担心个人号受限或按量账单暴涨。

**点完 Apply Changes 后，模型列表里还是没有模型怎么办？**

先确认你已经**完全退出并重新打开** Claude Desktop（macOS 要按 `Cmd+Q` 退出，Windows 从托盘完全退出，只关窗口不会重载 Gateway 配置）。其次检查 **Gateway base URL** 是否填成了 `https://codingpass.ai`（末尾不要带 `/v1`），以及 **Gateway auth scheme** 是否选了 `Bearer`。

**Gateway base URL 末尾要加 /v1 吗？**

不要加。直接填 `https://codingpass.ai`。Claude Desktop 会自己在后面拼接 `/v1/models` 和 `/v1/messages`，如果多填了 `/v1`，请求会发到 `/v1/v1/messages` 并报错。

**为什么模型列表里只有 Claude 模型，看不到 GPT、DeepSeek 或 Kimi？**

Claude Desktop 在 Gateway 模式下会向 `/v1/models` 拉取列表，但客户端自身只识别并展示 `claude-*` 开头的模型 ID。所以选择器里只会出现你套餐中包含的 Claude 模型。想用同一份额度和 Key 跑 GPT-6.1、DeepSeek 或 GLM，可以接入 [OpenCode](https://codingpass.ai/zh/tools/opencode)、[ZCode](https://codingpass.ai/zh/tools/zcode) 或 [Codex](https://codingpass.ai/zh/tools/codex)。

**MCP 服务器、Artifacts、扩展思考和提示缓存还能用吗？**

都能用。`claude_desktop_config.json` 里的本地 MCP 服务器、Artifacts、文件附件、扩展思考和提示缓存都通过 Gateway 正常工作。缓存读取按官方缓存读取价计量，多轮长对话的额度消耗很低。

**还能切回原来的 Claude Pro 或 Max 账号吗？**

可以。打开 `Developer → Configure Third-Party Inference`，把 Inference provider 切回默认选项（或清空 Gateway 配置）并重启 Claude Desktop，就能恢复原来的 `claude.ai` 登录。也可以用 [CC Switch](https://codingpass.ai/zh/tools/cc-switch) 一键切换。

**用到 5 小时上限会怎样？**

每个 5 小时窗口最多用月额度的 1/6（Go 上是 $10 的 Sonnet 5.5，约 342 次请求）。这道上限按所有模型合计，所以用到后 CodingPass 对所有模型都返回 429 和重置时间。可以等它重置、为当前窗口买重置卡，或升级套餐。[上限与 429 的规则](https://codingpass.ai/zh/usage-limits#response)。

## 同一个 Key，所有 Agent 通用。
