For the complete documentation index, see llms.txt. This page is also available as Markdown.

Gemini CLI

Gemini CLI 是一款通过命令行界面与 Gemini 模型进行交互的工具。

你可以查看 帮助文档 了解更多详情。

安装 Gemini CLI

使用 npm 全局安装 Gemini CLI:

npm install -g @google/gemini-cli

安装完成后,你可以在终端中直接使用 gemini 命令。

配置

Gemini CLI 通过环境变量读取配置信息。

步骤 1:打开(或创建)环境变量文件

vim ~/.env

步骤 2:添加以下配置

# 通过 AI 网关路由的 Gemini 请求基础 URL
GOOGLE_GEMINI_BASE_URL=https://gateway.theturbo.ai

# 您的 AI 网关 / AI 网关 API 密钥
GEMINI_API_KEY=YOUR_API_KEY

# 默认使用的 Gemini 模型
GEMINI_MODEL=gemini-2.5-flash

请将 YOUR_API_KEY 替换为创建 AI 网关实例后生成的 API 密钥。

使用 Gemini CLI

完成配置后,运行以下命令启动 Gemini CLI:

此后,Gemini CLI 将通过 AI 网关发送所有请求,从而实现对 Gemini 模型的统一身份认证与集中化管理。

注意

  • 请确保当前 shell 会话已加载上述环境变量。

  • 你可以通过修改 GEMINI_MODEL 的值来更换默认模型。

  • 请妥善保管你的 API 密钥,避免将其提交到代码仓库中。

最后更新于