Claude Code

Claude Code 接入指南

Claude Code 是 Anthropic 官方的 AI 编程助手。Token101 通过 Anthropic Messages API（/api/v1/messages）完整支持 Claude Code，让你可以在使用 Claude Code 的同时，享受 Token101 的 API Key 管理、模型路由和用量追踪功能。

前置条件

• Node.js 20 或更高版本（nodejs.org）
• Token101 API Key — 订阅用户可直接创建；Free 用户需先在 token.ppthub.shop/settings/apikeys 完成 API 激活
• 安装 Claude Code（见步骤一）

步骤一 — 安装 Claude Code

Windows 安装（以 Windows 11 为例）

访问 claude.com/product/claude-code 下载 Claude Code。

在 Windows 中打开 PowerShell，执行：

irm https://claude.ai/install.ps1 | iex

我们可以看到已经安装成功了，并且有提示：”Native installation exists but C:\Users\ameureka.local\bin is not in your PATH. Add it by opening: System Properties → Environment Variables → Edit User PATH → New → Add the path above. Then restart your terminal.”

本地安装已存在，但 C:\Users\ameureka\.local\bin 不在环境变量 PATH 中。请通过以下步骤添加：打开 系统属性 → 环境变量 → 编辑用户 PATH → 新建 → 添加上述路径，然后重启终端。

输入 claude --version 可以看到下面报错，说明 Claude Code 可执行文件尚未加入系统环境变量，所以找不到 Claude Code。如果没有报错可忽略，接下来我们解决报错问题。

关键步骤：将路径添加到环境变量 (PATH)

你需要将安装路径，例如：C:\Users\ameureka.local\bin 添加到系统 PATH 中。

1. 打开环境变量设置

用户 → 系统 → 高级系统设置 → 高级

2. 编辑 Path 变量

• 在弹出的窗口中，查看上半部分的 "环境变量" 列表。

• 找到名为 Path 的变量，选中它，然后点击下方的 "编辑"。

3. 添加新路径

• 在弹出的编辑窗口中，点击右侧的 "新建"。
• 将下面这个路径复制并粘贴进去： %USERPROFILE%\.local\bin 注意，根据你的实际的路径填写例如：C:\Users\ameureka.local\bin

• 一路点击 "确定"，关闭所有设置窗口。

4. 重新启动终端（最关键的一步）

环境变量修改后，必须关闭当前正在运行的 PowerShell 窗口。

• 关闭它，然后重新打开一个新的 PowerShell 窗口。
• 再次输入命令测试：

claude --version

这次系统就能成功识别并输出版本号了。

macOS 安装

访问 claude.com/product/claude-code 下载 Claude Code。

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

验证安装：

claude --version

步骤二 — 配置环境变量（基础知识，可跳过）

Claude Code 通过以下两个环境变量连接 API 后端：

Token101 同时受理两个鉴权变量，你只需要设置一个。ANTHROPIC_AUTH_TOKEN 会让 Claude Code 发送 Authorization: Bearer ...，也和一键安装脚本写入的变量一致，因此推荐使用它。ANTHROPIC_API_KEY 会让 Claude Code 发送 X-Api-Key: ...，同样有效——如果你已经在用它，可以继续沿用。请不要两个同时设置，否则 Claude Code 实际发送哪个请求头会取决于版本。

Windows — 永久写入用户环境变量

在 PowerShell 中执行以下命令，将变量持久化到用户环境（重启后仍然有效）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://token.ppthub.shop/api", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxx...your-api-key", "User")

如需在当前 PowerShell 会话中立即生效，还可以临时设置：

$env:ANTHROPIC_BASE_URL = "https://token.ppthub.shop/api"
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxx...your-api-key"

macOS / Linux — 永久写入配置文件（~/.zshrc）

echo 'export ANTHROPIC_BASE_URL="https://token.ppthub.shop/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxx...your-api-key"' >> ~/.zshrc
source ~/.zshrc

第三行 source 命令会重新加载该配置文件，让你刚刚写入的环境变量立即生效，不需要关闭再重新打开终端窗口。

步骤三 — 配置 Claude Code

首次启动时，在 PowerShell 或终端中输入 claude，Claude Code 会引导你完成初始配置：

选择默认 Dark Mode 模式，直接回车。

直接选择继续，直接回车。

步骤四 — 快速一键接入 Token101 API 到 Claude Code

