Gemini CLI 安装教程（Linux）

Linux 安装 Gemini CLI 的思路与 macOS 一致：npm 全局安装加上 ~/.gemini/ 下的配置文件。

0. 前置：安装 Node.js

需要 Node.js 22+。以 Ubuntu 为例：

# 通过 NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 或 nvm（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22

验证：

node -v
npm -v

1. 安装 Gemini CLI

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

若提示 EACCES，按照以下方式切到用户级 npm 前缀：

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @google/gemini-cli

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

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 "简要介绍一下 Linux 内核"

返回正常后，在项目目录下直接运行 gemini 即可进入交互会话。

常见问题

gemini: command not found（包名差异）

老教程里有时会写 @google/generative-ai-cli，现在官方包已改为 @google/gemini-cli。如果装错了包请先卸载：

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

API 调用失败

• 401：API Key 错误或分组不是 gemini。
• 连接超时：服务器出站 443 可能被策略拦截，放行后重试。
• 400 模型不存在：GEMINI_MODEL 名称与 AI通道后台「可用模型」列表不一致。

.env 文件未被读取

确认路径是 $HOME/.gemini/.env（文件名前有点号），以及没有多余 BOM。也可以临时用 export 直接注入环境变量测试是否能跑通。

想锁定具体模型不走默认

把 GEMINI_MODEL 改成具体型号，或在交互会话里用 /model 命令切换。