Gemini CLI - VisionCoder 智能体平台

Gemini CLI 是 Google 官方的命令行 Agent，强在 长上下文（百万 token 级）和多模态输入。VisionCoder 在 /v1beta 路径下完整兼容 Gemini API —— 改 Base URL 和 Key 就能用。

前提

在 API Key 管理创建 API Key
已装 Node.js 18+
Windows 用户：额外装 Git for Windows

安装 Gemini CLI

macOS / Linux
Windows PowerShell
Windows CMD

npm install -g @google/gemini-cli
gemini --version

npm install -g @google/gemini-cli
gemini --version

npm install -g @google/gemini-cli
gemini --version

配置 3 个环境变量

Gemini CLI 通过环境变量读上游、Key、模型：

变量名	值
`GOOGLE_GEMINI_BASE_URL`	`https://coder.api.visioncoder.cn`
`GEMINI_API_KEY`	`YOUR_API_KEY`
`GEMINI_MODEL`	`gemini-2.5-pro`（或其它 Gemini 模型）

macOS / Linux
Windows PowerShell
Windows CMD
Windows 图形界面

追加到 ~/.zshrc（或 ~/.bashrc）：

export GOOGLE_GEMINI_BASE_URL="https://coder.api.visioncoder.cn"
export GEMINI_API_KEY="YOUR_API_KEY"
export GEMINI_MODEL="gemini-2.5-pro"

生效：

source ~/.zshrc

[Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://coder.api.visioncoder.cn", "User")
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "YOUR_API_KEY", "User")
[Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-2.5-pro", "User")

执行完关闭 PowerShell 重开。

setx GOOGLE_GEMINI_BASE_URL "https://coder.api.visioncoder.cn"
setx GEMINI_API_KEY "YOUR_API_KEY"
setx GEMINI_MODEL "gemini-2.5-pro"

执行完关闭 CMD 重开。

Win + R → sysdm.cpl 回车
「高级」→「环境变量」
在「用户变量」里新建上面 3 个
关掉所有终端再开

备用：文件配置

如果环境变量不生效（少数 corporate 环境），可以走配置文件：

位置

macOS / Linux：~/.gemini/settings.json 和 ~/.gemini/.env
Windows：C:\Users\你的用户名\.gemini\ 下

`settings.json`

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

`.env`

GOOGLE_GEMINI_BASE_URL="https://coder.api.visioncoder.cn"
GEMINI_API_KEY="YOUR_API_KEY"
GEMINI_MODEL="gemini-2.5-pro"

创建目录：

macOS / Linux
Windows PowerShell
Windows CMD

mkdir -p ~/.gemini
touch ~/.gemini/settings.json ~/.gemini/.env

New-Item -ItemType Directory -Force "$env:USERPROFILE\.gemini"
notepad "$env:USERPROFILE\.gemini\settings.json"
notepad "$env:USERPROFILE\.gemini\.env"

mkdir "%USERPROFILE%\.gemini"
notepad %USERPROFILE%\.gemini\settings.json
notepad %USERPROFILE%\.gemini\.env

验证

macOS / Linux
Windows PowerShell
Windows CMD

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL
gemini

进入交互后输入：

/auth

看到 Authentication: gemini-api-key 类似输出即成功。

echo $env:GEMINI_API_KEY
echo $env:GOOGLE_GEMINI_BASE_URL
gemini

echo %GEMINI_API_KEY%
echo %GOOGLE_GEMINI_BASE_URL%
gemini

故障排查

进入后还是要走 Google 登录

settings.json 没设 selectedType: "gemini-api-key"，或者 GEMINI_API_KEY 没读到。先 echo $GEMINI_API_KEY 确认有值，再补 settings.json。

模型不识别

Gemini 系列模型由上游 Google 提供，VisionCoder 透传。具体可用模型按 Google 官方为准：

gemini-2.5-pro —— 推荐默认
gemini-2.5-flash —— 快速、便宜
其它请查 Google 官方文档

Gemini 模型不出现在 GET /v1/models 返回里——/v1/models 是 OpenAI 兼容端点，只列 OpenAI/Anthropic/开源模型。Gemini 走独立的 /v1beta 路径。

403 / 鉴权失败

GEMINI_API_KEY 是不是 VisionCoder 的 Key（不是 Google AI Studio 的）
GOOGLE_GEMINI_BASE_URL 是不是 https://coder.api.visioncoder.cn（不带 /v1beta，CLI 会自己拼）

加群 & 客服

​前提

​安装 Gemini CLI

​配置 3 个环境变量

​备用：文件配置

​位置

​settings.json

​.env

​验证

​故障排查

​相关

​加群 & 客服

前提

安装 Gemini CLI

配置 3 个环境变量

备用：文件配置

位置

`settings.json`

`.env`

验证

故障排查

相关

加群 & 客服