接入 CC Switch

使用 CC Switch 在多套 Claude Code 配置间切换，将 PilotAIHub 作为其中一个 profile。

简介

CC Switch 是 Claude Code 的配置切换工具，用于在多套 API 端点（如官方、PilotAIHub、自建网关）间一键切换，而无需反复修改环境变量。将 PilotAIHub 配置为一个 profile，即可在保留官方账号的同时，按需切换到 PilotAIHub 进行治理化调用。

前置条件

已注册 PilotAIHub 账号并创建虚拟 Key；已安装 Claude Code（见 Claude Code 接入）。

安装 CC Switch

按 CC Switch 项目 README 安装（通常为 npm 全局安装或下载二进制）。安装后通过其命令管理 profile。

配置 base_url

将 CC Switch (PilotAIHub profile) 的 OpenAI 兼容接口地址指向 PilotAIHub 网关：

配置位置

在 CC Switch 中新增一个 profile，命名为 PilotAIHub，填入下方的 base_url 与 API Key 作为该 profile 的环境变量值。切换到 PilotAIHub profile 后，Claude Code 即通过 PilotAIHub 网关调用。

环境变量 ANTHROPIC_BASE_URL

ANTHROPIC_BASE_URL=https://api.pilotaihub.com

配置 API Key

在 PilotAIHub 控制台创建虚拟 API Key（以 pk- 开头），填入 CC Switch (PilotAIHub profile) 的 API Key / Secret 字段：

环境变量 ANTHROPIC_AUTH_TOKEN

ANTHROPIC_AUTH_TOKEN=sk-p-xxxxxxxxxxxxxxxx

Key 安全

API Key 是账户凭证，请勿提交到代码仓库或公开分享。CC Switch (PilotAIHub profile) 的配置仅保存在本地，不会上传 PilotAIHub 之外。

选择模型

在 CC Switch (PilotAIHub profile) 的模型选择处填写 PilotAIHub 支持的 model_code，例如 claude-sonnet-4-5。完整模型列表见控制台「模型」页或模型市场。

验证调用

配置完成后，用以下请求验证连通性。成功时应返回模型回复：

curl 验证

curl https://api.pilotaihub.com/chat/completions \
  -H "Authorization: Bearer sk-p-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍你自己"}
    ]
  }'

期望响应

HTTP 200 + 一条 assistant 角色的回复。若返回 401 请检查 Key 是否正确；若返回 429 请降低请求频率或联系管理员提升限额。

切换 profile

切换到 PilotAIHub

# 列出所有 profile
cc-switch list

# 切换到 PilotAIHub profile
cc-switch use PilotAIHub

# 验证当前生效配置
cc-switch current

进阶用法

建议为不同项目创建不同 PilotAIHub Key，并用 CC Switch profile 区分，便于成本归因。
切换 profile 后需重启 Claude Code 进程以加载新环境变量。
排查时可先 cc-switch current 确认当前端点。

常见问题

切换未生效

若切换后 Claude Code 仍连旧端点，确认已重启进程（环境变量在启动时读取），且 CC Switch 写入的是 Claude Code 实际读取的配置位置。