跳转至

Gemini CLI 接入 JarlessAPI 指南

本文档介绍如何安装 Google Gemini CLI 并将其配置为通过 JarlessAPI 提供服务。

前置条件

  • 已安装 Node.js 20 或更高版本（可执行 node --version 确认）
  • 已在 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 和 GOOGLE_GEMINI_BASE_URL 两个环境变量确定鉴权密钥与服务地址。建议将这两个变量写入系统配置文件，以确保重启后持续生效。

打开 PowerShell，执行以下命令：

[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的 Gemini CLI 分组 API Key", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://jarlessapi.com", [System.EnvironmentVariableTarget]::User)

配置完成后，关闭并重新打开一个新的 PowerShell 窗口，变量方可生效。

打开终端（Terminal），执行以下命令将变量追加至 Shell 配置文件：

echo 'export GEMINI_API_KEY="你的 Gemini CLI 分组 API Key"' >> ~/.zshrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://jarlessapi.com"' >> ~/.zshrc
source ~/.zshrc

打开终端，执行以下命令将变量追加至 Shell 配置文件：

echo 'export GEMINI_API_KEY="你的 Gemini CLI 分组 API Key"' >> ~/.bashrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://jarlessapi.com"' >> ~/.bashrc
source ~/.bashrc

使用正确分组的密钥

GEMINI_API_KEY 必须填写 Gemini CLI 专属分组的 API Key，不可使用其他客户端分组的密钥，否则请求将返回鉴权错误。

变量名称注意事项

Gemini CLI 使用的环境变量名称（GEMINI_API_KEY、GOOGLE_GEMINI_BASE_URL）与其他客户端不同，请勿与 Claude Code 或 Codex 的变量名混淆。

第三步：启动 Gemini CLI

配置完成后，在终端中执行以下命令启动 Gemini CLI：

gemini

Gemini CLI 将自动读取已配置的环境变量并连接至 JarlessAPI 服务。

验证配置是否生效

若启动后遇到连接或鉴权错误，可执行以下命令检查当前窗口中的服务地址和密钥是否已配置：

if [ -n "$GEMINI_API_KEY" ]; then echo "已配置"; else echo "未配置"; fi
echo $GOOGLE_GEMINI_BASE_URL

-not [string]::IsNullOrWhiteSpace($env:GEMINI_API_KEY)
echo $env:GOOGLE_GEMINI_BASE_URL

密钥检查应显示“已配置”（PowerShell 为 True），地址应与上方一致。若不符，请重新执行 source 命令或重启终端窗口。

更多排错方法，参见 常见错误排查。