Skip to content

Gemini(终端) ​

通过环境变量和配置文件在电脑上安装和接入 Gemini CLI。

  • 协议与地址: Google Gemini 协议,GOOGLE_GEMINI_BASE_URL 填 https://aicode.cat/v1beta(要加 /v1beta)。
  • 前置准备: 先到 创建 API Key 拿一把绑定了 Gemini 分组的 Key。下面示例模型用 gemini-3-pro(以 主站控制台 为准)。

macOS / Linux ​

1. 安装 Node.js(需 18+) ​

已经装过 Node.js 18+ 可直接跳到第 2 步。

  • macOS: 先安装 Homebrew(部分海外资源需开启 TUN 代理),再安装 Node.js:

    Bash
    brew install node
    node --version
  • Linux(Debian / Ubuntu):

    Bash
    curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
    sudo apt-get install -y nodejs
    node --version

2. 安装 Gemini CLI ​

Bash
npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com/

安装 Gemini CLI

3. 创建配置文件 ​

把 在这里替换成你的_API_KEY 换成你的 Key,在终端执行:

命令行写入
mkdir -p "$HOME/.gemini"

cat > "$HOME/.gemini/.env" << 'EOF'
GEMINI_API_KEY=在这里替换成你的_API_KEY
GOOGLE_GEMINI_BASE_URL=https://aicode.cat/v1beta
GEMINI_MODEL=gemini-3-pro
EOF

cat > "$HOME/.gemini/settings.json" << 'EOF'
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
EOF
手动:~/.gemini/.env
GEMINI_API_KEY=在这里替换成你的_API_KEY
GOOGLE_GEMINI_BASE_URL=https://aicode.cat/v1beta
GEMINI_MODEL=gemini-3-pro
手动:~/.gemini/settings.json
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

核对配置(只检查变量和地址,不把 Key 打印到终端):

Bash
grep '^GEMINI_API_KEY=' "$HOME/.gemini/.env" | sed 's/=.*/=<已设置>/'
grep -E '^(GOOGLE_GEMINI_BASE_URL|GEMINI_MODEL)=' "$HOME/.gemini/.env"

核对 .env

4. 验证配置 ​

终端中输入 gemini 启动,在对话框里输入「您好!」,能正常回复即配置成功。

Bash
gemini

验证 Gemini 对话

Windows ​

1. 安装 Node.js(需 18+) ​

前往 Node.js 官网 下载安装 LTS 版本,装完在 PowerShell 执行 node --version 确认版本 ≥ 18。

Windows 检查 Node 版本

2. 安装 Gemini CLI ​

按 Win + R 输入 powershell 打开 PowerShell,执行:

PowerShell
npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com/

Windows 安装 Gemini CLI

若提示「在此系统上禁止运行脚本」,以管理员身份运行 PowerShell,执行 Set-ExecutionPolicy Unrestricted 并输入 Y 确认,再重新安装。

3. 创建配置文件 ​

把 在这里替换成你的_API_KEY 换成你的 Key,在 PowerShell 执行:

命令行写入
mkdir "$env:USERPROFILE\.gemini" -Force | Out-Null

$envText = @'
GEMINI_API_KEY=在这里替换成你的_API_KEY
GOOGLE_GEMINI_BASE_URL=https://aicode.cat/v1beta
GEMINI_MODEL=gemini-3-pro
'@
[System.IO.File]::WriteAllText("$env:USERPROFILE\.gemini\.env", $envText, (New-Object System.Text.UTF8Encoding($false)))

$json = @'
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
'@
[System.IO.File]::WriteAllText("$env:USERPROFILE\.gemini\settings.json", $json, (New-Object System.Text.UTF8Encoding($false)))
手动:.env
GEMINI_API_KEY=在这里替换成你的_API_KEY
GOOGLE_GEMINI_BASE_URL=https://aicode.cat/v1beta
GEMINI_MODEL=gemini-3-pro
手动:settings.json
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

手动方式的文件路径:C:\Users\<你的用户名>\.gemini\.env 和 C:\Users\<你的用户名>\.gemini\settings.json。

核对配置:

PowerShell
if (Select-String -Path "$env:USERPROFILE\.gemini\.env" -Pattern '^GEMINI_API_KEY=') { 'GEMINI_API_KEY=<已设置>' }
Select-String -Path "$env:USERPROFILE\.gemini\.env" -Pattern '^(GOOGLE_GEMINI_BASE_URL|GEMINI_MODEL)='

Windows 核对 .env

4. 验证配置 ​

PowerShell 中输入 gemini 启动,在对话框里输入「您好!」,能正常回复即配置成功。

PowerShell
gemini

验证 Gemini 对话

常见问题 ​

手动打开 .gemini 文件夹与防坑提示 ​

  • Windows(CMD): start "" "%USERPROFILE%\.gemini"(用记事本手动新建时,请先在资源管理器「查看」里勾选「文件扩展名」,确保文件名是 .env 和 settings.json,不要变成 .env.txt 或 settings.json.txt)
  • macOS(终端): mkdir -p "$HOME/.gemini" && open "$HOME/.gemini"(访达按 Command + Shift + . 显示隐藏文件)
  • 改完必重启: 每次修改 .env 或 settings.json 后,先按 Ctrl + C 退出当前 gemini,再重新运行才会生效。