Gemini CLI 部署

安装和配置 Gemini CLI，Google AI 编程助手。

Gemini CLI 是 Google 的 AI 编程助手，由 Gemini 2.5 Pro 驱动。

使用 CC-Switch 快速配置（推荐）

Warning

使用 CC-Switch 配置前，请确保已通过 npm 全局安装 Gemini CLI：

npm install -g @google/gemini-cli

推荐使用 CC-Switch 快速配置工具进行图形化配置。

配置步骤

打开 CC-Switch，点击顶部的「Gemini」标签页
点击右上角 ”+” 按钮添加新配置
填写配置信息：
- 提供商名称: 自定义名称
- Base URL: https://ai.nebulatrip.com
- API Key: 您的 Gemini 专用令牌
- Model: gemini-3-pro-preview
点击「保存」，然后启用配置

手动命令行配置

1. 安装 Gemini CLI

npm install -g @google/gemini-cli

2. 创建配置目录

mkdir -p ~/.gemini
cd ~/.gemini

3. 创建 .env 文件

cat > .env << 'EOF'
GOOGLE_GEMINI_BASE_URL=https://ai.nebulatrip.com
GEMINI_API_KEY=your-api-key
GEMINI_MODEL=gemini-3-pro-preview
EOF

4. 创建 settings.json 文件

cat > settings.json << 'EOF'
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
EOF

5. 启动 Gemini CLI

gemini

配置文件位置

Windows: %USERPROFILE%\.gemini\
macOS/Linux: ~/.gemini/

Important Note

确保从平台创建 Gemini CLI 专用令牌
Gemini 令牌与 Claude Code/CodeX 令牌不通用
切换配置后需要重启 Gemini CLI 才能生效

常见问题

API Key 在哪里获取？

登录平台控制台，创建 Gemini CLI 专用令牌。