使用 CometAPI 配置 Gemini CLI

使用本指南通过 Gemini CLI 将 CometAPI 作为 API 端点运行。官方参考资料：

模型可用性会随时间变化。请查看 CometAPI Models page 了解可用的 Gemini 模型。

前提条件

要求	详情
Node.js	22+（推荐 LTS）
操作系统	macOS、Linux 或 Windows
CometAPI key	来自你的 CometAPI Dashboard（以 `sk-` 开头）

安装 Gemini CLI

npm install -g @google/gemini-cli

或通过 Homebrew 安装（macOS / Linux）：

brew install gemini-cli

验证：

gemini --version

设置环境变量

export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"

将 sk-your-cometapi-key 替换为你的实际 CometAPI key。

启动 Gemini CLI

cd your-project
gemini

首次启动时，系统会提示你选择主题、确认安全提示，并信任当前工作目录。

为了避免每次会话都重新导出，请将以下内容添加到你的 shell 配置中：

# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"

重启终端以使更改生效。

无效的 API Key 错误

请确认 GEMINI_API_KEY 已正确设置。运行 echo $GEMINI_API_KEY 进行检查。

fetch failed

网络限制可能会阻止连接。请尝试使用系统级代理。

Node.js 版本错误

Gemini CLI 要求 Node.js 22+。运行 node --version 进行检查。

卸载 Gemini CLI

运行 npm uninstall -g @google/gemini-cli。