Claude Code 配置教程

本教程将指导你如何获取 API 令牌，并在 Claude Code（命令行版）中配置中转 API。

1. 令牌获取教程

第一步：打开中转站

在浏览器中访问：https://backgrace.com/

第二步：注册账号

点击「注册」，输入用户名和密码完成注册。

第三步：登录

使用刚注册的账号登录。

第四步：充值额度

登录后，点击「钱包管理」，输入兑换码或支付宝付款完成充值。充值成功后可在页面查看当前余额。

第五步：创建令牌

1. 点击左侧菜单栏的 「令牌管理」
2. 点击 「添加令牌」
3. 填写信息：
   • 名称：随意填写（如 my-token）
   • 其他选项保持默认即可
4. 点击 「提交」

第六步：复制令牌

创建成功后，点击复制按钮获取你的 API Key。

格式示例： sk-xxxxxxxxxxxxxxxx（以 sk- 开头）

注意： 复制时确保前后没有多余的空格！

2. 可用模型列表与价格说明

模型列表

提示： 日常编程推荐使用 claude-sonnet-4-6，性价比最高。claude-haiku-4-5-20251001 价格最低但复杂代码可能出错。claude-opus-4-6 质量最高但消耗较多额度。

3. Claude Code 配置教程

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，支持直接在终端中与 Claude 交互。

3.1 前置环境安装

安装 Node.js

Claude Code 需要 Node.js 环境才能运行。

1. 访问 Node.js 官网：https://nodejs.org/
2. 下载 LTS（长期支持版）
3. 双击安装包，一路点击「下一步」完成安装
4. 验证安装：

node -v

看到版本号（如 v20.x.x）即安装成功。

安装 Git（可选，推荐）

1. 访问：https://git-scm.com/download/win
2. 下载并安装，使用默认设置即可

3.2 安装 Claude Code

打开终端（Windows 用 CMD 或 PowerShell，macOS/Linux 用 Terminal），运行：

npm install -g @anthropic-ai/claude-code

等待安装完成即可。

3.3 下载安装 CC-Switch

CC-Switch 是一款跨平台桌面应用，提供图形界面来管理 Claude Code 的 API 配置，无需手动设置环境变量。

前往 GitHub 下载页面：https://github.com/farion1231/cc-switch/releases

Windows 安装

MSI 安装器（推荐）：

1. 下载 .msi 安装包
2. 双击运行安装向导，按提示完成安装
3. 从开始菜单启动 CC-Switch

便携版：

1. 下载 .zip 压缩包
2. 解压到任意目录
3. 运行 cc-switch.exe

macOS 安装

Homebrew 安装（推荐）：

brew tap farion1231/ccswitch
brew install --cask cc-switch

手动安装：

1. 下载 .dmg 安装包
2. 打开后将应用拖入「应用程序」文件夹
3. 从启动台启动 CC-Switch

Linux 安装

Debian / Ubuntu：

sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f

AppImage 通用版：

chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImage

Arch Linux（AUR）：

paru -S cc-switch-bin

3.4 使用 CC-Switch 配置中转 API

第一步：添加提供商

启动 CC-Switch，点击 「添加提供商」，选择 「自定义配置」。

第二步：填写配置信息

第三步：保存配置

确认信息无误后，点击 「保存」。

第四步：启用配置

在提供商列表中选中刚才创建的配置，点击 「启用」。也可以右键系统托盘图标直接切换提供商。

第五步：重启 Claude Code

关闭并重新启动 Claude Code，配置即可生效。在终端中输入 claude 开始使用。

提示： CC-Switch 还支持 API 速度测试、配置自动备份、环境变量冲突检测等高级功能，详见 CC-Switch 官方文档。

3.5 模型选择

启动 Claude Code 后，可以使用 /model 命令切换模型：

1. 在 Claude Code 交互界面中输入 /model
2. 按回车
3. 从列表中选择你想使用的模型（如 claude-sonnet-4-6）

4. 常见问题与注意事项

Q1：ANTHROPIC_BASE_URL 需要加 /v1 吗？

不需要。 Claude Code 使用的是 Anthropic 原生接口，Base URL 设为 https://backgrace.com 即可，不要加 /v1。

注意： 如果你使用的是其他 OpenAI 兼容客户端（如 Chatbox、Cursor 等），则需要使用 https://backgrace.com/v1。

Q2：CC-Switch 配置后 claude 命令无法使用？

• 确保 Node.js 已正确安装（node -v 能正常输出版本号）
• 确保 Claude Code 已全局安装（npm install -g @anthropic-ai/claude-code）
• 确保在 CC-Switch 中已启用对应的提供商配置
• 配置切换后，需要关闭并重新启动 Claude Code才能生效

Q3：提示 API Key 无效？

• 确认令牌复制正确，前后无多余空格
• 确认令牌以 sk- 开头
• 确认账户有足够的余额

Q4：使用 CC-Switch 配置后会影响什么？

启用配置后，所有模型请求（包括默认模型）都会通过中转站路由，不会走官方 Anthropic 账号。这意味着消耗的是你中转站账户的额度。

Q5：如何查看剩余额度？

登录 https://backgrace.com/，在控制面板中查看当前余额。