Claude Code·Codex CLI 사용량 확인: /usage와 status line 설정 방법

Claude Code나 Codex CLI로 긴 작업을 진행하다 보면 답변 품질보다 먼저 신경 쓰이는 것이 사용량입니다. 지금 대화의 컨텍스트가 얼마나 찼는지, 5시간 한도와 주간 한도가 얼마나 남았는지, 새 세션을 열어야 할 시점인지 알고 싶어집니다.

두 도구 모두 /usage로 사용량을 확인할 수 있고, 터미널 아래쪽 status line에도 필요한 수치를 계속 표시할 수 있습니다. 다만 이름이 같다고 동작까지 같은 것은 아닙니다. Claude Code는 명령형 스크립트에 상태 데이터를 넘기고, Codex CLI는 표시할 항목을 골라 TUI 하단에 배치합니다.

이 글은 Claude Code 2.1.226과 Codex CLI 0.148.0, Linux 환경에서 직접 확인한 화면을 기준으로 정리합니다. 기능이 빠르게 바뀌는 도구이므로 먼저 버전을 확인하세요.

claude --version
codex --version

처음 설치하는 단계라면 Claude Code 처음 설치하고 실행해보기와 WSL에 OpenAI Codex CLI 설치하기를 먼저 참고할 수 있습니다.

세션 토큰·컨텍스트·계정 한도는 서로 다릅니다

사용량 화면을 열기 전에 세션 토큰, 컨텍스트, 계정 한도를 따로 보는 것이 중요합니다.

구분	의미	확인 목적
세션 토큰·비용	현재 세션에서 주고받은 입력·출력·캐시 토큰과 비용 정보	어떤 작업이 토큰을 많이 쓰는지 확인
컨텍스트 사용률	현재 대화가 모델의 작업 기억 공간을 차지한 비율	대화 압축이나 새 세션 전환 시점 판단
5시간·주간 한도	구독 계정이나 서비스에 적용되는 사용 가능량	한도 도달과 재설정 시각 확인

컨텍스트가 80%라고 해서 주간 한도도 80%를 쓴 것은 아닙니다. 반대로 새 세션을 열어 컨텍스트가 비어 있어도 계정의 주간 사용량은 초기화되지 않습니다.

컨텍스트는 대화 하나의 공간이고, 사용 한도는 계정 전체의 이용 가능량입니다.

status line은 작업창 하단의 상시 표시 영역

Claude Code와 Codex CLI의 status line은 별도의 대시보드가 아닙니다. 작업창의 입력 영역 바로 아래에 계속 붙어 있는 상태 줄입니다. 한 번 설정하면 세션을 사용하는 동안 현재 모델·작업 폴더·컨텍스트·계정 한도를 계속 볼 수 있습니다.

두 도구 모두 status line을 작업창 맨 아래의 상시 요약 영역으로 사용합니다. 표시 항목과 설정 방법은 제품마다 다릅니다.

/usage는 명령을 실행할 때만 상세 화면이 열리지만 status line은 코딩 중에도 계속 보입니다. 다음 상황을 빨리 알아차리기 위해 설정합니다.

• 긴 작업을 시작하기 전에 5시간·주간 한도가 가까운지 확인
• 컨텍스트가 많이 차기 전에 대화 압축이나 새 세션을 준비
• 의도한 모델과 프로젝트 폴더에서 작업 중인지 확인

역할은 같지만 구현은 다릅니다. Claude Code는 스크립트가 표시할 문자열을 만들고, Codex CLI는 내장 선택 화면에서 항목과 순서를 고릅니다.

Claude Code /usage 화면 읽기

Claude Code를 실행한 상태에서 다음 명령을 입력합니다.

/usage

현재 화면에는 세션 비용·시간·코드 변경량·입출력 토큰과 함께 구독 계정의 사용 구간이 표시됩니다. 확인 환경에서는 현재 구간과 주간 구간의 사용률, 재설정 시각을 볼 수 있었습니다. 계정별 실제 수치는 캡처에서 가렸습니다.

화면의 각 항목은 다음 의미입니다.

