Claude Code 接入 QuickRouter API 教程

Claude Code 是 Anthropic 推出的终端智能编程工具，支持通过自然语言在命令行中完成代码生成、文件读取、调试、修改和重构等操作。

如果你不想直接使用官方默认接口，也可以通过配置环境变量的方式，将 Claude Code 接入 QuickRouter API https://quickrouter.ai。完成后，Claude Code 就可以通过 QuickRouter 提供的接口访问对应模型，实现更灵活的接入方式。

---

一、开始前需要准备的内容

在正式配置之前，请先准备以下两项信息，这些都可以在 QuickRouter API 控制台中获取：

配置项	示例	说明
API Key	sk-xxxxxxxxxxxxxxxx	你在控制台创建的密钥
Base URL	https://api.quickrouter.ai	注意不要追加 /v1

---

二、安装 Claude Code

在安装 Claude Code 之前，请先确认本机已经安装 Node.js，建议使用 Node.js 18 或更高版本。

先在终端执行以下命令，检查当前 Node.js 环境：

node --version

如果尚未安装 Node.js，请先安装完成后再继续。

1）安装 Claude Code

执行以下命令：

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

2）执行原生安装

安装完成后，建议继续执行下面这条命令：

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"

然后执行：

source ~/.zshrc

如果你使用的是 Bash，则执行：

source ~/.bashrc

---

五、如何确认是否接入成功

在已经完成环境变量配置的终端中输入：

claude

如果配置正常，通常会出现以下表现：

1. 不再提示 Not logged in 或 Please run /login
2. 可以直接进入 Claude Code 交互界面
3. 可以直接输入测试指令，例如：

请帮我用 Python 写一个 Hello World

如果能够正常返回结果，说明 Claude Code 已经成功接入 QuickRouter API。

---

六、常见问题

Q1：提示余额不足怎么办？

如果出现额度不足、余额不足或调用失败等提示，建议优先检查以下几项：

• 当前 API Key 是否仍有可用额度
• 账号是否已经完成充值
• 当前令牌分组是否设置正确
• 当前模型是否处于可用状态

如果控制台支持切换模型或分组，也可以切换后重新测试。

例如，在 Claude Code 中切换模型可以使用：

/model gpt5.4

你也可以替换为自己当前可用的其他模型名称。

---

Q2：为什么还是提示 Not logged in 或 Please run /login？

这类情况最常见的原因通常有两个：

• 环境变量名称写错了，必须使用 ANTHROPIC_AUTH_TOKEN
• 你在一个终端里配置了变量，却在另一个终端里执行了 claude

更稳妥的做法是：在同一个终端窗口中先设置变量，再直接启动 claude。

---

Q3：Base URL 是否需要加 /v1？

不需要。

请直接使用：

https://api.quickrouter.ai

不要手动添加 /v1。

---

Q4：误输入 /login 怎么办？

/login 是用于登录官方 Anthropic 账号的命令。

如果你接入的是 QuickRouter API，通常不需要使用它。

如果误进入登录流程，直接按 Esc 退出，然后重新检查当前终端中的环境变量是否配置正确即可。

---

七、总结

如果你希望通过 QuickRouter API 使用 Claude Code，核心流程其实很简单：

1. 安装 Claude Code
2. 配置 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL
3. 在同一个终端窗口中运行 claude

建议第一次先使用“临时配置”进行测试，确认能够正常进入 Claude Code 后，再改成“长期配置”。这样更方便排查问题，也更不容易出错。