Gemini CLI 安装教程（macOS）

本文介绍在 macOS 上安装 Gemini CLI 并接入 AI通道的步骤。

0. 前置：安装 Node.js

Gemini CLI 需要 Node.js 22+。推荐：

# Homebrew
brew install node

# 或官网安装包
# https://nodejs.org/

验证：

node -v
npm -v

1. 安装 Gemini CLI

npm install -g @google/gemini-cli
gemini --version

如出现 EACCES，建议改用 nvm/fnm 管理 Node，避免对系统目录写入。

2. 配置 Gemini CLI 接入 AI通道

2.1 配置文件在哪里

• ~/.gemini/.env
• ~/.gemini/settings.json（可选）

2.2 创建配置目录

mkdir -p ~/.gemini

2.3 写入 .env

cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://aitongdao.com
GEMINI_API_KEY=sk-你的密钥
GEMINI_MODEL=gemini-2.5-pro
EOF

把 sk-你的密钥 替换为在 aitongdao.com 创建的令牌（分组选 gemini）。注意 GOOGLE_GEMINI_BASE_URL 没有 /v1。

2.4 可选：写入 settings.json

cat > ~/.gemini/settings.json <<'EOF'
{
  "theme": "Default",
  "selectedAuthType": "gemini-api-key"
}
EOF

2.5 验证配置

ls -la ~/.gemini
cat ~/.gemini/.env

3. 启动并验证

gemini --version
gemini "你好，做个自我介绍"

能看到模型回复就说明配置生效。后续进入项目目录执行 gemini 即进入交互模式。

常见问题

找不到 gemini 命令

查 npm 全局前缀：npm prefix -g，把 <前缀>/bin 加入 ~/.zshrc 的 PATH，source ~/.zshrc 后重试。

API 调用失败（401）

确认密钥与分组：Key 完整复制，且分组是 gemini。也可用 curl 直接测试：

curl "https://ai.aitongdao.com/v1beta/models/gemini-2.5-pro:generateContent?key=sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"ping"}]}]}'

模型返回乱码或空响应

检查 .env 中 GEMINI_MODEL 是否是后台「可用模型」列表中的名称。拼写错误会触发降级或空返回。

想同时使用 Gemini 和 OpenAI 工具

两边互不干扰：Gemini CLI 只读 ~/.gemini/，Codex 只读 ~/.codex/。分别配置即可。