推荐安装
先安装 FlyHub CLI，再用它写入配置文件与环境变量（写入 ~/.gemini/.env）。将 Key 换成控制台里的密钥即可。
# 安装 FlyHub CLI
curl -fsSL https://flyhub.cn/install.sh | bash
export PATH="$HOME/.flyhub/bin:$PATH"
# 一键配置（将 Key 替换为控制台密钥）
flyhub setup gemini --key <FLYHUB_API_KEY>若已安装过 CLI，可只执行 flyhub setup gemini --key <FLYHUB_API_KEY>。已设置 FLYHUB_API_KEY 时可省略 --key。更多工具：flyhub setup list
手动安装
1. 安装 Gemini CLI
Gemini 模型请使用 Gemini 原生端点，不要用 OpenAI 兼容格式。
bash
brew install gemini-cli或使用 npm（Windows 需先安装 Node.js）：
bash
npm install -g @google/gemini-cli2. 配置 FlyHub
将 <FLYHUB_API_KEY> 替换为控制台 Key，粘贴整段到终端：
bash
mkdir -p ~/.gemini && cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://api.flyhub.cn
GEMINI_API_KEY=<FLYHUB_API_KEY>
GEMINI_API_KEY_AUTH_MECHANISM=bearer
EOF保存后无需 source，下次运行 gemini 会自动读取 ~/.gemini/.env。
3. 选择鉴权方式
首次运行 gemini 时，在 Get started 界面选择 Use Gemini API Key（不要选 Google 登录或 Vertex AI）。
若之前已选 OAuth 登录，需重置后重新选择：
bash
rm ~/.gemini/settings.json4. 故障排查
API 返回 401 或 invalid_bearer_token：确认 Key 完整、无多余空格、未被删除。若仍失败，请在控制台重新创建 Key 并重试。
模型不可用：先调用 GET /v1/models 获取实时列表，核对模型 ID 拼写。
准备好了？登录控制台 · 充值 · 创建 API Key