Codex CLI 상태 표시줄 설정: /statusline으로 모델·컨텍스트 정보를 처음 고르는 법
TL;DR
Codex CLI의 하단 상태 표시줄을 바꾸려면 TUI 입력창에서
/statusline
을 선택합니다. picker에서 항목을 토글하고 순서를 정한 뒤 확정하면 구성이
config.toml
의
tui.status_line
에 저장됩니다. 첫 설정은
model-with-reasoning
,
current-dir
,
context-remaining
세 항목만 고르고 저장 결과를 확인하는 데서 마칩니다.
핵심 3줄 요약
핵심 1
/statusline
은 셸 명령이 아니라 Codex TUI 안에서 실행합니다.
핵심 2
공식 항목을 picker에서 토글하고 순서를 바꿀 수 있습니다.
핵심 3
상태 값은 보조 신호이며 정확도나 품질을 보증하지 않습니다.
이 글에서 다룰 내용
-
/statusline을 입력할 정확한 위치 - 처음 고를 세 항목과 선택 이유
- Space·좌우 화살표·Enter로 토글·재정렬·확정하는 순서
-
tui.status_line저장 확인과 표시 생략 조건
Codex
/statusline
은 무엇인가
한 문장 정의:
/statusline
은 Codex TUI 하단에 표시할 정보를 대화형 picker에서 고르고 순서를 바꾸는 명령입니다.
확정한 구성은
config.toml
의
tui.status_line
에 저장됩니다. OpenAI 공식 문서가 예로 드는 항목은 model, model+reasoning, context stats, rate limits, Git branch, token counters, session ID, current directory 또는 project root, Codex version입니다.
현재 검증한
codex-cli 0.144.6
picker에서는
model-with-reasoning
,
current-dir
,
context-remaining
,
context-used
,
context-window-size
를 확인했습니다. 공식 문서는 운영체제·터미널·플랜·지역·언어·최소 버전을 확정하지 않으므로 현재 입력창의 completion부터 확인해야 합니다.
언제 쓰면 좋은가
긴 작업에서 현재 모델과 작업 폴더, 남은 컨텍스트를 화면 아래에서 함께 보고 싶을 때 맞습니다. 저장소를 오가거나 대화가 길어질수록 현재 환경을 잘못 읽기 쉽습니다. 상태 표시줄은 이를 눈으로 확인할 단서가 됩니다.
다만 상태 표시줄은 검사 결과가 아닙니다. 모델명과 폴더가 맞아도 코드가 정확하다는 뜻은 아닙니다. 남은 컨텍스트 비율이 높아도 답변 사실성은 보장되지 않습니다. 파일 변경은 diff와 테스트로 따로 검토해야 합니다.
/statusline
으로 처음 설정하는 5단계
1. 현재 표시와 고를 항목을 정합니다
첫 설정에서는
model-with-reasoning
,
current-dir
,
context-remaining
만 고릅니다. OpenAI의 필수값이 아니라 이번 글의 보수적인 시작 예시입니다. 작업 방식에 맞지 않으면 picker에 실제로 보이는 다른 공식 항목을 고릅니다.
2. Codex TUI 입력창에서
/statusline
을 찾습니다
운영체제 셸이 아니라 Codex 입력창에서
/statusline
을 입력하고 completion row를 확인합니다. 현재
codex-cli 0.144.6
에서는
/statusline configure which items appear in the status line
이 나타났습니다.
설명이 보이지 않으면 입력을 취소합니다. 인식 여부가 불분명한 slash token을 일반 프롬프트로 제출하지 않습니다.
3. picker에서 항목을 토글합니다
Enter
를 한 번 눌러
Configure Status Line
을 엽니다. Space로 항목을 켜거나 끕니다. 격리 검증에서는 검색란에
context
를 입력해
context-remaining
,
context-used
,
context-window-size
를 확인하고
context-remaining
을 추가했습니다.
4. 좌우 화살표로 순서를 조정하고 사람이 확정합니다
picker 안내에 따라 좌우 화살표로 순서를 바꿉니다. 이번 예시는
model-with-reasoning → current-dir → context-remaining
입니다. 선택과 순서를 사람이 확인한 뒤
Enter
로 확정합니다. 현재 화면은
Esc
로 닫을 수 있다고 안내했습니다.
5.
tui.status_line
저장을 확인합니다
공식 문서 기준으로 확정한 footer는 즉시 갱신되고 구성이
config.toml
에 저장됩니다. 격리 검증에서는 아래 구조가 만들어졌습니다.
[tui]
status_line = ["model-with-reasoning", "current-dir", "context-remaining"]
status_line_use_colors = true이 코드는 로컬 검증에서 관찰한 예시입니다. 모든 환경의 기존 설정을 대신하지 않습니다. 첫 설정에서는 파일을 직접 편집하지 말고 picker가 저장한 항목과 순서가 기대와 같은지만 읽습니다.
결과를 읽고 완료를 판단하는 법
통과 기준은 세 가지입니다.
/statusline
completion 설명이 보여야 합니다.
Configure Status Line
picker가 열리고, 확정 뒤
tui.status_line
에 기대한 배열이 저장돼야 합니다.
표시 생략 경계: 현재 설치 picker는 context 값을 사용할 수 없을 때 항목을 생략할 수 있다고 설명했습니다. footer에 값이 바로 보이지 않더라도 설정 파일에 항목이 저장됐는지 먼저 확인하세요.
이번 격리 시험은 비민감 빈 폴더와 별도
CODEX_HOME
에서 진행했습니다. completion 확인, picker 열기,
context-remaining
선택, 설정 저장까지 확인했습니다. 모델 요청이나 프로젝트 파일 변경은 없었습니다.
항목 선택을 돕는 복사 프롬프트
아래 프롬프트는
/statusline
picker에 넣는 명령이 아닙니다. picker를 열기 전에 공식 항목 중 무엇을 고를지 정리할 때만 선택적으로 사용합니다.
목표: Codex 상태 표시줄에 넣을 항목 3개와 순서를 정합니다.
허용 입력: 현재 picker에 실제로 표시된 공식 항목명과 사용자가 밝힌 작업 목적만 사용합니다.
제외 입력: 고객명, 실명, 이메일, 계정 식별자, 인증정보, 비밀값, 내부 경로, picker에 없는 항목은 사용하지 않습니다.
출력 형식: 추천 순서 3개, 각 항목의 이유 한 문장, 제외한 항목과 이유를 씁니다.
완료 기준: 사람이 추천을 검토합니다. 그런 다음 picker에서 직접 토글·재정렬하고
tui.status_line
에 같은 순서가 저장됐는지 확인합니다.
추정 금지: picker에 없는 지원 항목, 플랜, 운영체제, 최소 버전, 표시 보장을 만들지 않습니다.
승인 지점: 사람이 선택과 순서를 확인하기 전에는 picker를 확정하거나 설정 파일을 직접 편집하지 않습니다.
실전 활용 팁
상태 표시줄에는 행동을 바꾸는 정보만 둡니다. 모델과 폴더를 확인합니다. 컨텍스트 여유가 줄면 작업 요약이나 새 대화 필요성을 검토하는 식입니다.
rate limits, token counters, session ID, Git branch, Codex version을 한 번에 모두 고를 필요는 없습니다. 실제 작업에서 자주 확인하는 항목만 추가하세요.
/title
은 창·탭 제목,
/theme
은 구문 강조 테마를 구성하므로 별도 기능입니다.
주의할 점
-
/statusline은 Codex TUI 입력창에서 선택합니다. - 공식 문서에 없는 제공 조건을 추정하지 않습니다.
-
context-remaining을 답변 정확도나 완료율로 해석하지 않습니다. - 첫 시험에서 직접 편집이나 동기화 자동화를 추가하지 않습니다.
- 상태 표시줄은 diff, 테스트, 권한 검토, 사람 승인을 대신하지 않습니다.
-
/title,/theme, Claude Code의 외부 statusLine command는 별도입니다.
자주 묻는 질문
/statusline
을 셸에서 실행해도 되나요?
아닙니다. Codex 대화형 TUI 안의 slash command입니다. 입력창에서 completion 설명을 확인한 뒤 선택하세요.
처음에는 어떤 항목을 고르면 되나요?
이번 글은
model-with-reasoning
,
current-dir
,
context-remaining
세 개로 시작합니다. 공식 필수 조합은 아니므로 현재 picker와 실제 목적을 보고 사람이 결정하세요.
확정했는데 컨텍스트 값이 보이지 않으면 실패인가요?
반드시 그렇지는 않습니다. 현재 설치 picker는 값을 사용할 수 없을 때 context 항목이 생략될 수 있다고 설명했습니다.
tui.status_line
저장부터 확인하세요.
Claude Code의
/statusline
과 같은 방식인가요?
아닙니다. Codex는 내장 picker에서 항목을 토글·재정렬해
tui.status_line
에 저장합니다. 기존 Claude Code 글은 자연어 요청으로 셸 스크립트와 statusLine command를 구성합니다.
출처
- OpenAI Codex Developer Commands 공식 문서 —
/statuslinepicker 순서, 공식 항목군, 즉시 반영,tui.status_line저장을 확인했습니다.
마무리
Codex 상태 표시줄의 첫 설정은
/statusline
설명 확인 → picker 열기 → 세 항목 토글 → 순서 검토 →
tui.status_line
저장 확인으로 끝낼 수 있습니다. 많은 정보를 켜기보다 현재 판단에 필요한 신호부터 고르세요.
