Cmd. /statusline

역할

터미널 상태줄에 표시할 필드를 커스터마이즈하는 Codex 명령. v0.128.0부터 active turn 중에도 편집할 수 있고, theme-aware 색상과 PR/branch 요약을 표시합니다.

/statusline

사용 조건

설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.

사용 예

/statusline

표시 항목 고르기

1. 입력창에서 /statusline을 실행해 항목 picker를 엽니다.
2. 하단 상태줄에 넣을 항목을 고르고 순서를 정합니다. 공식 명령 문서가 예로 드는 항목은 모델, 컨텍스트 사용량, rate limit, git branch, 토큰 카운터, 세션 ID, 현재 디렉터리, Codex 버전입니다.
3. 확정하면 상태줄이 바로 바뀌고 선택이 config.toml의 [tui] 아래 status_line 배열로 저장됩니다.

tui.status_line은 항목 식별자를 표시 순서대로 담는 문자열 배열입니다. 공식 config reference는 쓸 수 있는 식별자 목록을 따로 공개하지 않으므로, 식별자를 손으로 적기보다 /statusline으로 고른 뒤 저장된 배열을 팀 설정에 옮기는 편이 안전합니다.

언제 쓰나

1. 긴 작업에서 컨텍스트 사용량과 rate limit을 계속 보고 싶을 때. /status를 반복 실행하는 대신 상태줄에 고정합니다.
2. 여러 worktree·branch 세션을 오갈 때. git branch와 세션 ID를 넣어 지금 어느 작업인지 바로 구분합니다.
3. 팀에서 /fast나 모델을 자주 바꿀 때. 모델 항목을 넣어 두면 전환 결과를 놓치지 않습니다.

비슷한 명령과 저장 위치

실행 결과와 유지 범위

하단 상태줄에 표시할 항목과 순서를 바꾸고 config.toml의 tui.status_line에 저장합니다. 모델이나 권한 정책을 바꾸는 명령은 아닙니다.

저장된 값은 다음 실행에도 그대로 쓰입니다. 0.128.0부터 진행 중인 turn에서도 편집할 수 있어 긴 작업을 멈추지 않고 항목을 바꿀 수 있습니다. 버전별 변경은 명령별 변경 기록에 있습니다.

주의사항

• 항목 식별자는 버전에 따라 늘거나 바뀔 수 있습니다. 팀 공용 설정에 넣기 전에 설치본의 picker에서 같은 항목이 보이는지 확인합니다.
• 상태줄은 표시만 바꿉니다. 모델·권한·사용량 자체를 바꾸려면 /model, /permissions, /usage를 씁니다.
• 사용자 설정과 프로젝트 .codex/config.toml에 값이 함께 있으면 실제로 적용된 값을 /debug-config로 확인합니다.
• 항목을 너무 많이 넣으면 좁은 터미널에서 잘립니다. 팀이 실제로 헷갈리는 정보만 고정합니다.

공식 근거

• Developer Commands
• Cli
• Config reference

전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록