Gemini CLI安装404错误源于npm认证失效、代理拦截或缓存错乱，需依次验证npm登录状态、清除缓存、切换至npm官方源安装，并检查Node.js版本兼容性及网络代理配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Gemini CLI安装时提示404错误，不是网络打不开Google，而是npm在GitHub代码加载服务上找不到指定提交的压缩包——认证失效、代理拦截或缓存错乱，三者中任一出问题都会让npx或npm install卡在下载环节。
确认是否真被404卡住
执行 npx https://github.com/google-gemini/gemini-cli 后，如果终端输出类似 404 Not Found - GET https://codeload.github.com/google-gemini/gemini-cli/tar.gz/368e9ab4d8aa075c6f50fa95b787e6c81c4d201f 的报错，说明问题定位准确。
此时不要重试 npm install -g，先停手——重复执行只会加深缓存污染。
检查 npm 登录与认证状态
方法一：验证当前登录用户
运行 npm whoami。若返回 Not logged in 或报错 ENEEDAUTH，说明 npm 未登录或 token 已过期。
方法二：强制重新登录
执行 npm login，按提示输入 npm 账号、密码和邮箱。注意：即使你从不发布包，【npx 从 GitHub 安装私有仓库时也依赖 npm 的认证凭据】。
登录成功后，再运行 npm config get registry，确保输出是 https://registry.npmjs.org/，而非企业内网镜像或错误配置的私有源。
清除缓存并绕过 GitHub 下载路径
第一步：清空 npm 缓存
npm cache clean --force
第二步：改用 npm install 全局安装（避开 npx 的 GitHub 直链逻辑）
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
这一步跳过所有 GitHub codeload 请求，直接走 npm 官方包仓库：npm install -g @google/gemini-cli。
第三步：若仍失败，检查是否误配了 .npmrc 中的 registry 或 authToken 字段。临时重命名该文件：ren %USERPROFILE%\.npmrc .npmrc.bak（Windows）或 mv ~/.npmrc ~/.npmrc.bak（macOS/Linux），再重试安装。
排查网络代理与企业防火墙
① 运行 npm config list，重点查看 proxy 和 https-proxy 是否非空。若存在且你不在企业网络中，说明代理残留。
② 清除代理设置：npm config delete proxy && npm config delete https-proxy。
③ 测试能否直连 GitHub codeload：curl -I https://codeload.github.com（macOS/Linux）或 Invoke-WebRequest -Uri "https://codeload.github.com" -Method Head（PowerShell）。若返回 403 或超时，说明网络层被拦截，需切换网络或联系 IT 部门放行 codeload.github.com 域名。
注意：某些云开发环境（如 GitHub Codespaces、Gitpod）默认禁用外部 codeload 访问，必须启用「Allow unrestricted network access」策略才能通过 npx 安装。
验证 Node.js 版本与 undici 兼容性
执行 node -v 和 npm -v。若 node 版本为 v20.13.1 或 v22.8.0，【必须升级到 v20.18.1+ 或 v22.9.0+】，否则 undici 库会因 TLS 握手失败触发 404 类似错误（实际是底层请求被静默丢弃，npm 误报为 404）。
升级方式（推荐 NVM）：
Windows 用户运行：nvm install 20.19.0 && nvm use 20.19.0；
macOS/Linux 用户运行：nvm install 22.9.0 && nvm use 22.9.0。
升级完成后，再次执行 node -v 确认输出为 v20.19.0 或 v22.9.0，再进行安装。
