View Categories

如何在 Claude Code 中使用 sub2api

4 min read

📖 English version →

前置条件 #

Step 1 — 获取 API Key #

1. 打开控制台

访问 to.woaitoken.com/console 并登录。

2. 新建令牌

进入 令牌 → 新增令牌，填写名称（如"Claude Code"），有效期选无限制，点击 提交。

3. 复制密钥

复制生成的密钥——以 sk- 开头。请立即保存，密钥仅展示一次。

Step 2 — 配置 Claude Code #

Claude Code 通过两个环境变量连接自定义 API 端点：

ANTHROPIC_BASE_URL = "https://to.woaitoken.com"
ANTHROPIC_API_KEY  = "sk-your-key-here"

三种配置方式任选其一：

方式 A — settings.json（推荐） #

编辑或创建 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://to.woaitoken.com",
    "ANTHROPIC_API_KEY": "sk-your-key-here"
  }
}

保存后直接运行 claude，无需重启终端。

方式 B — Shell 配置文件（永久生效） #

macOS / Linux — 在 ~/.zshrc 或 ~/.bashrc 末尾添加：

export ANTHROPIC_BASE_URL="https://to.woaitoken.com"
export ANTHROPIC_API_KEY="sk-your-key-here"

然后重新加载：

source ~/.zshrc

Windows PowerShell：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://to.woaitoken.com","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY","sk-your-key-here","User")

执行后需重新打开终端窗口。

方式 C — 临时生效（仅测试用） #

ANTHROPIC_BASE_URL="https://to.woaitoken.com" \
ANTHROPIC_API_KEY="sk-your-key-here" \
claude

> ⚠ 仅对当前终端窗口有效。日常使用请选方式 A 或 B。

Step 3 — 验证连接 #

运行内置健康检查：

claude doctor

API connectivity 旁出现绿色 ✓ 表示配置成功。

也可以直接运行 claude 并发送一条测试消息（如"你好"）——收到回复即代表成功。

常见问题 #

401 Unauthorized 检查 API Key 是否完整（含 sk- 前缀，无多余空格）。

连接超时 确认 ANTHROPIC_BASE_URL 的值为 https://to.woaitoken.com——末尾无斜杠，无 /v1 后缀。Claude Code 会自动拼接路径。

429 Too Many Requests 账号额度已用尽，请前往 woaitoken.com 充值。

settings.json 不生效 确认文件路径为 ~/.claude/settings.json（不是项目子目录）。检查 JSON 语法，缺少逗号会导致整个文件失效。

Updated on 2026年5月29日

What are your Feelings

  • Happy
  • Normal
  • Sad
Shopping Cart