Codex CLI 状态栏配置指南
适用版本：Codex CLI 0.154.0+
一、概述
Codex CLI 原生支持可配置状态栏 ，无需任何外部脚本。
Codex 把状态栏做成了内置功能 ，通过 config.toml 里的字段名数组配置即可，配置都在 [tui] 段下：
toml
[tui]
status_line = ["git-branch", "context-used", "used-tokens", "context-window-size", "model-with-reasoning", "thread-name"]
status_line_use_colors = true二、字段表与调整方式
内置字段全集（0.154.0）
| 分类 | 字段 |
|---|---|
| 位置与仓库 | current-dir、project-name、git-branch、pull-request-number、branch-changes |
| 上下文与用量 | context-used、context-remaining、context-window-size、used-tokens、total-input-tokens、total-output-tokens、thread-credits、estimated-thread-cost |
| 会话 | status、run-state、task-progress、thread-id、thread-name、thread-title、workspace-headline |
| 模型 | model、model-with-reasoning、reasoning、fast-mode |
| 权限与版本 | permissions、approval-mode、codex-version |
| 其他 | five-hour-limit、weekly-limit、raw-output |
字段名拼错会被忽略或报 unknown item，不会导致启动失败，但也不会显示。
三种调整方式
bash
# 1) 会话内交互式调整（官方入口，会写回 config.toml）
# 提示语："Use /statusline to configure which items appear in the status line."
/statusline
# 2) 单次覆盖，用于快速试验字段是否有效
codex -c 'tui.status_line=["codex-version","permissions","approval-mode"]'
# 3) 直接编辑 ~/.codex/config.toml 的 [tui] 段（推荐用于固化配置）变更流程固定为：改配置 → 重启 codex → 看底栏。