日志、诊断与问题报告
收集 CLI、桌面、会话和登录日志，定位卡住、版本差异与 worktree 环境问题。
先记录发生问题的入口、版本、项目位置和复现步骤。桌面与系统 CLI 可能捆绑不同版本，不能只报告全局 codex --version 就代表应用内部版本。
定位日志
| 内容 | 位置或入口 |
|---|---|
| macOS app logs | ~/Library/Logs/com.openai.codex/YYYY/MM/DD |
| 会话 transcripts | CODEX_HOME/sessions，默认 ~/.codex/sessions |
| 已归档会话 | CODEX_HOME/archived_sessions |
| 登录诊断 | 配置日志目录内的 codex-login.log |
| 可选纯文本 TUI 日志 | 显式 log_dir 目录内的 codex-tui.log |
需要启用 TUI 文本日志时可运行 codex -c log_dir=./.codex-log。日志包含项目、工具或身份上下文，提供给支持人员前检查敏感内容。
任务或终端卡住
先检查是否等待审批，再在终端执行 pwd 或 git status 确认环境。桌面终端可关闭面板并用 Ctrl+` 重新打开。必要时等待其他活动聊天完成，再重启应用。
较小的新聊天有助于隔离复现，但应保留原错误与日志。选错 Local/Worktree/Cloud 时可取消当前运行，再用输入框向上箭头找回提示。
Worktree 环境不完整
worktree 默认只继承 Git 跟踪文件，缺失依赖或被忽略的配置时使用本地环境或 .worktreeinclude。共享环境配置应位于所打开项目根目录的 .codex 下，monorepo 尤其需要核对项目根。
提交反馈
/feedback 可按界面选择分享现有会话，提交后取得 session ID。也可查官方仓库已有 issue，再提交包含版本、脱敏错误和最小复现的新 issue。企业禁用 feedback 时该入口不可用，使用组织支持流程。