跳转到主要内容

​
概述

Gemini CLI 是 Google 推出的开源命令行 AI 工具，可让你在终端中直接与 Gemini 模型交互，进行代码理解、生成和编辑等操作。 通过将 Gemini CLI 连接到 FoxAPI，你可以使用 FoxAPI 提供的 Gemini 系列模型。
Gemini CLI 不支持通过配置文件自定义 Base URL。配置需要修改安装包内的源文件。更新包后需要重新修改。

​
前置条件

FoxAPI API Key

一个有效的 FoxAPI API Key，并确保有权限访问 Gemini 模型。

Node.js 20+

安装 Gemini CLI 需要 Node.js v20 或更高版本以及 npm。

​
安装与配置

1

第一步：安装 Gemini CLI

npm install -g @google/gemini-cli
2

第二步：设置 API Key

将你的 FoxAPI API Key 添加到 Shell 配置文件（~/.bashrc、~/.zshrc 等）中：
export GEMINI_API_KEY="sk-your-foxapi-api-key"
然后重新加载配置：
source ~/.zshrc  # 或 source ~/.bashrc
3

第三步：修改 Base URL

Gemini CLI 不支持通过配置文件自定义 Base URL，需要直接修改安装包内的两个源文件。首先，找到 npm 全局安装目录：
npm root -g
然后修改以下两个文件：文件 1： {install_dir}/@google/gemini-cli/node_modules/@google/genai/dist/node/index.mjs（约第 11222 行）文件 2： {install_dir}/@google/gemini-cli/node_modules/@google/genai/dist/node/index.cjs（约第 11244 行）在两个文件中，找到并替换：
// 修改前：
initHttpOptions.baseUrl = `https://generativelanguage.googleapis.com/`;

// 修改后：
initHttpOptions.baseUrl = `https://api.foxapi.cc/`;
在 macOS/Linux 上，你可以使用 sed 命令快速替换：
INSTALL_DIR=$(npm root -g)
sed -i.bak 's|https://generativelanguage.googleapis.com/|https://api.foxapi.cc/|g' \
  "$INSTALL_DIR/@google/gemini-cli/node_modules/@google/genai/dist/node/index.mjs" \
  "$INSTALL_DIR/@google/gemini-cli/node_modules/@google/genai/dist/node/index.cjs"
更新 Gemini CLI（npm update -g @google/gemini-cli）后，源文件会被覆盖，需要重新执行此修改。
4

第四步：开始使用

在你的项目目录中启动 Gemini CLI：
cd /path/to/your/project
gemini
或运行单次命令：
gemini "解释一下这个项目的架构"
在交互模式中，输入 /model 可以切换模型。

​
验证连接

运行以下命令验证配置是否正确： 
gemini "你好，请确认你正在正常工作。"
如果配置正确，Gemini 将通过 FoxAPI 返回回复。

​
可用模型

模型说明
gemini-2.5-pro最强大的 Gemini 模型，适合复杂任务
gemini-2.5-flash快速高效，适合日常编程辅助
gemini-3-pro-preview下一代 Gemini Pro 预览版
gemini-3-flash-preview下一代 Gemini Flash 预览版

​
常见问题

  • 确认 GEMINI_API_KEY 环境变量已正确设置，且值为你的 FoxAPI API Key（以 sk- 开头）。
  • 确认 Key 未过期且账户余额充足。
  • 确认该 Key 有权限访问 Gemini 模型。
  • 确认 Base URL 修改已在两个文件（index.mjs 和 index.cjs）中正确应用。
  • 检查网络连接，确保能访问 api.foxapi.cc。
  • 如果所在地区有网络限制，尝试使用 VPN。
  • 运行 npm update -g @google/gemini-cli 后，源文件会被覆盖。
  • 需要重新按照第三步的方法修改 Base URL。
  • 确认模型名称正确且在 FoxAPI 上可用。
  • 在交互模式中使用 /model 命令切换不同模型。