Claude Code 配置教程
本教程将指导你如何获取 API 令牌,并在 Claude Code(命令行版)中配置中转 API。
1. 令牌获取教程
第一步:打开中转站
在浏览器中访问:https://backgrace.com/
第二步:注册账号
点击「注册」,输入用户名和密码完成注册。
第三步:登录
使用刚注册的账号登录。
第四步:充值额度
登录后,点击「钱包管理」,输入兑换码或支付宝付款完成充值。充值成功后可在页面查看当前余额。
第五步:创建令牌
- 点击左侧菜单栏的 「令牌管理」
- 点击 「添加令牌」
- 填写信息:
- 名称:随意填写(如
my-token) - 其他选项保持默认即可
- 名称:随意填写(如
- 点击 「提交」
第六步:复制令牌
创建成功后,点击复制按钮获取你的 API Key。
格式示例:
sk-xxxxxxxxxxxxxxxx(以sk-开头)注意: 复制时确保前后没有多余的空格!
2. 可用模型列表与价格说明
模型列表
| 模型 ID | 说明 | 价格级别 | 适用场景 |
|---|---|---|---|
claude-opus-4-6 |
Claude Opus 4.6(最强) | 较贵 | 复杂推理、高质量输出 |
claude-sonnet-4-5-20250929 |
Claude Sonnet 4.5(推荐) | 适中 | 编程推荐、日常使用 |
claude-haiku-4-5-20251001 |
Claude Haiku 4.5(轻量) | 便宜 | 翻译、简单问答、轻量任务 |
提示: 日常编程推荐使用 claude-sonnet-4-5-20250929,性价比最高。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 环境才能运行。
- 访问 Node.js 官网:https://nodejs.org/
- 下载 LTS(长期支持版)
- 双击安装包,一路点击「下一步」完成安装
- 验证安装:
node -v
看到版本号(如 v20.x.x)即安装成功。
安装 Git(可选,推荐)
- 访问:https://git-scm.com/download/win
- 下载并安装,使用默认设置即可
3.2 安装 Claude Code
打开终端(Windows 用 CMD 或 PowerShell,macOS/Linux 用 Terminal),运行:
npm install -g @anthropic-ai/claude-code
等待安装完成即可。
3.3 Windows 配置(一键脚本)
打开 PowerShell,运行以下命令:
iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/claude-cli-setup.ps1')
脚本运行后,按提示输入 API 地址:
https://backgrace.com
然后输入你的 API Key(sk- 开头的令牌),脚本会自动完成环境变量配置。
配置完成后,重新打开终端,输入 claude 即可使用。
3.4 macOS 配置(一键脚本)
安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
或使用 npm 安装:
npm install -g @anthropic-ai/claude-code
配置环境变量
运行一键配置脚本:
curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/claude-cli-setup.sh | bash
脚本运行后,按提示输入 API 地址:
https://backgrace.com
然后输入你的 API Key(sk- 开头的令牌),脚本会自动完成环境变量配置。
配置完成后,输入 claude 即可使用。
3.5 Linux 配置(一键脚本)
安装 Claude Code
curl -fsSL https://claude.ai/install.sh | bash
如果提示权限不足:
sudo curl -fsSL https://claude.ai/install.sh | bash
配置环境变量
运行一键配置脚本:
curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/claude-cli-setup.sh | bash
脚本运行后,按提示输入 API 地址:
https://backgrace.com
然后输入你的 API Key(sk- 开头的令牌),脚本会自动完成环境变量配置。
配置完成后,输入 claude 即可使用。
3.6 模型选择
启动 Claude Code 后,可以使用 /model 命令切换模型:
- 在 Claude Code 交互界面中输入
/model - 按回车
- 从列表中选择你想使用的模型(如
claude-sonnet-4-5-20250929)
4. 常见问题与注意事项
Q1:ANTHROPIC_BASE_URL 需要加 /v1 吗?
不需要。 Claude Code 使用的是 Anthropic 原生接口,Base URL 设为 https://backgrace.com 即可,不要加 /v1。
注意: 如果你使用的是其他 OpenAI 兼容客户端(如 Chatbox、Cursor 等),则需要使用
https://backgrace.com/v1。
Q2:设置环境变量后 claude 命令无法使用?
- 确保 Node.js 已正确安装(
node -v能正常输出版本号) - 确保 Claude Code 已全局安装(
npm install -g @anthropic-ai/claude-code) - Windows 用户设置永久环境变量后,需要关闭并重新打开终端
Q3:提示 API Key 无效?
- 确认令牌复制正确,前后无多余空格
- 确认令牌以
sk-开头 - 确认账户有足够的余额
Q4:设置 ANTHROPIC_BASE_URL 后会影响什么?
设置后,所有模型请求(包括默认模型)都会通过中转站路由,不会走官方 Anthropic 账号。这意味着消耗的是你中转站账户的额度。
Q5:如何查看剩余额度?
登录 https://backgrace.com/,在控制面板中查看当前余额。