Gemini CLI 部署指南 部署

Google AI 编程助手安装指南

资源	地址
官方文档	geminicli.com/docs

📋 前置要求

请先完成 Node.js 环境安装，确保 Node.js 18+ 已正确安装。

安装 Gemini CLI

npm install -g @google/gemini-cli

验证安装：

gemini --version

配置 CC Code 中转

🖥️ Windows 平台 🖥️ Windows

第一步：创建配置目录

在用户目录下创建 %USERPROFILE%\.gemini\ 文件夹。

第二步：创建 .env 文件

在 .gemini 文件夹中新建 .env 文件：

GOOGLE_GEMINI_BASE_URL=https://ai.cccode.org
GEMINI_API_KEY=您的CC Code Gemini专属密钥
GEMINI_MODEL=gemini-2.5-pro-preview

第三步：创建 settings.json 文件

在 .gemini 文件夹中新建 settings.json 文件：

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

🍏 macOS 平台 🍏 macOS

创建配置目录：

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

创建 .env 文件：

cat > .env << 'EOF'
GOOGLE_GEMINI_BASE_URL=https://ai.cccode.org
GEMINI_API_KEY=您的CC Code Gemini专属密钥
GEMINI_MODEL=gemini-2.5-pro-preview
EOF

创建 settings.json 文件：

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

🐧 Linux 平台 🐧 Linux

与 macOS 步骤相同，在 ~/.gemini/ 目录下创建相应的配置文件。

启动 Gemini CLI

gemini

注意事项

⚠️ 注意

• Gemini 令牌与 Claude Code/CodeX 令牌不通用，请在 CC Code 控制台创建 Gemini 专用令牌
• 切换配置后需要重启 Gemini CLI 才能生效

下一步

• 查看第三方应用
• 查看常见问题