Antigravity CLI 的 model 字段为什么不能照搬 API 模型 ID
如果你已经在 Gemini CLI 或 API 请求里用过 gemini-4-argon，给 Antigravity CLI 配置同一名称却遇到 404，先看当前工具要求怎样填写模型。模型属于同一系列，不代表两个客户端的配置字段和取值格式相同。
AIGoCode 的 Antigravity CLI 接入文档对这处差异有明确说明：切换到 Gemini 4 Argon 时，agy 示例中的模型值是 Gemini 4 Argon (Low)，括号和空格都不能少；写成 gemini-4-argon 会报 404。本文围绕这一配置差异排查，不是对全部 404 原因的归纳，也没有执行真实请求测试。
先确认打开的是 agy，而不是桌面版
官方教程只适用于命令行版 Antigravity CLI，也就是 agy。文档说明桌面版 Antigravity 暂不支持自定义 API Key，不能把命令行教程当成桌面版接入步骤。
先在终端用 agy --version 确认命令能运行。若尚未安装，按官方页对应系统的步骤处理；不要把 Gemini CLI 的安装包或 gemini 启动命令当作 agy 的安装和启动方式。
这条 agy 接入路径只支持 Gemini 协议，并要求 Gemini 分组的 Key。需要 Claude 或 GPT 时，应查对应工具教程，不能从“字段都叫 Key”推断其可交换使用。
检查配置目录，再检查字段结构
两份官方文档给出的配置文件并不相同。以下列出 macOS / Linux 示例中的位置，以及各自的模型配置方式，方便对照文件是否改对。
| 检查项 | Gemini CLI | Antigravity CLI（agy） |
|---|---|---|
| 配置文件 | ~/.gemini/settings.json | ~/.gemini/antigravity-cli/settings.json |
| 模型字段结构 | model.name | 顶层 model |
| 默认模型示例 | gemini-3.8-flash | Gemini 3.8 Flash (Low) |
| 另一项配置差异 | security.auth.selectedType 为 gemini-api-key | modelProvider 为 gemini |
这张表对比的是两份教程的示例，不是两个工具所有配置项的完整列表。Windows 应使用官方 PowerShell 章节给出的目录和写入方法，不要把表中的家目录写法原样搬过去。
尤其要避免只在 Gemini CLI 的文件里改了 model.name，然后期待 agy 的模型自动变化。先找到本工具对应的文件，再检查字段；本文不推断两个工具所有环境变量、配置文件之间的优先级或隔离规则。
官方写入命令会重写 settings.json，并为已有文件生成带时间戳的 .bak 备份。如果原来配置了 MCP 等自定义内容，文档要求只合并示例中的相关字段，避免覆盖整份配置。
切模型时完整保留名称格式
agy 的官方示例将 modelProvider 设为 gemini，model 设为 Gemini 3.8 Flash (Low)。切换 Argon 时，教程要求把后者替换成 Gemini 4 Argon (Low)。
核对时逐项检查：模型名称是否一致、单词之间是否保留空格、括号和括号中的档位是否完整。不要自行把它规范化成小写短横线格式，也不要直接套用 Gemini CLI 的 model.name 结构。
官方页还说明括号中的 Low 可换成 Medium 或 High。本文不提供这些档位的价格或性能测评，也不把文档示例当作账号始终具备对应权限的保证。先按当前文档与实际账号可用范围完成一种配置，再考虑调整。
配置里的环境变量示例使用 GEMINI_API_KEY 和 GOOGLE_GEMINI_BASE_URL，后者填写 https://api.aigocode.dev。这里应核对 agy 教程的取值，不要把完整 API 请求路径当作该项示例地址。真实 Key 只在本地配置，不贴到排错截图或文章评论里。
区分主模型填写错误与后台标题提示
同样出现“不支持模型”的文字，先保留完整模型名，再判断属于哪一种情况。
一类是把 agy 的 Argon 配置写成 gemini-4-argon。官方文档明确将这种填写方式与 404 联系起来，应按上述格式检查主模型值。
另一类是 gemini-3.1-flash-lite-preview is not supported。agy 教程解释，这个小模型用于后台给会话起标题，分组中没有它；文档认为该提示不影响使用，可以忽略。这个结论只适用于文档点名的标题模型提示，不能套到任何未知模型或所有请求失败上。
建议同时记录：报错里出现的模型名、主界面当前模型、是否仍能正常获得回复。这样求助时能说明是“主对话失败”，还是“对话正常但出现标题模型提示”，而不是把它们合称为“模型不能用”。
用界面与用量记录收尾验证
完成配置后，按官方要求关闭并重新打开终端，在自己信任的项目目录运行 agy。首次设置涉及服务条款和目录信任时，阅读内容后由自己决定是否同意、是否信任该目录。
官方默认示例的验证标志是左上角显示 Gemini API key，下方显示 Gemini 3.8 Flash (Low)。先以示例完成一轮核对；切换模型后，也要重新检查实际显示，而不是只看文件已经保存。
发一句简短问候，收到正常回复后，到AIGoCode 控制台的用量记录确认对应模型请求。若出现 Invalid thought signature，官方建议退出并重新运行 agy 开新会话，同一会话不要中途切模型；仍出现则联系客服并提供报错时间。
如果当前错误是 401、403 或 429，应转向对应错误排查。模型字段的格式检查有明确适用场景，不能替代认证、额度或并发问题的处理。