安装 Gemini CLI
Gemini CLI 是 Google 官方开源终端工具，通常要求 Node.js 20 或更高版本。请以官方仓库的当前要求为准。
npm install -g @google/gemini-cli先确认协议兼容性
Gemini CLI 原生认证和端点配置可能随版本变化。是否能够直接使用自定义 OpenAI 兼容接口，应以 Gemini CLI 当前官方能力为准；不要把普通 Gemini API Key 与 Api Halo 令牌混用。
如当前版本只支持 Google 官方认证，不应强行套用 OpenAI Base URL。可改用支持 OpenAI Compatible 的客户端调用 Api Halo 中已上架的 Gemini 模型。
调用 Gemini 模型的稳妥方式
兼容 Base URL：
API Key：Api Halo 令牌
模型：从模型广场复制当前 Gemini 模型名
https://apihalo.cn/v1API Key：Api Halo 令牌
模型：从模型广场复制当前 Gemini 模型名
使用支持自定义 OpenAI 地址的 SDK、Chatbox、Cherry Studio、OpenClaw 或其他客户端，可以通过 Api Halo 调用当前上架的 Gemini 模型。
验证原则
- 确认客户端确实支持自定义兼容端点。
- 核对模型名称和令牌分组。
- 执行最小请求。
- 在控制台日志确认成功状态。
常见问题
为什么不直接给出 Gemini CLI 的 Api Halo 配置文件？
因为官方工具的认证与自定义端点能力可能变化，未经确认写固定配置容易误导。应优先遵循当前官方文档。
能否调用 Gemini 模型？
可以通过支持 OpenAI Compatible 的工具调用模型广场当前上架的 Gemini 模型。
配套在线工具
按本教程确认安装方式后，带入对应软件生成配置，再执行一次最小连接测试。