AI Agent / 系统课时

连接 GitHub 仓库

连接 GitHub 仓库

Codex 云端要读取、修改并基于仓库执行任务,第一步是把 GitHub 账号与 Codex 的云端工作流连接起来,并明确授权到哪些组织和仓库。本节完成最小权限授权、组织审批检查,以及连接后的实际仓库验证。

学习目标

  • 能完成 GitHub 授权并把访问范围限制到目标仓库
  • 能区分个人授权、GitHub 组织审批与仓库级访问范围
  • 能在 Codex 云端任务中验证目标仓库已经被正确检出

授权前先确定访问范围

先确认你准备让 Codex 使用哪个 GitHub 账号、哪个组织以及哪些仓库。推荐从单个测试仓库开始,而不是一开始授权整个组织。安装 GitHub 集成与授予具体仓库访问权是两件事:集成已经安装,不代表某个私有仓库一定在允许范围内。

如果目标仓库属于 GitHub Organization,还要确认组织是否要求管理员审批第三方应用。你本人能在浏览器打开仓库,并不意味着已安装的 GitHub 应用自动拥有相同权限;组织策略可能继续阻止访问。

从 Codex 发起 GitHub 连接

在 Codex 的云端入口发起 GitHub 连接后,浏览器会进入 GitHub 的真实授权或安装流程。选择正确账号与组织,并把仓库范围限制为本课要使用的目标仓库;如果组织要求审批,先完成管理员审批,再回到 Codex 继续。

在云端任务里验证仓库

授权完成后,创建一个以目标仓库为上下文的 Codex 云端任务,并让任务环境检查当前工作目录、分支和远程仓库。下面的命令只读取 Git 状态,不会修改代码:

bash
git status --short --branch
git remote -v

预期输出

text
## <BRANCH>
origin  https://github.com/<OWNER>/<REPO>.git (fetch)
origin  https://github.com/<OWNER>/<REPO>.git (push)

实际分支名和仓库地址会不同。只要 origin 指向预期仓库,并且命令能正常读取 Git 状态,就说明该云端任务已经拿到目标仓库上下文。不要以“GitHub 授权页面显示成功”替代这一步验证。

仓库不可见时按权限链排查

如果 Codex 中找不到仓库,先确认 GitHub 当前登录账号本身能访问该仓库,再检查 GitHub 应用是否被安装到正确组织,以及该仓库是否包含在允许范围内。对组织仓库,还要检查管理员审批或组织级应用限制是否尚未完成。

若个人仓库可见而组织仓库不可见,优先怀疑组织策略;若同一组织只有部分仓库不可见,优先检查仓库选择范围。不要反复解除并重新连接账号,这通常会掩盖真正的权限边界问题。

连接成功后的原则很简单:Codex 只应获得完成任务所需的仓库范围。先小范围授权、在云端环境实际验证,再逐步扩展,比一次性开放整个组织更安全,也更容易定位后续的访问故障。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

连接 GitHub 仓库

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通