Gemini CLI

推荐：通过 CC Switch 导入

1. 在云筑Hub API Key 页面选择 Import to CC Switch。
2. 应用选择 Gemini。
3. 选择当前可用的主模型。
4. 确认 Endpoint 为 https://www.yunzhuhub.cn。
5. 启用配置，完全退出 Gemini CLI 后重新打开。

验收

• CLI 能发送最小文本请求；
• 控制台日志显示选择的模型；
• 没有把 OpenAI 格式路径误填到 Gemini 原生入口；
• 客户端输出中没有打印完整 API Key。

手工配置

Gemini CLI 官方配置参考确认，使用 Gemini API Key 认证时，GEMINI_API_KEY 提供密钥，GOOGLE_GEMINI_BASE_URL 覆盖 Gemini API 的默认入口。

PowerShell

$env:GEMINI_API_KEY="<YOUR_API_KEY>"
$env:GOOGLE_GEMINI_BASE_URL="https://www.yunzhuhub.cn"
gemini

macOS / Linux

export GEMINI_API_KEY="<YOUR_API_KEY>"
export GOOGLE_GEMINI_BASE_URL="https://www.yunzhuhub.cn"
gemini

首次启动时选择 Use Gemini API Key。云筑Hub可从 x-goog-api-key 读取密钥，不需要将它写入项目配置。

官方来源与最后核验日期见官方核验记录。