CCSwitch 手动配置教程

CCSwitch 适合在多套 AI 编程工具或多个 API 配置之间切换。本教程只介绍手动添加 DuckMans，不依赖“一键导入”。

1. 先确认要配置的工具

不同工具使用的协议和地址不同，不能混填：

使用场景	协议	地址
Codex CLI、Codex 桌面端、Codex IDE 插件	OpenAI Responses	https://duckmans.com/v1
Claude Code 原生 Claude 路线	Anthropic Messages	https://duckmans.com
Claude Code 调用 OpenAI 兼容模型	CCSwitch 协议转换	https://duckmans.com，并开启对应的本地代理路由

先核对分组和协议

Claude Code 使用哪条路线，必须以 DuckMans 后台对当前 Key 所属分组的说明为准。不要把 OpenAI 兼容分组的 Key 当作 Anthropic Key，也不要假设所有分组都支持协议转换。

2. 安装 CCSwitch

从 CCSwitch 官网 或 GitHub Releases 下载当前系统对应的版本并安装。

安装后先正常打开一次。macOS 如果阻止首次启动，可在“系统设置 → 隐私与安全性”中确认该应用；Windows 便携版应解压到固定目录后再运行。

3. 准备 DuckMans 信息

1. 在 DuckMans 后台创建一个专用 API Key，参见创建 API Key。
2. 记录该 Key 所属分组明确支持的协议。
3. 从后台复制当前可用的完整模型 ID。

示例中的密钥统一写作：

YOUR_API_KEY

4. 手动添加 Codex 供应商（CC Switch 3.17.0）

在 CC Switch 中切换到 Codex，点击右上角 +，选择 自定义配置。3.17.0 的实际字段如下：

字段	内容
供应商名称	DuckMans Codex
备注	OpenAI Responses（可选）
官网链接	https://docs.duckmans.com（可选）
API Key	YOUR_API_KEY
API 请求地址	https://duckmans.com/v1
完整 URL	关闭
上游格式	Responses（原生）

填写自己的 API Key 和 `https://duckmans.com/v1`，关闭完整 URL，并选择 **Responses（原生）**。

保存后，供应商会出现在 Codex 列表中。点击 启用 才会把它设为当前供应商；仅保存不会切换现有配置。

点击 **启用** 切换到 DuckMans 供应商，然后完全退出并重新打开 Codex。

保存并启用后，完全退出正在运行的 Codex CLI、桌面应用或编辑器，再重新打开。Codex 各入口共用用户目录中的 .codex 配置，详见 Codex CLI 教程。

5. 手动添加 Claude Code 供应商

在 CCSwitch 中切换到 Claude Code / Claude 应用，先根据 Key 的分组选择路线。

路线 A：Anthropic Messages

只有 DuckMans 后台明确标注该 Key 分组支持 Anthropic/Claude 兼容调用时，才这样配置：

字段	内容
供应商名称	DuckMans Claude
API Key	YOUR_API_KEY
Base URL	https://duckmans.com
API 格式	Anthropic Messages
完整 URL 模式	关闭
模型	该分组后台当前可用的完整模型 ID

这里不在地址末尾添加 /v1，由 Claude Code 按 Anthropic 协议请求标准路径。

路线 B：CCSwitch 协议转换

只有 DuckMans 后台明确标注该 Key 分组支持目标 OpenAI 兼容模型，并且当前 CCSwitch 版本支持把 Claude Code 请求转换为 OpenAI Responses 时，才使用此路线：

字段	内容
Base URL	https://duckmans.com
API 格式	OpenAI Responses
完整 URL 模式	关闭
模型	该分组后台当前可用的完整模型 ID

保存后还需在 CCSwitch 中开启本地代理和 Claude 路由，并在使用期间保持 CCSwitch 运行。只填写地址和 Key 不能完成协议转换。

6. 最小测试

• Codex：打开测试目录后输入“只读取当前目录并概括文件，不要修改”。
• Claude Code：在测试目录运行 claude，输入“只读取当前目录并概括文件，不要修改”。

常见问题

• 401：重新复制完整 API Key，检查前后空格和 Key 所属分组。
• 403：通常是分组或协议不匹配，回后台核对当前 Key 的权限。
• 404：Codex 使用 https://duckmans.com/v1；Claude Code 的 CCSwitch 供应商前缀使用 https://duckmans.com。
• 模型不存在：不要照抄教程中的示例名称，填写后台当前可用的完整模型 ID。
• 修改未生效：完全退出目标应用后重开；代理转换路线还要确认 CCSwitch 和路由仍在运行。

恢复原配置

如果新供应商不可用，回到 Codex 供应商列表，重新点击原供应商的 启用，再完全退出并重启 Codex。不要在未确认可用前删除原供应商。