# Claude Code 国内直连教程：接入Gemini 3.5 Flash

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，可以直接在终端中运行，并围绕当前项目目录进行代码级协作。它适合开发者阅读项目、修改代码、排查 Bug、生成文档和完成多轮开发任务。

如果你希望在国内环境中使用 Claude Code，同时又想调用 **Gemini 3.5 Flash** 这类速度快、成本更友好的模型，**QuickRouter API**  quickrouter.ai  支持国内直连调用 Claude、Gemini、GPT、DeepSeek、Grok 等主流模型。配置完成后，Claude Code 仍然在本地终端运行，但模型请求会通过 QuickRouter API 转发到指定模型，例如：

```text
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 创建方式：

1. 打开 QuickRouter API
2. 登录账号
3. 进入「令牌管理」
4. 点击「添加令牌」
5. 创建一个专门用于 Claude Code 的 API Key

建议令牌配置：

- 令牌名称：Claude Code Gemini
- 过期时间：可选择永不过期
- 额度设置：按需设置，也可以设置为无限额度
- 分组：选择支持 Gemini 模型的分组
- 模型：确认支持 `gemini-3.5-flash`
- 其他配置：保持默认即可

---

## 四、核心配置参数

Claude Code 接入 Gemini 3.5 Flash 时，重点是下面三个参数：

| 参数 | 推荐值 | 说明 |
|---|---|---|
| `ANTHROPIC_BASE_URL` | `` | QuickRouter 的 Claude Code 接入地址 |
| `ANTHROPIC_AUTH_TOKEN` | `sk-你的API令牌` | QuickRouter API Key |
| `ANTHROPIC_MODEL` | `gemini-3.5-flash` | 指定 Claude Code 使用的模型 |

如果你的网络环境偶尔超时，也可以加上：

```text
API_TIMEOUT_MS=300000
```

---

## 五、Windows 安装和配置 Claude Code

Windows 用户可以直接使用 PowerShell 原生安装 Claude Code，不一定需要 WSL / Ubuntu。

### 1. 安装 Node.js

如果还没有安装 Node.js，可以先安装 Node.js LTS 版本。

安装完成后，重新打开 PowerShell，验证：

```powershell
node --version
npm --version
```

能正常显示版本号，说明 Node.js 和 npm 已经可用。

### 2. 安装 Git for Windows

如果你的电脑还没有安装 Git，建议先安装 Git for Windows。

国内下载 Git 官网较慢时，可以使用清华镜像：

```text
https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/
```

进入页面后，选择较新的版本，下载类似下面名称的安装包：

```text
64-bit Git for Windows Setup.exe
```

安装时建议勾选：

```text
Add Git to PATH
```

这样后续在 PowerShell 或终端中可以直接使用 Git 命令。

### 3. 安装 Claude Code

以管理员身份打开 PowerShell，执行：

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

安装完成后，关闭当前 PowerShell，再重新打开一个新的 PowerShell。

验证安装：

```powershell
claude --version
```

如果能看到版本号，说明 Claude Code 已经安装成功。

### 4. 配置 QuickRouter API 和 Gemini 3.5 Flash

在 PowerShell 中执行：

```powershell
setx ANTHROPIC_BASE_URL "quickrouter.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-你的API令牌"
setx ANTHROPIC_MODEL "gemini-3.5-flash"
setx API_TIMEOUT_MS "300000"
```

示例：

```powershell
setx ANTHROPIC_BASE_URL "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

进入你的项目目录：

```powershell
cd D:\your-project
```

启动 Claude Code：

```powershell
claude
```

首次启动时，按提示完成初始化即可：

- 选择终端主题
- 确认安全提示
- 使用默认 Terminal 配置
- 信任当前工作目录
- 开始使用 Claude Code 辅助开发

---

## 六、Windows CMD 配置方式

如果你不用 PowerShell，而是使用 `cmd.exe`，可以使用下面的方式。

### 当前窗口临时生效

```cmd
set ANTHROPIC_BASE_URL=quickrouter.ai
set ANTHROPIC_AUTH_TOKEN=sk-你的API令牌
set ANTHROPIC_MODEL=gemini-3.5-flash
set API_TIMEOUT_MS=300000
```

