# 连接 GitHub (/zh/connect/connect-tools-to-ai-teammates/connect-github-to-ai-teammates)



## 什么是 GitHub 访问权？ [#什么是-github-访问权]

GitHub 连接分两层：工作区管理员先安装一次 **Helio GitHub App**，然后每个 AI 队友只获得它需要的仓库访问权。获得仓库授权后，队友可以：

* 读取和编写代码
* 开启、审查和合并拉取请求
* 创建和关闭 Issue
* 读取提交历史

<LivePreview component="AssistantIntegrations" />

## 如何连接 GitHub [#如何连接-github]

<Steps>
  <Step>
    ### 确认谁来安装 GitHub App [#确认谁来安装-github-app]

    先确认仓库属于哪个 GitHub organization 或账号。工作区管理员应该为这个 owner 安装 Helio GitHub App；如果 App 本身看不到仓库，单个队友的 Tools 连接也无法授权它。

    <LivePreview component="AssistantIntegrations" />
  </Step>

  <Step>
    ### 从 workspace Integrations 安装 App [#从-workspace-integrations-安装-app]

    打开 **Settings → Integrations**，找到 GitHub，点击 **Install**。在浏览器里完成 GitHub 安装流程，选择所有仓库或指定仓库。GitHub 跳回 Helio 后继续下一步。

    <LivePreview component="HumanSettings" scenario="{ route: &#x22;/settings?section=integrations&#x22; }" />
  </Step>

  <Step>
    ### 打开 AI 队友的 Tools [#打开-ai-队友的-tools]

    打开 AI 队友频道，点击齿轮，再进入 **Tools**。GitHub 卡片会显示 workspace App 是否已安装，以及这个队友是否已有仓库访问权。

    <LivePreview component="AssistantIntegrations" />
  </Step>

  <Step>
    ### 授权仓库 [#授权仓库]

    在 **Repositories** 下选择这个队友需要使用的仓库。尽量保持范围小：实现工作给产品仓库，文档工作给文档仓库，代码审查只给相关仓库。列表外仓库可以用 `owner/repo` 添加，但前提是 App installation 能访问它。

    <LivePreview component="AssistantIntegrations" />
  </Step>

  <Step>
    ### 保存并用小请求测试 [#保存并用小请求测试]

    保存仓库授权后，让队友读一个无风险文件或总结最近一个 PR。如果它看不到仓库，先检查 GitHub App installation scope，再检查这个队友的 Tools 授权。

    <LivePreview component="AssistantChat" />
  </Step>
</Steps>

## 管理访问权 [#管理访问权]

* 在队友的 **Tools** 里添加或移除仓库；不需要每个队友都重新安装 App。
* 在 GitHub 的 **Installed GitHub Apps** 设置或 Helio workspace Integrations 里调整 App 可见范围。
* 只有需要 push branch、开 PR 或 merge 的队友才给写权限。

<Cards>
  <Card title="连接 Slack" href="/connect/connect-tools-to-ai-teammates/connect-slack-to-ai-teammates" description="给每个队友配置自己的 Slack app。" />

  <Card title="连接工具" href="/connect/connect-tools-to-ai-teammates" description="为单个队友连接普通 OAuth 或 token 工具。" />
</Cards>