Codex 连接 GitHub 后找不到仓库或文件怎么办？
Codex 连接 GitHub 后搜不到仓库、读不到文件或任务无法启动时，按组织授权、仓库范围、文件路径、分支和同步状态排查。
适用场景：授权成功不等于能看到全部内容
Codex 接 GitHub 后，用户经常会遇到三类问题：列表里看不到某个仓库；仓库能选中但找不到目标文件；任务启动后 Codex 读到的分支和你本地看到的不一样。很多人第一反应是重新登录，但真正原因可能是组织授权、仓库选择范围、默认分支、文件路径或远程同步延迟。
这篇适合给 Codex 接入私有仓、团队组织仓或多仓库项目时使用。永沃云枢在 https://ai.jn83.com 的实操建议是，先把 GitHub 连接当成权限和索引问题处理，再进入 AI API 接入、模型调用管理或自动化改代码流程，避免让 Codex 在错误仓库里猜。
操作步骤：按“账号、组织、仓库、文件”排查
第一步，确认登录账号。浏览器里当前 GitHub 账号、Codex 授权账号和组织成员身份要一致。若你有个人号和公司号，先确认仓库到底在哪个账号下，不要只看显示头像。
第二步，看组织授权。有些组织要求管理员批准第三方应用，成员自己点授权后仍然无法访问组织私有仓。遇到这种情况，应请管理员检查应用权限、允许的仓库列表和 SSO 状态，而不是反复刷新 Codex 页面。
第三步，确认仓库范围。为了降低风险，很多团队只授权 selected repositories。新增仓库、改名仓库或迁移到新组织后，要重新把仓库加入授权范围。仓库能打开，不代表里面所有分支和文件都已经被当前任务上下文选中。
第四步，给 Codex 明确文件路径和分支。不要只说“改登录页”，最好写成“在 main 分支检查 pages/login 或 app/login 相关文件，先只读并列出路径”。如果 GitHub 搜索只能按仓库名定位，就先进入仓库，再让 Codex 用项目内搜索找文件。
常见问题/避坑：不要把本地未推送改动当成远程文件
本地已经改过但没有 push 的文件，Codex 远程任务通常看不到。相反，远程分支新提交了内容，本地 IDE 可能还没 pull。排查时要写清楚 commit、分支和文件路径，必要时让 Codex 先输出它看到的最新提交摘要。
另一个坑是仓库太大。大仓库里搜索文件名、生成索引或读取上下文都可能变慢。建议先给目录范围，例如只看 packages/web、server/api 或 docs，并把不相关目录排除。这样 Codex 接入更像一次有边界的工程任务，而不是让模型在全仓里碰运气。
检查清单：任务启动前确认这些证据
GitHub 登录账号正确；组织已批准授权；仓库在允许范围内；目标分支明确；目标文件路径明确；本地改动已推送或说明不需要；Codex 能列出相关目录；任务只读预检通过；不会访问无关仓库；有失败时的截图或错误文案。
FAQ：找不到文件时能直接让 Codex 全仓搜索吗？
可以，但要给边界。比如让它先列出可能目录，再确认后读取文件，而不是直接改动。对包含客户资料、密钥、账单和生产配置的仓库，更要限制访问范围。GitHub 连接问题本质上是权限和上下文问题，先把边界说清楚，后面的开发者 AI 调用才可靠。
如果排查仍然没有结果，可以把错误文案、仓库 URL、组织名称、目标分支、目标文件路径和授权截图整理成一份最小复现材料。交给管理员或平台支持时，只提供必要信息，不要附带完整密钥、客户数据或无关仓库列表。这样既能保护账号安全，也能让问题定位更快。
最后再做一次人工确认：让仓库负责人在网页端打开同一分支和同一路径，确认文件确实存在，再让 Codex 只读列目录。这个动作很土，但能排除拼写、大小写、目录迁移和默认分支切换造成的误会。