Gemini CLI 安装与配置

Google AI 编程助手，适合超大上下文代码任务。

请先完成「环境准备」章节，确保 Node.js 和 npm 已安装。

Linux / macOS 配置

步骤 1: 安装 Gemini CLI

npm i -g @google/gemini-cli

步骤 2: 配置环境变量

添加到 ~/.bashrc 或 ~/.zshrc：

# 中转站地址：只填写域名，不要追加 /v1beta
export GOOGLE_GEMINI_BASE_URL="https://api.icodeeasy.cc"

# 使用本站 API Key
export GEMINI_API_KEY="你的API Key"

# 推荐快速模型。也可以改为 gemini-3.1-pro-preview 等强模型
export GEMINI_MODEL="gemini-3.5-flash"

# 推荐显式使用 Gemini API v1beta
export GOOGLE_GENAI_API_VERSION="v1beta"

保存后运行 source ~/.bashrc 或 source ~/.zshrc 使配置生效。

注意：GOOGLE_GEMINI_BASE_URL 不要写成 https://api.icodeeasy.cc/v1beta，否则 Gemini CLI 会拼出 /v1beta/v1beta/models/... 导致请求路径错误。 如果 api.icodeeasy.cc 连接慢，可以把 GOOGLE_GEMINI_BASE_URL 换成 https://jp.icodeeasy.cc，同样不要追加 /v1beta。

步骤 3: 启动 Gemini

cd your-project-folder
gemini

Windows 配置

步骤 1: 安装 Gemini CLI

npm i -g @google/gemini-cli

步骤 2: 配置环境变量（PowerShell）

# 中转站地址：只填写域名，不要追加 /v1beta
[Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.icodeeasy.cc", "User")

# 使用本站 API Key
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的API Key", "User")

# 推荐快速模型。也可以改为 gemini-3.1-pro-preview 等强模型
[Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-3.5-flash", "User")

# 推荐显式使用 Gemini API v1beta
[Environment]::SetEnvironmentVariable("GOOGLE_GENAI_API_VERSION", "v1beta", "User")

设置后需要重新打开 PowerShell 才能生效。

如果 api.icodeeasy.cc 连接慢，可以把 GOOGLE_GEMINI_BASE_URL 换成 https://jp.icodeeasy.cc，同样不要追加 /v1beta。

步骤 3: 启动 Gemini

新开一个 PowerShell，进入工程目录并启动：

cd your-project-folder
gemini

模型选择

常用模型：

Gemini CLI 内置的 flash 选项可能会解析到旧的 gemini-3-flash-preview。如果客户端或插件传入 gemini-3-flash，本站会自动映射到 gemini-3-flash-preview。

Raw API 测试示例

如果你想绕过 CLI 直接测试 Gemini 原生接口，可以使用：

curl "https://api.icodeeasy.cc/v1beta/models/gemini-3.5-flash:streamGenerateContent?alt=sse" \
  -H "x-goog-api-key: 你的API Key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "你好，请简单介绍一下你自己"}]
      }
    ]
  }'

非流式接口路径是：

/v1beta/models/{model}:generateContent

流式接口路径是：

/v1beta/models/{model}:streamGenerateContent?alt=sse

常见问题