Gemini CLI 配置¶

Google AI 编程助手，Gemini 2.5 Pro 驱动。

核心特性：

超大上下文窗口：1M tokens
Agent Mode 自动规划任务
Google Search 实时联网

Windows 完整安装教程：¶

第一步：安装Node.js¶

方法一：使用官方安装包（推荐）

访问 https://nodejs.org
下载 LTS 版本的 Windows Installer (.msi)
运行安装程序，按默认设置完成安装
安装程序会自动添加到 PATH 环境变量

方法二：使用包管理器

使用 Winget（Windows 11 或 Windows 10 自带）：

winget install OpenJS.NodeJS.LTS

使用 Chocolatey：

choco install nodejs-lts

使用 Scoop：

scoop install nodejs-lts

验证安装：

node --version
npm --version

提示： 建议使用 LTS（长期支持）版本以获得最佳稳定性。安装完成后需重启命令行窗口。

第二步：安装 Gemini CLI¶

npm install -g @google/gemini-cli

验证安装：

gemini --version

第三步：获取 API 令牌¶

访问 https://api.rutaceae.com/console/token
点击「添加令牌」
选择有 Gemini 模型的分组（可前往模型广场查看：https://api.rutaceae.com/pricing）
令牌名称：随意填写（如 "Gemini"）
额度建议：设置为无限额度
其他选项保持默认
点击确认，复制生成的令牌

第四步：创建配置文件¶

按 Win + R，输入 %USERPROFILE% 回车
创建 .gemini 文件夹
在文件夹内创建以下两个文件：

.env 文件：

GOOGLE_GEMINI_BASE_URL=https://api.rutaceae.com
GEMINI_API_KEY=sk-xxxxxxxxxxxxxxxx
GEMINI_MODEL=gemini-3-pro-preview

settings.json 文件：

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

⚠️ 重要： 将 .env 文件中的 sk-xxxxxxxxxxxxxxxx 替换为您的令牌！

第五步：启动 Gemini CLI¶

gemini

开始使用 Gemini CLI！🚀

macOS 完整安装教程¶

第一步：安装 Node.js¶

brew install node

第二步：安装 Gemini CLI¶

npm install -g @google/gemini-cli
gemini --version

第三步：获取 API 令牌¶

访问 https://api.rutaceae.com/console/token
点击「添加令牌」
选择有 Gemini 模型的分组（可前往模型广场查看：https://api.rutaceae.com/pricing）
令牌名称：随意填写（如 "Gemini"）
额度建议：设置为无限额度
其他选项保持默认
点击确认，复制生成的令牌

第四步：创建配置文件¶

# 创建配置目录
mkdir -p ~/.gemini

# 创建 .env 文件
cat > ~/.gemini/.env << 'EOF'
GOOGLE_GEMINI_BASE_URL=https://api.rutaceae.com
GEMINI_API_KEY=sk-xxxxxxxxxxxxxxxx
GEMINI_MODEL=gemini-3-pro-preview
EOF

# 创建 settings.json 文件
cat > ~/.gemini/settings.json << 'EOF'
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
EOF

编辑 .env 文件，替换令牌：nano ~/.gemini/.env

第五步：启动 Gemini CLI¶

gemini

Linux 完整安装教程¶

第一步：安装 Node.js¶

Ubuntu / Debian：

sudo apt update
sudo apt install -y nodejs npm

CentOS / Fedora：

sudo dnf install -y nodejs npm

Arch Linux：

sudo pacman -S nodejs npm

第二步：安装 Gemini CLI¶

npm install -g @google/gemini-cli
gemini --version

第三步：获取 API 令牌¶

访问 https://api.rutaceae.com/console/token
点击「添加令牌」
选择有 Gemini 模型的分组（可前往模型广场查看：https://api.rutaceae.com/pricing）
令牌名称：随意填写（如 "Gemini"）
额度建议：设置为无限额度
其他选项保持默认
点击确认，复制生成的令牌

第四步：创建配置文件

# 创建配置目录
mkdir -p ~/.gemini

# 创建 .env 文件
cat > ~/.gemini/.env << 'EOF'
GOOGLE_GEMINI_BASE_URL=https://api.rutaceae.com
GEMINI_API_KEY=sk-xxxxxxxxxxxxxxxx
GEMINI_MODEL=gemini-3-pro-preview
EOF

# 创建 settings.json 文件
cat > ~/.gemini/settings.json << 'EOF'
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
EOF

编辑 .env 文件，替换令牌：nano ~/.gemini/.env

第五步：启动 Gemini CLI

gemini