一、为什么推荐 Claude Code 搭配 QuickRouter API？
Claude Code 是 Anthropic 推出的命令行 AI 编程工具。和普通网页聊天不同，它可以直接在你的本地项目目录中运行，帮助你阅读代码、分析项目结构、生成代码、修复 bug、解释逻辑和辅助重构。
对于开发者来说，Claude Code 的优势在于它更接近真实开发流程：你不需要频繁复制代码到网页里，也不需要手动描述一堆上下文。只要在项目目录中启动 Claude Code，它就可以围绕当前项目进行交互。
如果你不想直接使用官方默认接口，也可以通过配置环境变量的方式，将 Claude Code 接入 QuickRouter API https://quickrouter.ai。完成后，Claude Code 就可以通过 QuickRouter 提供的接口访问对应模型，实现更灵活的接入方式。
二、准备工作
在开始之前，你需要准备以下内容：
| 准备项 | 说明 |
|---|---|
| QuickRouter API 账号 | 用于获取 API Key |
| API Key | 在 QuickRouter API 控制台创建令牌 |
| Node.js / npm | Claude Code 需要通过 npm 安装 |
| Git | Windows 用户建议先安装 Git for Windows |
| 一个本地项目目录 | Claude Code 通常在项目文件夹中运行 |
QuickRouter API 控制台地址：
https://api.quickrouter.ai
需要特别注意的是，Claude Code 配置 QuickRouter API 时，Base URL 应填写：
https://api.quickrouter.ai
Claude Code 使用的是 Anthropic 相关环境变量，因此这里的接口地址不需要加 /v1。
三、Windows 安装 Claude Code
Windows 用户可以原生安装 Claude Code，不一定需要 WSL / Ubuntu。推荐使用 PowerShell 操作。
1. 安装 Git for Windows
如果你还没有安装 Git for Windows，可以先下载安装包。安装时建议勾选： Add Git to PATH
如果 Git 官网下载较慢，也可以使用清华镜像：
https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/
选择最新版本，并下载 64-bit Git for Windows Setup 结尾的 .exe 安装包。
2. 打开 PowerShell
在开始菜单搜索：
PowerShell
右键选择：以管理员身份运行
如果普通 PowerShell 已经可以正常安装，也可以不使用管理员权限。
3. 安装 Claude Code
在 PowerShell 中执行：
npm install -g @anthropic-ai/claude-code
安装完成后，建议关闭当前 PowerShell，再重新打开一个新的 PowerShell 窗口。
4. 验证安装
执行：
claude --version
如果能看到版本号，说明 Claude Code 已经安装成功。
5. 配置 QuickRouter API
在 PowerShell 中执行以下命令：
setx ANTHROPIC_BASE_URL "https://api.quickrouter.ai"
setx ANTHROPIC_AUTH_TOKEN "你的 QuickRouter API Key"
将 你的 QuickRouter API Key 替换成你在 QuickRouter API 控制台创建的真实令牌。
设置完成后，需要关闭当前 PowerShell，并重新打开新的 PowerShell，让环境变量生效。
6. 进入项目目录并启动
示例：
cd D:\your-project
claude
首次启动时，按照提示完成初始化即可：
- 选择喜欢的主题
- 确认安全须知
- 使用默认 Terminal 配置
- 信任当前工作目录
- 开始使用 Claude Code 辅助开发
四、macOS 安装 Claude Code
macOS 用户可以通过 Homebrew 安装 Node.js，然后使用 npm 安装 Claude Code。
1. 安装 Homebrew 和 Node.js
如果已经安装过 Homebrew，可以直接跳过 Homebrew 安装步骤。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node
node --version
确认能看到 Node.js 版本号后，继续安装 Claude Code。
2. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
claude --version
如果能看到版本号，说明安装成功。
3. 配置 QuickRouter API
推荐使用 Claude Code 的永久配置方式，在 ~/.claude/settings.json 中写入环境变量。
先创建目录：
mkdir -p ~/.claude
然后编辑配置文件：
nano ~/.claude/settings.json
写入以下内容：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
"ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
"API_TIMEOUT_MS": "300000"
}
}
保存后退出。
注意：ANTHROPIC_BASE_URL 必须是：
https://api.quickrouter.ai
不要加 /v1。
4. 启动 Claude Code
进入你的项目目录：
cd your-project-folder
claude
按提示完成初始化后，就可以开始在项目中使用 Claude Code。
五、Linux 安装 Claude Code
以下命令以 Ubuntu / Debian 为例。
1. 安装 Node.js LTS
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
node --version
2. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
claude --version
看到版本号后，说明安装完成。
3. 配置 QuickRouter API
创建 Claude Code 配置目录：
mkdir -p ~/.claude
编辑配置文件：
nano ~/.claude/settings.json
写入：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
"ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
"API_TIMEOUT_MS": "300000"
}
}
其中：
sk-你的API令牌
需要替换成你在 QuickRouter API 控制台创建的真实 API Key。
4. 启动 Claude Code
cd your-project-folder
claude
首次启动时按照提示完成配置即可。
六、如何创建 QuickRouter API 令牌？
登录 QuickRouter API 控制台：
https://api.quickrouter.ai
进入后台后，找到「令牌管理」，然后点击「添加令牌」。
建议配置如下：
| 配置项 | 推荐设置 |
|---|---|
| 令牌名称 | Claude Code |
| 过期时间 | 永不过期 |
| 额度设置 | 按需设置，测试阶段可使用默认配置 |
| 分组 | 选择 Claude Code 专属或 Claude 相关分组 |
| 其他选项 | 保持默认 |
创建完成后，复制生成的 API Key，并填入前面的配置中。
七、常见问题
1. 提示 Invalid API Key · Please run /login 怎么办？
这个报错通常说明 Claude Code 没有正确读取到 API Key。
可以检查：
ANTHROPIC_AUTH_TOKEN是否填写正确- API Key 是否以
sk-开头 ANTHROPIC_BASE_URL是否填写为https://api.quickrouter.ai- Windows 是否在设置环境变量后重新打开了 PowerShell
- macOS / Linux 的
~/.claude/settings.json是否保存成功
2. 为什么 Claude Code 显示 offline？
Claude Code 可能会通过连接 Google 来判断网络状态。如果你的网络环境无法访问 Google，可能会显示 offline。
这个状态不一定影响实际使用。只要模型请求可以正常返回，就可以继续使用。
3. 请求时出现 fetch failed 怎么办？
可以尝试：
Ctrl + C
claude
也就是退出 Claude Code 后重新启动。
如果仍然失败，可以检查网络环境、API Key、接口地址，以及 QuickRouter API 控制台中的令牌权限和额度。
4. Base URL 到底要不要加 /v1？
Claude Code 使用 QuickRouter API 时，不要加 /v1。
正确写法：
https://api.quickrouter.ai
错误写法：
https://api.quickrouter.ai/v1
这是很多用户配置失败的常见原因。
八、适合哪些使用场景？
Claude Code 搭配 QuickRouter API，适合以下场景：
- 本地项目代码阅读
- 老项目重构
- Bug 定位和修复
- 根据需求生成新功能
- 分析项目目录和依赖关系
- 生成 README、接口文档、注释说明
- 辅助前端页面修改
- 辅助后端接口开发
- 快速理解陌生代码库
相比普通 AI 聊天工具，Claude Code 的优势是可以直接在项目目录中工作，更适合持续开发和复杂项目维护。
九、总结
如果你正在寻找一种更接近真实开发流程的 AI 编程方式，Claude Code 是一个值得尝试的工具。它可以直接运行在本地项目中，围绕当前代码库进行分析、修改和生成。
通过 QuickRouter API 配置 Claude Code 后，只需要准备 API Key，并设置：
ANTHROPIC_BASE_URL=https://api.quickrouter.ai
ANTHROPIC_AUTH_TOKEN=你的 QuickRouter API Key
即可完成接入。
需要重点记住的一点是：Claude Code 使用 QuickRouter API 时，Base URL 填写 https://api.quickrouter.ai，不要加 /v1。
配置完成后，在项目目录中运行：
claude
就可以开始使用 Claude Code 辅助开发。