Gemini CLI 与 Antigravity CLI 常见问题
本页适用于 Gemini CLI 和 Antigravity CLI。
先按报错判断
| 报错 | 优先处理 |
|---|---|
model_not_found / 当前服务暂不支持该模型 | 检查模型名称和令牌分组 |
403 Forbidden | 检查令牌的「模型可用列表」 |
| 配置没生效 | Gemini CLI 查 .env 是否在实际读取目录；Antigravity CLI 查 settings.json 和用户环境变量，并重启终端 |
返回 503：服务暂时不可用
服务暂时不可用，请稍后重试
error.code: get_channel_failed
表示当前模型没有可用通道，属于服务端模型路由暂时不可用，不是 API Key 格式错误。稍后重试；持续出现则联系客服并提供请求时间和 request id。
如果接口返回 model_not_found，说明配置中的模型不属于当前令牌分组：
- 在 模型广场 确认模型支持的 Gemini 分组
- 用同名分组创建令牌 —— 不同 Gemini 分组不能直接混用
- 确认客户端配置里的模型名称与模型广场完全一致
返回 403：该令牌无权访问模型
创建令牌时填写的「模型可用列表」不包含客户端当前请求的模型。
建议在 令牌管理 里留空；必须限制时，填写与报错中完全一致的模型名。
配置没生效
| 客户端 | 检查 |
|---|---|
| Gemini CLI | .env 是否位于实际读取的配置目录；GEMINI_API_KEY 与 GOOGLE_GEMINI_BASE_URL 是否生效 |
| Antigravity CLI | settings.json 与用户环境变量；改完重启终端 |
配置见 Gemini 配置。