Gemini CLI

Gemini CLI 是 Google 出品的开源 AI 编程 CLI（gemini 命令）。

一、从零安装 Gemini CLI

已安装 Gemini CLI？直接跳到下一节。

macOS 用户通过 Homebrew 安装：

brew install gemini-cli

也可以通过 npm 安装（跨平台通用）：

npm install -g @google/gemini-cli

Windows 用户推荐 npm 方式（需先装 Node.js）。

二、获取 CA API Key

访问 CA 控制台注册账号并创建一个 API Key（格式为 sk-...），复制备用。完整可用模型列表也在 Dashboard 里查看。

三、接入 CA

把下面命令中的 <你的-CA-key> 替换成你刚复制的 key，整段粘贴到终端执行：

mkdir -p ~/.gemini && cat > ~/.gemini/.env << 'EOF'
GOOGLE_GEMINI_BASE_URL=https://caapi.top
GEMINI_API_KEY=sk-<你的-CA-key>
GEMINI_API_KEY_AUTH_MECHANISM=bearer
EOF

保存后无需重启终端或 source，下一次执行 gemini 命令即生效。跑 gemini 命令时会出现「Get started」引导页，问你「How would you like to authenticate for this project?」，提供三个选项：

• ·Sign in with Google
• ·Use Gemini API Key ← 必须选这个
• ·Vertex AI

按键盘 ↓ 键移动到「Use Gemini API Key」，按 Enter 确认。此时 Gemini 会自动读取你已经配置好的 CA API Key，按 Enter 确认即可进入正常使用。

如果此前已经选了 OAuth 模式登录，执行下面命令重置：

rm ~/.gemini/settings.json

删除后下次启动 gemini 会重新跑认证向导，再选「Use Gemini API Key」即可。