Claude Code 是 Anthropic 推出的命令行 AI 编程助手，可以直接在终端中运行，并围绕当前项目目录进行代码级协作。它适合开发者阅读项目、修改代码、排查 Bug、生成文档和完成多轮开发任务。
如果你希望在国内环境中使用 Claude Code，同时又想调用 Gemini 3.5 Flash 这类速度快、成本更友好的模型，QuickRouter API https://quickrouter.ai 。 支持国内直连调用 Claude、Gemini、GPT、DeepSeek、Grok 等主流模型。配置完成后，Claude Code 仍然在本地终端运行，但模型请求会通过 QuickRouter API 转发到指定模型，例如：
gemini-3.5-flash
这样就可以在 Claude Code 的开发流程里使用 Gemini 3.5 Flash 辅助写代码、改 Bug、整理文档和分析项目。
一、为什么用 Claude Code 接入 Gemini 3.5 Flash？
Claude Code 的优势是“贴近真实开发流程”。它不是单纯的网页聊天窗口，而是可以在项目目录中运行，结合当前代码上下文进行连续协作。
Gemini 3.5 Flash 更适合下面这些场景：
- 需要较快响应速度
- 希望控制模型调用成本
- 经常进行代码解释、文档生成、需求整理
- 需要快速分析项目目录和接口逻辑
- 做轻量开发、脚本编写、批量修改建议
- 希望在 Claude Code 中切换到 Gemini 系列模型
对于日常开发来说，Gemini 3.5 Flash 可以作为一个“速度优先、成本友好”的编程模型选择。搭配 Claude Code 后，可以直接在终端中围绕项目上下文工作，不需要频繁切换网页或客户端。
二、为什么建议通过 QuickRouter API 使用？
Claude Code 默认连接 Anthropic 官方接口。对于国内用户来说，直接连接官方接口可能会遇到网络不稳定、配置复杂、额度受限或模型选择不够灵活的问题。
通过 QuickRouter API 接入后，可以把 Claude Code 的请求转到 QuickRouter API，再由 QuickRouter API 调用指定模型。
主要优势：
- 支持国内直连使用 Gemini、Claude、GPT 等主流模型
- 一个 API Key 可以统一管理多个模型
- 支持 Claude Code、Cursor、OpenCode、Cherry Studio、Trae、Cline 等开发工具
- 配置方式简单，只需要 API Key、Base URL 和模型名
- 可以把 Claude Code 默认模型指定为
gemini-3.5-flash - 适合开发者统一管理额度、令牌和模型权限
三、使用前需要准备什么？
正式配置前，建议先准备下面几项内容。
| 准备项 | 说明 |
|---|---|
| Node.js | Claude Code 通过 npm 安装，需要先安装 Node.js |
| npm | Node.js 自带 npm，用于安装 Claude Code |
| Git | Windows 用户建议安装 Git for Windows |
| QuickRouter API Key | 登录 QuickRouter API 控制台创建令牌 |
| Gemini 3.5 Flash 模型权限 | 确认令牌所在分组支持 gemini-3.5-flash |
| 项目目录 | Claude Code 通常在具体项目文件夹中运行 |
QuickRouter API Key 创建方式：
- 打开 QuickRouter API
- 登录账号
- 进入「令牌管理」
- 点击「添加令牌」
- 创建一个专门用于 Claude Code 的 API Key
建议令牌配置：
- 令牌名称：Claude Code Gemini
- 过期时间：可选择永不过期
- 额度设置：按需设置，也可以设置为无限额度
- 分组：选择支持 Gemini 模型的分组
- 模型：确认支持
gemini-3.5-flash - 其他配置：保持默认即可
四、核心配置参数
Claude Code 接入 Gemini 3.5 Flash 时，重点是下面三个参数：
| 参数 | 推荐值 | 说明 |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.quickrouter.ai | QuickRouter 的 Claude Code 接入地址 |
ANTHROPIC_AUTH_TOKEN | sk-你的API令牌 | QuickRouter API Key |
ANTHROPIC_MODEL | gemini-3.5-flash | 指定 Claude Code 使用的模型 |
如果你的网络环境偶尔超时，也可以加上：
API_TIMEOUT_MS=300000
五、Windows 安装和配置 Claude Code
Windows 用户可以直接使用 PowerShell 原生安装 Claude Code，不一定需要 WSL / Ubuntu。
1. 安装 Node.js
如果还没有安装 Node.js，可以先安装 Node.js LTS 版本。
安装完成后，重新打开 PowerShell，验证：
node --version
npm --version
能正常显示版本号，说明 Node.js 和 npm 已经可用。
2. 安装 Git for Windows
如果你的电脑还没有安装 Git，建议先安装 Git for Windows。
国内下载 Git 官网较慢时，可以使用清华镜像：
https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/
进入页面后，选择较新的版本，下载类似下面名称的安装包：
64-bit Git for Windows Setup.exe
安装时建议勾选：
Add Git to PATH
这样后续在 PowerShell 或终端中可以直接使用 Git 命令。
3. 安装 Claude Code
以管理员身份打开 PowerShell，执行：
npm install -g @anthropic-ai/claude-code
安装完成后，关闭当前 PowerShell，再重新打开一个新的 PowerShell。
验证安装：
claude --version
如果能看到版本号，说明 Claude Code 已经安装成功。
4. 配置 QuickRouter API 和 Gemini 3.5 Flash
在 PowerShell 中执行：
setx ANTHROPIC_BASE_URL "https://api.quickrouter.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-你的API令牌"
setx ANTHROPIC_MODEL "gemini-3.5-flash"
setx API_TIMEOUT_MS "300000"
示例：
setx ANTHROPIC_BASE_URL "https://api.quickrouter.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-xxxxxxxxxxxxxxxx"
setx ANTHROPIC_MODEL "gemini-3.5-flash"
setx API_TIMEOUT_MS "300000"
设置完成后，必须关闭当前 PowerShell，再重新打开新的 PowerShell，环境变量才会生效。
5. 启动 Claude Code
进入你的项目目录：
cd D:\your-project
启动 Claude Code：
claude
首次启动时，按提示完成初始化即可：
- 选择终端主题
- 确认安全提示
- 使用默认 Terminal 配置
- 信任当前工作目录
- 开始使用 Claude Code 辅助开发
六、Windows CMD 配置方式
如果你不用 PowerShell，而是使用 cmd.exe，可以使用下面的方式。
当前窗口临时生效
set ANTHROPIC_BASE_URL=https://api.quickrouter.ai
set ANTHROPIC_AUTH_TOKEN=sk-你的API令牌
set ANTHROPIC_MODEL=gemini-3.5-flash
set API_TIMEOUT_MS=300000
然后启动：
claude
这种方式只在当前 CMD 窗口生效，关闭窗口后会失效。
永久写入环境变量
setx ANTHROPIC_BASE_URL "https://api.quickrouter.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-你的API令牌"
setx ANTHROPIC_MODEL "gemini-3.5-flash"
setx API_TIMEOUT_MS "300000"
执行完成后，关闭 CMD，重新打开，再运行：
claude
七、macOS 安装和配置 Claude Code
macOS 用户建议先通过 Homebrew 安装 Node.js，然后再安装 Claude Code。
1. 安装 Homebrew
如果你还没有安装 Homebrew，可以执行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. 安装 Node.js
brew install node
验证 Node.js 是否安装成功：
node --version
npm --version
3. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
验证安装：
claude --version
4. 配置 QuickRouter API 和 Gemini 3.5 Flash
推荐使用 Claude Code 的永久配置方式。
创建或修改配置文件：
mkdir -p ~/.claude
nano ~/.claude/settings.json
写入以下内容：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
"ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
"ANTHROPIC_MODEL": "gemini-3.5-flash",
"API_TIMEOUT_MS": "300000"
}
}
保存后退出。
注意：
ANTHROPIC_BASE_URL 必须是 https://api.quickrouter.ai
不要加 /v1
5. 启动 Claude Code
进入项目目录：
cd your-project-folder
启动：
claude
八、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
npm --version
2. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
验证安装：
claude --version
3. 配置 QuickRouter API 和 Gemini 3.5 Flash
创建 Claude Code 配置目录：
mkdir -p ~/.claude
nano ~/.claude/settings.json
写入：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
"ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
"ANTHROPIC_MODEL": "gemini-3.5-flash",
"API_TIMEOUT_MS": "300000"
}
}
保存后退出。
4. 启动 Claude Code
进入你的项目目录：
cd your-project-folder
启动 Claude Code：
claude
九、如何确认已经在使用 Gemini 3.5 Flash？
配置完成后，可以从以下几个方向检查。
1. 检查环境变量
macOS / Linux：
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_MODEL
Windows PowerShell：
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL
如果输出类似下面内容，说明基础配置已生效：
https://api.quickrouter.ai
gemini-3.5-flash
2. 在 Claude Code 中测试
进入项目目录后运行：
claude
然后输入：
请说明你当前适合承担哪些代码开发任务，并用简短列表回答。
如果能够正常响应，说明 Claude Code 已经可以通过 QuickRouter API 调用模型。
3. 在 QuickRouter 控制台查看调用记录
也可以进入 QuickRouter API 控制台查看请求记录、用量和模型调用情况，确认是否正在调用 gemini-3.5-flash。
十、Claude Code 常用开发提示词
Claude Code 更适合在真实项目目录中使用。建议每次使用前先进入具体项目文件夹，而不是在系统根目录或无关目录中运行。
下面是一些常用提示词。
分析项目结构
帮我分析这个项目的目录结构，说明主要模块的作用，并指出入口文件在哪里。
排查接口报错
帮我检查这个接口为什么返回 500。请先阅读相关路由、服务层和日志处理逻辑，再给出修改建议。
新增功能
根据当前项目风格，帮我新增一个用户登录页面，要求包含手机号登录、验证码输入和提交按钮。
重构组件
帮我把这个组件拆分得更清晰，保持原功能不变，并说明每个子组件的职责。
生成部署说明
帮我生成一份部署说明，要求适合新手阅读，包含环境准备、构建命令、启动命令和常见错误。
检查安全问题
帮我检查当前项目中可能存在的 API Key 泄露、CORS 配置不当、接口鉴权缺失等问题。
十一、常见问题处理
1. 提示 Invalid API Key / Please run /login 怎么办？
这通常说明 Claude Code 没有正确读取到环境变量或配置文件。
请检查：
ANTHROPIC_AUTH_TOKEN是否填写正确- API Key 是否以
sk-开头 - API Key 是否已经过期或被禁用
- 令牌分组是否支持
gemini-3.5-flash ANTHROPIC_BASE_URL是否填写为https://api.quickrouter.ai- 是否错误添加了
/v1 - 修改配置后是否重新打开终端
settings.json是否为合法 JSON 格式
3. 配置了模型但没有生效怎么办？
可以按下面顺序排查：
- 确认已经设置
ANTHROPIC_MODEL - 确认值为
gemini-3.5-flash - 关闭终端后重新打开
- 确认没有在启动命令里使用其他
--model - 确认 Claude Code 内部没有通过
/model切换到其他模型 - 确认 QuickRouter 令牌分组支持该模型
如果你在 Claude Code 中手动使用 /model 切换过模型，可能会覆盖默认模型选择。建议重新确认当前模型配置。
4. 出现 fetch failed 怎么办？
可以按下面顺序排查：
- 退出 Claude Code
- 重新打开终端
- 重新进入项目目录
- 再次运行
claude - 检查 API Key、Base URL 和模型名
- 检查当前网络是否可访问
https://api.quickrouter.ai - 适当调大
API_TIMEOUT_MS
5. Windows 提示无法加载 claude.ps1 怎么办？
如果 PowerShell 提示脚本执行策略限制，可以临时使用下面命令调整当前用户策略：
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
然后重新打开 PowerShell，再执行：
claude --version
6. 显示 offline 是否影响使用？
Claude Code 可能会通过连接外部服务判断网络状态。部分网络环境下，即使显示 offline，也不一定影响模型调用。
如果 Claude Code 可以正常回答和处理代码任务，可以忽略该状态。
7. Gemini 3.5 Flash 适合所有编程任务吗？
Gemini 3.5 Flash 更适合速度优先、成本敏感、日常开发辅助类任务，例如代码解释、文档生成、接口排查、轻量功能开发等。
如果是复杂架构设计、大规模重构、长上下文深度推理任务，可以根据实际效果切换到更强的模型。
十二、快速配置总结
如果你已经安装好 Node.js 和 Claude Code，只想快速接入 QuickRouter API 并使用 Gemini 3.5 Flash，可以直接看下面这部分。
Windows PowerShell
setx ANTHROPIC_BASE_URL "https://api.quickrouter.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-你的API令牌"
setx ANTHROPIC_MODEL "gemini-3.5-flash"
setx API_TIMEOUT_MS "300000"
然后关闭 PowerShell，重新打开，再运行：
claude
Windows CMD
setx ANTHROPIC_BASE_URL "https://api.quickrouter.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-你的API令牌"
setx ANTHROPIC_MODEL "gemini-3.5-flash"
setx API_TIMEOUT_MS "300000"
然后关闭 CMD，重新打开，再运行：
claude
macOS / Linux
编辑：
~/.claude/settings.json
写入：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
"ANTHROPIC_BASE_URL": "https://api.quickrouter.ai",
"ANTHROPIC_MODEL": "gemini-3.5-flash",
"API_TIMEOUT_MS": "300000"
}
}
然后进入项目目录运行：
claude
十三、总结
Claude Code 适合希望在本地项目中使用 AI 辅助开发的用户。它可以直接在终端中读取项目上下文，帮助完成代码分析、功能开发、Bug 排查、文档生成和重构优化等任务。
如果你希望在国内环境中使用 Claude Code，同时调用 Gemini 3.5 Flash，可以通过 QuickRouter API 进行接入。配置时只需要准备好 QuickRouter API Key，并设置：
ANTHROPIC_BASE_URL=https://api.quickrouter.ai
ANTHROPIC_MODEL=gemini-3.5-flash
不要把 Base URL 写成：
https://api.quickrouter.ai/v1
完成配置后，就可以在 Windows、macOS 或 Linux 中直接运行 Claude Code，并通过 QuickRouter API 调用 Gemini 3.5 Flash 模型进行本地开发辅助。
参考链接
- Claude Code 环境变量文档：https://code.claude.com/docs/en/env-vars
- QuickRouter Claude Code Base URL 配置：https://quickrouter.ai/tutorials/claude-code-base-url