Gemini CLI 配置教程：通过 OfoxAI 接入 Google Gemini 命令行工具（2026）

摘要

Gemini CLI 是 Google 推出的 Gemini 模型命令行工具，让开发者在终端中调用 Gemini 进行代码生成、文件分析、多模态处理。通过 OfoxAI，你可以使用 Gemini 协议的同时获得更丰富的模型选择和路由优化。本文讲解安装、配置和模型选择的完整流程。

什么是 Gemini CLI

Gemini CLI 是 Google 官方的 Gemini 模型命令行客户端，定位类似 Claude Code——把大模型的能力直接带到终端里。

核心能力：

• 代码生成和审查：Gemini 模型擅长代码理解
• 长文件分析：利用 1M token 上下文窗口
• 多模态任务：分析图片、PDF 等文件

和网页版 Gemini 的区别在于：CLI 能直接访问本地文件系统，无缝融入 git、make、npm 等工具链。

安装 Gemini CLI

通过 npm 分发：

npm install -g @google/gemini-cli

安装完成后运行 gemini --version 确认安装成功。需要 Node.js 18 或更高版本。

配置 API：通过 OfoxAI 接入

Gemini CLI 使用 Gemini 原生协议。有两种配置方式。

方式一：配置文件（推荐）

创建或编辑 ~/.gemini/settings.json：

{
  "apiKey": "<你的 OFOXAI_API_KEY>",
  "baseUrl": "https://api.ofox.ai/gemini"
}

在 OfoxAI 控制台 注册账号并创建 Key。一个 Key 即可调用 Gemini、GPT、Claude 等多家模型。

Gemini CLI 的 base URL 配置方式可能随版本变化。如果上述方式不生效，请参考 Gemini CLI 最新文档 确认配置格式。

方式二：环境变量

在 shell 配置文件中设置 API Key：

# ~/.zshrc 或 ~/.bashrc
export GEMINI_API_KEY=<你的 OFOXAI_API_KEY>

保存后执行 source ~/.zshrc 使配置生效。

环境变量方式适合在 CI/CD 环境中使用。但如果需要配置 base URL，仍然需要配合 settings.json 使用。

验证连通性

gemini "你好，介绍一下自己"

如果返回了回复，说明配置成功。

可用模型

通过 OfoxAI 接入后，可以使用以下 Gemini 模型：

选择建议：日常开发用 gemini-3.1-flash-lite-preview（快速低成本），复杂推理用 gemini-3.1-pro-preview，处理图片或 PDF 时用 gemini-3-pro-preview。

实际使用场景

代码生成

gemini "用 Python 写一个异步 HTTP 客户端，支持重试和指数退避"

代码审查

gemini "审查这段代码，指出潜在的 bug 和优化建议" < main.py

长文件分析

Gemini 的 1M token 上下文窗口特别适合大型文件：

gemini "分析这个日志文件，找出所有错误和可能的原因" < application.log

多模态任务

gemini "描述这张架构图的内容" --file architecture.png

通过 OfoxAI 接入的额外优势

• 故障回退：当某个上游节点不可用时，OfoxAI 自动切换到备用节点
• 路由优化：请求被路由到延迟最低的节点
• 统一计费：一个账户管理所有模型费用
• 更多模型：同一个 API Key 还可以在其他工具中调用 GPT、Claude 等模型

注意事项

1. 版本兼容性：Gemini CLI 仍在活跃开发中，配置方式（特别是 base URL 的设置）可能随版本更新变化
2. 模型 ID：通过 OfoxAI 使用时，模型 ID 格式为 google/模型名
3. 网络环境：确保终端可以正常访问 api.ofox.ai

总结

Gemini CLI 把 Google Gemini 的能力带到了终端里，适合在命令行中完成工作的开发者。通过 OfoxAI 配置接入后，不需要 Google Cloud 账号即可使用，同时获得故障回退和路由优化的好处。安装只需一条 npm 命令，配置只需编辑一个 JSON 文件。

详细集成说明参见 OfoxAI Gemini CLI 集成文档。