Claude 可以把 GitHub 仓库中的指定文件加入聊天或项目知识。 在聊天里从“+”选择“从 GitHub 添加”;长期反复分析同一套代码时,可以把文件放进项目,并在代码更新后使用同步按钮。
这套入口适合看懂陌生项目、梳理接口和解释某段实现。本文按官方的 GitHub 集成功能讲解,代码提交与部署需要另外安排工作流。
一次提问放聊天,持续阅读放项目
| 你要完成的事 | 入口 | 后续动作 |
|---|---|---|
| 解释几个文件 | 聊天“+” | 选择文件后发送问题 |
| 多次讨论同一个模块 | 项目知识“+” | 添加 GitHub 文件并定期同步 |
| 调整分析范围 | 项目中的配置图标 | 增减文件或文件夹 |
首次使用时,Claude 会引导你完成 GitHub 身份验证。使用拥有目标仓库权限的账号,后面的文件选择器才有机会列出对应内容。
在聊天中接入代码
- 打开 Claude 聊天,点击输入区左下角的“+”。
- 选择“从 GitHub 添加”,按提示完成 GitHub 登录授权。
- 在文件浏览器里勾选本次问题涉及的文件和文件夹。
- 写清问题并发送;Claude 会读取选中内容作为回答上下文。
第一次分析登录流程,可以先选路由文件、认证逻辑和相关测试。依赖目录、构建产物会占用上下文,先把范围放在当前流程涉及的源码与测试。
请根据选中的文件说明登录请求的处理顺序。每一步写出文件路径和函数名;缺少的依赖文件单独列出,先不要猜测它的实现。
先检查回答引用的文件是否属于你选中的范围。 若它指出缺少配置或调用方,补上对应文件后再追问,比一开始塞入整个仓库更容易核对。
项目中的代码怎样保持更新
打开项目,在项目知识右上角点击“+”,选择 GitHub。搜索可访问仓库或粘贴仓库 URL,再选择文件。后续同一项目的聊天就可以利用这些内容。
项目提供“同步”和配置图标。准备讨论刚合并的代码前,先同步,再确认新增文件是否已纳入选择范围。 同步已有内容与增加新目录是两件事:前者更新版本,后者需要检查配置。
可以让 Claude 先回答“当前选中模块包含哪些文件、入口在哪里”,再展开性能或错误分析。这样能提前发现选错目录或遗漏测试的问题。
私有仓库不出现,按权限层级排查
| 现象 | 检查位置 | 应采取的动作 |
|---|---|---|
| 粘贴私有库 URL 后无法读取 | GitHub App 的仓库访问范围 | 授予指定仓库访问,或请求管理员批准 |
| 已连接,唯独一个组织的库不出现 | GitHub 应用的组织访问 | 完成该组织的 SSO 授权 |
| 组织旁显示“请求” | 组织 OAuth 应用策略 | 等组织管理员批准请求 |
SSO 场景下,进入 GitHub 的 Settings → Applications,打开 Claude 条目,在组织访问处查看“授予”或“请求”。官方明确说明,反复断开重连不会自动补齐组织 SSO 授权。
使用企业托管用户的组织,还需要在托管账号登录且 SSO 会话有效时连接。管理员可以检查组织的第三方应用访问设置,以及 Claude App 是否有尚未批准的请求。
常见问题
Q: Claude 连接 GitHub 后会读取整个仓库吗? A: 添加时由你选择具体文件和文件夹。围绕当前任务选择范围,并检查项目配置中实际包含的内容。
Q: 聊天和项目分别从哪里添加? A: 聊天从左下角“+”选择“从 GitHub 添加”;项目从项目知识右上角“+”选择 GitHub。
Q: 私有仓库可以连接吗? A: 可以,前提是 GitHub 账号和 Claude 应用具有相应访问权限;组织管理员可能需要批准。
Q: 项目的仓库内容什么时候更新? A: 官方提供同步图标。仓库有变更或开始新分析前,主动同步并检查文件选择范围。
Q: 已连接却看不到公司的仓库怎么办? A: 优先检查组织 SSO 授权,以及 GitHub App 是否被授予目标仓库权限。
Q: 可以把这篇当作 Claude Code 的 Git 推送教程吗? A: 本文覆盖 Claude 聊天和项目里的文件接入。终端中的 Git 提交、推送及测试属于另外的开发操作。
参考来源
事实核对日期:2026 年 11 月 4 日。