Claude Code 是 Anthropic 官方推出的终端智能编码工具。你可以直接在命令行里用自然语言完成代码生成、读取本地文件、调试、修改和重构等开发任务。
如果你希望不使用默认官方接口，也可以通过配置环境变量的方式，将 Claude Code 接入
快游 API https://quickrouter.ai 国内直连全球AI大模型
配置完成后，就可以通过快游 API 来调用 Claude Code 所需的模型服务，整体接入方式也比较直接。
一、接入前需要准备什么
开始之前，请先准备好下面 2 项关键信息。你可以登录快游 API 控制台获取对应内容。
| 配置项 | 填写示例 | 说明 |
|---|---|---|
| API Key | sk-xxxxxxxxxxxxxxxx | 填写你在控制台创建的 Key |
| Base URL | https://api.quickrouter.ai | 不要加 /v1 后缀 |
二、先安装 Claude Code
请先确认你的电脑已经安装 Node.js，建议版本为 18 或以上。
你可以先在终端中执行下面的命令，检查当前 Node 环境：
node --version
如果本机还没有安装 Node.js，请先安装完成后再继续后面的步骤。
1）基础安装
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 再试一次。
四、配置快游 API 并启动 Claude Code
Claude Code 会通过环境变量识别你使用的接口地址和密钥。
因此，设置环境变量和运行 claude，最好放在同一个终端窗口中完成。
方式一：临时配置（适合首次测试）
这种方式只对当前终端窗口生效，适合第一次验证是否配置成功。
Windows（PowerShell）
$env:ANTHROPIC_AUTH_TOKEN="sk-你的快游API密钥"
$env:ANTHROPIC_BASE_URL="https://api.quickrouter.ai"
claude
macOS / Linux
export ANTHROPIC_AUTH_TOKEN="sk-你的快游API密钥"
export ANTHROPIC_BASE_URL="https://api.quickrouter.ai"
claude
方式二：长期配置（推荐）
如果你希望以后每次打开终端，直接输入 claude 就能使用，那么建议配置为全局环境变量。
Windows
在“环境变量” -> “用户变量”中新增以下两个变量：
ANTHROPIC_AUTH_TOKEN=你的快游API密钥
ANTHROPIC_BASE_URL=https://api.quickrouter.ai
保存后，重新打开终端即可生效。
macOS / Linux
把下面的内容写入 ~/.zshrc 或 ~/.bashrc：
export ANTHROPIC_AUTH_TOKEN="sk-你的快游API密钥"
export ANTHROPIC_BASE_URL="https://api.quickrouter.ai"
然后执行：
source ~/.zshrc
如果你使用的是 bash，则改为：
source ~/.bashrc
五、怎么判断是否配置成功
在已经设置好环境变量的终端里输入：
claude
如果接入正常，一般会出现下面这些现象：
- 不会再出现 Not logged in · Please run /login 之类的提示
- 会直接进入 Claude Code 的交互界面
- 你可以直接输入测试指令，例如：
请帮我用 Python 写一个 Hello World
如果能够正常返回结果，就说明已经接入成功。
六、常见问题 FAQ
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
Q4：不小心输入了
/login
怎么办？
/login 是用于登录官方 Anthropic 账号的。
如果你接入的是快游 API，就不需要使用这个命令。
如果误进入登录流程，直接按 Esc 退出即可，然后重新检查当前终端里的环境变量配置。
七、总结
如果你想让 Claude Code 通过快游 API 来运行，核心步骤其实只有三步：
-
安装 Claude Code
-
配置 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL
-
在同一个终端窗口中启动 claude
建议你第一次先用“临时配置”测试，确认能正常进入 Claude Code 之后，再改成“长期配置”。这样更稳，也更不容易排错。