Skip to content

Codex CLI 日志在哪里：先运行doctor，再查TUI或SQLite日志

先执行

codex doctor --summary
codex doctor --json > codex-doctor.json

不要假设所有安装都有~/.codex/log/codex-tui.log。先从doctor读取实际的CODEX_HOME、log dir、log DB和sqlite home。

四种诊断数据不同

数据用途是否可直接公开
codex doctor安装、配置、认证、网络、state概况只分享脱敏摘要
TUI文本日志最近的warning和error先检查提示词、命令和路径
logs_2.sqlite结构化内部日志不上传raw数据库
sessions/*.jsonl会话和工具调用原则上不公开

auth.json不是日志，它可能包含认证token。不要打印或附加其内容。

读取实际日志路径

环境中可能存在以下一个或两个位置：

$CODEX_HOME/log/codex-tui.log
<sqlite home>/logs_2.sqlite

只有文本日志存在时，才读取小范围：

tail -n 120 "$CODEX_HOME/log/codex-tui.log"
rg -n -i 'error|warn|reconnect|401|403|timeout|mcp' \
  "$CODEX_HOME/log/codex-tui.log" | tail -n 80

SQLite内部schema可能变化，不要把临时SQL当作长期官方接口。先使用doctor的integrity结果和界面上的准确错误。

按错误分支

错误下一步
HTTP 401登录状态、账号、系统时间；不要读取token正文
WebSocket失败VPN、代理、IPv4/IPv6、重连路径
Network access is restrictedworkspace沙箱的网络设置
missing field sandboxPolicyBrowser / Computer Use与node_repl版本兼容性
SQLite state runtime失败错误码以及Windows/WSL路径边界
PATH中多个Codex当前运行文件与更新目标是否一致

GitHub Issue只放最小信息

  • codex --version
  • CLI / Desktop / IDE extension
  • OS与安装方式
  • 一行准确错误
  • 最短复现步骤
  • 脱敏后的doctor分类摘要

不要上传auth.json、raw logs_2.sqlite、session JSONL、完整.codex压缩包、.env或未检查的完整日志。

参考资料

相关文章