Claude Code 接入¶

Claude Code 支持通过 ANTHROPIC_BASE_URL 连接第三方 LLM 网关，并通过 ANTHROPIC_AUTH_TOKEN 把密钥作为 Bearer Token 发送。RouteFast 使用这两个官方配置项接入，无需修改 Claude Code 本身。

首次使用请按下方步骤配置密钥、地址和模型，并发送简单文本请求检查连接。

准备工作¶

在 RouteFast.AI 创建一个属于 Anthropic-Claude 分组的 API Key。
确认账号有可用余额。
在终端运行 claude --version，记录客户端版本，并核对下方模型的最低版本要求。

安装 Claude Code¶

macOS、Linux 或 WSL：

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

Windows PowerShell：

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

安装后验证：

claude --version
claude doctor

安装命令与系统要求会变化，请以 Claude Code 官方安装文档为准。

Windows 原生环境与 WSL 是两套环境：在实际运行 Claude Code 的一侧安装并配置。原生 Windows 可选装 Git for Windows 以使用 Bash；不要把 PowerShell 命令粘贴到 WSL 终端。

临时配置：推荐先这样测试¶

下面的变量仅对当前终端及其后启动的进程有效；关闭窗口后需要重新设置。若你已在 Claude Code 的 settings.json 中配置过同名变量，文件中的值可能覆盖当前终端值，先检查旧配置。

macOS / Linux / WSL¶

export ANTHROPIC_BASE_URL="https://api.routefast.ai"
export ANTHROPIC_AUTH_TOKEN="sk-routefast-..."

claude --model claude-sonnet-5

Windows PowerShell¶

$env:ANTHROPIC_BASE_URL="https://api.routefast.ai"
$env:ANTHROPIC_AUTH_TOKEN="sk-routefast-..."

claude --model claude-sonnet-5

Windows CMD¶

set ANTHROPIC_BASE_URL=https://api.routefast.ai
set ANTHROPIC_AUTH_TOKEN=sk-routefast-...

claude --model claude-sonnet-5

claude-sonnet-5 是示例模型 ID，请先确认它在你的 Anthropic-Claude 密钥模型目录中。不要在 Token 值前自行添加 Bearer，客户端会自动添加。

持久配置¶

Claude Code 的用户级配置文件：

macOS / Linux / WSL：~/.claude/settings.json
Windows：%USERPROFILE%\.claude\settings.json

先为已有文件保留一份带日期的备份，再合并 env 字段，不要直接覆盖已有配置：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.routefast.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-routefast-..."
  }
}

该方式会把密钥以明文保存在本机。共享电脑或受管设备应改用系统密钥管理、企业环境变量或短期注入方式。不要把这个文件提交到 Git。

同名变量存在于 shell 和设置文件时，Claude Code 使用设置文件的 env 值；用户、项目和受管设置之间还存在优先级。父终端打印的值不能证明 Claude Code 实际使用了它。修改完成后重新启动客户端，并按下方 /status 检查。官方配置优先级

选择模型¶

首次验证可用 claude --model <模型ID> 指定精确模型；也可在会话内用 /model <模型ID> 切换。以下环境变量适合在当前终端设置启动模型：

export ANTHROPIC_MODEL="claude-sonnet-5"
claude

以下为部分模型的官方客户端版本要求（2026-09-07）：

示例模型 ID	官方 Claude Code 最低版本
`claude-sonnet-5`	`2.1.197`
`claude-opus-5`	`2.1.219`
`claude-opus-4-8`	`2.1.154`
`claude-fable-5`	`2.1.170`
`claude-fable-5-1`	`2.1.255`

版本要求详见 Claude Code 官方模型配置。可用模型随密钥分组变化；工具、缓存和长上下文等能力还取决于模型与上游配置，不能仅凭模型出现在目录中判断。

/model 内置选项也不等于 RouteFast 可用目录。Claude Code 的网关模型发现默认关闭，接入时无需开启 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY，直接使用模型目录中的精确 ID 即可。官方模型发现说明

验证当前连接¶

先在一个测试目录中启动 Claude Code，再运行：

/status

检查实际生效配置：

Anthropic base URL 应为 https://api.routefast.ai；
Auth token 应标明来自 ANTHROPIC_AUTH_TOKEN，而不是只显示既有 claude.ai 登录；
当前模型应是你选择且该密钥可访问的模型。

随后发送一个简单提示，例如“只回复：连接测试成功，不调用工具”。收到完整回答后，在 RouteFast 用量记录中核对时间、模型和费用。这是一次实际调用，可能产生费用；成功仅验证当前配置下的这次文本请求。官方连接验证

如果地址或凭证来源不符，检查用户/项目设置及旧网关配置，特别是 CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_VERTEX、CLAUDE_CODE_USE_FOUNDRY 等云平台变量。先确认它们是否仍有用途，再移除不再使用的设置；仅重新 export Token 不一定能改变已选中的 provider。官方认证优先级

可选：关闭非必要流量¶

按自己的网络和隐私需求决定是否设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1，它不是 RouteFast 鉴权所需配置。可将它加入用户设置的 env，或在启动前设置：

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

PowerShell 使用 $env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"。开启后会关闭自动更新、遥测、错误报告和部分依赖功能开关的能力，需要安排手动更新；它不保证所有工具流量都经过 RouteFast。0 或 false 仍算开启，要恢复需移除变量并重启。具体影响随版本变化，请参阅官方环境变量说明。

使用旧版时还需注意：官方记录 2.1.246 之前可能将网关凭证附在发往 Anthropic 的遥测或用量请求上；暂不能升级时，可通过此开关关闭这类流量。官方网关说明

VS Code 与其他入口¶

本页配置适用于 CLI。VS Code 扩展还涉及 VS Code 用户设置中的 claudeCode.environmentVariables，仅配置 ~/.claude/settings.json 可能仍遇到扩展登录提示。Desktop 也有独立的第三方推理配置；使用这些入口时，请按官方入口说明配置并检查实际连接。

更新或恢复官方直连¶

使用本页原生安装方式时，手动更新 Claude Code：

claude update

若原先通过 Homebrew、WinGet 或系统包管理器安装，请使用对应包管理器升级。官方升级说明

要临时恢复 Anthropic 官方连接，在当前终端移除 RouteFast 变量并重新启动：

unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_MODEL
unset CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC