Claude Code 接入 TimRouter：配置与验收

本教程针对 Claude Code CLI 的 Anthropic Messages 接口配置。先验证网关的地址、认证与模型，再启动 Claude Code；普通文本请求成功后，工具调用和长任务仍需单独验证。

更新于 2026-10-03。

1. 前置条件

按 Claude Code 官方安装文档安装 CLI，并用 claude --version确认可运行。
在 TimRouter 控制台准备可用 Key、额度和支持 Anthropic Messages 的 Claude 模型 ID。
在实时价格页核对模型及分组；不要用官网模型名或 Claude Code 默认别名推断 TimRouter 一定可用。

2. 配置环境变量

从控制台选择当前分组有权限的模型，复制完整模型 ID。先在当前终端设置 TIMROUTER_API_KEY 和 TIMROUTER_MODEL；下面的示例只读取环境变量，缺少任一项就停止，不会使用默认模型。密钥不要写入代码仓库。

macOS / Linux 使用 Bash 或 Zsh。在同一终端先输入 Key 和模型 ID，再设置 Claude Code 变量：

printf 'TimRouter API Key: '
read -r -s TIMROUTER_API_KEY
printf '\n模型 ID（从控制台复制）: '
read -r TIMROUTER_MODEL
export TIMROUTER_API_KEY TIMROUTER_MODEL
: "${TIMROUTER_API_KEY:?未设置 TIMROUTER_API_KEY}"
: "${TIMROUTER_MODEL:?未设置 TIMROUTER_MODEL}"

export ANTHROPIC_BASE_URL="https://api.timrouter.com"
export ANTHROPIC_AUTH_TOKEN="$TIMROUTER_API_KEY"
export ANTHROPIC_MODEL="$TIMROUTER_MODEL"

ANTHROPIC_BASE_URL填写根地址，不要加 /v1。客户端会继续拼接 /v1/messages；本配置使用 ANTHROPIC_AUTH_TOKEN发送 Bearer 认证。

Windows PowerShell 可在已设置 TIMROUTER_API_KEY和 TIMROUTER_MODEL的会话中执行：

if ([string]::IsNullOrWhiteSpace($env:TIMROUTER_API_KEY)) { throw "未设置 TIMROUTER_API_KEY" }
if ([string]::IsNullOrWhiteSpace($env:TIMROUTER_MODEL)) { throw "未设置 TIMROUTER_MODEL" }
$env:ANTHROPIC_BASE_URL = "https://api.timrouter.com"
$env:ANTHROPIC_AUTH_TOKEN = $env:TIMROUTER_API_KEY
$env:ANTHROPIC_MODEL = $env:TIMROUTER_MODEL

会话变量只对从该终端启动的进程生效。先检查已有 settings.json、apiKeyHelper或组织配置是否指定了其它认证来源；桌面应用与编辑器扩展的配置入口可能不同，本页命令用于 CLI。

3. 先验收 Messages 请求

以下 Bash / Zsh 命令需要 Python 3 来安全生成 JSON。它会发起一条可能计费的短请求；成功标准是 HTTP 成功、返回消息内容，并能与控制台用量对应。

: "${ANTHROPIC_BASE_URL:?请先完成环境变量配置}"
: "${ANTHROPIC_AUTH_TOKEN:?请先完成环境变量配置}"
payload=$(python3 - <<'PYMODEL'
import json
import os
import sys
model = os.environ.get("TIMROUTER_MODEL", "").strip()
if not model:
    sys.exit("未设置 TIMROUTER_MODEL")
print(json.dumps({"model": model, "max_tokens": 16, "messages": [{"role": "user", "content": "只回复 OK"}]}))
PYMODEL
) && curl --fail-with-body --silent --show-error \
  "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  --data "$payload"

该步骤确认 Messages 端点与模型能够响应，尚未确认 Claude Code 的全部请求参数或工具能力。

4. 启动 Claude Code 验收

: "${TIMROUTER_API_KEY:?未设置 TIMROUTER_API_KEY}"
: "${TIMROUTER_MODEL:?未设置 TIMROUTER_MODEL}"
claude --model "$TIMROUTER_MODEL"

运行 /status核对当前认证来源与模型，确认不是意外使用其它账号配置。
在空测试目录发送“只回复 OK，不读取或修改文件”，确认正常完成。
对需要的代码工作流做小范围验证，例如读取一个测试文件并解释内容；文件修改和工具执行按 CLI 的确认流程操作。
记录时间、模型与请求 ID（如有），对照 TimRouter 控制台用量。出现调用失败时，不把 CLI 启动成功当作接入成功。

5. 常见错误

现象	排查步骤
401 / Invalid API Key	核对 Key 与当前终端环境；Bearer 认证对应 AUTH_TOKEN，x-api-key 认证对应 API_KEY，避免混用认证来源。
404 / /v1/v1/messages	将 ANTHROPIC_BASE_URL 改回根地址，检查客户端或代理是否重复加了 /v1。
模型不存在 / 默认模型不可用	复制控制台中有权限的完整 Claude 模型 ID，使用 --model 明确选择，不依赖会变化的别名。
接口能回复，CLI 仍失败	检查 CLI 版本、参数与流式/工具调用支持；保留失败请求 ID，确认所选分组支持实际工作流。
429、余额或限额错误	核对 Key 限额、分组速率与账户余额，按具体错误处理。
变量在新窗口失效	环境变量只在当前会话生效；在实际启动 CLI 的终端重新设置。不要将 Key 写进共享项目配置。

官方配置资料

第三方网关的模型权限与功能兼容需以网关实际结果确认；上述官方资料说明客户端配置方式，不构成对 TimRouter 的官方合作或可用性背书。