FlexAPI Docs

主题

Gemini CLI 使用指南 ​

这份教程用于记录 Gemini CLI 接入 FlexAPI 的配置流程。

Step 1: 获取 API Key ​

1. 登录 FlexAPI 控制台 ​

前往 FlexAPI，登录并选择对应的分组，创建 FlexAPI API Key。

2. 充值额度或购买订阅 ​

按照使用模式，选择按时长订阅或充值额度按量付费。

3. 获取 API Key ​

在控制台创建或复制你的 FlexAPI API Key，后续配置 Gemini CLI 时会用到。

参考：FlexAPI API获取教程

Step 2: 安装 Gemini CLI ​

1. 环境要求 ​

  • Node.js 18 或更高版本

Node.js 18 或更高版本下载步骤 ​

bash
# 方法一：通过 Homebrew 安装 Node.js LTS
brew install node

# 方法二：也可以访问 https://nodejs.org/ 下载 macOS LTS 安装包
# 下载 .pkg 文件后，按照安装向导完成安装

# 验证 Node.js 和 npm 是否安装成功
node --version
npm --version

echo "Node.js 安装成功：如果上方显示 v18 或更高版本，并显示 npm 版本号，说明环境已准备好。"
bash
# 方法一：使用 NodeSource 官方仓库（推荐，Ubuntu / Debian）
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 方法二：使用系统包管理器
# Ubuntu / Debian
sudo apt update
sudo apt install -y nodejs npm

# CentOS / RHEL / Fedora
sudo dnf install -y nodejs npm

# 验证 Node.js 和 npm 是否安装成功
node --version
npm --version

echo "Node.js 安装成功：如果上方显示 v18 或更高版本，并显示 npm 版本号，说明环境已准备好。"
powershell
# 方法一：通过 winget 安装 Node.js LTS
winget install OpenJS.NodeJS.LTS

# 方法二：也可以访问 https://nodejs.org/ 下载 Windows LTS 安装包
# 下载 .msi 文件后，按照安装向导完成安装

# 验证 Node.js 和 npm 是否安装成功
node --version
npm --version

Write-Host "Node.js 安装成功：如果上方显示 v18 或更高版本，并显示 npm 版本号，说明环境已准备好。"

2. 全局安装 Gemini CLI ​

text
npm install -g @google/gemini-cli

请先参考 Gemini CLI 官方说明完成安装，并确认终端中可以正常运行 Gemini CLI 命令。

bash
gemini --version

如果显示版本号，说明 Gemini CLI 已安装成功。

Step 3: 配置 FlexAPI ​

将 Gemini CLI 的 API Key、Base URL 或模型提供方配置到 FlexAPI 网关：

字段建议值
API Key你的 FlexAPI API Key
Base URLhttps://flexapi.me
Model按需填写 FlexAPI 支持的模型

1. 选择配置文件方式配置（推荐） ​

创建配置目录 ​

Gemini CLI 的配置文件位于 ~/.gemini/ 目录

bash
mkdir -p ~/.gemini
powershell
mkdir $env:USERPROFILE\.gemini

创建 .env 配置文件 ​

在 ~/.gemini/ 目录下创建 .env 文件（Windows：在 %USERPROFILE%.gemini\ 目录下创建 .env 文件） 添加以下内容：

text
GOOGLE_GEMINI_BASE_URL=`https://flexapi.me`
GEMINI_API_KEY=your-Flexapi-key-here
GEMINI_MODEL=choose a model

创建 settings.json 配置文件 ​

在 ~/.gemini/ 目录下创建 settings.json 文件：

text
{
  "ide": {
    "enabled": true
  },
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

该配置文件启用了 IDE 集成，且设置认证方式为 API Key

参数说明

  • GOOGLE_GEMINI_BASE_URL: https://flexapi.me
  • GEMINI_API_KEY: 您在 FlexAPI 控制台创建的 API 密钥
  • GEMINI_MODEL: 使用的模型（默认为 gemini-2.5-pro）

2. 通过环境变量配置（适合临时使用） ​

bash
export GOOGLE_GEMINI_BASE_URL="https://flexapi.me"
export GEMINI_API_KEY="your-Flexapi-key-here"
export GEMINI_MODEL="gemini-2.5-pro"
powershell
$env:GOOGLE_GEMINI_BASE_URL="https://flexapi.me"
$env:GEMINI_API_KEY="your-Flexapi-key-here"
$env:GEMINI_MODEL="gemini-2.5-pro"
CMD
set GOOGLE_GEMINI_BASE_URL=https://flexapi.me
set GEMINI_API_KEY=your-Flexapi-key-here
set GEMINI_MODEL=gemini-3-pro-preview

Step 3: 启动和验证 ​

1. 启动 ​

进入项目目录并启动 Gemini CLI:

text
cd C:\path\to\your\project
gemini

首次启动时，Gemini CLI 会读取配置文件中的设置。

2.验证配置 ​

在 Gemini CLI 中尝试发送一个简单的请求测试连接：

text
你好，请帮我创建一个 Python 的 hello world 程序

Agent Mode (可选) ​

Gemini CLI 支持 Agent Mode，可以自动规划和执行复杂任务：

text
gemini --agent

在 Agent Mode 下，Gemini 会：

  • 自动分析任务需求
  • 制定执行计划
  • 逐步执行并验证结果
  • 根据反馈调整策略

常见问题 ​

Q: 配置后无法调用怎么办？ ​

先确认 API Key 是否正确、Base URL 是否填写为 https://flexapi.me，再检查当前分组是否启用了对应模型。

1. 命令未找到 ​

bash
# 检查 npm 全局安装路径并添加到 PATH（如果不在）
npm config get prefix

# 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

2. API 连接失败 ​

  • 检查环境变量或配置文件中的 GEMINI_API_KEY 是否设置正确
  • 验证 GOOGLE_GEMINI_BASE_URL 是否正确
  • 测试网络连接

3. 更新 gemini ​

bash
npm install -g @google/gemini-cli

FlexAPI Docs

Copyright © 2026 FlexAPI