• Session: 현재 세션의 토큰 내역, API·전체 소요 시간, 코드 변경량과 표준 목록가 기준 비용 추정치. 할인·프로모션이 반영된 실제 API 청구액과 다를 수 있으며, Claude 구독 사용자에게는 별도 청구액을 뜻하지 않음
• Current session: 현재 적용 중인 사용 구간과 재설정 시각
• Current week: 주간 사용률과 재설정 시각
• 모델별 구간: 요금제나 프로모션에 따라 특정 모델의 별도 주간 사용량이 표시될 수 있음

Anthropic 공식 문서는 /usage가 세션 사용량과 요금제 사용 구간을 보여준다고 설명합니다. 다만 API 키, Claude 구독, Team·Enterprise, Bedrock·Vertex AI처럼 인증과 결제 경로가 다르면 같은 항목이 모두 나타나지는 않습니다. 화면에 없는 수치를 다른 계정의 예시와 억지로 맞출 필요는 없습니다.

사용량 요청이 일시적으로 실패하면 마지막으로 확인한 값이 표시될 수 있습니다. 이때는 화면의 갱신 안내를 확인하고 다시 조회합니다.

Claude Code status line 빠른 설정

Claude Code에서는 입력창에 /statusline과 원하는 구성을 자연어로 적습니다. 응답이 끝날 때마다 상태 값이 갱신됩니다.

/statusline 모델명, 현재 폴더, 컨텍스트 사용률, 5시간·주간 사용량을 한 줄로 보여줘

/statusline은 자연어 요청을 받아 ~/.claude/ 아래에 표시용 스크립트를 만들고 설정을 자동으로 갱신합니다. 설정 과정에서 파일 수정 승인을 요구할 수 있습니다. 설정 뒤에는 터미널 하단에서 실제 값이 갱신되는지 확인합니다.

처음부터 모든 정보를 넣기보다 다음 네 가지로 시작하는 편이 읽기 쉽습니다.

1. 현재 모델
2. 현재 프로젝트 폴더 또는 Git 브랜치
3. 컨텍스트 사용률
4. 5시간·주간 사용률

표시줄이 너무 길면 터미널 폭이 좁을 때 잘립니다. 비용·세션 시간·입출력 토큰까지 모두 넣기보다 /usage에서 볼 정보와 상시 볼 정보를 나누는 편이 낫습니다.

Claude Code statusLine 직접 구성

직접 설정할 때 필요한 파일은 두 개뿐입니다.

파일	역할
~/.claude/statusline.sh	Claude Code가 전달한 값을 읽어 표시할 한 줄을 만듦
~/.claude/settings.json	Claude Code에 실행할 스크립트의 위치를 알려 줌

동작 순서는 Claude Code가 현재 상태를 JSON으로 전달 → 셸 스크립트가 jq로 필요한 값만 읽음 → printf 결과가 입력창 아래에 표시입니다. 코드를 한 번에 이해하려 하기보다 다음 순서대로 파일을 만들면 됩니다.

1. jq 설치 확인

스크립트가 JSON을 읽을 때 jq를 사용합니다.

jq --version

버전이 출력되지 않는 Ubuntu·WSL 환경에서는 설치합니다.

sudo apt update
sudo apt install -y jq

2. 표시용 스크립트 만들기

~/.claude/statusline.sh 파일을 열어 다음 내용을 저장합니다.

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

MODEL=$(printf '%s' "$input" | jq -r '.model.display_name // "Claude"')
DIR=$(printf '%s' "$input" | jq -r '.workspace.current_dir // .cwd // ""')
CONTEXT=$(printf '%s' "$input" | jq -r '.context_window.used_percentage // 0 | floor')
FIVE_HOUR=$(printf '%s' "$input" | jq -r '.rate_limits.five_hour.used_percentage | if . == null then "-" else "\(. | floor)%" end')
WEEKLY=$(printf '%s' "$input" | jq -r '.rate_limits.seven_day.used_percentage | if . == null then "-" else "\(. | floor)%" end')

printf '[%s] %s | context %s%% | 5h %s | week %s\n' \
  "$MODEL" "${DIR##*/}" "$CONTEXT" "$FIVE_HOUR" "$WEEKLY"

각 변수는 다음 값을 담당합니다.

