先确认命令是否被系统识别：执行codex --version，若报command not found，说明安装或PATH未生效；需重装npm install -g @openai/codex@latest、重启终端，并验证node -v≥22.0.0、npm -v≥10.0.0。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在终端输入 codex 命令后卡住、报错或直接无响应，不是模型没加载完，而是底层执行链某个环节断开了——可能是命令根本没识别，也可能是认证没过，还可能是沙箱拦住了网络或文件写入。
先确认命令是否被系统识别
第一步：在终端里执行 codex --version。
如果返回类似 command not found 或 'codex' 不是内部或外部命令，说明问题出在安装层或环境变量层，【此时不要往下查配置或 Key，90% 的时间都浪费在这一步】。
第二步：重新运行全局安装命令：npm install -g @openai/codex@latest。
安装完成后，必须关闭当前终端窗口，再新开一个——很多用户改完环境却还在旧会话里反复试，结果一直失败。
第三步：检查 Node 和 npm 版本是否达标：node -v 和 npm -v。
Node.js 必须 ≥ 22.0.0，npm 必须 ≥ 10.0.0；版本低会导致全局 bin 路径注册异常，哪怕装了也找不到命令。
命令能运行但卡在浏览器回调页
终端显示 Opening browser for authentication...，浏览器弹出登录页并提示“已成功”，但终端仍停在原地不动。
这不是网络慢，而是本地回调服务没收到凭证——常见于 WSL、远程 SSH、Docker 容器或企业防火墙拦截 localhost:3000 端口。
方法一：强制指定回调端口
执行 codex login --port 3001，然后手动在浏览器打开 http://localhost:3001/callback?code=xxx（把实际 code 参数粘进去）。
方法二：禁用自动浏览器跳转
加 --no-browser 参数：codex login --no-browser，终端会输出一个完整授权 URL，复制到 Chrome/Firefox 中打开即可，绕过所有本地回调链路。
认证通过但执行命令报 401 或 403
终端显示 Authenticated successfully，但运行 codex "list files" 时返回 401 Unauthorized 或 403 Forbidden。
401 表示凭证已过期或未绑定当前工作区；403 则说明账号有权限限制，比如 SSO 管理员关闭了个人 API 访问，或席位未分配。
执行 codex debug auth，查看输出中的 token_expires_at 时间戳。
如果已过期，直接运行 codex logout && codex login 重登；如果未过期但仍是 401，说明你用的 API Key 属于另一个 OpenAI 组织，需切换到正确组织再生成新 Key。
【注意：VSCode 插件和 CLI 使用的是两套独立凭证，不要以为 IDE 里能用，终端就一定行】
命令执行一半突然中断或报沙箱错误
例如运行 codex "install eslint" 时提示 Permission denied: network access blocked，或修改文件后发现换行符全变成 LF 导致 Git 报 CRLF 冲突。
这是 Codex Windows 沙箱的默认行为——它主动拦截网络请求、限制文件写入范围、统一转换行尾符。
临时关闭沙箱（仅调试用）：codex config set sandbox_mode disabled。
这会让 Codex 以当前用户权限运行，不再拦截网络或重写文件，适合快速验证是否为沙箱导致的问题。
若需保留沙箱但放行某类操作，可精确配置：codex config set network_access allowed 或 codex config set line_ending_strategy native。
前者允许网络请求，后者保持原始换行符（Windows 默认 CRLF），避免 Git 工作区污染。
