Gemini CLI 安装教程（macOS）

0. 前置：安装 Node.js

先装 Node.js（建议 22+）：Nodejs macOS

1. 安装 Gemini CLI

第一步：打开终端（按 Command + 空格，输入 Terminal，按回车）

第二步：执行安装命令（推荐先用这个包）

npm install -g @google/generative-ai-cli

第三步：验证安装

gemini --version

如果提示找不到 gemini 命令，说明包名可能不同，再试下面这个：

npm install -g @google/gemini-cli

然后再验证：

gemini --version

2. 配置 Gemini CLI（接入词元AI）

2.1 配置文件在哪里？

Gemini CLI 的配置目录：~/.gemini/

什么意思？

• ~ 表示你的用户主目录
• 完整路径是：/Users/你的用户名/.gemini/

2.2 创建配置目录

mkdir -p ~/.gemini

2.3 写入环境变量配置文件

创建 .env 文件（注意替换 API Key）：

cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://api.ci-yuan-ai.com
GEMINI_API_KEY=你的词元AI Key
GEMINI_MODEL=gemini-2.5-pro
EOF

必须替换：把 你的词元AI Key 替换成你从词元AI官网复制的真实 Key

如何替换？

1. 复制上面整段命令
2. 把 你的词元AI Key 这几个字替换成你的真实 Key
3. 然后粘贴到终端执行

配置说明：

• GOOGLE_GEMINI_BASE_URL - 词元AI的服务地址
• GEMINI_API_KEY - 你的 API Key
• GEMINI_MODEL - 默认使用的模型（gemini-2.5-pro 是最新版本）

2.4 可选：写入认证配置

让 Gemini CLI 明确使用 API Key 模式：

cat > ~/.gemini/settings.json <<'EOF'
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
EOF

3. 启动并验证

方法一：直接启动交互模式

gemini

方法二：发送一条测试消息

gemini "Hello"

如果能正常回复，说明配置成功了。

常见问题

1. 提示找不到 gemini 命令

原因：包名可能不同，或者安装失败。

解决方法：

1. 尝试安装另一个包：npm install -g @google/gemini-cli
2. 检查 Node.js 是否正确安装：node -v
3. 重启终端

2. API 调用失败

原因：API Key 不正确，或者配置文件格式错误。

解决方法：

1. 检查 .env 文件是否正确创建：cat ~/.gemini/.env
2. 确认 API Key 是否正确（注意不要有多余的空格）
3. 登录词元AI官网检查账户余额