Claude配置

1. 什么是 Claude Code

Claude Code 是 Anthropic 官方提供的终端编码代理，可以直接在本地项目里理解代码、修改文件、执行命令，也可以和 VS Code、JetBrains 等 IDE 配合使用。

当你通过 RouteAPI 使用 Claude Code 时，本质上仍然是在走 Anthropic 协议，只是把 Claude Code 的请求改为发送到你的 RouteAPI 接入点。这样更适合统一管理密钥、额度和可用模型。

开始之前，请先准备：

一个可正常访问的终端环境
已安装的 Claude Code CLI
你的 RouteAPI 站点地址
你的 RouteAPI 密钥
RouteAPI 控制台里可用的 Claude 协议模型 ID

2. 步骤一：安装 Claude Code

安装 CLI

macOS / Linux / WSL 可直接运行：

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

Windows PowerShell 可运行：

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

如果你在 Windows 原生环境中安装，通常还需要提前准备 Git for Windows。

验证安装

claude --version

如果输出版本号，说明 CLI 已经安装成功。

3. 步骤二：配置 RouteAPI

Claude Code 可以从环境变量读取接入点和密钥。为了让终端和 IDE 共用同一份配置，更推荐把这些变量写入 settings.json。

3.1 找到配置文件

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

3.2 写入 RouteAPI 接入信息

{
  "env": {
"ANTHROPIC_BASE_URL": "https://www.routeapi.ai/",
"ANTHROPIC_AUTH_TOKEN": "你的 RouteAPI 密钥"
  }
}

上面这段配置里：

ANTHROPIC_BASE_URL：填写你的 RouteAPI 站点根地址，通常不带 /v1
ANTHROPIC_AUTH_TOKEN：填写你的 RouteAPI 密钥，适合使用 Bearer Token 方式鉴权的网关接入

如果你只是想临时测试，也可以先在当前终端会话里直接设置环境变量。请根据当前 Shell 选择对应命令：

如果你使用的是 macOS / Linux / WSL 中的 bash、zsh 或 sh：

export ANTHROPIC_BASE_URL="https://你的-routeapi-域名"
export ANTHROPIC_AUTH_TOKEN="你的 RouteAPI 密钥"

如果你使用的是 Windows PowerShell：

$env:ANTHROPIC_BASE_URL="https://你的-routeapi-域名"
$env:ANTHROPIC_AUTH_TOKEN="你的 RouteAPI 密钥"

配置完成后，重新打开一个终端窗口再启动 claude，通常会更稳妥。

4. 步骤三：选择您的模型

Claude Code 的模型选择有两种常见方式。

方式 A：固定一个默认模型

如果你希望所有会话默认都走同一个模型，可以直接设置 ANTHROPIC_MODEL：

{
  "env": {
"ANTHROPIC_BASE_URL": "https://你的-routeapi-域名",
"ANTHROPIC_AUTH_TOKEN": "你的 RouteAPI 密钥",
"ANTHROPIC_MODEL": "控制台中可用的模型 ID"
  }
}

这种方式最简单，适合团队统一指定一个默认模型。

方式 B：保留 Opus / Sonnet / Haiku 三档选择

如果你希望继续使用 Claude Code 里的档位选择能力，可以分别指定三档默认模型：

{
  "env": {
"ANTHROPIC_BASE_URL": "https://你的-routeapi-域名",
"ANTHROPIC_AUTH_TOKEN": "你的 RouteAPI 密钥",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "你的高性能模型 ID",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "你的主力模型 ID",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "你的轻量模型 ID"
  }
}

配置好之后，启动 Claude Code：

claude

然后在会话中输入：

/model

即可在 Claude Code 内选择当前会话要使用的模型档位。