需先执行codex --version确认CLI已安装且PATH生效，再运行codex doctor验证日志系统就绪（✅才可查）；Mac/Linux用tail -f $(ls -t session-*.log | head -n 1)实时捕获错误流，Windows用Get-Content配合Select-String过滤关键词，跨平台可通过export CODEX_LOG_LEVEL=debug或PowerShell等效命令启用调试日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在终端里直接看到Codex运行时的真实报错内容，而不是等它闪退后去翻文件夹——这需要绕过图形界面拦截，用命令行实时捕获日志流，尤其适用于CLI模式下命令执行失败、API调用中断、MCP连接超时等场景。
查日志前先确认Codex是否真在运行
敲codex --version，如果返回版本号说明CLI已装好；若提示command not found，请先解决PATH问题，否则后续所有日志命令都无效。
执行codex doctor，观察输出中“Runtime”和“Log”两项状态。只有显示✅或“OK”的，才代表日志系统已就绪；若标⚠️或❌，说明配置损坏或路径权限异常，必须先修复再查日志。
Mac/Linux：三步直取最新错误流
第一步：进入日志目录
执行cd ~/.codex/logs，注意路径中【.codex是隐藏目录，ls默认不显示，必须手动cd进去】。
第二步：找最新日志文件
运行ls -t session-*.log | head -n 1，这条命令会按修改时间倒序列出所有会话日志，取第一行即为当前或最近一次崩溃对应的日志名。
第三步：实时追踪错误输出
用tail -f $(ls -t session-*.log | head -n 1)启动监听。此时只要Codex再次出错，错误堆栈会立刻滚动出现在终端里，不用等它结束再打开文件。
Windows：用PowerShell精准定位
方法一：快速查看最近错误
打开PowerShell，执行：Get-ChildItem "$env:USERPROFILE\.codex\logs\session-*.log" | Sort-Object LastWriteTime -Descending | Select-Object -First 1 | Get-Content
方法二：过滤关键词锁定故障点
在同个窗口中追加管道：| Select-String -Pattern "error", "fail", "panic", "exception" -CaseSensitive
这能跳过千行正常日志，只输出带错误标识的行，比如panic: runtime error: invalid memory address这种致命信号。
【注意】Windows上若返回“找不到路径”，请确认Codex是否以非管理员身份首次运行过——未成功初始化时.logs文件夹根本不会创建，此时需先执行一次codex login触发基础环境生成】
跨平台通用：启用Debug级别日志
在运行任何Codex命令前，先设置环境变量：export CODEX_LOG_LEVEL=debug（Mac/Linux）或$env:CODEX_LOG_LEVEL="debug"（PowerShell）。
然后执行你原本要跑的命令，例如：codex run --file src/main.py。
此时所有底层调用、HTTP请求头、MCP响应体、模型token消耗都会打到日志里。错误不再藏在深处，而是和上下文一起浮现——比如你会看到[MCP] POST http://localhost:3000/v1/execute timeout after 8s，比单纯“connection refused”更有指向性。
