OmniDino
EN / 中文
获取 API Key
首页 模型 价格 教程 关于 联系 登录 获取 API Key
EN 中文

Gemini CLI

Gemini CLI

在终端中使用 Gemini， 理解代码、调用工具并自动完成任务。

Gemini CLI 是 Google 官方开源终端 Agent，支持项目上下文、文件编辑、Shell、网页工具、GEMINI.md、MCP、Extensions、Hooks 和非交互自动化。

Gemini CLI GitHub 开始安装 API 连接测试
OSS Google 官方开源 源码、Release、Issues 和开发文档均公开在 GitHub。
CLI 终端 Agent 读取文件、编辑代码、执行命令并处理复杂工作流。
MCP 工具扩展 通过 MCP 和 Extensions 连接外部系统与数据。
GEM Gemini 模型 官方上游聚焦 Google Gemini 与 Vertex AI 服务。
工具介绍

Gemini CLI 是什么？

它将 Gemini 模型和工程工具放进终端，可围绕当前目录理解代码、生成计划、修改文件和执行命令。

从“回答问题”升级到“在工作区里完成任务”。

Gemini CLI 不只是聊天窗口。它可以读取项目文件、运行 Shell、搜索网页、调用 MCP 工具，并通过 GEMINI.md 持续遵循项目规则。任何会修改文件或执行命令的 Agent，都应该先在 Git 测试仓库中验证。

交互式开发 运行 gemini 后持续对话、审批工具调用并完成项目任务。
非交互自动化 使用 gemini -p、管道输入和结构化输出连接脚本与 CI。
可扩展架构 通过 MCP、Extensions、Skills、Hooks、Subagents 和自定义命令扩展能力。

官方 Gemini CLI 当前不能直接使用 OmniDino 的 OpenAI 兼容地址。

Gemini CLI 官方支持 Google 账号、Gemini Developer API Key 和 Vertex AI。任意 OpenAI-compatible Base URL、多供应商模型路由和自定义 Provider 仍不是稳定的官方功能。因此不要把 https://api.omnidino.com/v1 填进不存在的 Gemini CLI Base URL 配置，也不要宣传 Gemini CLI 可以直接调用 GPT、Claude、DeepSeek 或 Qwen。需要直接使用 OmniDino 多模型时，请使用 Codex、Claude Code、Cherry Studio、Dify 或其他明确支持自定义网关的客户端。

GitHub 下载中心

所需工具全部引用开源项目。

GCLI

Google Gemini CLI

Google 官方开源终端 Agent，包含 CLI、Core、工具、Extensions 和完整文档。

Google 官方 Apache-2.0 Windows macOS Linux
GitHub 项目 Releases
NODE

Node.js

npm 与 npx 安装 Gemini CLI 所需的开源 JavaScript Runtime。

Node.js 20+ npm npx 跨平台
Node.js GitHub
BREW

Homebrew

macOS 和 Linux 常用的开源包管理器，可用于安装 Gemini CLI。

macOS Linux Package Manager
Homebrew GitHub
VS

Visual Studio Code

用于查看 Diff、终端、代码修改和 Gemini CLI IDE 集成的开源编辑器。

Editor Git Terminal IDE Integration
VS Code GitHub
MCP

MCP Reference Servers

Model Context Protocol 官方参考服务器与社区服务器索引。

MCP Tools Resources Open Source
GitHub 项目
SDK

MCP SDK

用于开发 Gemini CLI 自定义 MCP Server，可将内部 API 或 OmniDino 功能封装成工具。

TypeScript Python Server Client
TypeScript SDK Python SDK
不要从不明 npm 镜像、网盘或第三方安装器下载修改版 Gemini CLI。官方 npm 包名是 @google/gemini-cli，GitHub 仓库是 google-gemini/gemini-cli。
安装 Gemini CLI

推荐 stable 稳定版本。

可以全局安装、临时使用 npx、通过 Homebrew 安装，或从 GitHub Release 获取二进制文件。

npm 全局安装

适合 Windows、macOS 和 Linux，也是最常见的安装方式。

先安装 Node.js 20 或更高版本。
包名必须是 @google/gemini-cli。
安装后运行 gemini –version。
升级时重新安装 latest。
npm 
npm install -g @google/gemini-cli

gemini --version

# 后续升级
npm install -g @google/gemini-cli@latest

npx 临时运行

无需全局安装，每次运行时获取对应包版本。