详情请参阅一键接入。

运行以下命令，快速接入 Token101：

macOS / Linux

bash <(curl -fsSL https://token.ppthub.shop/scripts/setup-token101-claude-code-mac-hub.sh)

Windows（PowerShell）

powershell -ExecutionPolicy Bypass -Command "& { Invoke-WebRequest -Uri 'https://token.ppthub.shop/scripts/setup-token101-claude-code-win-hub.ps1' -OutFile 'setup-token101-claude-code-win-hub.ps1'; ./setup-token101-claude-code-win-hub.ps1 }"

或先下载到本地，再执行：

Invoke-WebRequest -Uri 'https://token.ppthub.shop/scripts/setup-token101-claude-code-win-hub.ps1' -OutFile 'setup-token101-claude-code-win-hub.ps1'
powershell -ExecutionPolicy Bypass -File ./setup-token101-claude-code-win-hub.ps1

交互模式（推荐） — 脚本会逐步询问模型映射、启动方式等选项：

powershell -ExecutionPolicy Bypass -File ./setup-token101-claude-code-win-hub.ps1

非交互模式 — 传入 API Key 参数，全程使用推荐默认值，无需手动选择：

powershell -ExecutionPolicy Bypass -File ./setup-token101-claude-code-win-hub.ps1 -ApiKey sk-你的密钥

建议：重启终端 — 配置完成后，建议关闭并重新打开 PowerShell，让环境变量生效。

步骤五 — 在项目中使用 Claude Code

进入项目目录，开始使用 Claude Code：

cd ~/my-project

# 询问项目相关问题
claude -p "这个项目是做什么的？"

# 交互模式
claude

# 高级权限运行模式（跳过权限确认提示，适合个人开发环境）
claude --dangerously-skip-permissions

支持的模型

在 Claude Code 中，通过切换模型槽位调用不同的 Token101 API 路由：

完整模型列表请参阅支持的模型。

工作原理

Claude Code 使用 Anthropic Messages API 格式通信。当你将 ANTHROPIC_BASE_URL 设置为 Token101 时：

1. Claude Code 向 https://token.ppthub.shop/api/v1/messages 发送请求
2. Token101 验证 API Key，执行限流和计费逻辑
3. Token101 将请求路由到对应的 AI 模型
4. 响应（包括流式 token）通过相同的管道返回

Token101 完整保留了 Anthropic Messages API 的契约：系统消息、多轮对话、工具调用和流式输出均正常工作。

Token 计数

Claude Code 在发送请求前会自动调用 POST /api/v1/messages/count_tokens 估算 prompt 的大小。你也可以用调用 /api/v1/messages 的同一个 API Key 直接调用它——它是免费的，不消耗你的积分（credits）。

curl https://token.ppthub.shop/api/v1/messages/count_tokens \
  -H "Authorization: Bearer sk-xxxx...your-api-key" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

响应返回输入 token 数：

{ "input_tokens": 8 }

Token 计数仅适用于 Claude（Anthropic 兼容）模型，其他模型会返回 400 错误。

常见问题

报错 Error: Missing API key 或 Invalid API key

1. 检查 ANTHROPIC_AUTH_TOKEN（如果你设置的是 ANTHROPIC_API_KEY，则检查它）是否已设置：echo $ANTHROPIC_AUTH_TOKEN
2. 在 token.ppthub.shop/settings/apikeys 确认 Key 状态正常
3. 确保 Key 以 sk- 开头

Base URL 格式问题

Anthropic SDK（Claude Code）使用 /api 作为 Base URL，不是 /api/v1：

# ✅ 正确
export ANTHROPIC_BASE_URL="https://token.ppthub.shop/api"

# ❌ 错误 — 这是 OpenAI SDK / Codex CLI 的格式
export ANTHROPIC_BASE_URL="https://token.ppthub.shop/api/v1"

报错 Error: 429 Too Many Requests

已达到请求频率限制。详见频率限制。

Claude Code 正常工作但返回了错误的模型

确认你使用的模型别名受支持。可以用 claude -p "你是哪个模型？" 确认实际响应的模型。

下一步

• 一键接入 — 一条命令完成 Claude Code 配置
• 支持的模型 — 查看所有可用模型
• 频率限制 — 了解请求配额
• 计费说明 — 追踪和管理用量
• Codex CLI 接入 — 同时使用 Codex CLI 时的配置方法