• MODEL: 현재 모델 이름
• DIR: 현재 작업 폴더의 마지막 이름
• CONTEXT: 현재 대화가 사용한 컨텍스트 비율
• FIVE_HOUR: 5시간 사용 구간의 사용률
• WEEKLY: 주간 사용률

input=$(cat)은 Claude Code가 보낸 JSON 전체를 받아 두는 부분입니다. 그다음 jq -r '.model.display_name'처럼 점으로 이어진 경로를 지정해 필요한 값만 꺼냅니다.

3. 실행 권한 추가

파일을 저장한 뒤 한 번만 실행합니다.

chmod +x ~/.claude/statusline.sh

이 권한이 없으면 Claude Code가 스크립트를 실행하지 못해 상태 줄이 나타나지 않습니다.

4. settings.json에 연결

~/.claude/settings.json의 최상위 객체 안에 statusLine을 추가합니다.

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh",
    "padding": 1
  }
}

이미 다른 설정이 들어 있다면 위 예제로 파일 전체를 덮어쓰지 말고 기존 { } 안에 statusLine 항목만 합쳐야 합니다. JSON 항목 사이의 쉼표도 확인합니다.

5. Claude Code 재시작과 실제 결과

Claude Code를 완전히 종료한 다음 프로젝트 폴더에서 다시 실행합니다.

claude

Claude Code 2.1.226에 별도의 임시 설정 파일을 연결해 실제로 실행했을 때 입력창 아래에는 다음 한 줄이 표시됐습니다.

[Opus 5 (1M context)] statusline-demo | context 0% | 5h - | week -

Claude Code 2.1.226을 임시 프로젝트와 격리 설정으로 실행한 뒤, 실제 TUI 하단 셀을 캡처한 화면입니다.

이 결과는 스크립트가 정상 실행되고 있다는 뜻입니다. statusline-demo는 테스트한 작업 폴더 이름이고, 새 세션이라 컨텍스트는 0%였습니다. 이 인증 환경에서는 Claude Code가 status line 입력 JSON에 5시간·주간 한도 값을 전달하지 않아 -로 표시됐습니다. -는 스크립트 오류가 아니라 해당 필드가 없을 때 보여 주도록 정한 기본값입니다. 값을 제공하는 요금제·인증 환경에서는 5h 41% | week 18%처럼 숫자로 나타납니다.

공식 문서의 핵심 필드는 model.display_name, workspace.current_dir, context_window.used_percentage, rate_limits.five_hour, rate_limits.seven_day입니다. 요금제나 인증 방식에 따라 rate_limits가 없을 수 있으므로 예제처럼 기본값을 두는 편이 안전합니다.

값이 표시되지 않을 때

아래 순서로 확인합니다.

1. jq --version이 정상 출력되는지 확인
2. ls -l ~/.claude/statusline.sh에서 실행 권한이 있는지 확인
3. settings.json의 JSON 문법과 스크립트 경로 확인
4. Claude Code를 완전히 종료한 뒤 다시 실행
5. 5시간·주간 값만 -라면 현재 입력 JSON에 rate_limits가 없는 환경인지 확인

설정을 없애려면 /statusline clear 또는 /statusline remove it처럼 요청할 수 있습니다. 수동으로 제거할 때는 settings.json에서 statusLine 항목만 지우고 JSON 쉼표가 깨지지 않았는지 확인합니다.

Codex CLI /usage와 /status 차이

Codex CLI에서도 대화 입력창에 /usage를 입력합니다.

/usage

확인한 0.148.0에서는 먼저 Show usage 메뉴가 열리고, 선택하면 계정의 토큰 활동을 일간·주간·누적으로 바꿔 볼 수 있었습니다. 원하는 범위를 바로 열 수도 있습니다.

/usage daily
/usage weekly
/usage cumulative

계정에 사용할 수 있는 usage limit reset이 있으면 재설정 메뉴가 활성화됩니다. 사용할 수 있는 reset이 없으면 해당 메뉴에 이용 가능한 재설정이 없다고 표시됩니다.

/usage와 /status는 목적이 다릅니다.

명령	보여주는 내용	사용할 때
/usage	계정의 일간·주간·누적 토큰 활동과 사용 가능한 재설정 메뉴	계정 전체 사용 패턴 확인
/status	현재 모델, 승인 정책, 쓰기 가능한 경로, 세션 토큰·남은 컨텍스트	지금 세션이 어떤 설정으로 동작하는지 확인

