主题
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:
Bashbrew install node node --versionLinux(Debian / Ubuntu):
Bashcurl -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/
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"
4. 验证配置
终端中输入 gemini 启动,在对话框里输入「您好!」,能正常回复即配置成功。
Bash
gemini
以下是 Windows
Windows
1. 安装 Node.js(需 18+)
前往 Node.js 官网 下载安装 LTS 版本,装完在 PowerShell 执行 node --version 确认版本 ≥ 18。

2. 安装 Gemini CLI
按 Win + R 输入 powershell 打开 PowerShell,执行:
PowerShell
npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com/
若提示「在此系统上禁止运行脚本」,以管理员身份运行 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)='
4. 验证配置
PowerShell 中输入 gemini 启动,在对话框里输入「您好!」,能正常回复即配置成功。
PowerShell
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,再重新运行才会生效。