Claude Code 是 Anthropic 推出的终端 AI 编程工具，支持开发者直接在命令行中通过自然语言完成代码生成、文件读取、项目分析、调试、修改和重构等操作。
如果你不想使用默认官方接口，也可以通过配置环境变量的方式，将 Claude Code 接入 QuickRouter API https://quickrouter.ai。 接入完成后，你就可以通过 QuickRouter API 调用 Claude Code 所需模型，在国内网络环境下更方便地使用各类主流大模型能力。
一、接入前需要准备什么
正式开始之前，请先准备好以下两项信息。你可以登录 QuickRouter API 控制台获取：
| 配置项 | 示例 | 说明 |
|---|---|---|
| API Key | sk-xxxxxxxxxxxxxxxx | 使用你在控制台创建的 API Key |
| Base URL | https://api.quickrouter.ai | 不要添加 /v1 后缀 |
二、安装 Claude Code
请先确认你的电脑已经安装 Node.js，建议版本为 18 或以上。
你可以先在终端执行下面的命令，检查当前 Node.js 环境是否可用：
node --version
如果终端能够正常输出版本号，就可以继续下一步；如果没有安装 Node.js，请先安装完成后再继续。
1）基础安装
先通过 npm 全局安装 Claude Code：
npm install -g @anthropic-ai/claude-code
2）安装原生运行组件
Claude Code 目前已经切换到 Native 安装方式。为了避免后续运行异常，完成基础安装后，建议继续执行下面这条命令：
claude install
安装成功后，通常会看到类似下面的提示：
Claude Code successfully installed!
三、Windows 用户常见问题处理
如果你使用的是 Windows，建议先完成下面两项设置；如果你使用的是 macOS 或 Linux，可以直接跳过本节。
1）放开 PowerShell 脚本执行权限
请使用 PowerShell 打开终端，并执行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
如果系统弹出确认提示，输入 Y 后回车即可。
如果不先执行这一步，后续运行
claude时，可能会遇到脚本被系统阻止执行的报错。
2）解决 claude 命令无法识别的问题
如果安装完成后输入 claude 仍然提示找不到命令，通常是因为安装目录没有加入系统环境变量。
你可以按下面方式处理：
- 按下
Win键，搜索“环境变量” - 打开系统环境变量设置
- 在当前用户的
Path中添加以下目录：
C:\Users\你的用户名\.local\bin
保存后，关闭并重新打开 PowerShell，再次执行 claude 测试是否生效。
四、配置 QuickRouter API 并启动 Claude Code
Claude Code 会通过环境变量读取你设置的接口地址和密钥。
因此，建议把设置环境变量和运行 claude 放在同一个终端窗口中完成，这样更不容易出错。
方式一：临时配置（适合首次测试）
这种方式只对当前终端窗口生效，适合第一次验证是否已经配置成功。
Windows（PowerShell）
$env:ANTHROPIC_AUTH_TOKEN="sk-你的QuickRouter API密钥"
$env:ANTHROPIC_BASE_URL="https://api.quickrouter.ai"
claude
macOS / Linux
export ANTHROPIC_AUTH_TOKEN="sk-你的QuickRouter API密钥"
export ANTHROPIC_BASE_URL="https://api.quickrouter.ai"
claude
方式二：长期配置（推荐）
如果你希望以后每次打开终端都能直接使用 Claude Code，建议将环境变量设置为全局。
Windows
在“环境变量” → “用户变量”中新增以下两个变量：
ANTHROPIC_AUTH_TOKEN=你的QuickRouter API密钥
ANTHROPIC_BASE_URL=https://api.quickrouter.ai
保存后，重新打开终端即可生效。
macOS / Linux
将下面内容写入 ~/.zshrc 或 ~/.bashrc：
export ANTHROPIC_AUTH_TOKEN="sk-你的QuickRouter API密钥"
export ANTHROPIC_BASE_URL="https://api.quickrouter.ai"
然后执行对应的命令让配置立即生效。
如果你使用的是 zsh：
source ~/.zshrc
如果你使用的是 bash：
source ~/.bashrc
五、如何判断是否接入成功
在已经配置好环境变量的终端中，直接输入：
claude
如果接入成功，通常会出现以下情况：
- 不再出现
Not logged in或Please run /login之类的提示 - 会直接进入 Claude Code 的交互界面
- 你可以直接输入测试指令，例如：
请帮我用 Python 写一个 Hello World
如果能够正常返回结果，就说明 Claude Code 已经成功通过 QuickRouter API 接入并可正常使用。
六、常见问题 FAQ
Q1：提示余额不足怎么办？
如果出现余额不足、额度不足或调用失败等提示，建议优先检查以下几项：
- 当前 API Key 是否还有可用额度
- 对应账号是否已经完成充值
- 当前分组或通道设置是否正确
- 当前调用的模型是否可用
如果控制台支持切换分组、线路或模型，也可以调整后再重新测试。
例如，在 Claude Code 中可以这样切换模型：
/model gpt5.4
如果你的 QuickRouter API 控制台支持其他模型，也可以替换成对应模型名称。
Q2：为什么还是提示 Not logged in 或 Please run /login？
这类问题最常见的原因一般有两个：
- 环境变量名称写错了，必须使用
ANTHROPIC_AUTH_TOKEN - 你是在一个终端窗口里设置的变量，却在另一个终端窗口里运行了
claude
更稳妥的方式是：
在同一个终端窗口里先设置变量，再直接运行 claude。
Q3：Base URL 需要加 /v1 吗？
不需要。请直接填写下面这个地址即可：
https://api.quickrouter.ai
Q4：误输入了 /login 怎么办？
/login 是 Claude Code 用于登录官方 Anthropic 账户的命令。
如果你当前使用的是 QuickRouter API，通常不需要执行这个命令。
如果误进入登录流程，直接按 Esc 退出即可，然后重新检查当前终端中的环境变量是否已经正确配置。
七、总结
如果你想让 Claude Code 通过 QuickRouter API 运行，核心步骤并不复杂，主要就是下面三步：
- 安装 Claude Code
- 配置
ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL - 在同一个终端窗口中启动
claude
建议第一次先使用“临时配置”的方式进行测试，确认能够正常进入 Claude Code 后，再改成“长期配置”。这样更方便排查问题，也更稳妥。