Gemini CLI 报 fetch failed 代理问题排查：把 endpoint 改到 TaoToken 的配置记录

1. Gemini CLI 报 fetch failed 到底卡在哪终端调用模型时的网络链路拆解Gemini CLI 是 Google 推出的命令行 AI 工具能在终端里直接对话、读代码、跑任务适合习惯用 shell 干活的开发者。它的请求链路其实很直白CLI 进程发起 HTTPS 请求Node.js 的 fetch 实现底层是 undici去解析域名、建连、发数据。只要中间任何一环断了你看到的报错就是那句经典的[API Error: exception TypeError: fetch failed sending request]注意这个报错的关键词是TypeError和fetch failed不是 401、不是 403、也不是超时。它意味着请求根本没发出去或者连接在建立阶段就被掐断了。很多人第一反应是去查 API Key 对不对其实方向错了——Key 错了会返回 401而 fetch failed 是网络层的问题。我实测下来这个报错最常见的触发场景有三个。第一是 DNS 解析失败域名压根解析不到 IP第二是 TCP 连接被重置握手阶段就断了第三是 TLS 证书校验过不去。这三种情况在终端里表现一模一样都是 fetch failed所以排查时得一层层往下剥。为什么 Gemini CLI 特别容易踩这个坑因为它的默认 endpoint 指向的是 Google 的 API 服务器而这个地址在国内网络环境下经常连不上。你 ping 一下就知道丢包率极高甚至完全不通。这时候不管你怎么重装 CLI、换 Node 版本、清缓存都没用因为问题不在本地代码而在请求根本到不了目的地。那正确的思路是什么不是去折腾网络工具而是把请求的 endpoint 换成一个你能稳定访问的地址。TaoToken 提供的 API 网关就是干这个的——它兼容 OpenAI 风格的接口协议Gemini CLI 只要把 base URL 指过去请求就能正常发出去。下面我会一步步带你把这个配置做完包括环境变量、配置文件、验证请求以及踩过的坑。先确认一下你的环境。打开终端跑一下node -v npm -v gemini --versionNode 版本建议 18 以上因为 undici 的 fetch 实现对 Node 版本有要求。如果gemini --version报 command not found说明 CLI 没装好先补上npm install -g google/gemini-cli装完之后别急着跑先把 endpoint 的事理清楚。很多人装完直接gemini然后看到 fetch failed就以为装错了其实装得没问题是网络链路的事。理解这一点后面的配置你才不会走弯路。2. TaoToken 前置准备拿到 Base URL 和 API Key 再动手改 endpoint在改 Gemini CLI 配置之前你得先有一个能用的 API 入口和一把 Key。TaoToken 这边提供的是兼容 OpenAI 协议的接口Gemini CLI 通过环境变量或者配置文件指向它就行。第一步打开浏览器进控制台。地址是 https://taotoken.net/console 注册登录之后进 API Keys 页面。这个页面长这样你能看到「创建新密钥」的按钮点一下会生成一串以sk-开头的字符串。复制下来存到一个安全的地方因为页面刷新之后就看不到了。第二步确认 Base URL。TaoToken 的 API 地址是https://taotoken.net/api注意这里不要加任何路径后缀比如/v1之类的Gemini CLI 会自己拼。你只需要把根地址填进去就行。第三步确认你要用的模型 ID。TaoToken 支持多种模型Gemini CLI 默认会请求gemini-2.5-pro或者类似的模型名。你可以在模型对话页面先试一下看看哪个模型 ID 能正常返回。地址是 https://taotoken.net/models 进去之后选一个模型发条消息能收到回复就说明这个模型 ID 可用。把这三样东西凑齐Base URL、API Key、Model ID。后面配置的时候会反复用到。这里有个细节要注意Gemini CLI 读取配置的优先级是「环境变量 配置文件 默认值」。也就是说如果你在 shell 里 export 了GEMINI_API_KEY它会覆盖配置文件里的值。所以改配置的时候要两边都检查别改了一边以为生效了结果被环境变量盖掉。另外如果你之前配过其他工具的 API Key比如 OpenAI 的OPENAI_API_KEY注意别搞混了。Gemini CLI 用的是自己的变量名不是通用的那个。我见过有人把OPENAI_API_KEY设成 TaoToken 的 Key然后跑 Gemini CLI 发现不生效就是因为变量名对不上。准备好之后先别急着改 CLI 的主文件。下一节我会给你两种配置方式一种是用环境变量适合临时测试另一种是写进配置文件适合长期使用。两种都给你可复制的片段。3. 可复制配置环境变量与 settings 片段把 endpoint 指向 TaoToken配置分两步走先设环境变量再写配置文件。环境变量负责告诉 CLI「用哪个 Key、连哪个地址」配置文件负责告诉它「用哪个模型、走什么协议」。先看环境变量。在你的 shell 配置文件里bash 是~/.bashrczsh 是~/.zshrc加上这几行export GEMINI_API_KEYsk-你的TaoToken密钥 export GEMINI_API_BASEhttps://taotoken.net/api export GEMINI_MODELgemini-2.5-pro加完之后执行source ~/.zshrc或者对应的文件让它生效。你可以用echo $GEMINI_API_BASE确认一下有没有设进去。然后是配置文件。Gemini CLI 的配置文件在~/.gemini/settings.json如果没有这个目录就手动建一个mkdir -p ~/.gemini然后写入以下内容{ apiKey: sk-你的TaoToken密钥, baseUrl: https://taotoken.net/api, model: gemini-2.5-pro, temperature: 0.7, maxTokens: 8192 }注意baseUrl这里填的是根地址不要带/v1。Gemini CLI 内部会自己拼接路径你多写了反而会 404。如果你用的是 Windows配置文件路径是C:\Users\你的用户名\.gemini\settings.json内容一样。环境变量则在「系统属性 高级 环境变量」里加或者用 PowerShell$env:GEMINI_API_KEYsk-你的TaoToken密钥 $env:GEMINI_API_BASEhttps://taotoken.net/api设完之后新开一个终端窗口让它生效。这里有个坑要提醒Gemini CLI 有些版本读的是GEMINI_API_BASE有些版本读的是GOOGLE_GEMINI_BASE_URL。如果你设了前者不生效试试后者。我实测下来较新的版本两个都认但老版本只认后者。你可以两个都设上不冲突。还有一个细节如果你之前改过 CLI 的index.js主文件加了 undici 的 ProxyAgent 那几行现在要把它去掉。因为我们已经把 endpoint 换成了能直接访问的地址不需要再走本地代理了。留着反而可能因为代理端口没开导致新的 fetch failed。改完配置之后别急着跑完整对话。先用一个最简单的请求验证一下链路通不通。下一节给你具体的验证命令。4. 验证请求一条命令确认 fetch failed 消失、响应正常返回配置改完最怕的就是「以为生效了其实没有」。所以验证这一步不能省。我给你一个最小化的验证流程跑完就能确认报错有没有消失。第一步确认环境变量读到了echo $GEMINI_API_BASE echo $GEMINI_MODEL输出应该是https://taotoken.net/api和你要用的模型 ID。如果是空的说明 shell 配置文件没 source或者你开的是新窗口但变量没写对地方。第二步直接用 curl 打一下接口确认网络层通curl -s -o /dev/null -w %{http_code} https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的TaoToken密钥如果返回200说明网络链路和 Key 都没问题。如果返回401是 Key 不对返回404是路径拼错了返回000是网络压根没通。这一步能把问题范围缩小到「网络」还是「配置」。第三步跑 Gemini CLI 本身gemini 用一句话介绍你自己如果一切正常你会看到模型返回的文本而不是fetch failed。这时候你可以再跑一个稍微复杂点的gemini 读取当前目录下的 package.json告诉我项目名和版本号这个命令会触发文件读取和模型推理能验证完整链路。我实测下来最常见的验证失败原因是环境变量和配置文件的值不一致。比如环境变量里设了旧的 endpoint配置文件里写了新的CLI 优先读环境变量结果还是走旧地址。所以验证之前先把两边对齐。还有一个情况你改了配置文件但没重启终端。Gemini CLI 每次启动会读一次配置如果你在同一个终端里改完直接跑可能读的还是旧值。保险起见改完配置新开一个终端窗口再验证。如果验证通过了说明 fetch failed 已经解决。但如果你跑的时候又遇到别的报错比如reading choices或者OAuth相关的那是另一类问题下一节我会把常见的几个报错和排查路径都列出来。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth 逐个拆配置过程中最容易撞上的几个报错我按出现频率排一下每个都给你排查路径。401 Unauthorized这个最直接Key 不对或者没带上。检查三件事Key 是不是复制完整了有没有漏掉sk-后面的字符、环境变量和配置文件里的 Key 是不是一致、请求头里有没有正确带上Authorization: Bearer。如果你用的是 curl 验证确认-H那行没写错。local proxy failed这个报错说明 CLI 还在尝试走本地代理。原因通常是你之前改过index.js加了 ProxyAgent或者环境里设了HTTP_PROXY/HTTPS_PROXY变量。排查方法先echo $HTTP_PROXY看看有没有值有就unset掉然后检查index.js有没有残留的 undici 代码有就删掉。我们现在的方案是直连 TaoToken不需要任何本地代理。reading choices这个报错通常出现在响应格式不对的时候。Gemini CLI 期望的是 OpenAI 风格的响应里面有个choices数组。如果 TaoToken 返回的格式不匹配或者你请求的路径不对比如少写了/v1就会读到 undefined。排查方法用 curl 直接打一次看返回的 JSON 结构里有没有choices字段。如果没有检查 base URL 是不是写成了https://taotoken.net/api而不是https://taotoken.net/api/v1——有些版本 CLI 会自己拼/v1有些不会你得试一下哪个能通。OAuth 相关报错Gemini CLI 有些版本会尝试走 Google 的 OAuth 流程报错里会出现OAuth或者authentication字样。这是因为 CLI 默认认为你要连 Google 官方服务。解决办法是在配置里显式指定 API Key 模式或者设一个环境变量GEMINI_AUTH_MODEapi_key。如果还是不行检查你的 CLI 版本老版本可能不支持纯 API Key 模式升级到最新版再试。除了这四个还有一个隐蔽的坑模型 ID 写错了。比如你写了gemini-2.5-pro但 TaoToken 那边实际叫gemini-2.5-pro-latest请求会返回 404 或者模型不存在的错误。排查方法是在模型对话页面确认可用的模型 ID复制粘贴过去别手打。最后提醒一句每次升级 Gemini CLI 之后配置文件可能会被重置环境变量一般不受影响。所以升级完先跑一次验证命令确认配置还在。如果发现又报 fetch failed大概率是配置文件被覆盖了重新写一遍就行。6. 长期稳定调用把配置固化下来后续换模型只改一个字段配置跑通之后接下来要考虑的是怎么让它长期稳定。我自己的做法是把所有可变的部分抽出来集中管理这样换模型或者换 Key 的时候只改一个地方。具体来说环境变量里只放 Key 和 Base URL这两个基本不变。模型 ID 放在配置文件里因为不同任务可能用不同模型。比如日常对话用gemini-2.5-pro跑代码审查用gemini-2.5-flash你可以在配置文件里设一个默认值然后在命令行用--model参数临时覆盖gemini --model gemini-2.5-flash 帮我 review 这段代码这样你不需要每次改配置文件灵活性更高。另外如果你有多台机器或者多个项目建议把配置写进项目的.env文件然后用 direnv 之类的工具自动加载。这样每个项目可以有独立的 API 配置互不干扰。对于需要长期跑 Agent 任务的场景比如让 Gemini CLI 自动处理一批文件建议用 Coding Plan 提供的额度比按次调用更划算。地址是 https://taotoken.net/coding-plan 进去之后能看到不同档位的说明选一个适合你调用量的就行。如果你在配置过程中遇到本文没覆盖的报错可以去接入文档页面查一下里面有针对不同工具和不同报错的详细说明https://taotoken.net/doc 。文档里还给了其他 CLI 工具的配置示例思路是一样的——把 endpoint 指向 TaoToken填上 Key 和模型 ID验证请求能通。最后说一个我踩过的坑有次我换了台机器把配置文件复制过去结果忘了改 Key跑起来一直 401。排查了半天才发现是 Key 还是旧机器的。所以跨机器同步配置的时候Key 那行一定要单独确认。现在我的做法是 Key 只放环境变量配置文件里不写 Key这样复制配置文件不会带出敏感信息也不会因为 Key 过期导致配置失效。