然后启动：

```cmd
claude
```

这种方式只在当前 CMD 窗口生效，关闭窗口后会失效。

### 永久写入环境变量

```cmd
setx ANTHROPIC_BASE_URL "api.quickrouter.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-你的API令牌"
setx ANTHROPIC_MODEL "gemini-3.5-flash"
setx API_TIMEOUT_MS "300000"
```

执行完成后，关闭 CMD，重新打开，再运行：

```cmd
claude
```

---

## 七、macOS 安装和配置 Claude Code

macOS 用户建议先通过 Homebrew 安装 Node.js，然后再安装 Claude Code。

### 1. 安装 Homebrew

如果你还没有安装 Homebrew，可以执行：

```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

### 2. 安装 Node.js

```bash
brew install node
```

验证 Node.js 是否安装成功：

```bash
node --version
npm --version
```

### 3. 安装 Claude Code

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

验证安装：

```bash
claude --version
```

### 4. 配置 QuickRouter API 和 Gemini 3.5 Flash

推荐使用 Claude Code 的永久配置方式。

创建或修改配置文件：

```bash
mkdir -p ~/.claude
nano ~/.claude/settings.json
```

写入以下内容：

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
    "ANTHROPIC_BASE_URL": "api.quickrouter.ai",
    "ANTHROPIC_MODEL": "gemini-3.5-flash",
    "API_TIMEOUT_MS": "300000"
  }
}
```

保存后退出。


### 5. 启动 Claude Code

进入项目目录：

```bash
cd your-project-folder
```

启动：

```bash
claude
```

---

## 八、Linux 安装和配置 Claude Code

下面以 Ubuntu / Debian 系统为例。

### 1. 安装 Node.js LTS

```bash
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
```

验证安装：

```bash
node --version
npm --version
```

### 2. 安装 Claude Code

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

验证安装：

```bash
claude --version
```

### 3. 配置 QuickRouter API 和 Gemini 3.5 Flash

创建 Claude Code 配置目录：

```bash
mkdir -p ~/.claude
nano ~/.claude/settings.json
```

