Gemini CLI

1. 准备 API Key 和模型

1. 1在 API Key 页面创建或复制密钥。
2. 2在模型定价页复制一个支持 Gemini 原生接口的准确模型 ID。
3. 3确保 Gemini CLI 为较新版本，自定义 Base URL 是当前版本的正式配置项。

2. 使用 CC Switch 一键导入

1. 1安装并打开 CC Switch。
2. 2在 API Key 页打开密钥操作菜单，选择 CC Switch 导入。
3. 3客户端选择 Gemini，再选择支持 Gemini 接口的模型。
4. 4保留服务根地址 https://ikun.love，不要添加 /v1 或 /v1beta。
5. 5保存并启用服务商，完全退出并重新打开 Gemini CLI。

3. 手动配置

3.1 推荐：写入 Gemini CLI 的用户 .env

GEMINI_API_KEY=此处替换为 API Key
GOOGLE_GEMINI_BASE_URL=https://ikun.love
GEMINI_MODEL=此处替换为准确的模型 ID

Gemini CLI 从当前目录向上查找 .env，再读取用户级 ~/.gemini/.env，并使用找到的第一份环境文件，而不是合并所有文件。 如果项目目录已有 .env，请确认它没有覆盖或遗漏上述变量。

3.2 临时测试：设置当前终端环境变量

export GEMINI_API_KEY="此处替换为 API Key"
export GOOGLE_GEMINI_BASE_URL="https://ikun.love"
export GEMINI_MODEL="此处替换为准确的模型 ID"

$env:GEMINI_API_KEY = "此处替换为 API Key"
$env:GOOGLE_GEMINI_BASE_URL = "https://ikun.love"
$env:GEMINI_MODEL = "此处替换为准确的模型 ID"

3.3 Base URL 和认证头说明

• GOOGLE_GEMINI_BASE_URL 使用服务根地址，不带 /v1 或 /v1beta；Google Gen AI SDK 会自行拼接 API 版本和模型路径。
• 默认按 Gemini 原生方式发送 x-goog-api-key。
• 只有网关明确要求 Authorization: Bearer 时，才额外设置下面的认证机制。

GEMINI_API_KEY_AUTH_MECHANISM=bearer

不要在没有认证错误的情况下随意切换认证头。

4. 启动并验证

1. 1运行 gemini。
2. 2首次提示认证方式时选择 Use Gemini API key，不要选择 Google 登录或 Vertex AI。
3. 3发送一个简短提示并等待完整响应。
4. 4打开使用日志，确认请求使用预期的 Gemini 模型。

gemini --model "此处替换为准确的模型 ID"

模型选择优先级为：--model、GEMINI_MODEL、settings.json 中的 model.name、默认模型。

5. 常见问题

6. 官方参考

• Gemini CLI 认证设置
• Gemini CLI 配置参考
• Gemini CLI 模型路由
• Gemini CLI 官方仓库