接入 Claude Code
通过 Better Gate 客户端、CC Switch 或手动配置接入 Claude Code。
Claude Code 是 Anthropic 推出的终端智能开发工具，能够理解项目上下文，将自然语言需求转化为代码修改、问题排查、测试运行和项目维护等实际操作。它可以直接在项目目录中工作，并与现有命令行开发流程结合。
Claude Code 可通过 Better Gate 客户端、CC Switch 或手动配置接入 Better Gate。请选择其中一种方式，不要同时使用，以免不同工具写入的配置相互覆盖。
1 安装 Claude Code（Windows、macOS、Linux）
npm install -g @anthropic-ai/claude-code
claude --version2 准备 Better Gate 配置
- 登录 Better Gate 控制台。
- 确认账户有可用余额（组织成员需确认自己的成员额度够用）。
- 打开“API Keys”，点击“创建 Key”。
- 填写 Key 名称，路由方式保持默认的“智能路由”就行，它会自动挑可用渠道；只有需要固定渠道时才选“指定渠道分组”。组织管理员为成员创建 Key，记得勾选“分配给成员”。
- 创建完成后点击“复制 Key”，保存完整的 API Key。
3 选择接入方式
3.1 通过 Better Gate 客户端接入 Claude Code (推荐)
下载并安装 Better Gate 客户端：
| 系统 | 下载地址 |
|---|---|
| Windows | 下载 Better Gate Windows 客户端 |
| macOS | 下载 Better Gate macOS 客户端 |
- 安装并启动客户端，点击“登录”。
- 浏览器打开授权页面后，确认当前账号并点击“授权并继续”，随后返回客户端。
通过客户端接入 Claude Code：
- 完整退出 Claude Code。
- 找到 Claude Code 卡片，点击“一键接入”（如果已经接入过，按钮会显示“配置接入”，点击后打开的还是同一个弹窗，只是预选了当前密钥）。
- 在弹窗中选择用于 Claude Code 的 API Key；如果列表未更新，点击“刷新密钥”。
- 点击“接入”，进入模型选择步骤：选“接入 Claude / GPT 系列模型”（推荐）可直接使用该密钥下的原生 Claude 模型；选“接入其他系列模型”则用于下面的角色映射。
- 确认选择后点击“接入”/“重新接入”，等待配置完成。
Claude Code 只会发送 Sonnet、Opus、Fable 和 Haiku 四类角色 ID。直接使用 Claude 系列模型不需要管这个；如果用的是非 Claude 系列模型，需要设置模型映射：
- 打开 Claude Code 卡片的“配置接入”。
- 点击对应密钥的“编辑配置”。
- 点击“获取模型列表”。
- 为 Sonnet、Opus、Fable、Haiku 四个角色分别设置映射的模型。
不再需要 Better Gate 时，可以在弹窗中点击对应密钥旁的“取消接入”：客户端会恢复 Claude Code 的官方登录与配置，工作区的 API Key 不会被删除，可以随时重新接入。
3.2 通过 CC Switch 接入 Claude Code
前往 CC Switch Releases 下载并安装 CC Switch。
添加 Better Gate 供应商：
- 打开 CC Switch，在顶部工具栏中选择“Claude Code”。
- 点击右上角的“+”，选择“自定义供应商”。
- 填写以下内容：
| 字段 | 值 |
|---|---|
| 供应商名称 | Better Gate |
| 官网链接 | https://better-gate.com/，可选 |
| API Key | 你的 Better Gate API Key |
| 请求地址 | https://gateway.better-gate.com |
“请求地址”不要以斜杠结尾；如果界面中有“完整 URL”开关，请保持关闭。保存配置后，在 Better Gate 卡片中点击“启用”。
3.3 手动配置 Claude Code
根据操作系统，在当前终端中设置以下环境变量。
macOS 或 Linux
export ANTHROPIC_BASE_URL="https://gateway.better-gate.com"
export ANTHROPIC_API_KEY="YOUR_BETTER_GATE_API_KEY"确认接入成功后，将两个 export 命令写入 zsh 的 ~/.zshrc 或 bash 的 ~/.bashrc。
Windows PowerShell
[Environment]::SetEnvironmentVariable(
"ANTHROPIC_BASE_URL",
"https://gateway.better-gate.com",
"User"
)
[Environment]::SetEnvironmentVariable(
"ANTHROPIC_API_KEY",
"YOUR_BETTER_GATE_API_KEY",
"User"
)Windows 环境变量设置完成后，请关闭所有终端窗口，然后重新打开 PowerShell。
完成任一接入方式后，重新打开终端并运行 claude。发送一条简短消息，再前往 Better Gate 控制台的用量页面，确认是否出现对应的请求记录。