接手一个陌生 GitHub 项目，可以先让 Claude 阅读少量入口文件，画出模块关系，再按回答补充依赖。仓库集成由你选择分析范围，读懂一个模块后再扩大范围。 这样更容易检查它的解释是否对应实际代码。
先给这次阅读定一个成果
“帮我看懂这个仓库”范围很大。把成果缩小为一份可验证的说明，例如“新用户注册从哪个接口进入、写入哪些数据、有哪些测试覆盖”。
选文件时可以按下面的顺序准备：
| 阅读阶段 | 优先选择 | 希望得到的结果 |
|---|---|---|
| 了解项目 | README、目录说明、入口文件 | 项目用途与启动位置 |
| 理解一个流程 | 对应路由、处理函数、依赖模块 | 调用顺序和数据流 |
| 核对行为 | 相关测试与配置示例 | 已覆盖条件和待确认项 |
按仓库实际结构选择文件，并要求 Claude 在回答中写出所依据的路径。
把选好的文件交给 Claude
在普通聊天左下角点击“+”，选“从 GitHub 添加”。完成 GitHub 身份验证后，在浏览器里选择目标文件和文件夹，发送问题。
第一次问题可以这样写：
我在接手这个项目。请先说明已选文件各自负责什么，再按实际调用关系解释注册流程。每个步骤附文件路径和函数名。缺少文件时告诉我需要补哪一份。
得到说明后，回到仓库核对两处入口和一处关键判断。路径、函数和判断条件都能找到，才继续用这份说明安排修改。 如果回答引用了未提供的文件，先确认它是在根据已读代码推断，还是已有直接依据。
追问要增加信息，不重复同一个大问题
假设 Claude 发现入口调用了一个未提供的权限模块，可以把该模块加入，然后问“新文件补齐后，前面的流程说明哪些地方需要修改”。
阅读测试时，要求它对应到具体条件：成功响应测试了什么，失败分支是否有用例，边界值是否只写在注释中。把测试名称与对应条件记下来，修改后用项目测试确认实际行为。
反复阅读同一仓库，放进项目
在 Claude 项目知识区域点“+”，选 GitHub，搜索仓库或粘贴 URL，再勾选文件。项目保存了可供后续聊天使用的代码上下文。
每次合并涉及该模块的改动后，先点同步图标。若出现新目录，再用配置图标调整选取范围。同步旧文件与纳入新文件都要检查，否则解释可能覆盖不到新增加的部分。
可以在开场问题里要求 Claude 列出本次分析所依据的文件，再逐项核对。这比只问“你是否用了最新版”更容易查证。
私有库权限卡在哪里
仓库列表与 GitHub 账号、Claude App 的授权范围和组织策略有关。能在浏览器打开仓库，仍需检查 Claude App 是否获准访问。
组织采用 SSO 时，进入 GitHub Settings → Applications → Claude，查看组织访问是否已授予。若按钮显示“请求”，交由组织管理员审批。官方说明，断开后重连不会自动完成 SSO 授权。
常见问题
Q: 读仓库必须先把全部代码下载到电脑吗？ A: 本文使用 Claude 的 GitHub 集成，在聊天或项目里直接选择仓库文件，无需按本文另建本地副本。
Q: 第一次该选哪些文件？ A: 围绕一个具体流程选择说明、入口和直接依赖，再依据回答补充相关测试与配置。
Q: 多轮追问适合放在哪里？ A: 单次阅读可用普通聊天；持续研究同一模块时，可将文件加入项目知识。
Q: 新提交合并后怎样更新上下文？ A: 在项目中使用同步图标，并检查配置中的文件选择是否包含新增文件。
Q: 为什么公司私有库在列表中消失？ A: 检查账号权限、GitHub App 仓库授权和组织 SSO；组织策略可能需要管理员批准。
Q: Claude 给出解释后能直接按它修改吗？ A: 先对照仓库核实文件和条件，再通过项目自己的测试验证改动。阅读解释作为开发参考保留。
官方依据
核对日期：2026 年 11 月 4 日。