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