Claude Code - RouterLink

Claude Code 是 Anthropic 官方的 Claude CLI。RouterLink 提供 Anthropic 兼容 endpoint，所以你可以把 Claude Code 走 RouterLink，直接消耗积分，而不必单独订阅 Anthropic。

为什么把 Claude Code 接到 RouterLink

按量付费 —— 用 RouterLink 积分余额，无需月度订阅
单 key 预算 —— 给 Claude Code 用的那把 key 设月度硬上限
统一计费 —— Claude Code 用量与其他流量在同一 dashboard 里
支持 Files API —— 通过 Claude Code 的 tool use 上传、获取、删除文件

配置

拿一把 RouterLink API key

没有的话先看快速开始。

安装 Claude Code

CLI — npm
CLI — macOS / Linux / WSL
CLI — Windows (PowerShell)
VS Code 扩展

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

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

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

从 VS Code Marketplace 安装 Claude Code 扩展，无需单独安装 CLI。配置全在 settings.json 里完成（见下一步）。

验证 CLI 安装：

claude --version

把 Claude Code 指向 RouterLink

CLI — Shell 配置
CLI — settings.json
VS Code 扩展

加到 ~/.zshrc 或 ~/.bashrc，之后每次启动自动生效：

export ANTHROPIC_BASE_URL="https://router-link.world3.ai/api/anthropic"
export ANTHROPIC_API_KEY="<你的-routerlink-key>"

重载 shell 后运行 claude。

编辑（或新建）~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<你的-routerlink-key>",
    "ANTHROPIC_BASE_URL": "https://router-link.world3.ai/api/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
    "API_TIMEOUT_MS": "3000000"
  }
}

Windows 路径：C:\Users\<用户名>\.claude\settings.json。

打开 VS Code 的 settings.json（Cmd/Ctrl+Shift+P → “Open User Settings (JSON)”）：

添加以下配置：

{
  "claudeCode.disableLoginPrompt": true,
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_AUTH_TOKEN",         "value": "<你的-routerlink-key>" },
    { "name": "ANTHROPIC_BASE_URL",            "value": "https://router-link.world3.ai/api/anthropic" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL","value": "claude-sonnet-4-6" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",  "value": "claude-opus-4-7" }
  ]
}

首次启动

在项目目录里跑 claude，选择 New Session：

如果想跳过 Anthropic 的新手引导（因为你用的是 RouterLink 凭证），创建或编辑 ~/.claude.json：

{ "hasCompletedOnboarding": true }

再次运行 claude，可能会出现登录提示 —— 由于鉴权由 RouterLink key 处理，可以跳过：

出现目录授权对话框时点击信任：

验证

随便问个问题，然后回 RouterLink Dashboard 看 —— 几秒内应该能看到这次请求，从你的 key 上扣费。

支持矩阵

功能	状态
`/v1/messages`（流式 + 非流式）	已支持
`/v1/messages/count_tokens`	已支持
Tool use	已支持
Prompt caching（`cache_control`）	已支持
Extended thinking	已支持
Files API（`/v1/files`）	已支持
Batches API	即将支持

完整兼容矩阵和边界情况见接入指南。

切换模型

Claude Code 默认用 Sonnet。需要临时换模型，直接在 Claude Code 里用 /model slash 命令 —— RouterLink 会原样把 model 名转给上游，任意 Anthropic 模型名都行（claude-sonnet-4-6、claude-opus-4-7、claude-haiku-4-5 等）。要设置持久默认模型，在 settings.json 或 shell 配置中指定 ANTHROPIC_DEFAULT_SONNET_MODEL（或 HAIKU / OPUS 变体）。也可以在 RouterLink 控制台里浏览并复制模型名：

在 Claude Code 里跑 /status 可以确认当前使用的模型：

排错

第一个请求就 `401 Unauthorized`

检查 ANTHROPIC_API_KEY（或 ANTHROPIC_AUTH_TOKEN）是不是 RouterLink 的 key（以 rl- 开头），不是 Anthropic 自家的 key。RouterLink 不接受上游 Anthropic key。

`429 budget_exceeded`

Claude Code 这把 key 撞月度预算了。去 API Keys → 编辑 提额，或在 计费 → 充值 加积分。

Claude Code 卡在 thinking 那步

确认你装的是最新版 Claude Code。RouterLink 在 v1.0+ 修了跨厂商 thinking 流式的几个边界。

改了配置不生效

关闭所有 Claude Code 窗口后重启。如果还有问题，删掉 settings.json 重新配置。建议用 JSON 校验工具检查格式 —— 多余的逗号或缺少括号会静默破坏配置文件。

如何升级 Claude Code

claude update

基础

API

​为什么把 Claude Code 接到 RouterLink

​配置

​支持矩阵

​切换模型

​排错

为什么把 Claude Code 接到 RouterLink

配置

支持矩阵

切换模型

排错