Google · gemini

在你使用的每台裝置上使用 Gemini CLI

Google 的開源終端機代理程式；如果你的組織是那樣運作的，它就跑在你自己的 Google Cloud 專案上，並且可以從手機閱讀。

How Happier runs Gemini CLI

Gemini 最有可能是跑在別人的計費邊界之內，而不是消費者登入之下的代理程式——Google Cloud 專案和地區，是從 Happier 啟動的那個行程的 shell 環境讀出來的。本頁存在，就是為了說這部分不會改變。

它也是 Happier 唯一會保存的 Google 憑證。Gemini 設定檔只要連過，在你的任何電腦上開始工作階段時都能選用；OAuth code 在伺服器上交換，回來時是加密過的組合，所以你安裝的應用程式裡不含任何 Google OAuth 密鑰。進入方式有二種，看你手上拿的是什麼：貼上重新導向網址，或讓原生應用程式開啟應用程式內建瀏覽器。在網頁用戶端上是貼上的那條路。當你寧可什麼都不連時，Happier 改讀本機訊號——Gemini 自己的環境變數、它的設定檔，以及受支援的 Google application-default 憑證檔——而供應商頁面會在你挑的電腦上替你啟動 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 行程的用戶端 — 不是唯讀的鏡像。回應權限請求、送出下一則指示、瀏覽儲存庫、閱讀差異。對話紀錄在離開你的電腦前就已端對端加密，所以承載它的伺服器持有的是密文。

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 授權。Google 對 Gemini 的收費，和沒有我們時完全相同。

Get Gemini CLI onto your phone in two commands

在放著你程式碼的電腦上執行一道指令，然後在你想工作的儲存庫裡執行 happier gemini。

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

逐步說明在指南裡。全部都採 MIT 授權，而中繼站是你可以自己執行的。