在使用 Codex 进行代码辅助开发时，许多开发者希望通过 GitHub 集成实现代码仓库的无缝同步与协作。然而，配置过程中常出现连接失败或权限错误等问题。本指南旨在提供一套清晰的步骤清单，帮助您在 Codex 中文指南环境下快速解决 GitHub 集成故障。
检查 GitHub 授权状态
首先，确认 Codex 是否已获得正确的 GitHub 访问权限。进入设置界面，查看 OAuth 应用授权列表。若发现授权已过期或被撤销，请点击“重新授权”按钮。确保选择的是包含必要读写权限的范围，特别是针对代码仓库的访问权。同时，检查 GitHub 账户是否存在双重验证问题，这可能导致令牌生成失败。
验证网络连接与代理设置
网络波动或企业防火墙限制是导致集成中断的常见原因。请尝试切换网络环境，排除本地 DNS 解析错误。若处于公司内网，需确认代理服务器是否允许 GitHub API 的请求通过。在 Codex 客户端中，手动测试 GitHub 连接状态，观察是否有超时提示。如有必要，调整网络策略以放行相关端口。
重置集成配置
若上述步骤无效，建议重置集成配置。注销当前的 GitHub 账号绑定，清除本地缓存的认证令牌。然后重新登录，按照向导完成授权流程。注意检查代码库的分支保护规则，确保 Codex 机器人具备推送代码的权限。完成后，重启 Codex 服务，验证功能是否正常恢复。