Skip to Content

Gemini CLI

Gemini CLI 是 Google 推出的命令行 AI 助手，基于 Gemini 模型提供代码生成、分析和对话能力。通过 AcceleAI 接入，你可以直接在终端中使用 Gemini 系列模型。

安装

npm install -g @google/gemini-cli

要求 Node.js 版本 >= 18。

环境变量配置

macOS / Linux

1. 打开终端，用 nano 编辑 ~/.zshrc：

nano ~/.zshrc

2. 在文件末尾粘贴以下内容：

export GOOGLE_GEMINI_BASE_URL="https://api.acceleai.cn/gemini"
export GEMINI_API_KEY="<ACCELE_AI_API_KEY>"

3. 保存并退出 nano：

  • Ctrl + O — 写入文件，按 Enter 确认
  • Ctrl + X — 退出 nano

4. 使配置立即生效：

source ~/.zshrc

提示：macOS 下如果找不到 .zshrc 文件，可以在 Finder 中按 Cmd + Shift + . 显示隐藏文件。

Windows

打开 PowerShell，设置用户级环境变量：

[Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.acceleai.cn/gemini", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "<ACCELE_AI_API_KEY>", [EnvironmentVariableTarget]::User)

设置完成后重新打开终端窗口使变量生效。

API Key 可在 AcceleAI 控制台  获取。

启动与认证

在终端中启动 Gemini CLI：

gemini

首次启动后，输入认证命令：

/auth

在弹出的认证方式选择中，选择 Gemini API Key (AI Studio)，即可通过 AcceleAI 提供的 Key 完成认证。

后续如需切换认证方式，随时可以再次执行 /auth 命令。

常见问题

无法连接或超时

  1. 确认 GOOGLE_GEMINI_BASE_URL 设置正确，值为 https://api.acceleai.cn/gemini
  2. 检查 GEMINI_API_KEY 是否有效
  3. 确认终端已执行 source ~/.zshrc 使配置生效

认证方式说明

Gemini CLI 提供三种认证方式：

  • Google Login — Google 账号登录
  • Gemini API Key (AI Studio) — 使用 AcceleAI 时选择此项
  • Vertex AI — Google Cloud 企业认证

通过 AcceleAI 使用时，请始终选择 Gemini API Key (AI Studio)。

Codex CLIOpenClaw