현재 세션이 예상한 모델과 폴더에서 실행 중인지 확인하려면 /status, 계정 단위 활동을 보려면 /usage가 더 맞습니다. /usage의 계정 토큰 활동은 ChatGPT 로그인 기준 기능입니다. API 키로 인증한 환경에서는 이 정보를 불러오지 못하거나 ChatGPT 로그인을 요구할 수 있습니다.

Codex CLI status line 항목 고르기

Codex CLI에서도 status line은 작업창 하단에 계속 표시됩니다. 다만 Claude Code처럼 별도의 셸 스크립트를 만들 필요는 없습니다. Codex CLI에는 표시 항목과 순서를 고르는 선택 화면이 내장돼 있습니다.

1. status line 선택 화면 열기

Codex CLI 입력창에서 다음 명령을 실행합니다.

/statusline

이 명령은 현재 status line에 넣을 수 있는 항목 목록을 엽니다.

2. 항목 선택과 순서 변경

선택 화면에서는 다음 키를 사용합니다.

• 위·아래 방향키: 선택할 항목으로 이동
• 스페이스바: 항목을 켜거나 끔
• 왼쪽·오른쪽 방향키: status line에 표시할 순서 변경
• Enter: 구성을 저장하고 선택 화면 닫기

Codex CLI 0.148.0에서 확인한 선택 화면 구조를 계정 정보 없이 재구성한 이미지입니다.

사용량 확인에 유용한 항목은 다음과 같습니다.

항목 ID	표시 내용
model-with-reasoning	현재 모델명과 reasoning 수준
context-used	현재 세션에서 사용한 컨텍스트 비율
context-remaining	현재 세션에 남은 컨텍스트 비율
five-hour-limit	5시간 사용 한도의 남은 양
weekly-limit	주간 사용 한도의 남은 양
git-branch	현재 Git 브랜치
current-dir	현재 작업 폴더
used-tokens	현재 세션의 전체 사용 토큰

context-used와 context-remaining은 같은 컨텍스트를 반대 방향으로 보여주므로 둘 중 하나만 선택해도 충분합니다. 또한 five-hour-limit과 weekly-limit은 사용한 비율이 아니라 남은 양을 표시합니다. Claude 예제 스크립트의 used_percentage와 숫자 방향이 반대라는 점에 주의합니다.

3. 저장 후 실제 표시 결과

Enter를 누르면 선택한 항목이 바로 적용되고 ~/.codex/config.toml의 tui.status_line에 저장됩니다. 다음에 Codex CLI를 다시 실행해도 같은 구성이 유지됩니다.

계정 사용률이 공개되지 않도록 모델·컨텍스트·현재 폴더만 선택한 뒤 Codex CLI 0.148.0을 실제 실행하면 하단에는 다음처럼 표시됩니다.

gpt-5.6-sol default · Context 0% used · /tmp/codex-statusline-demo

Codex CLI 0.148.0을 임시 프로젝트에서 실행한 뒤 실제 TUI 하단 셀을 캡처한 화면입니다.

화면 위쪽의 Ask Codex to do anything은 입력 영역이고, 그 아래 한 줄이 status line입니다. 현재 모델, 새 세션의 컨텍스트 사용률, 임시 작업 폴더가 한 화면에 계속 남아 있는 것을 확인할 수 있습니다.

4. config.toml 직접 편집

선택 화면을 사용하면 아래와 같은 설정이 ~/.codex/config.toml에 저장됩니다. 사용량과 작업 위치를 함께 보려면 다음 구성이 무난합니다.

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

이미 파일에 [tui] 구역이 있다면 [tui]를 하나 더 만들지 말고 기존 구역 아래에 status_line = [...]만 추가합니다. TOML에서 같은 테이블을 중복 선언하면 설정을 읽지 못할 수 있습니다.

OpenAI 공식 샘플의 기본 status line은 model-with-reasoning, context-remaining, current-dir입니다. 위 예시는 사용량 확인에 맞춰 항목을 바꾼 구성입니다. 항목 ID는 버전에 따라 달라질 수 있으므로 직접 입력하기 전에 현재 버전의 /statusline 목록을 먼저 확인하는 편이 안전합니다.

