Codex日志按运行形态和系统严格分存：CLI/TUI日志位于~/.codex/logs/（macOS/Linux）或%USERPROFILE%.codex\logs\（Windows），Desktop日志绑定系统路径，实时监控需用tail或Get-Content提前运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex报错日志不是藏在某个神秘路径里，而是按运行形态严格分存：CLI命令行版、TUI终端界面版、Desktop桌面应用版各自有固定落盘位置，Windows/macOS/Linux三系统路径规则不同，漏看任意一类都可能错过关键线索。
CLI 和 TUI 模式日志路径
打开终端，直接输入以下命令查看最新日志文件列表：
【macOS / Linux】 ls -lt ~/.codex/logs/ | head -3
【Windows PowerShell】 Get-ChildItem "$env:USERPROFILE\.codex\logs\" | Sort-Object LastWriteTime -Descending | Select-Object -First 3
日志文件名通常为 session-20260805-142231.log 或 codex-tui.log，其中 session-*.log 记录每次会话的完整执行链，codex-tui.log 是 TUI 模式专属主日志。若目录为空，说明 Codex 连初始化都没完成，问题大概率出在签名或权限层，不是日志没生成，而是根本没机会写入。
Desktop 桌面版日志路径
桌面版日志与系统原生日志机制绑定，路径不随安装位置变动：
【macOS】 ~/Library/Logs/Codex/
【Windows】 %APPDATA%\Codex\logs\
【Linux】 ~/.config/Codex/logs/
重点盯住 mcp.log 和 codex-desktop.log：前者记录 MCP Server 启动失败、插件连接中断等底层通信问题；后者捕获 UI 渲染异常、Electron 主进程崩溃等界面级错误。若双击桌面图标无反应，先查 codex-desktop.log 是否存在——不存在即代表启动流程卡在更早环节（如 Gatekeeper 拦截），此时需转向系统日志而非 Codex 自身日志。
实时监控日志流
不用反复打开文件，用 tail 命令让错误当场浮现：
第一步：定位当前日志目录
【所有系统】 codex --log-dir
第二步：进入该目录后执行实时追踪
【macOS / Linux】 tail -F $(codex --log-dir)/session-*.log 2>/dev/null || tail -F $(codex --log-dir)/codex-tui.log
【Windows】 Get-Content "$(codex --log-dir)\session-*.log" -Wait -Tail 1 2>$null || Get-Content "$(codex --log-dir)\codex-tui.log" -Wait -Tail 1
这一步必须在触发报错前就运行。很多瞬时崩溃（比如 Electron 启动闪退）只留下毫秒级日志片段，等你手动打开文件再翻找，内容早已被新日志覆盖。tail -F 能确保你看到第一行错误堆栈，而不是事后补救。
从系统级日志反向定位
当 Codex 自身日志为空或语焉不详时，系统日志是最后防线：
方法一：macOS 控制台.app → 左侧“报告”→ 搜索 “Codex” 或 “Electron” → 筛选“错误”级别条目
方法二：Windows 事件查看器 → Windows 日志 → 应用程序 → 右键“筛选当前日志”→ “事件来源”填入 “Application Error” 或 “Electron” → 查看 ID 1000 错误条目
方法三：Linux journalctl → journalctl -u codex-desktop.service --since "2 hours ago" | grep -i "fail\|segfault\|core"
【注意】 Windows 上若事件查看器中找不到 Codex 相关条目，说明进程甚至没注册到系统服务管理器，问题一定出在安装包完整性或 .NET Runtime 缺失上，此时应跳过日志排查，直接重装。
