Skip to content

Gemini CLI 接入 211API

两个环境变量完成接入:Gemini CLI 的请求经 211API 中转,适合高频、低延迟的轻量调用场景。

准备工作

  • 一个 211API 账号,并在控制台创建好 API Key(sk- 开头)。
  • 本地已安装 Node.js 18 或更高版本。

第一步 · 安装 Gemini CLI

bash
npm install -g @google/gemini-cli

第二步 · 配置环境变量

把 API Key 与接口地址指向 211API。macOS / Linux(bash / zsh):

bash
# 写入 ~/.zshrc 或 ~/.bashrc 可长期生效
export GEMINI_API_KEY="sk-你的-211API-Key"
export GOOGLE_GEMINI_BASE_URL="https://www.211api.com/v1"

Windows(PowerShell):

powershell
$env:GEMINI_API_KEY = "sk-你的-211API-Key"
$env:GOOGLE_GEMINI_BASE_URL = "https://www.211api.com/v1"

# 长期生效(用户级):
# setx GEMINI_API_KEY "sk-你的-211API-Key"

提示

可用模型与具体型号名以 211API 控制台「模型列表」为准;如果工具内支持指定模型,按列表中的名称填写即可。

第三步 · 启动并验证

在项目目录中启动 Gemini CLI,提出一个简单问题确认链路正常:

bash
cd 你的项目目录
gemini

# 会话内输入:
用一句话介绍这个项目的结构

返回正常即完成接入。调用记录、Token 消耗与倍率明细可在 211API 控制台实时查看。

常见问题

仍走官方接口 — 确认 GOOGLE_GEMINI_BASE_URL 已在当前终端会话生效(setx 写入后需重开终端),并检查没有被其他配置文件覆盖。

401 鉴权失败 — 确认 GEMINI_API_KEY 使用的是 211API 控制台创建的 Key,而非 Google AI Studio 的 Key。