Gemini CLI 报错：not available in your location、named user、Request contains an invalid argument 怎么办（2026）
大约 3 分钟GeminiGemini CLIGemini CLI报错GOOGLE_CLOUD_PROJECTUNABLE_TO_GET_ISSUER_CERT_LOCALLY
一句话结论
先确认你还在 Gemini CLI 的支持范围内：2026-06-18 起，个人免费账号和 Google AI Pro / Ultra 已不能用 Gemini CLI（见 Gemini CLI 还能用吗）。在支持范围内的，再按下面的报错对照处理；最常见的坑是 GOOGLE_CLOUD_PROJECT 环境变量设错。
阅读说明
官方信息查阅日期：2026-10-24。来源：google-gemini/gemini-cli 官方文档 Troubleshooting、Authentication。本站不提供任何绕过地区限制的方法。
登录和认证报错
You must be a named user on your organization's Gemini Code Assist Standard edition subscription
You must be a named user on your organization's Gemini Code Assist Standard edition subscription to use this service. Please contact your administrator to request an entitlement to Gemini Code Assist Standard edition.
- 原因：Gemini CLI 检测到
GOOGLE_CLOUD_PROJECT或GOOGLE_CLOUD_PROJECT_ID环境变量，会强制检查组织订阅。 - 个人账号：删除这两个变量，同时检查
.bashrc、.zshrc等 shell 配置文件和.env文件。 - 组织账号：联系 Google Cloud 管理员，把你加进组织的 Gemini Code Assist 订阅。
Failed to sign in … not currently available in your location
Failed to sign in. Message: Your current account is not eligible... because it is not currently available in your location.
- 原因：Gemini CLI 目前不支持你所在的地区。
- 官方处理只有一条：查看 Gemini Code Assist 的官方可用地区列表。本站不提供绕过方法。
Failed to sign in. Message: Request contains an invalid argument
- 原因：Google Workspace 账号，或关联了 Google Cloud 的 Gmail 账号，可能无法开通 Code Assist 免费层。
- 官方建议：Google Cloud 账号可以把
GOOGLE_CLOUD_PROJECT设为你的项目 ID；或者改用 Google AI Studio 的 Gemini API key。注意：个人免费层已于 2026-06-18 停止服务，见 Gemini CLI 还能用吗。
UNABLE_TO_GET_ISSUER_CERT_LOCALLY / unable to get local issuer certificate
- 原因：公司网络的防火墙在拦截检查 SSL/TLS 流量，Node.js 需要信任公司的根证书。
- 处理：先设置
NODE_USE_SYSTEM_CA=1，让 Node.js 使用系统证书库；还不行，再把NODE_EXTRA_CA_CERTS设为公司根证书文件的绝对路径。
其他常见报错
| 报错 | 原因 | 处理 |
|---|---|---|
gemini: command not found | 没装好，或 npm 全局目录不在 PATH | 检查 npm 全局目录是否在 PATH；用 npm install -g @google/gemini-cli@latest 更新 |
EADDRINUSE | MCP 服务器要用的端口被占用 | 停掉占用端口的进程，或给 MCP 服务器换端口 |
Operation not permitted / Permission denied | 开了沙箱，操作超出沙箱允许范围 | 看官方沙箱配置文档调整 |
| 不进入交互模式 | 环境里有 CI_ 开头的变量，被判定为 CI 环境 | 临时去掉变量运行，如 env -u CI_TOKEN gemini |
npm WARN deprecated … | 依赖的旧包提示 | 官方说明无害，可以忽略 |
退出码对照
| 退出码 | 类型 | 含义 |
|---|---|---|
| 41 | FatalAuthenticationError | 认证过程出错 |
| 42 | FatalInputError | 输入无效或缺失（仅非交互模式） |
| 44 | FatalSandboxError | 沙箱环境出错（Docker、Podman、Seatbelt） |
| 52 | FatalConfigError | settings.json 配置无效 |
| 53 | FatalTurnLimitedError | 达到会话最大轮数（仅非交互模式） |
排查技巧
- 加
--debug看详细输出；交互模式下按 F12 打开调试控制台。 /stats model查看本次会话的 token 用量和额度。- 在 CLI 里用
/bug直接提交问题。
相关阅读
参考来源（官方）
- google-gemini/gemini-cli · Troubleshooting guide：https://github.com/google-gemini/gemini-cli/blob/main/docs/resources/troubleshooting.md（查阅日期：2026-10-24）
- google-gemini/gemini-cli · Authentication setup：https://github.com/google-gemini/gemini-cli/blob/main/docs/get-started/authentication.mdx（查阅日期：2026-10-24）
- google-gemini/gemini-cli · Quotas and pricing（/stats model）：https://github.com/google-gemini/gemini-cli/blob/main/docs/resources/quota-and-pricing.md（查阅日期：2026-10-24）