在 Gemini CLI 中使用

Gemini CLI 是 Google 官方的命令行编码助手。本网关提供 Gemini 原生 /v1beta 协议入口，把请求地址指过来即可。

前置要求

• Node.js 20+
• 已经在网关后台拿到 API Token（参考 快速开始）

1. 安装 Gemini CLI

npm install -g @google/gemini-cli

或 Homebrew：

brew install gemini-cli

验证：

gemini --version

2. 配置网关

Gemini CLI 通过环境变量决定请求地址和密钥：

export GEMINI_API_KEY="sk-你的Token"
export GOOGLE_GEMINI_BASE_URL="https://api.geoq.help"

写进 ~/.zshrc / ~/.bashrc：

cat >> ~/.zshrc <<'EOF'
export GEMINI_API_KEY="sk-你的Token"
export GOOGLE_GEMINI_BASE_URL="https://api.geoq.help"
EOF
source ~/.zshrc

网关已经把 /v1beta/models/{model}:generateContent 路由实现成 Gemini 原生格式，所以 GOOGLE_GEMINI_BASE_URL 只填到域名根，不要带 /v1beta。

3. 选择模型

启动：

gemini

进入后输入 /model 切换模型，常用：

• gemini-2.5-pro
• gemini-2.5-flash
• gemini-2.0-flash

或一行启动直接指定：

gemini --model gemini-2.5-pro

4. 验证

> 列出当前目录的 ts 文件并解释每个文件的作用

正常返回响应 + 后台 日志 页面看到调用记录，就接通了。

5. 常见问题

报错：API key not valid

• GEMINI_API_KEY 没生效：echo $GEMINI_API_KEY 自查
• 用了 Google AI Studio 的 Key：必须用网关后台生成的 sk- 开头 Token

报错：model not found / 404 当前分组没绑该 Gemini 模型。后台 模型 页面确认实际可用列表。

Gemini CLI 仍然走 generativelanguage.googleapis.com 说明 GOOGLE_GEMINI_BASE_URL 没读到。某些版本的 Gemini CLI 用 GOOGLE_GENAI_API_BASE 这个变量，可以两个都设：

export GOOGLE_GEMINI_BASE_URL="https://api.geoq.help"
export GOOGLE_GENAI_API_BASE="https://api.geoq.help"

只想偶尔用网关 不要写进 ~/.zshrc，临时跑一次：

GEMINI_API_KEY=sk-xxx GOOGLE_GEMINI_BASE_URL=https://api.geoq.help gemini

进阶

• 配合 direnv 按目录切不同 Token
• 多模态：gemini -p "看下这张图" -i ./screenshot.png，网关会把图片 base64 透传到 Gemini