---
title: "集成与自动化"
description: "Gemini CLI 集成与自动化入口：IDE companion、hooks、headless mode、脚本自动化、GitHub Action、Issue/PR 自动化和本地开发。"
verifiedAt: "2026-05-09"
---

Gemini CLI 不只适合在终端聊天。真正落地时，它会进入 IDE、Shell 脚本、CI、GitHub issue、PR review 和本地开发环境。

> [!NOTE]
> 这一组页面解决“如何把 Gemini CLI 放进工作流”的问题。先选入口，再看权限、输入输出和失败兜底。

## 学习路径

```mermaid
flowchart LR
    IDE["IDE integration"] --> Hooks["Hooks"]
    Hooks --> Headless["Headless mode"]
    Headless --> Automation["Shell / CI automation"]
    Automation --> GitHub["GitHub Action"]
    GitHub --> IssuePR["Issue / PR automation"]
    IssuePR --> LocalDev["Local development"]
    LocalDev --> Troubleshooting["Troubleshooting"]

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

<Cards>
  <Card title="IDE + Hooks" description="人在编辑器里工作时，先看 IDE companion 和 lifecycle hooks。" href="/docs/gemini-cli/official/07-integrations-automation/70-ide-integration" />
  <Card title="Headless + Automation" description="需要脚本化或 CI 调用时，从 headless mode 开始。" href="/docs/gemini-cli/official/07-integrations-automation/72-headless-mode" />
  <Card title="GitHub Action" description="需要 issue、PR、review 自动化时，进入 run-gemini-cli GitHub Action。" href="/docs/gemini-cli/official/07-integrations-automation/74-github-action" />
</Cards>

## 目录

| 页面 | 适合场景 |
| --- | --- |
| [IDE 集成](/docs/gemini-cli/official/07-integrations-automation/70-ide-integration) | 需要编辑器上下文、原生 diff、ACP |
| [Hooks](/docs/gemini-cli/official/07-integrations-automation/71-hooks) | 需要在工具调用前后插入校验、阻断或日志 |
| [Headless mode](/docs/gemini-cli/official/07-integrations-automation/72-headless-mode) | 需要非交互式调用 Gemini CLI |
| [自动化脚本](/docs/gemini-cli/official/07-integrations-automation/73-automation) | 需要把 CLI 放进 Shell、CI 或批处理 |
| [GitHub Action](/docs/gemini-cli/official/07-integrations-automation/74-github-action) | 需要在 GitHub workflow 里运行 Gemini CLI |
| [Issue 与 PR 自动化](/docs/gemini-cli/official/07-integrations-automation/75-issue-pr-automation) | 需要自动分诊 issue、生成回复、辅助 PR review |
| [本地开发](/docs/gemini-cli/official/07-integrations-automation/76-local-development) | 需要贡献 Gemini CLI 或排查 CLI 自身 bug |

## 选择方式

```text
人在 IDE 里工作     IDE companion 或 ACP
需要流程拦截        hooks
需要脚本调用        headless mode
需要 CI 自动处理    run-gemini-cli GitHub Action
需要改 Gemini CLI   本地开发流程
```

## 进入前检查

| 检查项 | 为什么重要 |
| --- | --- |
| 输入是否可重复 | 自动化必须能在无人工补充的情况下复跑 |
| 输出是否可审计 | CI、issue 和 PR 场景要能追踪 Gemini 做了什么 |
| 权限是否收窄 | hooks、headless、GitHub Action 都可能放大工具权限 |
| 失败是否可兜底 | 自动化失败要回到日志、人工 review 或普通 CLI |

## 下一步

先读：[IDE 集成](/docs/gemini-cli/official/07-integrations-automation/70-ide-integration)。

## 官方来源

- [Google Developers Gemini CLI](https://developers.google.com/gemini-code-assist/docs/gemini-cli?hl=zh-cn)
- [Gemini CLI GitHub](https://github.com/google-gemini/gemini-cli)
