Codex CLI 사용량 확인: /usage로 일간·주간·누적 토큰 활동 처음 보는 법
TL;DR
Codex CLI의 계정 token activity를 확인하려면 TUI 입력창에서
/usage
를 엽니다. 메뉴에서 사용량 보기를 선택하거나
/usage daily
,
/usage weekly
,
/usage cumulative
로 범위를 바로 지정할 수 있습니다. 첫 점검은 수치를 읽고 기록하는 데서 끝내며, available earned reset 사용은 별도 승인으로 남깁니다.
핵심 3줄 요약
핵심 1
/usage
는 운영체제 셸 명령이 아니라 Codex TUI 안에서 여는 계정 사용량 메뉴입니다.
핵심 2
공식 문서는 daily·weekly·cumulative token activity 보기와 available earned reset action을 구분합니다.
핵심 3
서비스 계정 인증이 없으면 sign-in requirement가 나타날 수 있으므로 현재 화면과 인증 상태를 확인합니다.
이 글에서 다룰 내용
-
/usage를 입력할 위치와 Enter 전에 인식 여부를 확인하는 법 - 사용량 메뉴와 daily·weekly·cumulative 보기의 차이
-
/status와/usage를 섞지 않는 기준 - reset을 실행하지 않고 읽기 전용 점검으로 마치는 방법
왜 사용량 확인이 필요한가
여러 작업을 이어서 처리하면 계정의 token activity가 어느 기간에 쌓였는지 궁금해집니다. 대화 횟수나 체감으로는 기간별 활동을 구분하기 어렵습니다. Codex가 제공하는 사용량 화면을 직접 확인합니다.
첫 확인에서 사용량 reset까지 실행하지 않습니다. daily·weekly·cumulative 중 어떤 범위를 보고 있는지 확인한 뒤 관찰 시각과 화면 범위를 기록하면 충분합니다.
Codex
/usage
란
/usage
는 Codex TUI에서 계정 token usage action을 여는 slash command입니다. 공식 Developer Commands 문서는 메뉴에서 token activity를 보거나 available earned reset을 사용할 수 있다고 설명합니다. 또한
/usage daily
,
/usage weekly
,
/usage cumulative
를 직접 입력해 각 보기를 열 수 있다고 명시합니다.
/usage
는 Codex TUI에서 계정 token activity의 기간별 보기를 여는 명령입니다. 결제 금액, 남은 작업 횟수, 조직별 과금 규칙까지 설명하는 기능이라고 넓혀 쓰면 안 됩니다. 공식 문서가 확인한 범위는 계정 token activity와 available earned reset action입니다.
언제 이 확인 흐름이 맞을까
작업 전후의 계정 사용량 화면을 비교하거나 최근 활동의 기간 범위를 확인할 때 맞습니다. daily·weekly·cumulative 보기 중 무엇을 기록할지 먼저 정하면 나중에 같은 기준으로 비교하기 쉽습니다.
비용 청구 내역이나 플랜 한도, 조직별 정책은
/usage
화면만으로 판단하지 않습니다. 공식 문서가 해당 정보를 보장하지 않으므로 공식 계정·관리 화면을 따로 확인합니다.
시작 전에 준비할 것
민감하지 않은 빈 폴더에서 Codex CLI를 실행합니다. 작업 파일을 읽거나 모델에게 요청을 보낼 필요는 없습니다. 입력창이 준비됐는지 확인한 뒤 아래 순서로 진행합니다.
이번에는
codex-cli 0.144.6
과 일회용
CODEX_HOME
에서 설치 표면을 점검했습니다.
/usage
completion과 Usage 화면을 확인했으며 모델 turn, 프로젝트 파일 생성,
config.toml
변경은 없었습니다. 이 관찰을 다른 버전이나 모든 계정의 제공 조건으로 일반화하지 않습니다.
1단계:
/usage
를 입력할 위치를 확인합니다
터미널 셸에
/usage
를 단독 명령처럼 실행하지 않습니다. 먼저
codex
로 TUI를 연 뒤 대화 입력창에
/usage
를 입력합니다.
Enter를 누르기 전에 slash completion에서
/usage
항목이 보이는지 확인합니다. 항목이 나타나지 않으면 입력을 지우고 현재 설치 화면의 명령 목록을 살펴봅니다. 인식되지 않은 문자열을 일반 프롬프트로 제출하지 않습니다.
2단계: Usage 메뉴를 엽니다
/usage
가 completion에서 확인됐을 때만 Enter를 누릅니다. 이 명령은 공식 문서상 usage menu를 엽니다. 현재 설치 점검에서는
Show usage
와 recent account token usage 설명이 있는 Usage 화면이 나타났습니다.
메뉴에는 사용량 보기와 available earned reset action이 함께 나타날 수 있습니다. 첫 확인에서는 사용량 보기만 선택합니다. reset 가능 여부가 보이더라도 실행하지 않습니다.
3단계: token activity 보기를 선택합니다
Usage 메뉴에서 token activity 보기를 선택합니다. 직접 열고 싶다면 공식 문서가 제시한
/usage daily
,
/usage weekly
,
/usage cumulative
중 필요한 명령을 사용합니다.
세 명령은 확인 범위를 나눕니다. 실제 기간과 단위, 수치는 현재 계정 UI를 기준으로 읽습니다. 문서에 없는 집계 시작 시각이나 갱신 주기를 추정하지 않습니다.
4단계: daily·weekly·cumulative를 구분합니다
기록에는 실행한 명령, 확인 시각, 선택한 범위, 화면에 표시된 상태를 함께 남깁니다. 예를 들어 daily 보기를 열었다면 weekly 값과 섞지 않고 daily 관찰로만 기록합니다.
서로 다른 기간의 수치를 곧바로 합산하거나 증가율로 바꾸지 않습니다. 계산 전에 각 화면의 의미를 현재 UI와 공식 안내에서 다시 확인합니다.
5단계: 읽기 전용 점검으로 마칩니다
원하는 범위를 확인했으면 화면을 닫고 관찰 결과만 보관합니다. 작업 파일 수정, Codex 설정 변경, 모델 요청은 이 기능 시작 흐름의 완료 조건이 아닙니다.
available earned reset은 사용량 조회와 다른 action입니다. reset 사용이 필요하면 대상 계정, 기대 효과, 승인자를 따로 확인한 뒤 별도 절차로 진행합니다.
복사해서 쓰는 점검 프롬프트
목표: Codex /usage 화면의 계정 token activity를 기간별로 구분해 읽기 전용 점검표로 정리합니다.
허용 입력: 확인 시각, 실행한 /usage 명령, 화면에 표시된 범위·단위·수치, 인증 요구 문구만 사용합니다.
제외 입력: 비밀값, 고객 데이터, 결제 추정, 플랜 한도 추정, 조직 정책 추정, reset 실행은 제외합니다.
출력 형식: 확인 시각 | 명령 | 범위 | 표시값 | 인증 상태 | 확인 필요 항목의 6열 표로 작성합니다.
완료 기준: daily·weekly·cumulative 중 실제로 확인한 범위만 기록하고 화면 원문과 한 번 대조합니다.
추정 금지: 문서나 화면에 없는 집계 주기, 비용, 남은 작업 횟수, reset 효과를 지어내지 않습니다.
승인 지점: earned reset 사용, 외부 공유, 결제 판단은 사람이 별도로 승인합니다.
실전 인사이트:
/status
와 역할을 나눕니다
공식 명령표에서
/status
는 현재 session configuration과 token usage를 요약합니다.
/usage
는 account token usage action과 daily·weekly·cumulative 보기를 엽니다. 현재 세션의 실행 조건은
/status
, 계정 활동 범위는
/usage
에서 확인하면 두 질문이 섞이지 않습니다.
두 화면의 수치를 같은 집계라고 가정하지 않습니다. 표시 범위와 설명을 먼저 확인하고, 서로 다른 목적의 값을 한 표에 합칠 때는 출처 열을 분리합니다.
주의할 점
- 공식 문서는 서비스 계정 인증이 없는 session에서 sign-in requirement가 나타난다고 명시합니다. 인증이 없을 때 임의 우회 방법을 만들지 않습니다.
- 플랜, 지역, 운영체제, 최소 버전 제공 조건은 현재 공식 문서에서 확인되지 않았습니다. 현재 설치의 slash completion과 계정 UI를 확인합니다.
- token activity를 비용, 잔여 횟수, 생산성으로 바로 해석하지 않습니다. 그런 관계는 공식 근거가 따로 필요합니다.
- available earned reset은 조회가 아니라 별도 action입니다. 첫 점검에서는 실행하지 않습니다.
- 사용량 화면을 공유해야 한다면 계정 식별 정보와 내부 사용 패턴이 포함됐는지 사람이 먼저 검토합니다.
자주 묻는 질문
/usage
를 터미널 셸에서 실행하나요?
아닙니다. Codex TUI의 대화 입력창에서 실행하는 slash command입니다. Enter 전에 completion row를 확인합니다.
daily·weekly·cumulative는 어떻게 바로 여나요?
공식 문서는
/usage daily
,
/usage weekly
,
/usage cumulative
를 직접 입력할 수 있다고 설명합니다. 실제 표시 범위와 단위는 현재 계정 화면을 기준으로 읽습니다.
/status
와
/usage
는 같은 명령인가요?
아닙니다.
/status
는 현재 session configuration과 token usage 요약에 가깝고,
/usage
는 계정 token usage action과 기간별 보기를 엽니다. 표시된 설명과 범위를 확인한 뒤 사용합니다.
sign-in requirement가 나오면 어떻게 하나요?
공식 문서는 서비스 계정 인증이 없을 때 sign-in requirement가 나타난다고 안내합니다. 현재 계정의 정상 인증 경로를 확인하고, 자격증명 파일을 복사하거나 비공식 우회 절차를 만들지 않습니다.
출처
- OpenAI Codex Developer Commands 공식 문서 —
/usage메뉴, token activity, daily·weekly·cumulative 직접 실행, 서비스 계정 인증 경계를 확인했습니다.
마무리
Codex CLI 사용량은
/usage
인식 확인, Usage 메뉴 열기, token activity 범위 선택, 화면 원문 대조, 읽기 전용 기록 순서로 처음 점검합니다. 사용량 reset과 비용 판단은 이 흐름에 섞지 않고 별도 승인으로 남깁니다.
