ChatGPT 看 GitHub 项目：Connect GitHub 实战教程
ChatGPT 看 GitHub 是 OpenAI Connectors 的功能：把 ChatGPT 接到你的 GitHub 仓库，让它直接读代码、回答项目问题。本文按授权、问问题、限制保姆级走一遍
30 秒了解：ChatGPT 看 GitHub，到底是什么
ChatGPT 看 GitHub 是 OpenAI Connectors 体系下的一个连接器：把你的 GitHub 账号授权给 ChatGPT 后，ChatGPT 能直接读你的仓库代码、issue、PR，回答跟项目相关的问题，不用你手动复制粘贴代码。 跟 Claude Code 在本地终端跑不一样，ChatGPT Connect GitHub 是「网页 ChatGPT 远程读 GitHub 仓库」——适合不在本地、不开 IDE 也想问 AI 关于代码的问题的场景。
这篇按授权 → 提问 → 限制保姆级走一遍。
如果你还不熟悉 ChatGPT，先看 ChatGPT 怎么注册 和 ChatGPT Plus 值不值 跑通基础。
准备工作：3 件事
- ChatGPT 付费账号：Connectors 通常需要 Plus / Pro / Team / Enterprise 中的至少一档（免费档支持有限）
- 一个 GitHub 账号：要分析的代码所在的账号
- 代码仓库的访问权限：你自己的私有仓库 OK，组织仓库可能要 admin 同意
第 1 步：在 ChatGPT 里开启 GitHub 连接器
打开 chatgpt.com，左下角点头像 → Settings（设置）→ 找 Connectors（连接器）面板。
里面列着所有可用的 Connectors：GitHub、Google Drive、SharePoint、Outlook、Dropbox 等等。找到 GitHub 一行：
- 状态显示 Not connected 就点旁边的 Connect
- 弹出一个 OAuth 授权页，跳到 GitHub
- 登录你的 GitHub 账号、授权 ChatGPT 访问
提示：第一次授权要求的是「读取仓库元数据 + 代码内容 + issue / PR」的权限。仔细看授权页列出的权限清单，确认你能接受再点 Authorize。
授权完跳回 ChatGPT 设置页，GitHub 状态变成 Connected，旁边显示你的 GitHub 用户名。
选择能访问的仓库范围
GitHub 授权时有两种范围：
- All repositories（所有仓库）：包括你的全部公开 + 私有仓库
- Only select repositories（选定的仓库）：手动勾选哪些仓库可以被 ChatGPT 读
强烈推荐选 Only select repositories——按需开放，不要一次给 ChatGPT 全部访问。可以先勾 1-2 个测试用的项目跑通流程，再按需加。
注意：组织（Organization）下的仓库，授权需要组织 admin 批准 OAuth App。个人项目随便授权，公司项目可能要走流程。
第 2 步：在 ChatGPT 对话里调用 GitHub
授权完回到 ChatGPT 主界面，新开一个对话。在输入框工具栏附近找到 附件 / 工具 按钮（不同版本位置略不同），里面会有 GitHub 选项；或者在 GPT-5 / 高级模型下，工具会自动按对话内容启用。
直接打字问跟 GitHub 相关的问题，ChatGPT 会自动调用 GitHub Connector：
帮我看一下 myusername/my-project 这个仓库，
README 写得怎么样？有没有需要补充的地方？ChatGPT 会：
- 通过 GitHub API 拉这个仓库的 README
- 读完内容
- 给你具体的修改建议
注意：第一次调用某个仓库时可能略慢（要拉文件、做索引）。后续对同一仓库的问题会快很多。
几个高频提问场景
场景 1：让 ChatGPT 解释陌生代码
看一下 myusername/legacy-app 仓库里的
src/services/payment.ts 文件。
用中文解释这个文件主要做什么、
有哪些关键函数、调用关系是怎样的。场景 2：让 ChatGPT 找 bug
我在 myusername/my-app 的 src/api/user.ts 里
有个函数老是返回空数组。
帮我看一下这个文件，结合调用方
src/pages/Users.tsx，定位可能的原因。场景 3：让 ChatGPT 写 PR 描述
看 myusername/my-app 仓库的 PR #142，
帮我用中文写一份完整的 PR description，
说明改了什么、为什么、怎么测。场景 4：让 ChatGPT 跟你 review 老 issue
帮我看一下 myusername/my-project 的 Issue #88。
issue 提出已经 6 个月没人处理了，
基于当前 main 分支的代码状态，
分析这个 issue 还是不是真问题、该怎么解决。第 3 步：理解 Connector 的边界（最关键的一段）
ChatGPT 看 GitHub 不等于 ChatGPT 能在 GitHub 里干活。它能做和不能做的事差别很大：
能做的事
- 读仓库文件（按路径或语义搜索）
- 读 issue 和 PR 内容（含评论）
- 读 commit 历史（看变更记录）
- 读 README / 文档
- 跨多个授权仓库做横向分析
不能做的事
- 不能直接修改你 GitHub 上的代码（不会推 commit、不会改 issue）
- 不能创建 PR / Issue（除非走 ChatGPT Agent 等更高级模式，仍受限）
- 不能跑你的代码（看代码不等于执行代码）
- 不能访问没授权的仓库（包括公开仓库 — 默认只看你授权的范围）
- 不能跟 IDE 里的本地代码联动（只读 GitHub 上已 push 的版本）
一句话：ChatGPT 看 GitHub 是「远程只读」。想让 AI 真正改代码、跑代码，用 Claude Code 或 Cursor。
跟 Cursor / Claude Code 的本质区别
| 维度 | ChatGPT Connect GitHub | Cursor / Claude Code |
|---|---|---|
| 形态 | 网页 ChatGPT 对话 | 本地 IDE / CLI |
| 看代码来源 | GitHub 远端仓库 | 本地工作目录 |
| 能否改代码 | 不能（只读） | 能（直接改本地文件） |
| 能否跑代码 | 不能 | 能（跑命令、看输出） |
| 适合场景 | 出差 / 没装环境 / 快速问 | 真正开发主力 |
怎么选：日常开发主力 100% 用 Cursor / Claude Code；出差 / 上下班路上 / 临时想问代码问题，掏出手机 ChatGPT 用 Connect GitHub。两者互补，不冲突。
ChatGPT 看 GitHub 的 5 个高级玩法
玩法 1：跨仓库横向分析
授权多个项目后，可以让 ChatGPT 一次对比：
对比一下我的两个仓库 myusername/old-api 和 myusername/new-api。
请分析：
- 技术栈有什么差异
- API 设计哪些地方变好了、哪些变差了
- 如果要把 old-api 里某些设计搬到 new-api，最该搬哪 3 个
- 给我一个分阶段的迁移建议
输出用中文、结构化列表。
适合：维护多个相关项目的时候，让 ChatGPT 给你做架构层面的横向思考。
玩法 2：让 ChatGPT 帮你写 onboarding 文档
接手新项目最痛的就是没文档。让 ChatGPT 给你写：
看 myusername/legacy-project 仓库， 帮我写一份新人 onboarding 文档。
要求：
- 项目用途一句话说清
- 技术栈清单 + 简短说明每个技术选型的原因
- 目录结构图 + 每个目录的职责
- 关键流程（如用户登录、支付、数据同步）的代码路径
- 本地开发环境怎么搭起来
- 常见坑 + 解决办法
输出 Markdown 格式，4000 字以内。
它会读项目的多个文件、综合写出一份草稿。你审一遍、补真实信息，比从零写省一大半时间。
玩法 3：用 Connector 做 code review 辅助
PR 提了之后，让 ChatGPT 帮你提前自查：
看 myusername/my-app 仓库的 PR #某编号。
帮我做一次 review：
- 这次改动的核心逻辑有没有 bug 风险
- 有没有破坏现有 API 的兼容性
- 测试覆盖够不够
- 代码风格跟项目其他部分一致吗
- 如果你是 reviewer 会提哪 3-5 个 comment
输出按上面 5 点结构化、用中文。
适合：提 PR 前自己用 ChatGPT 跑一轮，省掉同事 review 时挑明显问题的时间。
玩法 4：让 ChatGPT 帮你回老 issue
老项目 issue 堆了几百个，让 ChatGPT 分类：
看 myusername/my-project 仓库的 open issues。
按下面分类：
- 已过期（功能早改没了或问题不存在了）
- 真问题但重复（指出跟哪个 issue 是同一个）
- 真新问题需要解决（按优先级排序）
给我每个分类的列表 + 处理建议。
适合：开源维护者周末花 1 小时做一次 issue 大扫除。
玩法 5：用 ChatGPT 写 release notes
要发新版本时让 ChatGPT 综合写 release notes：
看 myusername/my-app 仓库从 v1.2.0 到 main 分支之间的所有 commit。
帮我写一份 v1.3.0 release notes：
- 用 Conventional Commits 风格分类（feat / fix / docs / chore）
- 用户视角说明每个改动的影响
- 突出 breaking changes
- 写一段升级指引
输出 Markdown 格式，准备发到 GitHub Releases 用。
常见的 4 个坑
| 现象 | 原因 | 解决 |
|---|---|---|
| 授权完但 ChatGPT 看不到仓库 | 选了 Only select repositories 但没勾对仓库 | 去 GitHub Settings → Applications → 找 ChatGPT 编辑授权范围 |
| ChatGPT 拒绝读组织私有仓库 | 组织 admin 没批准 OAuth App | 联系 admin 在 Organization Settings → Third-party access 批准 |
| 同一文件问两次答案不一样 | 模型有随机性 / 仓库被你改过 | 重要决策不要只信一次回答，多问几次取共识 |
| 想让 ChatGPT 改 GitHub 代码 | 当前 Connector 只读、不能写 | 想改代码用 Claude Code 本地干 |
怎么管理已授权的访问
随时去 github.com/settings/applications 看：
- OAuth Apps 列表 里能找到 ChatGPT
- 点进去能看到授权范围、勾选哪些仓库
- 不想用了点 Revoke（撤销）一键断开
ChatGPT 这边也能断：Settings → Connectors → GitHub → Disconnect。两边都断 = 完全清理。
离职 / 换工作前一定记得 Revoke 公司 GitHub 的授权——OAuth 授权一旦给了不会自动过期。
安全提醒：3 件事必看
- 不要授权敏感商业仓库：哪怕 OpenAI 承诺企业用户数据不训练，把客户代码 / 核心算法暴露给第三方依然是合规风险，企业用先走法务 / 安全审计
- 定期检查授权：每季度去
github.com/settings/applications看一眼，过期的、不用的、忘了存在的 OAuth App 全部 Revoke - API rate limit 注意：ChatGPT 读你仓库会消耗 GitHub API quota，频繁问可能撞到限速
下一步
- 想看 ChatGPT 注册 → ChatGPT 怎么注册
- 想看 ChatGPT Plus 值不值 → ChatGPT Plus 值不值
- 想看真正能改代码的 AI → Claude Code 怎么用
- 想看 IDE 内 AI → Cursor 怎么用
- 想看 ChatGPT vs Claude Code 选哪个写代码 → ChatGPT vs Claude Code 场景对比
- 想看 AI 编程全景 → AI 写代码完全指南
常见问题
Q：免费版 ChatGPT 能用 Connect GitHub 吗？ A：Connectors 体系功能基本要求 Plus / Pro / Team / Enterprise 中的至少一档。免费档支持的 Connector 类型有限，且功能受限。如果你已经付 Plus 钱，这个功能就是「白送」。
Q：ChatGPT 会把我代码拿去训练吗？ A：按 OpenAI 公开政策，付费档默认不用用户数据训练；Team / Enterprise 进一步承诺数据隔离。但企业敏感代码建议看最新 DPA / 隐私政策，重要项目走法务审批。
Q：Connect GitHub 跟 ChatGPT 网页直接粘代码有啥区别？ A：Connector 能让 ChatGPT 看「整个仓库结构」，可以跨文件检索、综合分析、读 issue / PR。粘代码只能给它看你复制的那一段。仓库级问题用 Connector，单文件代码片段用粘贴。
Q：ChatGPT 看到的代码是最新的吗？ A：是。每次提问时 ChatGPT 都通过 GitHub API 拉当前状态——所以你 push 之后立刻问就能看到新版本。但本地未 push 的代码它看不到。
Q：能让 Connect GitHub 跑测试或部署吗？ A：不能。Connector 只读 GitHub 远端内容，不能跑命令。要跑测试 / 部署用 Claude Code 本地干，或配合 GitHub Actions 跑 CI。