Skip to Content

Gemini CLI

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

安装

npm install -g @google/gemini-cli

要求 Node.js 版本 >= 18。

环境变量配置

将以下内容添加到 ~/.zshrc（或 ~/.bashrc）：

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

执行生效：

source ~/.zshrc

API Key 可在 AcceleAI 控制台  获取。

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

启动与认证

在终端中启动 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