在 Win11 上用 Claude Code 接入 Gemini 模型（无需 WSL/Ubuntu）

最近 AI Agent 很火，之前我玩过 OpenCode，现在想试试 Anthropic 官方的 Claude Code 。但是 Claude 官方模型太贵，而我有 Google 的 Gemini API Key（量大管饱）。

于是我决定：在 Windows 11 上，用 Claude Code 的壳，接 Gemini 的脑。

在不安装 Linux 子系统 (WSL) 的情况下，如何在 Win11 原生 PowerShell 环境下跑通它。

一、准备工作（地基要打好）

在开始之前，我们需要先装好 3 个基础工具。

1. 安装 Node.js（运行环境）

Claude Code 是基于 Node.js 运行的，这是第一步。

去 Node.js 官网下载 LTS 版本（长期支持版）。
双击安装包，一路点击 "Next" (默认安装) 即可。
关键验证 ：安装完成后，关闭所有 旧的终端窗口，打开一个新的 PowerShell，输入：
powershell 复制代码
```
node -v
```
- 如果出现 v20.x.x 或更高的版本号，说明安装成功。
- 如果提示红字 "无法将"node"项识别为..."，请重启电脑再试。

2. 安装 Git（核心依赖，必装！）

这一步很多人容易漏掉！ Claude Code 在 Windows 上运行时，必须调用 Git Bash 环境。如果没装，启动时会直接报错。

去 Git 官网下载 "64-bit Git for Windows Setup"。
安装时会出现很多选项，不要犹豫，全程点击 "Next" (一路下一步)，使用默认配置即可（默认配置会自动配置环境变量）。
验证：在 PowerShell 中输入：
powershell 复制代码
```
git --version
```
- 看到类似 git version 2.x.x 即为成功。

3. 安装 Ripgrep（搜索工具）

Claude Code 需要这个工具来搜索代码，Linux 上很简单，但 Windows 上很容易报错。

打开 PowerShell (管理员)，输入：

powershell 复制代码

winget install BurntSushi.ripgrep.MSVC

注意：如果提示需要同意协议，输入 Y 回车。如果下载失败，请检查网络连接或多试几次。
安装完后，必须重启终端 ，输入 rg --version，看到版本号才算成功。

解决 PowerShell 权限问题

Win11 默认禁止运行未签名的脚本。如果不修改策略，后续安装会报错。

在 PowerShell 中执行：

powershell 复制代码

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

（提示时选 A 或 Y 回车）

二、安装核心组件

我们需要安装两个包：一个是官方的 Claude Code，一个是负责转发请求到 Gemini 的路由插件（Router）。

在 PowerShell 中依次执行：

powershell 复制代码

npm install -g @anthropic-ai/claude-code
npm install -g @musistudio/claude-code-router

三、配置 Gemini（关键步骤）

我们需要创建一个配置文件，将原本发往 Anthropic 的请求重定向到 Google Gemini。

在 PowerShell 输入：mkdir $env:USERPROFILE\.claude-code-router 创建配置文件夹。
输入 notepad $env:USERPROFILE\.claude-code-router\config.json 用记事本创建并打开配置。
复制以下配置内容（已配置好 Gemini 模型映射，防止 404）：

json 复制代码

{
  "LOG": true,
  "Providers": [
    {
      "name": "gemini",
      "api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/",
      "api_key": "这里填入你的_Gemini_API_Key_注意不要有空格", 
      "models": [
        "gemini-2.0-flash", 
        "gemini-3-pro-preview"
      ],
      "transformer": {
        "use": ["gemini"]
      }
    }
  ],
  "Router": {
    "default": "gemini,gemini-2.0-flash",
    "background": "gemini,gemini-2.0-flash",
    "think": "gemini,gemini-2.0-flash",
    "longContext": "gemini,gemini-2.0-flash",
    "webSearch": "gemini,gemini-2.0-flash"
  }
}

操作提示 ：请将 api_key 的值替换为你自己的 Gemini Key，然后保存关闭。

四、核心避坑：API 网络连通性问题

重点：如果运行报错 fetch failed，请仔细阅读本节。

这是安装过程中最容易卡住的地方。由于 Google 的 API 服务在海外，国内网络直接访问可能会出现连接超时或失败。

问题原因 ：

Claude Code 底层依赖的 Node.js 网络库对部分 Windows 系统代理设置的识别可能不完全，导致即便配置了常规的 HTTP 代理，终端请求依然无法送达。

解决办法 ：

请确保你的网络环境可以正常访问 Google 服务。

如果你使用的是网络加速工具或代理软件，强烈建议开启"增强模式"、"TUN 模式"或"接管系统流量"功能。

原理：开启此类模式后，工具会通过虚拟网卡层级接管系统流量，强制 Node.js 的请求走代理通道。这是解决 fetch failed 最有效的方案。

五、 👻 最大的坑：后台"僵尸"进程（非人为失误）

这是特别需要说明的、最容易让人崩溃的"非人为"失败点。

现象描述：

当你第一次运行报错（比如配置写错了，报找不到模型），你去修改了 config.json 并保存完美。
但是！当你再次运行程序时，它依然报旧的错误！

为什么会这样？

这不是你没改对文件，而是 Claude Code Router 的后台服务（Server）是一个常驻进程 。

当你关闭命令行窗口时，后台那个 node.exe 进程并没有结束 。它依然加载着旧的配置文件在内存里运行。你修改了硬盘上的文件，但进程内存里用的还是旧配置。

解决方法：

每次修改完 config.json，必须手动结束进程，强制它重启读取新配置。

在 PowerShell 执行这句指令：

powershell 复制代码

taskkill /F /IM node.exe

切记：只要修改了配置文件，务必执行一次上述命令。

六、启动与验证

完成以上步骤后：

确认网络环境已配置好（API 可达）。
确认配置文件已保存。

直接运行：

powershell 复制代码

ccr code

如果看到绿色的交互界面，尝试输入"你好"，若能收到回复，恭喜你成功跑通！🎉

总结

在 Windows 上运行此类 AI 命令行工具，"API 网络连通性" 和 "Node 进程残留" 是两个最大的拦路虎。希望这篇实录能帮你省下排错时间。如果你遇到了 fetch failed 或修改配置不生效，请回头检查第四、第五点！

在 Win11 上用 Claude Code 接入 Gemini 模型（无需 WSL/Ubuntu）

一、 准备工作（地基要打好）

1. 安装 Node.js（运行环境）

2. 安装 Git（核心依赖，必装！）

3. 安装 Ripgrep（搜索工具）

解决 PowerShell 权限问题

二、 安装核心组件

三、 配置 Gemini（关键步骤）

四、 核心避坑：API 网络连通性问题

五、 👻 最大的坑：后台"僵尸"进程（非人为失误）

现象描述：

为什么会这样？

解决方法：

六、 启动与验证

总结

一、准备工作（地基要打好）

二、安装核心组件

三、配置 Gemini（关键步骤）

四、核心避坑：API 网络连通性问题

六、启动与验证