CQTAI

Gemini 配置（CLI）

通过配置文件把 Gemini CLI 指向 CQT AI 网关，即可使用平台的 Gemini 兼容模型。

💡 小白推荐：用 CC-Switch 图形化配置更省事（见左侧「CC-Switch 配置」）。下面是手动配置方式。

前置条件

  • 已申请 CQT AI 的 APIKey（在控制台「APIKey 管理」创建）。
  • 已安装 Gemini CLI。

第一步：打开配置文件夹

打开你的终端，按系统运行命令打开 Gemini 配置文件夹：

# Windows (CMD)
start "" "%USERPROFILE%\.gemini"

# macOS / Linux
open "$HOME/.gemini"

第二步：创建 .env 文件

在该文件夹手动创建 .env 文件，写入以下内容（把 APIKey 换成你自己的）：

GOOGLE_GEMINI_BASE_URL=https://api.cqtai.com/gemini
GEMINI_API_KEY=你的APIKey

第三步：验证

在终端运行 gemini，对话测试是否配置成功：

gemini

配置字段说明

  • GOOGLE_GEMINI_BASE_URL：CQT AI Gemini 网关地址。
  • GEMINI_API_KEY：你的 APIKey。

常见问题

  • 401 认证失败：检查 GEMINI_API_KEY 是否填对、无多余空格；确认 APIKey 未禁用。
  • 连接失败：确认 GOOGLE_GEMINI_BASE_URL 正确，网络可访问。
  • 配置不生效：确认 .env 在 .gemini 文件夹内，保存后重开终端。