Cloud Shell 入口

Cloud Shell 是 Gemini CLI 的低摩擦入口：你不用先修本機 Node、npm、PATH 和 shell 環境，就能在 Google Cloud 環境裡啟動 Gemini CLI。但它不是你的本機開發機，尤其不能忽略 project、IAM、賬單和程式碼所在位置。

1. Cloud Shell 解決什麼問題

• Cloud Shell 已預裝 Gemini CLI，啟動就能用，不需要 npm install。
• 不需要本機安裝 Node.js。
• 不需要處理本機 PATH、npm 全域性目錄、shell 相容問題。
• 天然靠近 Google Cloud 專案。
• 適合臨時驗證命令、Cloud 文件學習和輕量任務。

Google Developers 當前頁面說明，Gemini CLI 可以在 Cloud Shell 中使用，無需額外設定；認證頁也說明，執行在 Cloud Shell 環境裡時通常會使用 Cloud Shell 憑據。Compute Engine 環境下，Gemini CLI 也會自動用 metadata server 上的 Application Default Credentials（ADC），同樣不需要再走互動式登入。

2. 先確認當前 project

Cloud Shell 最大的風險不是“能不能啟動”，而是“它現在屬於哪個 Google Cloud project”。開始前先確認：

gcloud config get-value project
gcloud auth list

如果 project 不對，先切換 project，再啟動 Gemini CLI。不要讓 CLI 在錯誤 project 下讀資源、查日誌或產生用量。

gcloud config set project YOUR_PROJECT_ID

3. Cloud Shell 的邊界

• 它不是你的本機專案環境。
• 本機程式碼、私有依賴、SSH key、IDE 工作流不一定在裡面。
• 長期專案開發仍要考慮本機、遠端開發機或 Cloud Workstations。
• 涉及生產專案時仍要遵守 IAM、憑據、賬單和許可權邊界。

flowchart LR
    Local["本機專案"] -->|真實開發| LocalCLI["本機 Gemini CLI"]
    Cloud["Google Cloud 專案"] -->|快速驗證| Shell["Cloud Shell"]
    Shell --> Project["當前 Cloud Project"]
    Project --> IAM["IAM / API / Billing"]
    Shell --> Temp["臨時檔案和輕量任務"]

    style Shell fill:#dbeafe,stroke:#3b82f6,stroke-width:2px
    style IAM fill:#fef3c7,stroke:#f59e0b

4. 什麼時候用 Cloud Shell

5. 和本機安裝的關係

Cloud Shell 適合降低上手門檻，但它不能替代所有開發環境。Gemini CLI 的核心價值是“帶著專案上下文執行任務”。如果你的專案在本機或團隊開發機上，最終仍應在真實專案環境裡測試。

本機安裝和 Cloud Shell 的分工可以這樣定：

• Cloud Shell：學習 Google Cloud 文件、驗證 CLI、查 Cloud 資源、做輕量指令碼。
• 本機/遠端開發機：讀真實儲存庫、跑專案測試、接本地工具鏈、處理 IDE 和 Git 工作流。
• Cloud Workstations：團隊受控開發環境，適合需要統一映象、許可權和審計的組織。

6. 接下來去哪

官方來源

• Google Developers Gemini CLI
• Gemini CLI Authentication Setup
• Google Cloud Shell