Gemini CLI 部署指南

Gemini CLI 由 Google 提供，基于 Gemini 2.5 Pro 模型。

前提条件

• 已安装 Node.js 18+

快速开始（三步走）

1. 安装 CLI
2. 配置 API Key
3. 开始编程

推荐：使用 CC-Switch 配置

初始设置

首先全局安装 Gemini CLI：

npm install -g @google/gemini-cli

CC-Switch 配置步骤

1. 启动 CC-Switch，导航到 Gemini 标签页
2. 点击橙色 "+" 按钮添加新配置
3. 填写供应商信息：
   • 供应商名称（如 "codekey"）
   • Base URL：https://api.codekey.cc
   • API Key：从 CodeKey 平台获取
   • 模型：gemini-3-pro-preview
   • 可选安全设置
4. 保存配置
5. 启用并激活新配置
6. 系统托盘切换可快速更改配置

提示

• CC-Switch 会自动创建 ~/.gemini/.env 和 settings.json
• 支持多供应商配置
• 配置变更需要重启 CLI

手动命令行配置

Windows

安装：

npm install -g @google/gemini-cli

创建配置目录： %USERPROFILE%\.gemini\

创建 .env 文件：

GOOGLE_GEMINI_BASE_URL=https://api.codekey.cc
GEMINI_API_KEY=your_key_from_codekey.cc
GEMINI_MODEL=gemini-3-pro-preview

创建 settings.json：

{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

启动：

gemini

macOS / Linux

安装：

npm install -g @google/gemini-cli

创建配置文件：

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

cat > .env << 'EOF'
GOOGLE_GEMINI_BASE_URL=https://api.codekey.cc
GEMINI_API_KEY=your_key_from_codekey.cc
GEMINI_MODEL=gemini-3-pro-preview
EOF

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

启动：

gemini

Linux 提示

Linux 下安装使用 sudo npm install -g @google/gemini-cli

主要功能

• 基于上下文的输入描述
• Agent Mode 自主编程
• Google Search 集成实时信息

重要说明

注意

• Gemini API Key 与 Claude Code / CodeX 令牌不同
• 配置变更需要重启 CLI
• 可在 CC-Switch 中进行 API 端点速测试

配置文件位置

操作系统	路径
Windows	%USERPROFILE%\.gemini\
macOS / Linux	~/.gemini/

常见问题

如何获取 API Key？

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

更多帮助

• 常见问题 FAQ
• 售前售后