---
title: "显式设置 log_dir 才会写出明文 TUI 日志"
summary: "默认日志在 $CODEX_HOME/log。只有你指定 log_dir 时，才会额外打开 opt-in 的明文 codex-tui.log。"
category: config
level: intermediate
surfaces: [cli]
tags: ["log_dir", "排错", "TUI"]
canonical: /tips/log-dir-enables-tui-log/
---

# 显式设置 log_dir 才会写出明文 TUI 日志

默认日志在 $CODEX_HOME/log。只有你指定 log_dir 时，才会额外打开 opt-in 的明文 codex-tui.log。

排指令链、MCP 启动失败、钩子没跑时，先把日志目录定下来：

```toml
log_dir = "/absolute/path/to/codex-logs"
```

一次性：

```bash
codex -c log_dir=./.codex-log
```

设了这个键之后，目录里会出现明文 `codex-tui.log`。默认位置不会自动打开这份明文文件，所以只开 `codex doctor` 往往看不到完整 TUI 记录。

日志会含提示和工具输出，不要把 `log_dir` 指到会进 Git 的目录，也不要贴进工单。看完就把一次性目录删掉。

## 来源

- [OpenAI · Config basics](https://learn.chatgpt.com/docs/config-file/config-basic)
- [OpenAI · Configuration reference](https://developers.openai.com/codex/config-reference)