Claude Code 使用教程

Claude Code 发出的是 Anthropic Messages 请求，不能把普通 OpenAI 兼容配置直接照搬。本教程只说明分组与协议要求；DuckMans 后台未明确支持的路线，不应配置成可用。

1. 先选择明确支持的路线

路线	Key 分组要求	协议	CCSwitch 中的地址	本地代理
原生 Claude 路线	后台明确支持 Claude/Anthropic 的分组	Anthropic Messages	`https://duckmans.com`	协议本身不要求转换
OpenAI 兼容模型路线	后台明确支持目标模型的分组	由 CCSwitch 转换为 OpenAI Responses	`https://duckmans.com`	必须开启对应的协议转换路由

Claude Code 原生 Anthropic Messages 与 OpenAI Responses 转换路线决策图

协议路线图：原生路线最终请求 /v1/messages；OpenAI Responses 路线只有在后台与当前 CCSwitch 都明确支持时才启用本地转换。

不要混用分组

创建 Key 时选择的分组必须与路线一致。若 DuckMans 后台没有明确标注某分组支持 Anthropic Messages 或 CCSwitch 转换，请不要假设它可用。

2. 安装 Claude Code 和 CCSwitch

按 Claude Code 官方文档安装 Claude Code，并运行 claude --version。再从 CCSwitch Releases 安装当前系统适用版本。

3. 配置原生 Claude 路线

仅当 Key 分组明确支持 Claude/Anthropic 时，在 CCSwitch 的 Claude Code 应用中添加自定义供应商。

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

CC Switch 3.17.0 Claude Code 自定义供应商模型映射 — 填写 `https://duckmans.com` 和后台当前可用模型 ID，选择 **Anthropic Messages**，并关闭完整 URL 模式。

Claude Code 会按 Anthropic Messages 协议拼接标准路径，最终请求地址是 https://duckmans.com/v1/messages。不要在 Base URL 手动追加 /v1。

保存后在 CCSwitch 首页切换到刚添加的供应商。启动 Claude Code 前再次确认当前供应商、Base URL 和模型映射；仅添加而未启用不会切换现有配置。

需要手动核对时，将下面字段合并到用户级 ~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json），不要覆盖其他设置：

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://duckmans.com",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID"
  }
}

不同角色只有在后台明确存在对应模型时才分别填写；保存后确认 JSON 逗号和花括号完整。

4. OpenAI 兼容模型路线的额外要求

只有在 DuckMans 后台明确支持目标模型、当前 CCSwitch 明确提供 Claude Code 到 OpenAI Responses 的转换时才使用：API 格式选 OpenAI Responses，Base URL 填 https://duckmans.com，完整 URL 模式关闭，并开启 CCSwitch 本地代理及 Claude 路由。使用期间保持 CCSwitch 运行。

只填写 OpenAI 地址和 Key 不能让 Claude Code 自动理解 OpenAI 协议，必须由 CCSwitch 完成请求与响应转换。

5. 启动和测试

切换到正确供应商后，在测试项目目录运行 claude，发送：

text

请只读取当前目录并列出主要文件，不要修改。

2026 年 7 月 14 日已使用一次性 DuckMans API Key 请求 https://duckmans.com/v1/messages，返回 HTTP 200 和 Anthropic Messages 响应结构；测试完成后临时凭据已删除。

DuckMans Anthropic Messages HTTP 200 响应结构示意

收到 HTTP 200 且响应包含 Messages 内容结构后，说明这条路线已经连通。

常见问题

401：检查 Key 是否完整，以及是否仍被旧环境变量覆盖。
403：重点核对 Key 分组与协议是否匹配。
404：Base URL 应为 https://duckmans.com，不要重复添加 /v1 或完整接口路径。
模型不存在：使用该 Key 分组后台当前可用模型 ID。
Connection refused：协议转换路线下，确认 CCSwitch、代理和 Claude 路由都在运行。
界面显示 Opus、Sonnet 或 Haiku：这些可能是角色名；实际模型以完整模型 ID 和请求记录为准。

Claude Code 使用教程 ​

1. 先选择明确支持的路线 ​

2. 安装 Claude Code 和 CCSwitch ​

3. 配置原生 Claude 路线 ​

4. OpenAI 兼容模型路线的额外要求 ​

5. 启动和测试 ​