Codex 访问 GitHub 项目：仓库权限与凭证排查

TL;DR：先证明 Git 能访问，再让 Codex 处理代码

Codex 访问 GitHub 项目时，先把问题拆成两层：Git 本身能否读取远程仓库，以及 Codex 是否在正确的项目目录中运行。先用 Git 官方命令验证远程地址和权限，再把明确的文件范围交给 Codex，不要把访问令牌粘进提示词。

第一步：确认当前目录和远程地址

pwd
git rev-parse --show-toplevel
git remote -v
git branch --show-current

如果 git rev-parse 失败，说明当前目录不是 Git 仓库。先进入正确的项目目录，或按团队流程克隆仓库；不要让 Codex 在错误目录里猜测项目结构。

第二步：用 Git 验证远程读取权限

读取远程引用不会修改本地文件，可以先运行：

git ls-remote origin HEAD

根据返回结果判断：

• 能返回提交引用：远程地址和基础读取权限基本可用；
• 提示仓库不存在：检查组织名、仓库名和远程 URL；
• 提示认证失败：检查 Git 凭证、组织策略或当前账号；
• 网络超时：转到 网络连接排查，不要先改仓库配置。

如果项目使用多个远程仓库，逐个检查名称和用途：

git remote get-url origin
git remote get-url --push origin

第三步：让 Codex 在正确分支中工作

确认远程访问后，再让 Codex 先做只读任务：

请先读取当前分支、远程仓库名称和项目 README，说明：
1. 当前分支是否适合修改；
2. 项目的测试命令是什么；
3. 目标文件是否存在。
不要访问或输出任何令牌、私钥和个人凭证，也不要修改文件。

如果需要修改，先建立独立分支并写出验收条件：

git switch -c codex-github-task
git status --short

Codex 不应替你决定提交、推送或覆盖远程分支。提交和推送仍然需要你检查 diff、测试结果和目标分支。

访问问题的判断表

| 现象 | 更可能的层级 | 下一步 | | --- | --- | --- | | git remote -v 没有输出 | 本地仓库配置 | 检查是否在正确目录，确认远程是否需要添加 | | git ls-remote origin HEAD 失败 | GitHub 地址或凭证 | 脱离 Codex 单独修复 Git 访问 | | Git 能访问，Codex 找不到文件 | Codex 启动目录 | 让 Codex 先输出项目根目录和文件列表 | | 能读仓库但不能推送 | 分支保护或写权限 | 按团队流程提交 Pull Request，不要强行推送 |

常见报错与解决

| 报错或现象 | 常见原因 | 处理方式 | | --- | --- | --- | | Repository not found | URL 错误或账号无权访问私有仓库 | 先用浏览器或 Git 官方命令核对仓库可见性 | | Permission denied | 凭证无效、组织策略限制或没有写权限 | 区分读取和推送权限，必要时联系仓库管理员 | | Could not resolve host | DNS 或网络环境问题 | 检查网络和代理，再看网络排错页 | | Codex 要求输出令牌 | 不应满足此要求 | 立即停止，使用脱敏信息重新描述问题 |

FAQ：Codex 如何安全访问 GitHub

需要把 GitHub Token 发给 Codex 吗？

不需要。Codex 可以使用当前机器已经配置的 Git 凭证，但提示词、日志和截图都不应包含令牌内容。

Git 能拉取但 Codex 不能修改，是什么问题？

拉取权限和本地文件写权限是两件事。先检查目录权限、当前用户和 Git 工作区状态，再确认 Codex 的审批设置。

Codex 可以直接替我推送代码吗？

是否推送取决于你的命令和权限配置，但生产分支不应自动推送。更稳妥的路径是让 Codex 修改独立分支，人工检查 diff 和测试后再提交。

私有仓库能不能让 Codex 读取？

前提是当前 Git 凭证本身有读取权限，并且组织政策允许。先用 git ls-remote 验证，不要用 Codex 的自然语言总结代替权限检查。

完成仓库访问检查后，可继续看 Codex 第一次任务、AGENTS.md 项目规则 和 Codex 429 排错。