工具集成 · Anthropic Messages

在 Claude Code 中使用 TokenRa

Claude Code 是 Anthropic 推出的终端 AI 编程助手，通过 Anthropic Messages 接口调用模型。接入 TokenRa 只需三项配置：Base URL、TokenRa API Key 和模型 ID。下表中的模型均已于 2026 年 10 月 29 日在 Claude Code 中实测完成读写文件任务。

Base URL: https://tokenra.io
接口格式: Anthropic Messages
配置文件: ~/.claude/settings.json
实测版本: Claude Code 2.1.312

Before you start

准备工作

TokenRa API Key：注册账号后，在控制台的「API 密钥」页面创建。Key 以 sk- 开头。
无需 Anthropic 账号：通过 TokenRa 使用 Claude Code 时不需要登录 Claude。

Install

安装 Claude Code

推荐使用 Anthropic 官方安装脚本，也可以用 Homebrew 或 WinGet 安装。npm 安装方式仍可用，但官方已不再推荐。

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

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# 或使用 Homebrew（macOS / Linux）、WinGet（Windows）
brew install --cask claude-code
winget install Anthropic.ClaudeCode

# 检查是否安装成功
claude --version

Configure

配置 TokenRa

Claude Code 会读取用户配置文件 ~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json）中 env 块里的环境变量。文件不存在时请新建，写入以下内容，并把 sk-... 换成你的 Key：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://tokenra.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "deepseek-v4.1-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4.1-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4.1-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4.1-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4.1-flash",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

配置项	说明
`ANTHROPIC_BASE_URL`	固定为 `https://tokenra.io`，不要加 `/v1`，Claude Code 会自动拼接 `/v1/messages`。
`ANTHROPIC_AUTH_TOKEN`	你的 TokenRa API Key，以 `Authorization: Bearer` 方式发送。
`ANTHROPIC_MODEL`	Claude Code 使用的模型，可填下表中的任意模型 ID。
`ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL`	Claude Code 中 `opus`、`sonnet`、`haiku` 三个别名对应的模型。Claude Code 还会用 haiku 模型处理后台任务，因此三项都要填 TokenRa 的模型 ID，也可以分别填不同的模型。
`CLAUDE_CODE_SUBAGENT_MODEL`	子代理（subagent）默认使用的模型。
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	可选。设为 `1` 会关闭自动更新、遥测和错误上报等非必要请求；需要自动更新时删掉这一行。

保存后重新启动 Claude Code。配置文件必须是严格的 JSON：不能有注释和多余的逗号，引号必须是英文引号。

也可以使用环境变量

这些变量也可以直接设为系统环境变量，不写配置文件：

# macOS / Linux：把以下几行加到 ~/.zshrc 或 ~/.bashrc，再新开一个终端
export ANTHROPIC_BASE_URL="https://tokenra.io"
export ANTHROPIC_AUTH_TOKEN="sk-..."
export ANTHROPIC_MODEL="deepseek-v4.1-flash"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4.1-flash"

# Windows PowerShell：写入当前用户的环境变量，新开的终端生效
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://tokenra.io", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-...", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4.1-flash", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "deepseek-v4.1-flash", "User")

也可以用 ANTHROPIC_API_KEY

TokenRa 两种写法都支持。ANTHROPIC_API_KEY 以 x-api-key 请求头发送，交互模式下 Claude Code 会先请你确认一次是否使用该 Key；用 ANTHROPIC_AUTH_TOKEN 则不会出现这一步。

Verify

验证配置

在任意目录运行一条单次指令：

claude -p "用一句话介绍你自己"

收到回答即说明 Base URL、Key 和模型都配置正确。不带 -p 运行 claude 会进入交互模式：首次启动时会让你选择配色主题、确认是否信任当前目录，配置好以上内容后不会要求登录。在会话中输入 /status 可查看已加载的配置文件。

Models

实测可用的模型

2026-10-29，以下模型均在 Claude Code 2.1.312 中完成了同一个任务：用 Read 工具读取文件，再用 Write 工具创建新文件。耗时为单次运行的整个任务时长，仅供参考。

模型	模型 ID	任务耗时（单次）
DeepSeek V4.1 Flash 1017	`deepseek-v4.1-flash-1017`	4 秒
DeepSeek V4.1 Flash	`deepseek-v4.1-flash`	5 秒
MiniMax M3	`minimax-m3`	6 秒
GLM-5.3	`glm-5.3`	7 秒
GLM-5.3 Flash	`glm-5.3-flash`	9 秒
Qwen3.8 Max	`qwen3.8-max`	14 秒
Kimi K3	`kimi-k3`	15 秒
MiniMax M3.1 Flash	`minimax-m3.1-flash`	26 秒
Kimi K3.1 Pro	`kimi-k3.1-pro`	32 秒

不适用的模型

gemini-3.8-flash 不能用于此类工具：它的上游会拒绝所有带工具定义的请求（HTTP 400），而编程助手的每个请求都带有工具。

Switch

切换模型

会话中：输入 /model kimi-k3.1-pro 可立即切换到另一个 TokenRa 模型；只输入 /model 会打开模型选择器，其中 opus、sonnet、haiku 对应你在 ANTHROPIC_DEFAULT_*_MODEL 中设置的模型。
单次启动：claude --model kimi-k3.1-pro。
修改默认模型：改 ANTHROPIC_MODEL。设置了这个变量时，每次启动都会使用它指定的模型，之前用 /model 选的模型不会保留。

FAQ

常见问题

启动后仍然要求登录

说明 Claude Code 没有读到 TokenRa 的配置。请检查文件路径是否为 ~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json）、内容是否为合法 JSON、变量是否写在 "env" 里。使用环境变量的话，请新开一个终端再启动。

报错 401：Invalid token

Key 缺失、填错或已被删除。请到「API 密钥」重新复制，并确认 ANTHROPIC_BASE_URL 是 https://tokenra.io，而不是 Anthropic 官方地址。

报错 503：model_not_found

模型 ID 填错了，或者 Claude Code 请求了 TokenRa 没有提供的 Claude 模型。请把 ANTHROPIC_MODEL 和三个 ANTHROPIC_DEFAULT_*_MODEL 都设为模型列表中的模型 ID。

报错 403：insufficient_user_quota

账户余额不足。请在控制台的「钱包」中充值后重试。

响应很慢

推理模型在每一步之前都可能思考较长时间：测试任务中 Kimi K3.1 Pro 约用 30 秒，DeepSeek V4.1 Flash 约 5 秒。日常小改动可以选用表中更快的模型。Claude Code 默认每个请求最多等待 10 分钟（API_TIMEOUT_MS）。

我的代码会发送到 TokenRa 吗？

会。Claude Code 会把你的指令和它读取的文件内容发送到你配置的接口（即 TokenRa），再由 TokenRa 转发给模型服务商。TokenRa 如何处理请求内容见零数据保留。

在哪里查看用量和费用？

每个请求都会记录在控制台的「使用日志」中，包含模型、token 用量和费用。各模型的实时价格见模型广场。

准备工作

安装 Claude Code

配置 TokenRa

也可以使用环境变量

验证配置

实测可用的模型

切换模型

常见问题

启动后仍然要求登录

报错 401：Invalid token

报错 503：model_not_found

报错 403：insufficient_user_quota

响应很慢

我的代码会发送到 TokenRa 吗？

在哪里查看用量和费用？

相关链接