logo

Gemini CLI 配置指南

安装步骤

1. 安装 Node.js

访问 Node.js 官网，建议下载左侧的 LTS 版本，它是长期支持版，更加稳定。

2. 安装 Git

访问 Git 官网，页面会自动推荐适合你操作系统的版本，点击按钮即可下载。

3. 安装 Gemini CLI

打开 cmd 命令行，通过 npm 安装 gemini-cli：

npm install -g @google/gemini-cli

配置步骤

配置 (.env)

创建配置文件 (Windows: %USERPROFILE%\.gemini\.env, Mac/Linux: ~/.gemini/.env)

GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=<LLMOXY_API_KEY>
GEMINI_MODEL=gemini-2.5-pro

注意：API Key 请使用 Gemini/Vertex 分组的令牌。

启动

gemini

详细配置步骤

1. 安装 Gemini CLI

打开 PowerShell，运行：

npm install -g @google/generative-ai-cli

验证安装：

gemini --version

如果提示找不到 gemini命令，尝试替代包名：

npm install -g @google/gemini-cli

打开终端（按 Command + Space，输入 Terminal，回车），运行：

npm install -g @google/generative-ai-cli

验证安装：

gemini --version

如果提示找不到 gemini命令，尝试替代包名：

npm install -g @google/gemini-cli

打开终端，运行：

npm install -g @google/generative-ai-cli

验证安装：

gemini --version

如果提示找不到 gemini命令，尝试替代包名：

npm install -g @google/gemini-cli

2. 配置 Gemini CLI（接入 LLMoxy）

Gemini CLI 使用自己的配置目录，不需要编辑 Shell 配置文件。

创建配置目录

mkdir -Force "$env:USERPROFILE\.gemini"

写入环境变量配置文件

创建 .env文件（请替换 API Key）：

@"
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=你的LLMoxy API Key
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.gemini\.env"

可选：写入认证配置

@"
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.gemini\settings.json"

配置目录位于 %USERPROFILE%\.gemini\（通常是 C:\Users\你的用户名\.gemini\）。

创建配置目录

mkdir -p ~/.gemini

写入环境变量配置文件

创建 .env文件（请替换 API Key）：

cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=你的LLMoxy API Key
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
EOF

可选：写入认证配置

cat > ~/.gemini/settings.json <<'EOF'
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}
EOF

配置目录位于 ~/.gemini/（即 /Users/你的用户名/.gemini/）。

创建配置目录

mkdir -p ~/.gemini

写入环境变量配置文件

创建 .env文件（请替换 API Key）：

cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=你的LLMoxy API Key
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
EOF

可选：写入认证配置

cat > ~/.gemini/settings.json <<'EOF'
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}
EOF

你 必须 将 你的LLMoxy API Key替换为从 LLMoxy 控制台 复制的真实 Key。

配置项说明：

  • GOOGLE_GEMINI_BASE_URL — LLMoxy 网关地址
  • GEMINI_API_KEY — 你的 API Key
  • GEMINI_MODEL — 默认模型（gemini-3.1-flash-image-preview-1 为最新旗舰）

常见问题

npm install -g提示权限错误

以管理员身份运行 PowerShell，然后重试。

通过 Homebrew 重新安装 Node.js，Homebrew 安装的不需要 sudo 权限。

使用 nvm 管理 Node.js（推荐），或修改 npm 全局目录： npm config set prefix ~/.npm-global，然后将 ~/.npm-global/bin加入 PATH。

提示 "gemini command not found"

  • 尝试替代包： npm install -g @google/gemini-cli
  • 确认 Node.js 已安装： node -v
  • 重启终端

API 调用失败

  • 检查配置文件内容是否正确
  • 确认 API Key 没有多余的空格
  • 到 LLMoxy 控制台 检查账户余额

远程服务器连接问题（Linux）

  • 检查网络： curl -I https://llmoxy.com
  • 如需代理，在 .env 中添加： HTTPS_PROXY=http://your-proxy:port
CC Switch 配置教程
CodeX CLI 配置指南