适合临时体验和受控环境。
仍然需要 Node.js 和 npm。
第一次运行会下载依赖。
日常长期使用更推荐全局安装。
npx 
npx @google/gemini-cli

# 指定 latest
npx @google/gemini-cli@latest

Homebrew 安装

适合已经使用 Homebrew 的 macOS 和 Linux 用户。

先确认 brew 可以正常运行。
安装命令以官方文档当前写法为准。
安装后检查 Gemini CLI 版本。
使用 brew upgrade 更新。
Homebrew 
brew install gemini-cli

gemini --version

# 后续升级
brew upgrade gemini-cli

GitHub Release

从官方 Releases 页面选择与你系统和架构匹配的文件。

仓库必须是 google-gemini/gemini-cli。
优先选择 stable 正式版本。
检查 Windows、macOS、Linux 和 CPU 架构。
预览版与 nightly 更适合测试用户。
打开 Releases
Release Channels 
stable   推荐日常使用
preview  体验即将发布的功能
nightly  最新提交构建，稳定性最低

首次使用建议选择 stable。
认证方式

Gemini CLI 官方支持三条主要路线。

GOOG

Google 账号登录

适合本地个人用户。运行 gemini 后选择 Sign in with Google，并在浏览器完成 OAuth。

KEY

Gemini API Key

使用 Google AI Studio 创建的 Gemini Developer API Key，环境变量名称为 GEMINI_API_KEY。

GCP

Vertex AI

适合 Google Cloud 企业场景，需要项目、区域、权限和相应 Vertex AI 认证。

Google OAuth 
gemini

# 在登录菜单中选择：
# Sign in with Google
GEMINI_API_KEY 必须是 Google Gemini Developer API Key，不能填 OmniDino Key。两者的认证、域名与协议不是一回事。
GEMINI.md

为项目建立长期生效的规则和上下文。

Gemini CLI 会按层级读取 GEMINI.md，让模型了解项目背景、规范、安全边界和验证方法。

01

项目背景

说明项目目标、技术栈、目录结构和关键模块。

02

代码规范

规定命名、格式、组件方式、错误处理和测试要求。

03

安全边界

明确不可修改的文件、敏感目录和禁止执行的命令。

04

构建命令

列出安装、启动、Lint、测试和生产构建命令。

05

Git 规则

要求使用分支、审阅 Diff，并禁止自动推送到生产仓库。

06

输出格式

要求先给计划、列风险、说明修改和提供验证结果。

GEMINI.md 模板 
# Project Context

## Project
- This is the OmniDino website and documentation project.
- Preserve the existing visual style.
- Prefer small, reviewable changes.

## Development Rules
- Use scoped CSS classes for every page.
- Keep mobile responsiveness.
- Use vanilla JavaScript unless the project already uses another framework.
- Do not remove working content without approval.

## Safety
- Never expose API keys or passwords.
- Do not edit production credentials.
- Do not run destructive database or deployment commands without approval.

## Verification
- Review the final Git diff.
- Test links, buttons, tabs and copy actions.
- Check desktop and mobile layouts.
- List every changed file and the reason.
在 Gemini CLI 中运行 /init 可以根据当前目录生成 GEMINI.md；运行 /memory show 可查看当前载入的上下文。
MCP 与 OmniDino

OmniDino 可以作为工具后端，而不是模型 Provider。

可开发 MCP Server，让 Gemini 调用 OmniDino 的模型测试、图片生成、余额查询或内部业务接口。

正确架构

Gemini CLI 仍由 Google Gemini 模型驱动。当 Gemini 决定调用工具时，再由你的 MCP Server 使用服务器端 OmniDino Key 请求 OmniDino。

Agent Model Google Gemini
Tool Protocol MCP
Tool Backend OmniDino API
API Key 保存在 MCP Server 端
这种方式会产生 Google Gemini 使用量和 OmniDino 工具调用量，两者应分别查看。
OmniDino MCP Flow 
Gemini CLI
  ↓ Gemini 模型决定调用工具
Your MCP Server
  ↓ 使用安全保存的 OmniDino Key
https://api.omnidino.com/v1
  ↓
OmniDino 模型 / 图片 / 业务接口
  ↓
MCP Server 将结构化结果返回 Gemini CLI
MCP 管理命令 
# 查看 MCP 帮助
gemini mcp --help

# 查看已配置服务器
gemini mcp list

# 在交互界面查看 MCP
/mcp

# 重新载入 MCP
/mcp reload
常用命令

交互模式与自动化速查表。

