Gemini CLI 配置

Gemini CLI 是 Google 官方的 Gemini 模型命令行客户端，本节介绍如何接入 HuiLiu API。

前置条件

1. 已完成 环境检查 并安装好 Gemini CLI
2. 已在控制台创建 Gemini 分组 的令牌

配置方法

环境变量

Linux / macOS

export GOOGLE_GEMINI_BASE_URL="https://www.huiliuapi.com/gemini"
export GEMINI_API_KEY="sk-你的令牌"

Windows PowerShell

[Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://www.huiliuapi.com/gemini", "User")
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "sk-你的令牌", "User")

项目级配置（可选）

在项目根目录创建 .gemini/settings.json：

{
  "selectedAuthType": "gemini-api-key",
  "apiKey": "sk-你的令牌",
  "endpoint": "https://www.huiliuapi.com/gemini"
}

启动 Gemini CLI

cd your-project
gemini

推荐模型

模型	说明
gemini-2.5-pro	首选，旗舰模型
gemini-2.5-flash	高速版，低延迟

切换模型：使用 /model 命令或启动时加参数：

gemini --model gemini-2.5-pro

常见命令

命令	说明
/help	查看帮助
/model	切换模型
/clear	清屏
/exit	退出

验证配置

gemini
# 输入：解释一下量子纠缠

正常返回内容即说明配置成功。

注意事项

1. 不要使用 Google 官方 OAuth 登录，否则会绕过 HuiLiu API
2. 如果之前用 OAuth 登录过，请删除 ~/.gemini/oauth_creds.json 后重试
3. 确认 selectedAuthType 是 gemini-api-key，不是 oauth-personal

更多排错请见 Gemini 常见问题。