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