中转 API 配置教程

Claude Code 配置教程

Base URL: https://backgrace.com/

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


1. 令牌获取教程

第一步:打开中转站

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

第二步:注册账号

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

第三步:登录

使用刚注册的账号登录。

第四步:充值额度

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

第五步:创建令牌

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

第六步:复制令牌

创建成功后,点击复制按钮获取你的 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 环境才能运行。

  1. 访问 Node.js 官网:https://nodejs.org/
  2. 下载 LTS(长期支持版)
  3. 双击安装包,一路点击「下一步」完成安装
  4. 验证安装:
bash
node -v

看到版本号(如 v20.x.x)即安装成功。

安装 Git(可选,推荐)

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

3.2 安装 Claude Code

打开终端(Windows 用 CMD 或 PowerShell,macOS/Linux 用 Terminal),运行:

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

等待安装完成即可。


3.3 Windows 配置(一键脚本)

打开 PowerShell,运行以下命令:

powershell
iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/claude-cli-setup.ps1')
Windows 一键脚本配置示例

脚本运行后,按提示输入 API 地址:

text
https://backgrace.com

然后输入你的 API Key(sk- 开头的令牌),脚本会自动完成环境变量配置。

配置完成后,重新打开终端,输入 claude 即可使用。


3.4 macOS 配置(一键脚本)

安装 Claude Code

bash
curl -fsSL https://claude.ai/install.sh | bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

或使用 npm 安装:

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

配置环境变量

运行一键配置脚本:

bash
curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/claude-cli-setup.sh | bash
macOS 一键脚本配置示例

脚本运行后,按提示输入 API 地址:

text
https://backgrace.com

然后输入你的 API Key(sk- 开头的令牌),脚本会自动完成环境变量配置。

配置完成后,输入 claude 即可使用。


3.5 Linux 配置(一键脚本)

安装 Claude Code

bash
curl -fsSL https://claude.ai/install.sh | bash

如果提示权限不足:

bash
sudo curl -fsSL https://claude.ai/install.sh | bash

配置环境变量

运行一键配置脚本:

bash
curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/claude-cli-setup.sh | bash

脚本运行后,按提示输入 API 地址:

text
https://backgrace.com

然后输入你的 API Key(sk- 开头的令牌),脚本会自动完成环境变量配置。

配置完成后,输入 claude 即可使用。


3.6 模型选择

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

  1. 在 Claude Code 交互界面中输入 /model
  2. 按回车
  3. 从列表中选择你想使用的模型(如 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/,在控制面板中查看当前余额。