Claude Code 接入教程
本页使用 Claude Code 客户端 + CC Switch 本地路由 + Noah 的 GPT 模型。
2026 年 10 月 8 日，Noah 公开模型广场提供 GPT 模型，Anthropic 接口数量为 0。因此当前不能只填一个 ANTHROPIC_BASE_URL 就当作 Claude 原生服务使用。
请求经过以下路径：
Claude Code → 本机 CC Switch 路由（Messages → Responses）→ Noah API → 所选 GPT 模型
客户端仍然是 Claude Code，实际使用的是 GPT；Sonnet、Opus、Haiku 在这套配置中是客户端模型档位，经映射后发送给实际模型。
1. 安装 Claude Code
Section titled “1. 安装 Claude Code”Windows PowerShell，可选择官方原生安装：
irm https://claude.ai/install.ps1 | iex或使用 WinGet，二选一即可：
winget install Anthropic.ClaudeCodemacOS / Linux / WSL：
curl -fsSL https://claude.ai/install.sh | bash安装后新开终端，检查：
claude --versionclaude doctor原生安装不依赖 Node.js。完整平台要求和安装问题参见 Claude Code 官方安装文档。
2. 安装 CC Switch
Section titled “2. 安装 CC Switch”从 CC Switch 官方 Releases 下载与你的系统和架构匹配的安装包。Windows 可选 MSI，macOS 可选 DMG，Linux 可选相应发行版安装包或 AppImage。
以下按 CC Switch 4.0.x 界面说明。旧版本按钮位置可能不同，建议更新后再操作。
3. 添加 Noah 供应商
Section titled “3. 添加 Noah 供应商”- 在 CC Switch 左侧栏选择 Claude Code。
- 点击「添加供应商」，选择「自定义配置」。
- 填写下表，并在高级选项里选择上游格式和模型映射。
| 配置项 | 值 |
|---|---|
| 名称 | Noah API |
| API Key | 控制台创建的 Noah 令牌密钥 |
| 请求地址 / Base URL | https://ai.11451418.xyz |
| 完整 URL | 关闭，使用默认前缀模式 |
| 认证字段 | ANTHROPIC_AUTH_TOKEN |
| 上游格式 | OpenAI Responses API（需开启路由） |
| 默认 / 回退模型 | gpt-6.1-sol |
| Sonnet 模型映射 | gpt-6.1-sol |
| Opus 模型映射 | gpt-6.1-sol |
| Haiku 模型映射 | gpt-6.1-sol |
先把三个档位映射到同一个已确认可用的模型，便于验证。默认 / 回退模型也要填，避免未命中档位时回退到 Noah 不存在的 Claude 模型。
地址不带 /v1，因为转换路由会追加 /v1/responses。保存后应看到供应商需要路由的提示。
不要仅凭模型名称开启 1M 上下文等额外选项；上下文长度和工具能力应以该分组实际支持为准。
4. 启动路由并选中供应商
Section titled “4. 启动路由并选中供应商”- 在 Claude Code 页面选择 路由 标签。
- 点击 开始路由，完成本地路由启动及 Claude 配置接管。
- 在 Noah 供应商卡片上点击 路由到此，确认请求会发送到 Noah。
- 保持 CC Switch 和本地路由运行，退出旧的 Claude Code 会话后重新启动。
路由默认监听 127.0.0.1:15721，可在设置中更改。CC Switch 会把 Claude 的实时配置指向本机路由，并使用路由需要的占位凭据；真实 Noah Key 保存在 CC Switch 供应商配置中。
使用此模式时，不需要再把真实 Noah Key 手动写进 Claude 的环境变量或 settings.json。
5. 启动并验证
Section titled “5. 启动并验证”在你的项目目录运行：
claude输入 /status，检查当前 API 地址和凭据来源。路由模式下，地址应指向本机路由，这属于正常情况。
发送一个简短问题，并同时检查：
- CC Switch 路由日志是否选中了 Noah、实际模型是否为
gpt-6.1-sol； - Noah 控制台是否出现对应令牌的请求记录；
- Noah 日志中的分组和扣费是否符合预期。
仅看到 Claude Code 的 Sonnet / Opus 标签不能证明实际调用了 Claude，要以路由和 Noah 请求记录中的实际模型为准。
后续切换模型
Section titled “后续切换模型”编辑 Noah 供应商的模型映射，填写该令牌分组可用的 Responses 模型。修改后重新打开会话并再次核对日志。
例如，只有确认令牌能使用 gpt-6-luna 时，才可将 Haiku 档位映射到它；本次公开目录中该模型仅显示在 self-pro 分组。不要照抄其他中转站的 Claude 模型名或分组名。
| 现象 | 检查方式 |
|---|---|
无法连接 127.0.0.1 | CC Switch 路由是否运行，端口是否与接管配置一致 |
| 仍访问 Anthropic 官方或其他中转 | 检查 /status 的地址、凭据来源、旧会话和环境变量冲突 |
404 或路径重复 | Noah 供应商地址应是根地址，完整 URL 开关关闭 |
找不到 claude-... 模型 | 默认回退模型和三个档位是否全部映射到 Noah 实际模型 |
401 / 403 | Noah Key、余额、令牌额度和分组，真实 Key 应保存在供应商配置 |
| 简单问答正常，工具调用失败 | 检查路由转换日志与上游错误；协议转换并不保证所有 Claude 功能都有相同表现 |
这是一套第三方转换方案。Claude Code 官方不对通过网关使用非 Claude 模型提供支持，各项功能仍取决于 CC Switch 适配与上游能力。
如果以后开放 Claude 原生接口
Section titled “如果以后开放 Claude 原生接口”只有模型广场和令牌分组实际提供 Anthropic Messages 接口时，才能另建原生供应商：上游格式选择 Anthropic Messages（原生），填服务根地址、Noah Key 和真实 Claude 模型 ID。无需这一步协议转换。