값이 보이지 않을 때

1. codex --version으로 현재 버전을 확인
2. /statusline을 다시 열어 항목이 선택돼 있는지 확인
3. ~/.codex/config.toml에 [tui]가 중복돼 있지 않은지 확인
4. Git 저장소가 아닌 폴더라면 git-branch가 비어 있을 수 있음
5. 인증 방식이나 계정 상태가 한도 정보를 제공하지 않으면 five-hour-limit·weekly-limit이 나타나지 않을 수 있음
6. 터미널 폭이 좁다면 항목 수를 줄이거나 순서를 짧게 조정

표시줄을 숨기고 싶다면 /statusline에서 항목을 모두 해제하거나 설정 파일에서 다음처럼 빈 배열을 사용합니다.

[tui]
status_line = []

컨텍스트와 계정 한도에 각각 대응하기

사용량이 높다고 무조건 새 세션을 열 필요는 없습니다. 어떤 값이 높은지부터 확인합니다.

대화 내용이 아니라 설치된 Skills 목록이 차지하는 비용부터 줄이고 싶다면 Claude Code /skill-doctor로 안 쓰는 스킬 정리하기에서 스킬별 사용 기록과 전후 비교 방법을 확인할 수 있습니다.

컨텍스트만 많이 찬 경우

현재 대화가 길어진 상태입니다. 다음 작업에 필요한 결정, 변경 파일, 테스트 결과를 프로젝트 문서에 남긴 뒤 대화를 압축하거나 새 세션으로 전환합니다.

Claude Code에서는 다음처럼 핵심을 지정해 압축할 수 있습니다.

/compact 코드 변경, 실패한 테스트, 다음 할 일만 보존해줘

새 세션으로 옮길 때는 Git 상태도 함께 확인합니다.

git status --short --branch
git diff --check

5시간·주간 한도가 높은 경우

새 세션을 열어도 계정 한도는 돌아오지 않습니다. 재설정 시각을 확인하고, 급하지 않은 대규모 탐색이나 반복 생성은 미룹니다. 작업을 계속해야 한다면 더 작은 모델을 선택할 수 있는지, 한 번에 읽힐 파일 범위를 줄일 수 있는지 검토합니다.

세션 토큰이 빠르게 늘어나는 경우

큰 로그, 빌드 출력, 테스트 전체 결과를 매번 대화에 넣고 있지 않은지 봅니다. 실패 줄만 추리거나 결과를 파일로 저장한 뒤 요약을 전달하면 컨텍스트 증가를 줄일 수 있습니다.

npm test 2>&1 | tee test-result.log

AI에게는 전체 로그를 반복해서 붙이기보다 test-result.log에서 실패 원인과 관련된 줄을 먼저 찾도록 요청합니다.

작업을 시작하기 전에 확인할 명령

긴 작업을 시작하기 전에 다음 항목을 확인합니다.

1. claude --version 또는 codex --version으로 현재 버전을 확인합니다.
2. 각 도구의 /status로 현재 세션과 설정 상태를 확인합니다. Codex CLI에서는 모델·승인 정책·쓰기 가능한 경로·남은 컨텍스트가 표시됩니다.
3. /usage로 계정 사용량과 재설정 시각을 봅니다.
4. status line에는 컨텍스트·5시간·주간 한도만 간결하게 남깁니다.
5. 컨텍스트가 차면 결정과 테스트 결과를 파일에 기록합니다.
6. 계정 한도에 가까우면 새 세션보다 작업 범위와 모델 선택을 먼저 조정합니다.

Claude Code와 Codex CLI의 메뉴 이름은 비슷하지만, 컨텍스트와 계정 한도를 구분하는 원칙은 같습니다. /usage는 필요할 때 자세히 보고, status line은 작업을 멈추기 전에 알아야 할 숫자만 계속 보여주는 용도로 쓰면 됩니다.

공식 문서

• Anthropic Claude Code: Manage costs effectively
• Anthropic Claude Code: Customize your status line
• Anthropic Claude Code: Settings
• OpenAI Codex: Developer commands
• OpenAI Codex: Configuration reference
• OpenAI Codex: Sample configuration