跳到主要内容

Gemini CLI 安装教程（Linux）

前置：安装 Node.js​

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

安装 Gemini CLI​

第一步：打开终端

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

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

第三步：验证安装

gemini --version

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

npm install -g @google/gemini-cli

然后再验证：

gemini --version

配置 Gemini CLI（接入Constreet）​

2.1 配置文件在哪里？​

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

什么意思？

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

2.2 创建配置目录​

mkdir -p ~/.gemini

2.3 写入环境变量配置文件​

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

cat > ~/.gemini/.env <<'EOF'GOOGLE_GEMINI_BASE_URL=https://api.constreet.ccGEMINI_API_KEY=你的Constreet KeyGEMINI_MODEL=gemini-2.5-proEOF

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

如何替换？

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

配置说明：

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

2.4 可选：写入认证配置​

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

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

启动并验证​

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

gemini

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

gemini "Hello"

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

常见问题​

提示找不到 gemini 命令​

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

解决方法：

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

API 调用失败​

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

解决方法：

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