Claude Code 是 Anthropic 推出的终端 AI 编程工具,适合用来做代码生成、项目理解、重构、调试和命令行自动化。如果你在国内网络环境下使用 Claude Code,常见问题是官方接口连接不稳定、支付和 API Key 管理不方便。
本文记录一种更容易落地的方式:通过 QuickRouter API 大模型 API 中转站 https://quickrouter.ai/ 接入 Claude Code。QuickRouter 支持 Claude Code 国内 API 中转、统一 Base URL、按量付费,并兼容主流 AI 开发工具。
一、准备 QuickRouter API Key
3 分钟快速接入 QuickRouter API 使用 OpenAI 兼容方式调用,替换 base_url 即可快速接入
开始前需要准备两个信息:
| 配置项 | 示例 |
|---|---|
| API Key | sk-xxxxxxxx |
| Base URL | https://api.quickrouter.ai |
API Key 可以在 QuickRouter 控制台创建。Base URL 使用:
https://api.quickrouter.ai
注意:Claude Code 场景下不要手动追加 /v1。
二、安装 Claude Code
确认本机已经安装 Node.js:
node --version
然后安装 Claude Code:
npm install -g @anthropic-ai/claude-code
安装完成后执行:
claude install
三、临时配置 Claude Code API
第一次测试建议使用临时环境变量,方便排查问题。
macOS / Linux
export ANTHROPIC_AUTH_TOKEN="你的 QuickRouter API Key"
export ANTHROPIC_BASE_URL="https://api.quickrouter.ai"
claude
Windows PowerShell
$env:ANTHROPIC_AUTH_TOKEN="你的 QuickRouter API Key"
$env:ANTHROPIC_BASE_URL="https://api.quickrouter.ai"
claude
如果 Claude Code 能正常进入交互界面,并且可以返回模型结果,说明已经接入成功。
四、长期配置方式
如果你希望每次打开终端都能直接使用 Claude Code,可以把环境变量写入系统配置。
macOS / Linux
写入 ~/.zshrc 或 ~/.bashrc:
export ANTHROPIC_AUTH_TOKEN="你的 QuickRouter API Key"
export ANTHROPIC_BASE_URL="https://api.quickrouter.ai"
然后执行:
source ~/.zshrc
Windows
在系统环境变量中新增:
ANTHROPIC_AUTH_TOKEN=你的 QuickRouter API Key
ANTHROPIC_BASE_URL=https://api.quickrouter.ai
保存后重新打开终端。
五、常见问题
1. Claude Code 提示 Not logged in 怎么办?
如果你使用 QuickRouter API,一般不需要走官方登录流程。优先检查:
ANTHROPIC_AUTH_TOKEN是否写错ANTHROPIC_BASE_URL是否写错- 是否在同一个终端窗口里设置变量并运行
claude
2. Base URL 要不要加 /v1?
不要加。直接使用:
https://api.quickrouter.ai
3. API Key 配置后还是失败?
优先检查:
- API Key 是否有效
- 账户余额是否充足
- 当前模型是否可用
- 终端环境变量是否生效
六、相关配置入口
如果你还需要接入其他工具或模型,可以参考:
总结
Claude Code 接入 QuickRouter API 的核心步骤很简单:
- 安装 Claude Code
- 获取 QuickRouter API Key
- 配置
ANTHROPIC_AUTH_TOKEN - 配置
ANTHROPIC_BASE_URL=https://api.quickrouter.ai - 启动
claude
对于国内开发者来说,使用 QuickRouter 做 Claude Code 国内 API 中转,可以减少网络连接和接口配置问题,也方便统一管理不同模型的调用。
