Skip to content

Gemini CLI

Gemini CLI 是 Google 官方的 Gemini 命令行工具。TokOne 支持 Google 协议路由(/v1beta),按下面配置即可使用 Gemini 模型。

安装

bash
npm install -g @google/gemini-cli

验证安装:

bash
gemini --version

配置

Gemini CLI 用两个环境变量:GEMINI_API_KEYGEMINI_BASE_URL

Base URL 是 /v1beta

Google 官方协议的根路径是 /v1beta(不是 /v1),TokOne 同步走这个路径。

bash
export GEMINI_API_KEY="sk-xxx"
export GEMINI_BASE_URL="https://api.tokone.ai/v1beta"
powershell
$env:GEMINI_API_KEY = "sk-xxx"
$env:GEMINI_BASE_URL = "https://api.tokone.ai/v1beta"

要永久生效,写到 ~/.zshrc(macOS)/ ~/.bashrc(Linux)/ Windows 用户级环境变量。

验证

bash
gemini "回复 OK"

能拿到回复 = 配置生效。

常见问题

报 404 但 Key 是对的

Base URL 漏掉了 /v1beta。Google 的协议根路径与 OpenAI 不同,必须显式带上 /v1beta

报 model not found

确认模型 ID 写对(如 gemini-3.5-flash),可用清单见模型清单

报 SSL / 证书错误

确认协议是 https://,不是 http://

下一步