在 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 运行的，这是第一步。

1. 去 Node.js 官网 下载 LTS 版本（长期支持版）。
2. 双击安装包，一路点击 “Next” (默认安装) 即可。
   • 如果出现 v20.x.x 或更高的版本号，说明安装成功。
   • 如果提示红字 “无法将“node”项识别为…”，请重启电脑再试。

关键验证：安装完成后，关闭所有旧的终端窗口，打开一个新的 PowerShell，输入：

node -v 

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

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

1. 去 Git 官网 下载 “64-bit Git for Windows Setup”。
2. 安装时会出现很多选项，不要犹豫，全程点击 “Next” (一路下一步)，使用默认配置即可（默认配置会自动配置环境变量）。
   • 看到类似 git version 2.x.x 即为成功。

验证：在 PowerShell 中输入：

git --version 

3. 安装 Ripgrep（搜索工具）

Claude Code 需要这个工具来搜索代码，Linux 上很简单，但 Windows 上很容易报错。
打开 PowerShell (管理员)，输入：

winget install BurntSushi.ripgrep.MSVC 

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

解决 PowerShell 权限问题

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

Set-ExecutionPolicy-ExecutionPolicy RemoteSigned -Scope CurrentUser 

（提示时选 A 或 Y 回车）

二、 安装核心组件

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

在 PowerShell 中依次执行：

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

三、 配置 Gemini（关键步骤）

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

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

{"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 执行这句指令：

taskkill /F /IM node.exe 

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

六、 启动与验证

完成以上步骤后：

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

直接运行：

ccr code 

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

总结

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