命令 用途 建议
gemini 启动交互式 Gemini CLI。 先进入正确项目目录。
gemini -p "任务" 非交互执行一次任务。 适合脚本、CI 和批量操作。
gemini "任务" 带初始任务启动交互会话。 快速进入具体项目目标。
cat file | gemini 通过管道处理文件内容。 Windows 可使用 Get-Content。
/about 查看版本与客户端信息。 提交 Issue 时附上输出。
/auth 管理认证方式。 切换 Google 登录、API Key 或 Vertex。
/model 查看或设置 Gemini 模型。 仅限当前认证方式可用模型。
/settings 打开设置界面。 管理 UI、权限和高级选项。
/init 生成项目 GEMINI.md。 生成后应人工审阅和精简。
/memory show 查看当前加载的 GEMINI.md。 排查项目规则未生效。
/mcp 管理 MCP Server。 查看工具、认证和连接状态。
/tools 查看可用工具。 确认文件、Shell 和 MCP 工具。
/permissions 管理目录信任和权限。 新项目先使用较严格策略。
/plan 进入只读计划模式。 修改大型项目之前先规划。
/quit 退出 Gemini CLI。 可使用 –delete 删除当前会话记录。
推荐工作流

从安装到第一次安全任务。

01

安装 Node.js 与 Gemini CLI

使用官方 GitHub 项目和 npm 包，安装后检查版本。

02

选择官方认证方式

本地用户优先 Google 账号；API 开发使用 Gemini Key；企业使用 Vertex AI。

03

在测试 Git 仓库启动

第一次不要直接进入生产项目，先使用小型可回滚仓库。

04

生成并审阅 GEMINI.md

运行 /init，然后人工补充代码规范、安全边界与测试命令。

05

从只读任务开始

先让 Gemini 解释 README、项目结构和潜在风险，不修改文件。

06

审阅计划与权限

使用 /plan 和 /permissions，确认工具调用范围。

07

添加可信 MCP 或 Extension

只安装有清晰 GitHub 仓库、许可证和权限说明的扩展。

08

需要时连接 OmniDino MCP

将 OmniDino 封装成受控工具，不把 OmniDino Key 写进公开项目。

常见问题

安装、认证和 OmniDino 兼容性排查。

当前官方 Gemini CLI 不支持把任意 OpenAI-compatible Gateway 当作模型 Provider。GEMINI_API_KEY 应填写 Google Gemini Developer API Key，不是 OmniDino Key。
官方上游当前聚焦 Google Gemini 和 Vertex AI。多供应商 OpenAI-compatible 后端仍不是正式功能。需要 OmniDino 多模型时，请选择明确支持自定义 Base URL 的客户端。
重新打开终端，确认 npm 全局目录位于 PATH，并运行 npm list -g @google/gemini-cli。也可以先用 npx @google/gemini-cli 测试。
本地 OAuth 需要浏览器能与终端环境通信。远程 SSH 或无界面服务器建议使用 Gemini API Key 或 Vertex AI，而不是本地浏览器登录。
检查 Key 是否来自 Google AI Studio、对应项目是否启用所需服务、模型是否在该账户和地区可用，并确认环境变量没有多余空格或引号。
模型可见性取决于认证方式、账户套餐、区域、配额和当前发布范围。Gemini CLI 不会因为你填写任意名称就自动获得模型访问权。
检查文件名和大小写，并使用 /memory show 查看加载内容。修改后运行 /memory refresh 或重新启动会话。
使用 gemini mcp list 和 /mcp 查看状态，检查命令、依赖、环境变量、HTTP 地址、OAuth 和日志。直接在终端运行 MCP 启动命令可帮助定位错误。
普通 Gemini CLI 模型请求不会经过 OmniDino，因此没有记录是正常的。只有明确调用了使用 OmniDino API 的自定义 MCP Tool，才会产生 OmniDino 记录。

Gemini CLI 或 MCP 仍然有问题？

联系支持时请提供操作系统、Gemini CLI 版本、Node.js 版本、安装方式、认证方式、模型名称、错误提示和日志。请隐藏 Google Key、OmniDino Key 与 OAuth Token。

[email protected]
继续阅读

进入下一篇 OmniDino 教程。

上一篇

Claude Desktop

安装 Claude Desktop，并正确理解 MCP、Extensions 与 OmniDino 的协作方式。

 下一篇

图片模型配置

配置 OmniDino 图片生成接口、模型参数和第三方客户端。