Gemini CLI 配置教程

安装并配置 Gemini CLI，连接 云策平台调用 Gemini 系列模型。

Gemini CLI 是 Google 官方开源的终端 AI 代理，可在命令行调用 Gemini 完成编码、调试与工作流自动化，适合命令行工作流集成。

平台优势

通过 云策接入 Gemini CLI：专线高速直连、无封号风险、余额永不过期，1 RMB = 1 USD。

前置准备

1. 注册并登录云策：前往 yuncezn.com/register
2. 充值获取额度：前往 yuncezn.com/purchase
3. 获取 API Key：在控制台令牌管理中创建并复制 API Key

第一步：安装 Gemini CLI

通过 npm 全局安装：

npm install -g @google/gemini-cli

验证安装：

gemini --version

环境要求

需要 Node.js ≥ 18。若未安装，请参考 Codex 手动配置 - 安装 Node.js。

第二步：配置环境变量

Gemini CLI 通过 OpenAI 兼容接口接入 yuncezn.com。设置以下环境变量：

macOS / Linux (~/.zshrc 或 ~/.bashrc)

export GEMINI_API_KEY="sk-替换成你的云策密钥"
export OPENAI_BASE_URL="https://yuncezn.com/v1"
export OPENAI_API_KEY="sk-替换成你的云策密钥"

Windows (PowerShell Profile)

$env:GEMINI_API_KEY = "sk-替换成你的云策密钥"
$env:OPENAI_BASE_URL = "https://yuncezn.com/v1"
$env:OPENAI_API_KEY = "sk-替换成你的云策密钥"

写入后重新加载配置：

zsh

source ~/.zshrc

bash

source ~/.bashrc

PowerShell

. $PROFILE

第三步：启动并验证

进入项目目录，启动 Gemini CLI：

cd your-project-folder
gemini

执行只读任务验证：

请只读分析当前项目结构，列出主要目录和入口文件，不要修改任何文件。

可选：配置文件方式

也可在 ~/.gemini/settings.json 中配置：

{
  "model": "gemini-2.0-flash",
  "api": {
    "base_url": "https://yuncezn.com/v1",
    "api_key": "sk-替换成你的云策密钥"
  }
}

故障排查

问题现象	解决方案
command not found: gemini	npm 全局路径未加入 PATH
401 unauthorized	检查 API Key 是否完整
404 model not found	确认 OPENAI_BASE_URL 带了 /v1 后缀
模型名错误	使用控制台列出的可用模型名

更多问题请参考 常见问题。