节点手册NODE HANDBOOK
开发工具排错

Codex连接失败怎么排查:登录、仓库、环境与网络分层

Codex连接问题可能发生在账号登录、仓库授权、环境准备、依赖下载、任务联网或Git推送中的任一层。看到“连接失败”时,先确定阶段,不要反复退出账号或修改全部网络设置。

节点手册编辑部 ·

Codex连接问题可能发生在账号登录、仓库授权、环境准备、依赖下载、任务联网或Git推送中的任一层。看到“连接失败”时,先确定阶段,不要反复退出账号或修改全部网络设置。

按阶段保存证据

阶段 最小检查 常见边界
登录 ChatGPT账号完成授权 套餐资格、工作区策略可能不同
仓库 能列出并读取目标仓库 读取权限不等于推送权限
环境 环境准备完成并能读取项目 依赖源和私有服务可能另需凭据
任务联网 明确目标域名是否允许访问 本地、云端和浏览器环境不同
推送 Git身份与远端权限通过 GitHub登录成功不等于连接器授权成功

排查顺序

先记录Codex运行位置:桌面本地、CLI、IDE还是Cloud。随后记录失败阶段和完整错误。网页授权成功后仍看不到仓库,应检查连接器或仓库授权范围;环境准备失败时,查看依赖、凭据和网络设置;任务内访问失败时,确认该环境是否允许网络,而不是默认认为本机浏览器能打开就代表任务环境可访问。

推送失败需要单独检查Git远端和凭据。不要把密码、访问令牌、私钥或完整仓库密钥写入日志。相关代理接管区别见系统代理与TUN,通用网络分层见连接成功但网页打不开,其他AI平台入口见AI与流媒体核验总入口。

常见问题

浏览器显示授权成功,为什么Codex仍没连接?

可能是回调尚未返回原应用、连接器授权范围不足或当前任务使用了不同账号/工作区。

本机能访问GitHub,云任务为什么失败?

本机和云环境的网络、凭据与代理设置不同,不能互相证明。

可以把Token粘贴进聊天排查吗?

不可以。只保留脱敏错误和权限范围,泄露后应立即撤销并重建。

什么时候联系支持?

当相同错误在固定账号、环境和步骤下可重复,并且官方排错仍无法解决时,提交任务链接、时间和脱敏错误。

来源与核验日期

资料核对:2026-10-27。产品功能会更新,以OpenAI当前帮助文档和客户端界面为准。