写入：

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌",
    "ANTHROPIC_BASE_URL": "api.quickrouter.ai",
    "ANTHROPIC_MODEL": "gemini-3.5-flash",
    "API_TIMEOUT_MS": "300000"
  }
}
```

保存后退出。

### 4. 启动 Claude Code

进入你的项目目录：

```bash
cd your-project-folder
```

启动 Claude Code：

```bash
claude
```

---

## 九、如何确认已经在使用 Gemini 3.5 Flash？

配置完成后，可以从以下几个方向检查。

### 1. 检查环境变量

macOS / Linux：

```bash
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_MODEL
```

Windows PowerShell：

```powershell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL
```

如果输出类似下面内容，说明基础配置已生效：

```text
api.quickrouter.ai
gemini-3.5-flash
```

### 2. 在 Claude Code 中测试

进入项目目录后运行：

```bash
claude
```

然后输入：

```text
请说明你当前适合承担哪些代码开发任务，并用简短列表回答。
```

如果能够正常响应，说明 Claude Code 已经可以通过 QuickRouter API 调用模型。

### 3. 在 QuickRouter 控制台查看调用记录

也可以进入 QuickRouter API 控制台查看请求记录、用量和模型调用情况，确认是否正在调用 `gemini-3.5-flash`。

---

## 十、Claude Code 常用开发提示词

Claude Code 更适合在真实项目目录中使用。建议每次使用前先进入具体项目文件夹，而不是在系统根目录或无关目录中运行。

下面是一些常用提示词。

### 分析项目结构

```text
帮我分析这个项目的目录结构，说明主要模块的作用，并指出入口文件在哪里。
```

### 排查接口报错

```text
帮我检查这个接口为什么返回 500。请先阅读相关路由、服务层和日志处理逻辑，再给出修改建议。
```

### 新增功能

```text
根据当前项目风格，帮我新增一个用户登录页面，要求包含手机号登录、验证码输入和提交按钮。
```

### 重构组件

```text
帮我把这个组件拆分得更清晰，保持原功能不变，并说明每个子组件的职责。
```

### 生成部署说明

```text
帮我生成一份部署说明，要求适合新手阅读，包含环境准备、构建命令、启动命令和常见错误。
```

### 检查安全问题

```text
帮我检查当前项目中可能存在的 API Key 泄露、CORS 配置不当、接口鉴权缺失等问题。
```

---

## 十一、常见问题处理

### 1. 提示 Invalid API Key / Please run /login 怎么办？

这通常说明 Claude Code 没有正确读取到环境变量或配置文件。

请检查：

- `ANTHROPIC_AUTH_TOKEN` 是否填写正确
- API Key 是否以 `sk-` 开头
- API Key 是否已经过期或被禁用
- 令牌分组是否支持 `gemini-3.5-flash`
- 是否错误添加了 `/v1`
- 修改配置后是否重新打开终端
- `settings.json` 是否为合法 JSON 格式


### 3. 配置了模型但没有生效怎么办？

可以按下面顺序排查：

1. 确认已经设置 `ANTHROPIC_MODEL`
2. 确认值为 `gemini-3.5-flash`
3. 关闭终端后重新打开
4. 确认没有在启动命令里使用其他 `--model`
5. 确认 Claude Code 内部没有通过 `/model` 切换到其他模型
6. 确认 QuickRouter 令牌分组支持该模型

如果你在 Claude Code 中手动使用 `/model` 切换过模型，可能会覆盖默认模型选择。建议重新确认当前模型配置。

### 4. 出现 fetch failed 怎么办？

可以按下面顺序排查：

1. 退出 Claude Code
2. 重新打开终端
3. 重新进入项目目录
4. 再次运行 `claude`
5. 检查 API Key、Base URL 和模型名
7. 适当调大 `API_TIMEOUT_MS`

### 5. Windows 提示无法加载 claude.ps1 怎么办？

如果 PowerShell 提示脚本执行策略限制，可以临时使用下面命令调整当前用户策略：

```powershell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
```

然后重新打开 PowerShell，再执行：

```powershell
claude --version
```

### 6. 显示 offline 是否影响使用？

Claude Code 可能会通过连接外部服务判断网络状态。部分网络环境下，即使显示 `offline`，也不一定影响模型调用。

如果 Claude Code 可以正常回答和处理代码任务，可以忽略该状态。

### 7. Gemini 3.5 Flash 适合所有编程任务吗？

Gemini 3.5 Flash 更适合速度优先、成本敏感、日常开发辅助类任务，例如代码解释、文档生成、接口排查、轻量功能开发等。

如果是复杂架构设计、大规模重构、长上下文深度推理任务，可以根据实际效果切换到更强的模型。

---




Claude Code 是 Anthropic 推出的命令行 AI 编程助手，可以直接在终端中运行，并围绕当前项目目录进行代码级协作。它适合开发者阅读项目、修改代码、排查 Bug、生成文档和完成多轮开发任务。

Claude Code 国内直连教程：接入Gemini 3.5 Flash

开发工具

人工智能

后端

本文详细介绍了如何在国内环境中配置ClaudeCode命令行AI编程助手，通过QuickRouter API直连调用Gemini 3.5 Flash模型。教程涵盖Windows、macOS和Linux系统的安装步骤，包括Node.js环境准备、API密钥配置及关键参数设置。Gemini 3.5 Flash模型响应速度快、成本友好，适合代码解释、文档生成、Bug排查等日常开发任务，帮助开发者在不切换网页的情况下直接在项目目录中高效协作。

验证码

Windows

路由

Ubuntu

Debian

Linux

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

本文详细介绍了如何在国内环境中配置ClaudeCode命令行AI编程助手，通过QuickRouter API直连调用Gemini 3.5 Flash模型。教程涵盖Windows、macOS和Linux系统的安装步骤，包括Node.js环境准备、API密钥配置及关键参数设置。Gemini 3.5 Flash模型响应速度快...

Claude Code 国内直连教程：接入Gemini 3.5 Flash-腾讯云开发者社区-腾讯云

Claude Code 国内直连教程：接入Gemini 3.5 Flash

Claude Code 国内直连教程：接入Gemini 3.5 Flash

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