Codex 常见问题
Codex 常见问题
Section titled “Codex 常见问题”这一页是常见问题入口。
如果你已经遇到报错，不要从头翻教程，先按问题类型进入对应排障页。
安装和登录问题
Section titled “安装和登录问题”Codex 登录失败
Section titled “Codex 登录失败”常见原因包括账号状态、网络、认证流程中断、环境变量或本地配置异常。
npm install 失败
Section titled “npm install 失败”不要只看最后一行错误。安装失败通常要结合 Node.js 版本、网络、镜像源、依赖锁文件和具体报错判断。
模型配置问题
Section titled “模型配置问题”模型接口 401、404、超时
Section titled “模型接口 401、404、超时”先判断是 API Key、Base URL、模型名、额度权限还是网络问题。
国内模型配置失败
Section titled “国内模型配置失败”如果你接的是 DeepSeek、通义千问、Kimi、硅基流动、智谱 GLM 或豆包，优先从这里分流。
项目读取和路径问题
Section titled “项目读取和路径问题”Codex 无法读取项目
Section titled “Codex 无法读取项目”重点检查当前目录是不是项目根目录、权限是否正确、文件是否被工具忽略。
中文路径和空格路径问题
Section titled “中文路径和空格路径问题”Windows 用户很容易遇到路径转义、编码和工具链兼容问题。不要凭感觉改目录，先看具体报错。
Git unsafe repository
Section titled “Git unsafe repository”这是 Git 的安全保护。处理前先确认当前目录确实是你的项目。
运行和构建问题
Section titled “运行和构建问题”本地预览站、前端开发服务器、后端服务都可能占用端口。
构建通过但页面不对
Section titled “构建通过但页面不对”构建通过只代表代码能生成，不代表页面内容、路由、缓存和部署一定正确。
Codex 使用方式问题
Section titled “Codex 使用方式问题”Codex 修改范围失控
Section titled “Codex 修改范围失控”如果 Codex 改了太多文件，不要急着全盘接受。先让它解释改动，再按范围回收。
不知道如何开始一个任务
Section titled “不知道如何开始一个任务”先看：
排障时的基本原则
Section titled “排障时的基本原则”遇到问题时，不要连续乱改配置。
更稳的方式是：
- 保留完整报错。
- 说明你刚刚做了什么。
- 让 Codex 判断问题类型。
- 一次只改一个变量。
- 修改后再验证。
排障不是比谁复制命令快，而是先把问题归类。