先判断:你缺的是仓库授权,还是 Codex 环境
GitHub 连接和 Codex 云端环境不是同一层。GitHub App 决定可访问的仓库;Codex 环境决定任务检出的仓库、分支或提交,以及运行的依赖和脚本。只完成其中一项,仓库未必出现在所有入口。
如果普通 GitHub 搜索里也看不到仓库,优先检查 App 授权和组织审批;如果仓库能被连接但创建 Codex 任务时无法选择,优先检查 Codex 环境是否为该仓库创建、当前用户是否拥有对应访问权,以及工作区是否启用了 Codex Cloud。
下图为本站原创的仓库授权链路示意封面,不是 GitHub 或 OpenAI 官方界面。

适用人群与典型症状
本文适用于使用 Codex 云端任务、代码审查或 ChatGPT GitHub 连接的开发者。不同 ChatGPT Plus、Pro、Business、Enterprise 工作区的入口和权限可能不同;请以当前账号界面为准。
仓库规则可参考AGENTS.md 实践;仓库可见但无法写文件或联网时,转到Codex 权限与沙箱指南。
- GitHub 已显示授权成功,但 Codex 下拉列表没有目标仓库
- 个人仓库可见,组织仓库不可见
- 新建仓库短时间内搜索不到
- 团队成员能用同一环境,自己却没有权限
- 仓库可选,但任务检出的分支或提交不是预期版本
五层排查模型:从账号到运行环境
按层排查比反复重连更快。每通过一层,保留 GitHub 仓库范围、组织审批状态、Codex 环境名称或实际分支等证据。
| 层级 | 要核对什么 | 常见现象 | 建议动作 |
|---|---|---|---|
| 身份 | ChatGPT 与 GitHub 是否为预期账号 | 只看到另一个账号的仓库 | 分别确认登录邮箱与 GitHub 用户名 |
| App 授权 | GitHub App 是全部仓库还是选定仓库 | 个人仓库可见,目标仓库缺失 | 在 GitHub 配置页补选仓库 |
| 组织策略 | 是否需要组织管理员批准 | 出现 Request 或受限提示 | 提交申请,由 GitHub 组织管理员审批 |
| 同步与索引 | 仓库是否新建、私有或刚修改授权 | 授权正确但列表暂时为空 | 等待短暂同步后再检查,必要时触发 GitHub 索引 |
| Codex 环境 | 环境是否绑定正确仓库、分支与可见范围 | 普通连接可见,云任务不可选 | 在 Codex 环境设置中创建或修正环境 |
第一步:检查 GitHub App 的仓库授权范围
在 ChatGPT 的 Settings → Apps 中打开 GitHub,进入 Choose repositories 或 GitHub 配置页。确认安装目标是正确账号或组织,并查看授权范围是“全部仓库”还是“仅选择的仓库”。仓库新建或转移后,要重新核对授权范围。
OpenAI 帮助中心指出,刚连接或修改授权后,仓库可能需要几分钟才显示。可先确认 GitHub 本身能搜索到仓库;文档还给出 repo:owner/repo import 形式的搜索作为手动触发索引的方法。
任何连接都不会绕过 GitHub 原有权限。你在源系统里无权读取的私有仓库,不会因为连接到 Codex 就自动获得访问权。
第二步:检查组织管理员审批与工作区权限
组织仓库常见的拦截点是 GitHub App 安装策略。个人可以发起 Request,但最终是否批准、能访问哪些仓库,仍由 GitHub 组织管理员控制。企业工作区还可能需要管理员在 ChatGPT 工作区中启用 Codex Cloud 或代码审查权限。
如果同事能看到仓库而你看不到,比较 ChatGPT 工作区、GitHub 仓库权限和 Codex 环境可见范围。不要共享账号、令牌或 Cookie 来“临时验证”。
- 查看 GitHub App 安装请求是否仍在 Pending
- 确认组织是否限制第三方 GitHub Apps
- 确认自己对私有仓库至少具有被授权的读取权限
- 确认工作区管理员已允许使用 Codex Cloud 或相关功能
- 确认环境不是仅对创建者或特定成员可见
第三步:检查 Codex 云端环境、分支和缓存
Codex 云端任务启动时会创建隔离容器,检出所选分支或提交,运行 setup script,再应用网络访问设置。仓库已经授权但环境绑定错误时,任务仍可能找不到预期代码。进入 Codex 环境设置,核对仓库、默认分支、setup script、环境变量和可见范围。
缓存能加快后续任务,但依赖变化后可能不再合适。修改 setup script、maintenance script、环境变量或 secrets 会使缓存失效;确认授权和环境绑定正确后,必要时再在环境页面执行 Reset cache。
仓库一旦可见,建议先用只读任务验证上下文,例如“列出项目入口、测试命令和当前分支”,再提交写入任务。站内的Codex 新项目启动清单可以帮助确认仓库结构与验证命令。
代码审查看不到仓库时的专项检查
Codex 代码审查还要求该仓库已经设置 Codex Cloud,并在 Codex 的 code review 设置中开启。配置自动审查通常需要对仓库设置具有 push 或 admin 权限。若在 PR 评论中手动触发,应使用官方文档给出的 @codex review 形式,并确认 PR 属于已启用的仓库。
代码审查规则可放在根目录或子目录的 AGENTS.md 中,但不能替代分支保护、CI 和人工批准。合并前仍要审查 diff 与测试结果。
最小复现记录与安全边界
仍无法解决时,整理不含机密的最小复现:工作区类型、GitHub 安装目标、仓库归属、授权范围、审批状态、Codex 环境名称与错误提示。不要附上令牌、Cookie、私钥或仓库机密。
[GPTUPCN 首页](/)是第三方中文信息与服务入口,并非 OpenAI 或 GitHub 官方。产品入口、计划可用性、权限名称和同步行为可能变化,应以 OpenAI 与 GitHub 当前设置页面为准。
结论:先查授权,再查环境,最后才重置
推荐顺序是:确认账号 → 检查 GitHub App 范围 → 完成组织审批 → 等待同步或索引 → 核对 Codex 环境 → 必要时重置缓存。这样能把“看不见仓库”和“任务运行失败”分开处理。
权限问题没有安全的快捷绕过方式。让正确的管理员批准最小必要范围,并用一个只读任务验证仓库和分支,是比共享凭据或扩大到全部仓库更稳妥的做法。
官方资料与延伸阅读
产品界面、价格、额度和规则可能调整,涉及实时信息时请以官方页面与账号内显示为准。
相关文章
继续阅读同一主题下的文章,可以把购买、支付、套餐、账号和到账问题串成完整流程。
常见问题
GitHub 已连接,为什么 Codex 仍看不到新仓库?+
先检查 GitHub App 是否选中了该仓库。新建、私有或刚修改授权的仓库还可能需要短暂同步;若属于组织,也可能等待管理员批准。
需要把 GitHub App 授权给全部仓库吗?+
不需要。按最小权限原则,只选择任务确实需要的仓库更稳妥;后续可在 GitHub 配置页补充授权。
Codex 云端环境和 ChatGPT 的 GitHub App 是一回事吗?+
不是。GitHub App 负责数据访问授权,Codex 云端环境负责任务检出仓库、运行依赖、环境变量和网络策略。两层都要正确。
个人仓库可见,组织仓库不可见,最可能是什么原因?+
常见原因是组织限制第三方 App、安装请求未批准,或你的 GitHub 账号没有目标仓库权限。应由组织管理员核对安装与仓库范围。
重置 Codex 环境缓存能解决仓库不可见吗?+
通常不能解决授权缺失。缓存重置适合环境依赖或代码状态不兼容;仓库列表缺失应先检查账号、App 授权、组织审批和环境绑定。
ChatGPT Plus 或 Pro 是否一定能看到相同的 Codex 入口?+
不一定。功能可用性可能受计划、工作区策略、地区和产品入口影响。请以当前账号界面与官方文档为准,不要依据他人截图推断。