EADST

日常使用 AI 编程工具时，我更倾向于通过统一的 API 网关管理模型和额度，再用 CC Switch 切换不同渠道。这样既能保留桌面客户端的项目管理和代码审阅体验，也方便按任务选择模型。

本文以 One API 类网关为例，介绍 Claude 和 Claude 桌面版的接入流程。客户端运行在本机，模型推理仍由网关背后的服务完成。

安装与准备

先安装两个桌面客户端：

• Claude 桌面版：编程任务使用应用中的 Code 标签页。
• Codex 桌面版：从官方页面获取适合当前系统的客户端。
• CC Switch：管理供应商、密钥和模型配置。

macOS 也可以通过 Homebrew 安装 CC Switch：

brew install --cask cc-switch

已安装的用户可以执行更新：

brew upgrade --cask cc-switch

接下来，从自己的 API 平台获取 接口地址、API Key 和实际模型 ID。本文统一使用占位符；填写时以平台的接入文档为准，尤其要区分模型展示名称和请求中使用的模型 ID。

配置 Claude 桌面版

打开 CC Switch，在应用列表中选择 Claude Desktop，点击“添加供应商”，选择自定义配置。如果没有这个入口，可以到“设置 → 通用 → 应用可见性”中检查。

这里应使用 Claude Desktop 面板。它管理桌面应用的第三方配置，不能直接用 Claude Code CLI 的 ANTHROPIC_* 配置片段代替。CC Switch 桌面版说明

填写供应商信息，例如：

供应商名称：My API - Claude
接口地址：https://api.example.com
API Key：YOUR_API_KEY

接入方式取决于网关能力：

• 直连模式：上游提供 Anthropic Messages API，模型 ID 能被桌面版识别。
• 模型映射模式：上游使用自定义模型别名，或需要转换接口格式。在供应商配置中开启“需要模型映射”。

使用映射模式时，将模型角色对应到网关接受的实际模型：

模型角色：Sonnet
菜单显示名：日常编程模型
实际请求模型：YOUR_MODEL_ID

这里的菜单显示名可以自行设置，实际请求模型必须准确。映射模式还需要开启 Claude Desktop 本地路由，使用期间保持 CC Switch 运行。保存供应商后点击“启用”，完全退出并重新打开 Claude，让配置生效。模型映射与路由说明

进入 Claude 的 Code 标签页，选择 Local 环境和项目目录，即可开始验证本地编程会话。这套本地配置不能直接视为云端会话的配置。Claude Code 桌面版说明

配置 Codex 桌面版

在 CC Switch 中切换到 Codex，添加自定义供应商，例如 My API - Codex。在配置编辑器中分别填写认证 JSON 和 TOML 配置。

认证 JSON：

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

TOML 配置：

model_provider = "my_api"
model = "YOUR_CODEX_MODEL_ID"

[model_providers.my_api]
name = "My API"
base_url = "https://api.example.com/v1"
wire_api = "responses"
requires_openai_auth = true

这套示例采用 CC Switch 文档中的 API Key 认证方式。model_provider 必须与供应商表名对应，base_url 指向自己的网关；requires_openai_auth 表示所用认证方式，不会把请求地址改回官方 API。CC Switch 配置格式

示例要求上游支持 Responses API。如果平台只提供 Chat Completions，需要使用 CC Switch 支持的本地路由和协议转换配置，不能直接照搬。Codex 的自定义供应商也可以通过用户级配置管理，相关字段见 Codex 配置文档。

保存并启用后，完全退出并重新打开 Codex 桌面应用，选择本地项目，新建会话进行测试。

验证与排查

我通常先发送一个简单请求，再让模型读取项目 README，最后尝试一个小范围代码修改。这样可以分别确认文本生成、文件读取和工具调用是否正常。仅看到客户端启动界面，还不能说明 API 已接通。

• 401/403：检查令牌、认证方式及目标模型权限。
• 404：检查接口协议和路径，尤其是重复的 /v1。
• 模型不存在：核对实际模型 ID，不要把菜单显示名当作请求模型。
• 切换后未生效：完全重启客户端，检查是否存在旧环境变量或其他配置覆盖。
• 映射模式连接失败：确认 CC Switch 和对应应用的本地路由仍在运行。
• 能聊天但不能执行任务：检查上游对工具调用、流式响应和相关参数的兼容性。

日常可以按渠道或用途建立多套 Provider，例如“日常编程”“复杂任务”“备用渠道”。每次切换后做一次简单验证，也更容易确认当前请求走的是哪个网关、使用的是哪一份额度。