Google · gemini

在你使用的每台设备上运行 Gemini CLI

Google 的开源终端智能体，如果你的组织就是这样运作的，它会对着你自己的 Google Cloud 项目运行，并且可以从手机上读取。

How Happier runs Gemini CLI

Gemini 是最有可能运行在别人的计费边界之内、而不是运行在消费者登录上的智能体——Google Cloud 项目和区域，从 Happier 启动的那个进程的 shell 环境里读出。本页存在，就是为了说明这部分不会改变。

它也是 Happier 唯一会保存的 Google 凭据。连接过 Gemini 配置之后，在你的任何电脑上开始会话时都可以选到它；OAuth code 在服务器上交换，并以加密包的形式返回，因此你安装的应用里不会附带 Google OAuth 密钥。进入的路有 2 条，取决于你手上拿的是什么：粘贴重定向 URL，或者让原生应用打开应用内浏览器。在网页客户端上走的是粘贴那条。当你宁可什么都不连接时，Happier 会改为读取本机的信号——Gemini 自家的环境变量、它的配置文件，以及受支持的 Google 应用默认凭据文件——而供应商页面会替你在选定的电脑上启动 gemini auth。

在这之下，Gemini 原生接受 MCP 服务器，因此你在 Happier 里定义过的服务器是作为工具清单送达的，而不是作为还得告诉它的 shell 命令。这个版本没有为这一个提供的，是列出那台电脑上已有的 Gemini 会话，或者把供应商状态搬到另外那台电脑的办法；通过 Happier 开始的会话可以恢复，而你在裸终端里开始的那一个，本页不会假装能找到。你放在 .gemini/skills 里的技能会被读取，并随会话带走。

What Gemini CLI does, and what Happier adds

Gemini CLI 是 Google 的开源终端编码智能体。happier gemini 会用你的 shell 已有的环境在你的仓库里启动它——在很多组织里，这意味着 Google Cloud 项目和区域，而不是消费者登录。

正是这种部署方式让本页显得重要。智能体运行在你自己的计费和数据边界之内，而 Happier 只增加了传输：加密的会话，你可以在手机上、浏览器里或别的电脑上读它。

happier gemini

Read, approve and answer Gemini CLI from any device

iOS 和 Android 应用、面向 macOS、Windows 和 Linux 的桌面应用，以及 app.happier.dev，都是通向运行在你电脑上的 Gemini CLI 进程的客户端 —— 而不是只读的镜像。回应一个权限请求、发送下一条指令、浏览仓库、阅读 diff。会话记录在离开你的电脑之前就已端到端加密，所以承载它的服务器持有的是密文。

Happier can install Gemini CLI for you

Happier 安装在已经存放着你仓库的那台电脑上，而 happier gemini 会在那里把 Gemini CLI 作为一个普通子进程启动，在你指定的目录里，用你自己登录好的身份。智能体和 Google 之间没有网关，你的源码在别处也没有任何副本。

Happier 会先在你的 PATH 上找 gemini，运行你装的那份。如果没有，它可以把 @google/gemini-cli 安装到 ~/.happier/tools/providers/gemini/ — 那是它自己的目录，不是你全局的 npm prefix。你自己管理的那份，永远不会在你不知情的情况下被替换或升级。

Google 自己介绍 Gemini CLI 的页面在 goo.gle/gemini-cli-auth-docs。Happier 不会镜像一份，因为把别人的安装说明抄一份过来，抄的就是一份会过期的东西。

Happier 这一侧的配置参考 —— Happier 文档中的 Gemini CLI。

Gemini CLI 跑在哪个账号上

Gemini CLI 是 Happier 可以指向“你连接过一次的凭据”的智能体之一，而不是指向那台电脑当下登录的账号。它接受 a Gemini login。

已连接服务是以凭据为键，而不是以智能体为键，所以同一份 Gemini login 在每一台你连接过的电脑上，都能给任何接受它的智能体选用 — 这也正是把你自己的账号组成一个池、跨多台电脑使用会有帮助的原因。凭据的加密和解密都在你自己的设备上进行；文档页面记载了各类配置档的规则，因为每个智能体接受哪些种类的配置档，正是会随版本变动的那类细节。

One app for Gemini CLI and 12 other agents

Gemini CLI 是 Happier 运行的 13 个命令行编码智能体之一，它们共用一份会话列表、一个权限收件箱、一套键盘快捷键和一份 MCP 配置。

You define an MCP server once and Gemini CLI receives it as native MCP inventory, next to whatever MCP servers it already had of its own.

这在你同时跑不止一个的日子里最要紧：不同厂商的会话并排摆着，点一下通知打开的是发出该请求的那个会话，而不是应用的首页。完整名单在这里。

The same Gemini CLI session in your terminal and in the app

在终端里输入 happier gemini，会话就在你站着的地方启动，而同一个会话同时也在应用里。你在那个 shell 里读到的是 Happier 自己对会话的呈现 —— 会话记录、权限提示、工具输出 —— 而不是 Gemini CLI 的界面。没有人需要为了拿到一个手机客户端而放弃终端。

没有交接到 Gemini CLI 自己 TUI 这回事。那是 Claude Code、Codex 和 OpenCode 才有的；用 Gemini CLI 时，会话两端都还是 Happier 的。happier attach <session-id> 会列出那台电脑上的会话，并标记它无法重新接上的那些，而不是等你选了之后才失败。

attach 指南列出了具体适用的情形，而不是把所有情形都许诺下来。

关于通过 Happier 运行 Gemini CLI 的问题

我必须先安装 Gemini CLI 吗？: 如果你的 PATH 上有 gemini，Happier 就用它；否则它可以把 @google/gemini-cli 包安装到 ~/.happier/tools/providers/gemini/。它从不升级或替换你自己管理的那一份。
它能配合 Vertex AI 项目使用吗？: 这个 CLI 从 Happier 启动的那个进程的环境里读取它的 Google Cloud 配置，所以在你的 shell 里能用的项目和区域，在这里也能用。Happier 不在智能体和 Google 之间加入自家的网关。
我的源代码会去哪里？: 哪里也不去。Gemini CLI 在你的电脑上读取你的工作目录，并像往常那样与 Google 通信。Happier 承载的是对话，端到端加密，而它经过的中继可以是你自己托管的那一个。
我可以把它和别家供应商的智能体并排使用吗？: 可以——这正是用一个应用而不是每家供应商一个应用的意义。Gemini 会话和另外 12 个智能体的会话，都出现在同部手机的同个列表里。
Happier 这侧要多少钱？: 不要钱，也没有席位数。所有东西——CLI、应用、中继——都是 MIT 许可的。Gemini 的费用 Google 照旧向你收取，和没有我们时完全相同。

Get Gemini CLI onto your phone in two commands

在存放你代码的那台电脑上执行一条命令，然后在你想工作的仓库里执行 happier gemini。

curl -fsSL https://happier.dev/install | bash

分步说明在指南里。这一切都是 MIT 许可的，而 relay 是你可以自己运行的。