Codex连接问题可能发生在账号登录、仓库授权、环境准备、依赖下载、任务联网或Git推送中的任一层。看到“连接失败”时,先确定阶段,不要反复退出账号或修改全部网络设置。
按阶段保存证据
| 阶段 | 最小检查 | 常见边界 |
|---|---|---|
| 登录 | ChatGPT账号完成授权 | 套餐资格、工作区策略可能不同 |
| 仓库 | 能列出并读取目标仓库 | 读取权限不等于推送权限 |
| 环境 | 环境准备完成并能读取项目 | 依赖源和私有服务可能另需凭据 |
| 任务联网 | 明确目标域名是否允许访问 | 本地、云端和浏览器环境不同 |
| 推送 | Git身份与远端权限通过 | GitHub登录成功不等于连接器授权成功 |
排查顺序
先记录Codex运行位置:桌面本地、CLI、IDE还是Cloud。随后记录失败阶段和完整错误。网页授权成功后仍看不到仓库,应检查连接器或仓库授权范围;环境准备失败时,查看依赖、凭据和网络设置;任务内访问失败时,确认该环境是否允许网络,而不是默认认为本机浏览器能打开就代表任务环境可访问。
推送失败需要单独检查Git远端和凭据。不要把密码、访问令牌、私钥或完整仓库密钥写入日志。相关代理接管区别见系统代理与TUN,通用网络分层见连接成功但网页打不开,其他AI平台入口见AI与流媒体核验总入口。
常见问题
浏览器显示授权成功,为什么Codex仍没连接?
可能是回调尚未返回原应用、连接器授权范围不足或当前任务使用了不同账号/工作区。
本机能访问GitHub,云任务为什么失败?
本机和云环境的网络、凭据与代理设置不同,不能互相证明。
可以把Token粘贴进聊天排查吗?
不可以。只保留脱敏错误和权限范围,泄露后应立即撤销并重建。
什么时候联系支持?
当相同错误在固定账号、环境和步骤下可重复,并且官方排错仍无法解决时,提交任务链接、时间和脱敏错误。
来源与核验日期
资料核对:2026-10-27。产品功能会更新,以OpenAI当前帮助文档和客户端界面为准。