Gemini CLI 接入 JarlessAPI 指南¶
本文档介绍如何安装 Google Gemini CLI 并将其配置为通过 JarlessAPI 提供服务。
前置条件¶
- 已安装 Node.js（建议版本 18 及以上）
- 已在 JarlessAPI 控制台获取 Gemini CLI 分组对应的 API Key（参见 获取 API Key）
第一步：安装 Gemini CLI¶
在终端中执行以下命令，全局安装 Gemini CLI：
npm install -g @google/gemini-cli
sudo npm install -g @google/gemini-cli
npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com
安装完成后，执行以下命令验证安装是否成功：
gemini --version
若终端输出版本号，则安装成功。
第二步：配置环境变量¶
Gemini CLI 通过 GEMINI_API_KEY 和 GEMINI_API_BASE_URL 两个环境变量确定鉴权密钥与服务地址。建议将这两个变量写入系统配置文件，以确保重启后持续生效。
以管理员身份打开 PowerShell（按 Win + X，选择"终端管理员"），执行以下命令：
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的 Gemini CLI 分组 API Key", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_BASE_URL", "https://jarlessapi.com", [System.EnvironmentVariableTarget]::User)
配置完成后，关闭并重新打开一个新的 PowerShell 窗口，变量方可生效。
打开终端（Terminal），执行以下命令将变量追加至 Shell 配置文件：
echo 'export GEMINI_API_KEY="你的 Gemini CLI 分组 API Key"' >> ~/.zshrc
echo 'export GEMINI_API_BASE_URL="https://jarlessapi.com"' >> ~/.zshrc
source ~/.zshrc
打开终端，执行以下命令将变量追加至 Shell 配置文件：
echo 'export GEMINI_API_KEY="你的 Gemini CLI 分组 API Key"' >> ~/.bashrc
echo 'export GEMINI_API_BASE_URL="https://jarlessapi.com"' >> ~/.bashrc
source ~/.bashrc
使用正确分组的密钥
GEMINI_API_KEY 必须填写 Gemini CLI 专属分组的 API Key，不可使用其他客户端分组的密钥，否则请求将返回鉴权错误。
变量名称注意事项
Gemini CLI 使用的环境变量名称（GEMINI_API_KEY、GEMINI_API_BASE_URL）与其他客户端不同，请勿与 Claude Code 或 Codex 的变量名混淆。
第三步：启动 Gemini CLI¶
配置完成后，在终端中执行以下命令启动 Gemini CLI：
gemini
Gemini CLI 将自动读取已配置的环境变量并连接至 JarlessAPI 服务。
验证配置是否生效¶
若启动后遇到连接或鉴权错误，可执行以下命令确认当前终端窗口中的环境变量值：
echo $GEMINI_API_KEY
echo $GEMINI_API_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_API_BASE_URL
若输出为空或显示旧值，说明当前窗口未加载最新配置，请重新执行 source 命令或重启终端窗口。
更多排错方法，参见 常见错误排查。