---
title: "Code Assist、Cloud 和 GitHub Action"
description: "理解 Gemini CLI 在 Google Code Assist、Cloud Shell、Vertex AI 和 GitHub Action 工作流里的位置。"
verifiedAt: "2026-05-09"
---

Gemini CLI 不是孤立工具。它在 Google 生态里连接了 Gemini Code Assist、Cloud Shell、Vertex AI、IDE agent mode 和 GitHub Action。

> [!NOTE]
> 这一篇解决的是产品位置：Gemini CLI 是终端和自动化入口，但账号、配额、企业控制和云项目往往来自更大的 Google 体系。

## Gemini Code Assist

Gemini Code Assist 更像产品层，覆盖：

- IDE 插件和 agent mode。
- Gemini CLI。
- Google 账号和订阅。
- 企业控制和隐私策略。
- 配额与使用限制。

如果你在 VS Code 或 JetBrains 里工作，Code Assist 的 IDE 能力更顺手；如果你在终端、CI、远程服务器里工作，Gemini CLI 更自然。

| 工作位置 | 更自然的入口 |
| --- | --- |
| IDE 内连续编辑 | Gemini Code Assist / IDE companion |
| 终端项目任务 | Gemini CLI |
| Google Cloud 环境 | Cloud Shell / Vertex AI |
| GitHub 仓库自动化 | run-gemini-cli GitHub Action |
| 企业策略和审计 | Code Assist enterprise controls / Google Cloud |

## Cloud Shell

Cloud Shell 适合快速体验或在 Google Cloud 项目里操作。它的优势是环境预置、账号上下文明确，不需要先处理本机 Node、PATH、代理和证书问题。

但真实长期开发仍建议在本地或团队标准开发环境里配置，避免把所有流程绑定到临时 shell。

## Vertex AI

Vertex AI 适合企业和云项目：

- 统一账单。
- 项目级权限。
- 区域和合规治理。
- 与 Google Cloud 服务集成。

如果团队已经在 Google Cloud 上，Gemini CLI 通过 Vertex AI 接入更容易进入统一治理。

## 企业使用边界

企业环境里不要只问“能不能跑”。还要问：

- 谁拥有 Cloud project。
- 认证方式是否符合组织策略。
- 配额、账单和日志归属在哪里。
- GitHub Action 的 secret 和 workflow permission 是否足够收窄。
- 产生的 prompt、diff、trace、日志是否允许进入外部系统。

这些问题不属于 CLI 使用技巧，而属于上线边界。

## GitHub Action

`google-github-actions/run-gemini-cli` 让 Gemini CLI 进入 GitHub Actions。适合：

- PR review。
- issue triage。
- 按评论触发任务。
- 定时扫描。
- 自动生成总结或标签。

接入前先定义权限边界：哪些任务只读，哪些任务能评论，哪些任务能改代码，哪些任务必须人工确认。

## 推荐接入顺序

```mermaid
flowchart LR
    Local["本地 Gemini CLI"] --> CloudShell["Cloud Shell / Vertex AI"]
    Local --> IDE["IDE companion"]
    Local --> Headless["Headless script"]
    Headless --> GitHub["GitHub Action"]
    GitHub --> Enterprise["Enterprise controls"]

    style Local fill:#dbeafe,stroke:#3b82f6
    style GitHub fill:#fef3c7,stroke:#f59e0b
    style Enterprise fill:#dcfce7,stroke:#22c55e
```

先在本地跑通低风险流程，再进入 headless 和 GitHub Action。企业控制应该在扩大自动化前定义，不要等 workflow 已经能写回仓库后再补权限。

## 入口选择口诀

如果任务发生在人正在编辑的代码里，用 IDE；如果任务发生在项目目录、日志、测试和脚本里，用 Gemini CLI；如果任务发生在 Google Cloud 项目里，用 Cloud Shell 或 Vertex AI；如果任务发生在仓库事件里，用 GitHub Action。

选错入口会带来额外复杂度。比如把本地长期开发全放在 Cloud Shell，会受临时环境限制；把需要人工确认的复杂重构放进 GitHub Action，会让权限和失败恢复变难；把团队账单项目当成本机个人登录处理，会让 quota、隐私和审计都说不清。

## 官方核验点

发布前要分别回到 Gemini Code Assist、Gemini CLI、Vertex AI 和 `run-gemini-cli` GitHub Action 的官方页面核验。重点不是记住营销名称，而是确认账号入口、权限范围、quota 归属、workflow permission 和数据处理边界是否还和教程一致。

## 一张定位图

```text
IDE 写代码      Gemini Code Assist / IDE companion
终端改项目      Gemini CLI
云上操作        Cloud Shell / Vertex AI
仓库自动化      run-gemini-cli GitHub Action
企业治理        Google Cloud / Code Assist enterprise controls
```

## 官方资料

- Gemini Code Assist 中文：[developers.google.com/gemini-code-assist](https://developers.google.com/gemini-code-assist/docs/gemini-cli?hl=zh-cn)
- Google Cloud 中文：[docs.cloud.google.com/gemini/docs/codeassist/gemini-cli](https://docs.cloud.google.com/gemini/docs/codeassist/gemini-cli?hl=zh-cn)
- IDE integration：[docs/ide-integration/index.md](https://github.com/google-gemini/gemini-cli/blob/main/docs/ide-integration/index.md)
- GitHub Action 仓库：[google-github-actions/run-gemini-cli](https://github.com/google-github-actions/run-gemini-cli)
- Enterprise configuration：[docs/cli/enterprise.md](https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/enterprise.md)

## 下一篇

<Cards>
  <Card title="工具横向对比" description="继续看 Gemini CLI、Codex CLI、Claude Code、OpenCode 和 Cursor 的分工。" href="/docs/gemini-cli/understanding/11-gemini-cli-vs-codex-claude-opencode" />
  <Card title="GitHub Action" description="需要实际接入 GitHub workflow 时，回到 GitHub Action 页面。" href="/docs/gemini-cli/official/07-integrations-automation/74-github-action" />
  <Card title="企业控制" description="团队和企业使用前，回到安全与企业章节。" href="/docs/gemini-cli/official/06-security-enterprise" />
</Cards>
