Gemini CLI：版本与协议
Gemini CLI 的「Google 登录」和猫云 API Key 是不同认证路径。官网 API Key 教程主要针对 Google AI Studio，不能仅将 Key 换成猫云就认为连接成功。
社区配置管理器 CC Switch / ccman 有 Gemini CLI 端点配置，涉及 GOOGLE_GEMINI_BASE_URL、GEMINI_API_KEY 与模型选择；但是自定义 Base URL 的生效方式存在版本差异。使用它们之前核对当前 Gemini CLI 版本和配置生成结果。
| 项目 | 核对要求 |
|---|---|
| 认证 | Gemini API Key 模式，不是 Google OAuth / Vertex |
| 协议 | Gemini 原生 generateContent，不是因为模型叫 Gemini 就选 OpenAI |
| 路径 | 本站协议前缀 /v1beta；SDK 是否自动拼接版本需按当前实现核对 |
| 模型 | 当前 Key 分组可调用的 Gemini 协议模型 |
本页不提供未经运行版验证的固定启动命令。若目标仅是使用 Gemini 模型而非必须使用 Gemini CLI，可选能配置对应原生协议的 OpenCode 等客户端。ACP 模式还需单独核对认证和环境继承，不能照搬普通终端的成功结论。
验证与安全
先保存原配置，只合并本页相关字段，不覆盖其他供应商、插件、MCP 和权限设置。密钥不要提交到仓库，配置备份同样需要保护。环境变量必须传入实际运行 Agent 的进程；Remote SSH、容器与本地桌面不是同一个环境。
重新打开客户端并选中猫云模型，发送短消息，到主站「使用记录」核对时间、模型与实扣。随后在隔离项目中只读取一个非敏感文件，检查工具调用、结果回传和最终回答。测试可能产生费用，保留工具审批，不开放自动执行来解决兼容性问题。
本页根据官方供应商配置说明适配，不代表所有模型及本站完整工具链已逐一验收。模型 ID、协议、权限以模型广场和密钥分组为准。错误处理见故障排查。