Gemini CLI 能启动，为什么还会走错认证或模型
终端里能看到 Gemini CLI 的界面，不等于它已经用上 AIGoCode 的 Key、服务地址和目标模型。排查时可以把安装、认证、模型选择和用量核对拆成几个检查点，先找出卡在哪一步。
本文依据 AIGoCode 的Gemini CLI 官方接入文档，集中处理“配置写过了，实际运行却不对”的情况。具体安装命令和各系统完整写入命令仍以官方页为准；下面没有执行真实模型调用，也不承诺所有版本表现一致。
第一关：先让版本命令通过
官方要求 Node.js 20 或更高版本，安装包为 @google/gemini-cli。安装完成后，关闭并重新打开终端，用 gemini --version 检查能否显示版本号。
这里先判断的是命令能否运行。如果仍然提示找不到命令，按文档重新打开终端，并用 node -v 核对 Node.js 版本。不要在命令都无法启动时，先去调整 API Key 或模型名称。
文档对 npm warn install-scripts ... @github/keytar 给出了一个很窄的判断条件：仅出现这项警告，而且版本命令能正常输出时，可以继续配置。不要把这个结论扩大成“所有 npm 警告和报错都能忽略”。
Windows 若提示禁止运行 gemini.ps1，官方还提供了 gemini.cmd 入口，例如 gemini.cmd --version。可以先按这一入口验证，不必把“脚本启动受阻”与“API 认证失败”混为一谈。
第二关：把认证字段与地址放在一起核对
AIGoCode 文档说明，这条 Gemini CLI 接入路径只支持 Gemini 协议，需使用 Gemini 分组的 Key。需要 Claude、GPT 时，应查看对应工具的教程，不能根据“一样都是 Key”就推断可互换。
官方示例中的关键配置是：
| 位置 | 文档示例 |
|---|---|
settings.json 的 security.auth.selectedType | gemini-api-key |
settings.json 的 model.name | gemini-3.8-flash |
环境变量 GEMINI_API_KEY | 自己创建的 Gemini 分组 Key |
环境变量 GOOGLE_GEMINI_BASE_URL | https://api.aigocode.dev |
核对时不要把完整的 generateContent 请求 URL 填进这里的地址项。本文表格只是重列该工具官方示例的填写值，不代表所有客户端都使用同一种 Base URL 规则。
如果已有 MCP 等自定义设置，先保留现有文件。官方写入命令会重写 settings.json，并对已有文件创建带时间戳的 .bak 备份；文档明确建议，需要保留自定义设置时，只合并认证和模型字段，不要覆盖整份文件。
按对应系统配置完成后，关闭终端再打开。若仍弹出 Google 登录页，或出现 Invalid auth method selected，官方把它指向配置文件未生效。回到认证配置检查；Windows 手动保存时，文档要求 UTF-8 无 BOM，避免 is not valid JSON。不要只凭环境变量已经写过，就认定文件一定有效。
第三关：认证提示正确后，再看模型是否跑偏
进入自己信任的项目目录启动 gemini。按官方示例，主界面应出现 Authenticated with gemini-api-key，底部状态栏显示配置的 gemini-3.8-flash。把这两处分别看一遍：一个检查认证模式，一个检查模型选择。
若报 404，并明确提示 gemini-3.5-flash-lite 或 gemini-3.1-pro-preview is not supported，文档的对应解释是 CLI 调用了分组里没有的模型。此时先核对配置文件中的模型名，再检查 /model 菜单是否选了 Auto 或其他模型。
当前教程要求使用 gemini-3.8-flash 或 gemini-4-argon，并说明换为后者时要替换配置命令中的模型名。这里转述的是当前教程的选择范围，实际权限与可用性仍需结合账号和当前文档核实；也不能据此把所有 404 都判成相同原因。
第四关：收到回复后，对照控制台记录
先发一句简短问候，确认能正常收到回复，再到AIGoCode 控制台的用量记录，核对是否出现对应模型的请求。这是官方接入验证的一部分，别只凭 CLI 打开成功就结束。
建议自己记下验证时间、状态栏模型和对应记录，方便后续定位；这只是排查记录建议，不是对平台日志字段或统计时延的承诺。截图和求助信息里不要包含完整 Key。
如果出现 Invalid thought signature，官方建议输入 /quit 退出，重新运行 gemini 开一个新会话，并且不要在同一会话中途切换模型。仍出现时，联系客服并提供报错时间。不要将这个处理办法扩大为所有历史会话错误的通用修复。
完成这四关后，才能把“能启动”“认证模式正确”“模型符合配置”“请求在 AIGoCode 侧有记录”连起来看。若实际返回的是 401、403 或 429，则按具体状态码继续排查；本站的认证与额度错误区分可作为后续阅读。