Claude Code 安装与配置教程
这篇教程说明如何在 Windows、Mac 和 Linux 上安装 Claude Code，并把它接到 HRouter：先装 Node.js，再装 Claude Code，最后写入 API 地址和 Key。Claude Code 使用 Anthropic Messages 协议，配置只需要两项：ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。
模型持续更新，准确列表以当前 Key 请求
/v1/models的结果为准，见 查询可用模型。
开始前
- 一个可用的 HRouter Key，分组包含 Claude 模型。还没有 Key 先看 创建 API Key。
- Node.js 18 或更高版本（下面第 1 步会安装）。
- 一个终端：Windows 用 PowerShell，Mac 用 Terminal，Linux 用你习惯的终端。
最省事的做法：HRouter Desktop
用 HRouter Desktop 选择 Claude Code，输入 Key，点击“识别 Key”，会自动写入下面第 3 步的全部配置，还能设置 Haiku、Sonnet、Opus 三个角色对应的模型。装好 Claude Code 后直接用它即可，可以跳过第 3 步。
连接参数
| 项目 | 值 |
|---|---|
| Base URL | https://hrouter.net |
| Key | 你的 HRouter sk-... |
| 模型 | 当前 Key 返回的 Claude 模型 |
Base URL 不要写成 https://hrouter.net/v1，更不要写成 /v1/messages。 Claude Code 会自己拼接 /v1/messages，多写一段路径会返回 404，见 404 路径错误。
第 1 步：安装 Node.js
Windows
方法一，官网下载：打开 https://nodejs.org/，下载 LTS 版本的 .msi 安装包，按默认选项安装。
方法二，包管理器：
# Chocolatey
choco install nodejs
# Scoop
scoop install nodejs
Mac
brew install node
没有 Homebrew 的话，也可以在 https://nodejs.org/ 下载 LTS 安装包。
Linux
Debian / Ubuntu：
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
或者使用系统包管理器：
sudo apt update
sudo apt install nodejs npm
验证
三个系统通用：
node --version
npm --version
node 版本需要是 18 或更高。
第 2 步：安装 Claude Code
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
Linux 上如果提示没有全局安装权限，可以加 sudo，或者把 npm 的全局目录切到用户目录：
sudo npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
验证安装：
claude --version
如果提示 claude 命令不存在，说明 npm 的全局目录不在 PATH 中，见 配置不生效怎么排查。
第 3 步：配置 HRouter
下面三种方法任选一种，推荐第一种。
方法一：编辑 settings.json
这个文件对所有终端都生效，不需要每次设置环境变量。
| 系统 | 文件位置 |
|---|---|
| Windows | C:\Users\你的用户名\.claude\settings.json |
| Mac / Linux | ~/.claude/settings.json |
文件不存在就手动创建，写入：
{
"env": {
"ANTHROPIC_BASE_URL": "https://hrouter.net",
"ANTHROPIC_AUTH_TOKEN": "sk-xxxxx",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}
把 sk-xxxxx 换成你自己的 Key。如果你的 Claude Code 版本使用的是 ANTHROPIC_API_KEY，把同一个 Key 填进去也可以。
方法二：临时环境变量
只对当前终端窗口生效，关掉就失效，适合先试一下。
Windows PowerShell：
$env:ANTHROPIC_BASE_URL = "https://hrouter.net"
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxx"
Mac / Linux：
export ANTHROPIC_BASE_URL="https://hrouter.net"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxx"
方法三：永久环境变量
Windows，设置后重新打开 PowerShell：
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://hrouter.net", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxx", [System.EnvironmentVariableTarget]::User)
Mac 默认使用 zsh，写入 ~/.zshrc；Linux 常见的是 bash，写入 ~/.bashrc：
# zsh（Mac 默认）
echo 'export ANTHROPIC_BASE_URL="https://hrouter.net"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxxx"' >> ~/.zshrc
source ~/.zshrc
# bash（Linux 常见）
echo 'export ANTHROPIC_BASE_URL="https://hrouter.net"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxxx"' >> ~/.bashrc
source ~/.bashrc
同一台电脑上不要同时用多种方法写不同的值。多处配置互相冲突时，最容易出现“改了没生效”，排查见 配置不生效怎么排查。
第 4 步：开始使用并验证
进入任意项目目录，运行：
claude
第一次建议只发一句最短的测试，确认连接正常：
如果你已经接到 HRouter，请只回复：HRouter Claude 已连接
收到回复后，到 使用记录 里能看到这次请求，说明整条链路已经通了。
选择模型
HRouter 不在文档里固定写死 Claude 型号，因为模型会持续更新。
- 使用 HRouter Desktop 时，模型会自动获取并预填，还能分别设置 Haiku、Sonnet、Opus 三个角色。
- 手动配置时，先查询当前 Key 的模型列表，从中选择
claude-*模型，见 查询可用模型。 - 在 Claude Code 里可以用
/model命令切换当前会话使用的模型。 - 也可以通过环境变量
ANTHROPIC_MODEL指定默认模型，并用ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL分别指定三个角色使用的模型。
怎么选更合适，见 编程场景怎么选模型。
在编辑器里使用
先完成上面的命令行配置，确认终端里 claude 正常，再接入编辑器：
常见问题
claude 命令不存在？
npm 全局目录没有加入 PATH。Windows 重新打开 PowerShell；Mac / Linux 运行 npm config get prefix，确认其中的 bin 目录在 PATH 里。
设置后还是走默认线路？
关闭终端重新打开。如果同时存在 settings.json 和环境变量，以及它们指向不同值，先删掉多余的一处。
提示 401 或鉴权失败？ 重新复制 Key，确认前后没有空格，且 Key 没有被禁用。详细步骤见 API 401 报错。
提示 404？
检查 Base URL 是不是多写了 /v1，见 404 路径错误。
提示模型不存在或请求失败？ 确认模型存在于当前 Key 的实时模型列表中，见 model_not_found。
提示 Claude Code 版本过低？
运行 npm update -g @anthropic-ai/claude-code 升级，详见 Claude Code 常见问题。