Gemini CLI

Gemini CLI 是 Google 的開源 AI 程式碼代理工具。此模板將 Gemini CLI 部署為 Zeabur 上的持久化雲端工作站，並提供瀏覽器可存取的 Web 終端機（ttyd）。

開始使用

1. 部署模板並等待服務啟動。請等待健康檢查變為綠色後再繼續。
2. 在瀏覽器中開啟服務網址（綁定到服務的網域）。
3. 登入，使用者名稱為 user，密碼請在 Zeabur 儀表板的 Instructions 頁籤查看。
4. 設定 API 金鑰 — 在 Zeabur 儀表板設定 GEMINI_API_KEY，或執行 gemini 依照提示認證。可在 Google AI Studio 取得免費金鑰。
5. 開始使用： gemini

常用指令

指令	說明
gemini	啟動互動式 Gemini CLI 會話
gemini --version	查看已安裝的版本
gemini -p "你的提示"	發送單次提示

持久化儲存

/home/node/ 下的所有資料在重啟和重新部署後都會保留。

建議資源配置

• 最低配置：1 vCPU / 4 GB RAM（輕度使用）
• 建議配置：2 vCPU / 16 GB RAM（重度使用、大型程式碼庫）

已知問題

• 首次登入完成後終端機可能會卡住，請重新整理網頁即可繼續使用。

變更紀錄

2026-03-31 — 首次發佈

• ttyd Web 終端機（密碼驗證）
• Homebrew 及 npm 全域套件持久化於磁碟
• 資源需求及網域綁定

連結

• Gemini CLI GitHub
• Google AI Studio