Gemini CLI 接入教程

本教程用于说明如何在 Gemini CLI 或兼容环境中接入 Msairelay。

接入前准备

• 一个可用 API Key
• 正确的 Base URL
• 模型名称
• 可运行的 Gemini CLI 环境

接入本质

Gemini CLI 接入 Msairelay，本质上是将原本指向默认服务的调用配置替换为 Msairelay 提供的兼容接口。

标准流程

1. 获取 API Key
2. 确认 Base URL
3. 找到 Gemini CLI 的服务端点配置项
4. 配置认证信息
5. 填写模型名称
6. 执行一次测试命令

如何判断是否成功

• CLI 能发出请求
• 服务端返回正常结果
• 没有鉴权报错
• 没有模型不存在报错

常见问题

1. CLI 无法连接 优先检查： - Base URL 是否正确 - 是否存在路径错误 - 网络是否正常

2. 鉴权失败 优先检查： - API Key 是否正确 - 环境变量或配置文件是否生效

3. 模型不可用 优先检查： - 模型名拼写 - 当前账户支持范围

后续建议补充

• Gemini CLI 环境变量示例
• 配置文件示例
• 不同系统下的命令示例