Codex /statusline 설정법: 모델·토큰·브랜치를 하단에 고정하기 | DAKER 커뮤니티
Codex /statusline은 긴 작업 중 모델, reasoning, 컨텍스트, rate limit, git branch, 토큰, 세션 정보를 하단 상태줄에 고정해 실수를 줄이는 설정입니다. 상태줄이란, Codex CLI 화면 아래에서 현재 세션의 모델과 작업 맥락을 계속 보여 주는 작은 운영판을 의미합니다. 긴 수정 요청을 보낸 뒤 “지금 어떤 모델이었지, 토큰은 얼마나 남았지, 브랜치는 맞나”를 다시 묻고 있다면 하단부터 정리할 차례입니다.
문제 상황: 왜 긴 작업일수록 하단 정보가 먼저 보여야 할까요?
Codex에게 큰 리팩터링이나 리뷰를 맡기면 대화는 금방 길어집니다. 중간에 모델, reasoning, 컨텍스트, 브랜치를 다시 확인하려고 멈추면 작업 흐름도 같이 끊깁니다. 하단 상태줄은 이 확인을 질문이 아니라 화면의 기본 정보로 바꿉니다.
핵심 개념: Codex 상태줄은 무엇을 고정하나요?
Codex 상태줄은 현재 세션에서 자주 확인하는 운영 정보를 하단에 고정합니다. 작성 기준일 현재 OpenAI 공식 개발자 명령 문서는 상태줄에서 모델, reasoning, 컨텍스트 통계, rate limit, git branch, token counter, session id, 현재 위치, Codex version 같은 항목을 고르고 재정렬할 수 있다고 설명합니다. 확인을 누르면 화면이 즉시 바뀌고 이후 설정에도 반영됩니다.
| 항목 | 보는 이유 | 실수 방지 효과 |
|---|---|---|
| 모델과 reasoning | 작업 난도에 맞는 실행인지 확인합니다. | 가벼운 모델로 깊은 설계를 맡기는 실수를 줄입니다. |
| 컨텍스트와 토큰 | 대화가 길어질 때 남은 여유를 봅니다. | 중요 로그를 넣기 전 압축이나 분리 판단을 빨리 합니다. |
| rate limit | 반복 실행이나 긴 검증 전에 한계를 봅니다. | 중간 중단 가능성을 작업 전부터 예상합니다. |
| git branch | 현재 작업 위치가 맞는지 확인합니다. | 엉뚱한 브랜치에서 수정하는 사고를 줄입니다. |
단계별 사용법: /statusline은 어떤 순서로 켜면 좋을까요?
처음에는 많은 항목을 다 켜기보다, 작업 실패를 실제로 줄이는 항목부터 둡니다. 아래 순서로 구성하면 화면은 복잡해지지 않고 필요한 신호만 남습니다.
- Codex CLI에서 상태줄 설정 명령을 열고 현재 표시 항목을 확인합니다.
- 모델과 reasoning 항목을 켜서 작업 난도와 실행 모드를 먼저 보이게 합니다.
- 컨텍스트 통계와 token counter를 켜서 긴 대화의 남은 여유를 확인합니다.
- rate limit과 git branch를 켜서 반복 실행과 브랜치 실수를 막습니다.
- 항목 순서를 자주 보는 것부터 배치한 뒤 저장하고 다음 작업에서 하단을 먼저 봅니다.
짧은 예시: 리뷰 작업 전에는 어떻게 쓰면 좋을까요?
PR 리뷰를 시작하기 전 하단에 모델과 reasoning, 브랜치, 토큰을 보이게 둡니다. 리뷰 중간에 대화가 길어지면 먼저 token counter를 보고, 로그를 더 넣을지 새 작업으로 나눌지 결정합니다. 브랜치가 기대와 다르면 리뷰 결과를 믿기 전에 작업 위치부터 고칩니다.
실수 방지 체크리스트: 상태줄을 켜고도 놓치기 쉬운 점은 무엇인가요?
- 상태줄은 권한을 바꾸는 기능이 아니라 확인을 빠르게 만드는 기능입니다.
- 모든 항목을 켜면 하단이 복잡해지므로 팀 작업 기준에 맞는 항목만 남깁니다.
- 긴 로그를 붙이기 전에는 token counter와 컨텍스트 통계를 먼저 봅니다.
- 브랜치 표시가 기대와 다르면 파일 수정 요청보다 작업 위치 확인을 먼저 합니다.
- 반복 작업 기준은 상태줄만 믿지 말고 AGENTS 파일이나 Rules 글처럼 저장소 지침으로 남깁니다.
공식 출처와 함께 볼 DAKER 글은 무엇인가요?
작성 기준일에는 OpenAI Codex 공식 개발자 명령, 설정 기본, 고급 설정 문서를 비공개로 확인했습니다. 공개 본문 정책상 외부 공식 문서 주소는 본문 링크로 넣지 않고, 이어서 볼 내부 링크만 남깁니다.
FAQ: Codex /statusline에서 자주 묻는 질문은 무엇인가요?
/statusline은 /status와 같은 기능인가요?
다릅니다. /status는 현재 상태를 한 번 확인하는 체크포인트이고, /statusline은 자주 볼 정보를 하단에 계속 표시하도록 고르는 설정입니다.
상태줄을 켜면 토큰 사용량이 줄어드나요?
직접 줄어드는 것은 아닙니다. 다만 남은 컨텍스트와 token counter를 보면서 로그 추가, 대화 분리, 작업 재개 판단을 더 빨리 할 수 있습니다.
팀에서 같은 상태줄을 써야 하나요?
완전히 같을 필요는 없습니다. 다만 모델, 토큰, 브랜치처럼 사고를 줄이는 항목은 팀 공통 기준으로 맞추는 편이 좋습니다.
IDE 확장에서도 설정이 이어지나요?
Codex 공식 설정 문서는 CLI와 IDE 확장이 같은 설정 레이어를 공유한다고 설명합니다. 다만 실제 표시 항목과 화면은 사용하는 표면에 따라 확인해야 합니다.
오늘 바로 할 일은 무엇인가요?
다음 Codex 작업을 시작하기 전 하단 상태줄에 모델, reasoning, token counter, git branch 네 항목이 보이는지 확인해 보세요.
다음 긴 작업을 맡기기 전에는 본문보다 하단을 먼저 보세요. 하단에 모델, 토큰, 브랜치가 보이면 작업의 첫 안전선은 이미 잡힌 것입니다.