---
title: "Cloud Shell 入口"
description: "Gemini CLI 在 Google Cloud Shell 和 Cloud Workstations 中的使用邊界，以及什麼時候優先用 Cloud Shell。"
verifiedAt: "2026-05-09"
---

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

> [!NOTE]
> **適合誰**：第一次驗證 Gemini CLI、學習 Google Cloud 文件、排除本機安裝變數、處理輕量 Cloud 專案任務時，可以優先用 Cloud Shell。真實本機專案長期開發，仍要回到專案所在環境。

## 1. Cloud Shell 解決什麼問題

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

> [!NOTE]
> [Cloud Workstations](https://cloud.google.com/workstations) 也預裝 Gemini CLI。如果團隊已經在 Cloud Workstations 上做受控開發，不需要再單獨裝 CLI。

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”。開始前先確認：

```bash
gcloud config get-value project
gcloud auth list
```

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

```bash
gcloud config set project YOUR_PROJECT_ID
```

## 3. Cloud Shell 的邊界

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

```mermaid
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

| 場景 | 建議 |
| --- | --- |
| 第一次體驗 Gemini CLI | 可以先用 Cloud Shell |
| Google Cloud 文件學習 | Cloud Shell 很合適 |
| 本機 Node 環境混亂 | 先用 Cloud Shell 排除安裝變數 |
| 真實本機專案開發 | 本機或遠端開發機更合適 |
| 企業專案 | 先確認組織策略、IAM 和審計要求 |

## 5. 和本機安裝的關係

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

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

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

> [!WARNING]
> **不要把 Cloud Shell 當生產運維捷徑**：它靠近 Cloud 資源，也意味著誤命令可能更接近生產環境。涉及刪除、釋出、許可權變更、賬單和資料匯出時，仍然要走變更流程。

## 6. 接下來去哪

<Cards>
  <Card title="釋出通道" description="繼續判斷 stable、preview、nightly 該怎麼選，避免把 nightly 當團隊預設。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started/05-release-channels" />
  <Card title="認證方式" description="如果 Cloud Shell 外還要跑本機、CI 或 Vertex AI，回到認證邊界。" href="/zh-Hant/docs/gemini-cli/official/00-getting-started/02-authentication" />
  <Card title="企業配置" description="團隊統一開發環境時，繼續看企業配置、policy、sandbox 和 telemetry。" href="/zh-Hant/docs/gemini-cli/official/06-security-enterprise/62-enterprise-config" />
</Cards>

## 官方來源

- [Google Developers Gemini CLI](https://developers.google.com/gemini-code-assist/docs/gemini-cli?hl=zh-cn)
- [Gemini CLI Authentication Setup](https://google-gemini.github.io/gemini-cli/docs/get-started/authentication.html)
- [Google Cloud Shell](https://cloud.google.com/shell)
