Codex 與 Claude Code statusline 設定小記

Codex 與 Claude Code statusline 設定小記

環境：

• macOS 26.5
• Codex CLI 0.135.0
• Claude Code 2.1.149

最近在整理 AI coding tool 的使用環境，發現底部那條 statusline 其實很值得設定一下。平常一直切 repo、切模型、跑長任務，如果沒有一眼看到 context 或 quota 狀態，很容易做到一半才發現快滿了，或是突然被中斷 Orz ....

這篇記一下目前我自己的 Codex 與 Claude Code statusline 設定。兩者概念有點不一樣, Codex 目前是用內建欄位組合；Claude Code 則是把 JSON 丟給 shell script，再把 script 印出的內容顯示出來。

Claude Code 官方文件 

• https://code.claude.com/docs/en/statusline

Codex 官方文件

• https://developers.openai.com/codex/cli/slash-commands

Codex 的 status_line

Codex 的設定檔在這裡：

~/.codex/config.toml

我目前放在 [tui] 裡，讓底部狀態列顯示模型、context、額度和目前目錄：

[tui]
status_line = [
  "model-with-reasoning",
  "context-remaining",
  "five-hour-limit",
  "weekly-limit",
  "current-dir",
]

這組欄位對我來說剛好。

• model-with-reasoning 可以確認現在是不是用預期的模型和 reasoning effort
• context-remaining 看長任務還剩多少空間
• five-hour-limit 和 weekly-limit 看額度壓力
• current-dir 則是避免自己在錯的專案裡下指令

我的 Codex 前面也有模型設定，整體看起來像這樣：

model = "gpt-5.5"
model_reasoning_effort = "medium"
personality = "pragmatic"

[tui]
status_line = [
  "model-with-reasoning",
  "context-remaining",
  "five-hour-limit",
  "weekly-limit",
  "current-dir",
]

改完後可以用下面指令確認版本，順便重開 Codex 看底部是否出現新欄位：

codex --version

Claude Code 的 statusLine

Claude Code 這邊比較自由。設定檔在：

~/.claude/settings.json
~/.claude/statusline-command.sh

也可以直接在 Claude Code 裡用 /statusline 讓它幫忙產生，或是直接呼叫 ai 幫你設定 :)

{
  "theme": "auto",
  "verbose": true,
  "statusLine": {
    "type": "command",
    "command": "bash /Users/max/.claude/statusline-command.sh"
  }
}

重點是 statusLine.command。Claude Code 會執行這個 command，並把目前 session 的 JSON 從 stdin 傳進去。script 只要讀 stdin，最後印出一行文字就好。

我的 script 目前顯示 

• model
• context 使用率
• 上一輪 token 數
• 有資料時顯示 5-hour limit：

內容如下

#!/bin/sh
input=$(cat)

model=$(echo "$input" | jq -r '.model.display_name // "Unknown"')

used_pct=$(echo "$input" | jq -r '.context_window.used_percentage // empty')
if [ -n "$used_pct" ]; then
  ctx=$(printf "%.0f%%" "$used_pct")
else
  ctx="ctx:--"
fi

in_tok=$(echo "$input" | jq -r '.context_window.current_usage.input_tokens // empty')
out_tok=$(echo "$input" | jq -r '.context_window.current_usage.output_tokens // empty')
if [ -n "$in_tok" ] && [ -n "$out_tok" ]; then
  total=$(( in_tok + out_tok ))
  if [ "$total" -ge 1000 ]; then
    tok_display=$(awk "BEGIN { printf \"%.1fk\", $total/1000 }")
  else
    tok_display="${total}"
  fi
  cost_part="tokens:${tok_display}"
else
  cost_part="tokens:--"
fi

後面再把 5-hour limit 接上去：

five_h_pct=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
five_h_reset=$(echo "$input" | jq -r '.rate_limits.five_hour.resets_at // empty')
if [ -n "$five_h_pct" ]; then
  five_h_pct_display=$(printf "%.0f%%" "$five_h_pct")
  if [ -n "$five_h_reset" ]; then
    five_h_reset_display=$(date -r "$five_h_reset" "+%H:%M" 2>/dev/null || date -d "@$five_h_reset" "+%H:%M" 2>/dev/null || echo "?")
  else
    five_h_reset_display="?"
  fi
  five_h_part="5h:${five_h_pct_display}(↺${five_h_reset_display})"
else
  five_h_part=""
fi

if [ -n "$five_h_part" ]; then
  printf "%s | ctx:%s | %s | %s" "$model" "$ctx" "$cost_part" "$five_h_part"
else
  printf "%s | ctx:%s | %s" "$model" "$ctx" "$cost_part"
fi

script 建好後記得給執行權限：

chmod +x ~/.claude/statusline-command.sh

最後看一下相關檔案位置，之後要備份或搬到新機器比較不會忘記：

~/.codex/
├── config.toml
└── version.json

~/.claude/
├── settings.json
├── settings.local.json
└── statusline-command.sh

小結一下：

• Codex 的 statusline 比較像「選內建資訊欄位」
• Claude Code 的 statusline 比較像「自己寫一個小 renderer」。

兩個都不難，但設定完之後，在長時間 coding session 裡真的比較安心。

又前進一步 ~ enjoy it

Reference

• https://code.claude.com/docs/en/statusline
• https://developers.openai.com/codex/cli/slash-commands