Gemini CLI 安装配置

Gemini CLI 安装配置

本页总览

💎 Gemini CLI 安装与 4All API 配置指南

Gemini CLI 是 Google 的官方命令行工具，可让您在终端中直接与强大的 Gemini 模型交互。通过以下步骤，您可以将其快速接入 4All API 聚合平台 ，享受极致的 AI 响应速度。

步骤 1：安装 Node.js

💡 提示: 运行 Gemini CLI 依赖 Node.js 环境。如果您之前已经安装过（例如在配置 Claude Code 或 CodeX 时已安装），请直接跳过此步骤。未安装的用户请前往 Node.js 官网下载安装。

步骤 2：安装 Gemini CLI

打开命令行（CMD）或终端（PowerShell / Terminal），执行以下命令进行全局安装：

# Windows 用户请以管理员身份运行
# macOS/Linux 用户可能需要添加 sudo
npm install -g @google/gemini-cli

安装完成后，您可以通过输入 gemini —version 命令来验证是否安装成功。

步骤 3：配置 4All API 聚合节点

1. 获取 API 密钥:

• 访问 [4All API 控制台] https://4All API.com 并登录。
• 创建一个新的令牌（Token），并复制生成的 sk-… 密钥备用。 (注：如果控制台有分组，请选择 Gemini 专用分组以确保最佳兼容性)

2. 创建配置文件: 在您的用户主目录下创建一个名为 .gemini 的隐藏文件夹：

• Windows: %USERPROFILE%.gemini (通常为 C:\Users\您的用户名.gemini )
• macOS/Linux: ~/.gemini

在该文件夹内，新建以下两个文件，并填入对应内容：

📄 文件一：.env (用于配置基础请求地址和密钥)

GOOGLE_GEMINI_BASE_URL=https://sg.4All API.com
GEMINI_API_KEY=sk-请在此处粘贴您从 4All API 获取的真实密钥
GEMINI_MODEL=gemini-3.1-pro

📄 文件二：settings.json (用于开启本地 IDE 增强与安全鉴权配置)

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

⚠️ 重要提示:

• 配置文件中的 GOOGLE_GEMINI_BASE_URL 必须严格填写为 https://sg.4All API.com ，且结尾不要加斜杠。

步骤 4：启动与使用

一切准备就绪！打开终端，使用 cd 命令进入您的项目目录。 运行以下命令即可唤醒助手，开始与 Gemini 3.1 Pro 互动：

gemini

---

Gemini CLI Windows一键启动脚本这份脚本

@echo off
chcp 65001 >nul
setlocal enabledelayedexpansion

echo ========================================
echo     Gemini CLI - 4All API 一键配置工具
echo ========================================
echo.

REM 设置 .gemini 文件夹路径
set "GEMINI_PATH=%USERPROFILE%\.gemini"

REM 创建 .gemini 文件夹
if not exist "%GEMINI_PATH%" (
    mkdir "%GEMINI_PATH%"
    echo [√] 已自动创建文件夹: %GEMINI_PATH%
) else (
    echo [*] 文件夹已存在: %GEMINI_PATH%
)

REM 检查是否已有配置
if exist "%GEMINI_PATH%\.env" (
    echo.
    echo [!] 发现已存在的 .env 配置文件
    set /p "OVERWRITE=是否覆盖更新? (Y/N): "
    if /i not "!OVERWRITE!"=="Y" (
        echo [×] 已取消配置操作
        pause
        exit /b 1
    )
)

REM 创建 .env 文件
(
echo GOOGLE_GEMINI_BASE_URL=https://sg.4All API.com
echo GEMINI_API_KEY=sk-请在此处粘贴您从 4All API 获取的真实密钥
echo GEMINI_MODEL=gemini-2.5-pro
) > "%GEMINI_PATH%\.env"
echo [√] 已生成核心配置文件: %GEMINI_PATH%\.env

REM 创建 settings.json
(
echo {
echo   "ide": {
echo     "enabled": true
echo   },
echo   "security": {
echo     "auth": {
echo       "selectedType": "gemini-api-key"
echo     }
echo   }
echo }
) > "%GEMINI_PATH%\settings.json"
echo [√] 已生成 IDE 增强设置: %GEMINI_PATH%\settings.json

echo.
echo ========================================
echo 🎉 恭喜！配置文件的基础框架已搭建完成！
echo ========================================
echo.
echo 下一步操作：
echo 1. 访问 https://4All API.com 获取您的专属 API 密钥
echo 2. 将密钥填入刚刚生成的 .env 文件中
echo.
echo.

set /p "OPEN=是否现在立即打开 .env 文件进行填写? (Y/N): "
if /i "!OPEN!"=="Y" (
    notepad "%GEMINI_PATH%\.env"
)

echo.
echo 按任意键退出...
pause >nul

Gemini CLI 的 Windows 一键配置脚本这套方案能极大地降低小白用户在你平台上的上手门槛。