한 줄 요약: 내가 만든 Codex 사용량 확인 앱은 웹페이지를 다시 열지 않고 메뉴 막대에서 현재 상태를 빠르게 확인하기 위해 시작한 개인 프로젝트입니다.
왜 메뉴 막대부터 만들었나
사용량을 확인하려고 매번 사이트를 여는 흐름이 반복됐습니다. 내가 필요한 것은 복잡한 분석 화면보다, 지금 확인할 수 있는 정보와 마지막 갱신 상태를 빠르게 보는 것이었습니다.
그래서 처음에는 메뉴 막대에서 한눈에 확인하는 최소 기능부터 정리했습니다.
내가 표시 기준을 나눈 방식
숫자가 있더라도 출처와 마지막 확인 시점을 함께 봅니다. 확인하지 못했거나 갱신이 실패한 경우에는 그 상태를 수치처럼 보이게 하지 않았습니다.
현재 직접 확인해 사용하는 범위와, 아직 검증하지 않은 플랫폼·기능은 같은 목록에 넣지 않았습니다.
프로젝트를 공개할 때 남긴 원칙
이 글은 완료를 과장하는 소개가 아니라, 내가 실제 사용 중인 범위와 미검증 범위를 함께 기록한 프로젝트 노트입니다. 이후 확인 범위가 넓어지면 그 결과를 별도 글로 갱신하겠습니다.
공개 범위
이 글에는 계정 화면, 내부 경로, 원문 문서와 작업 로그를 넣지 않습니다. 내가 직접 확인한 기준과 결과만 남깁니다.
공식 안내로 보는 Codex 사용량 확인 경로
메뉴 막대에 값을 띄우기 전에 알아 둘 것은, 공식적으로 사용량을 확인하는 경로가 이미 있고 메뉴 막대 표시는 그 값을 요약해 보여 주는 보조 수단이라는 점입니다. 아래는 OpenAI의 Codex 요금 안내 페이지와 GitHub의 Codex CLI 프로젝트 문서(2026년 10월 18일 기준)에 적힌 내용입니다.
한도의 모양: 5시간 단위와 주간 한도
Codex 요금 안내는 플랜별로 5시간 단위의 로컬 메시지 수를 추정치로 제시하고, 주간 한도가 함께 적용될 수 있다고 설명합니다. 5시간 수치는 고정된 개수가 아니라 추정이며, 로컬 메시지와 클라우드 작업이 같은 플랜 허용량을 함께 쓰고 클라우드 작업은 로컬 메시지보다 허용량을 더 쓸 수 있다고 합니다. 일부 플랜은 5시간 한도가 현재 없거나 고정 한도가 없는 것으로 안내되어 있어, 플랜에 따라 화면에 보여 줄 값 자체가 달라집니다. 구체적인 숫자는 바뀔 수 있어 이 글에서는 옮기지 않습니다.
공식 확인 경로 두 가지
같은 안내에서 현재 한도와 초기화 시각은 chatgpt.com의 Codex 사용량 설정 화면에서 볼 수 있고, 활성 Codex CLI 세션에서 /status를 실행하면 남은 한도가 표시된다고 합니다. 이 글에서 메뉴 막대 표시에 “마지막 갱신 상태”를 붙이고 값을 알 수 없을 때 CX --%로 그리는 이유는, 메뉴 막대의 숫자가 이 공식 화면보다 늦거나 틀릴 수 있기 때문입니다. 숫자가 의심스러우면 공식 화면이 기준입니다.
Codex CLI는 로컬에서 실행됩니다
GitHub의 Codex CLI README는 이 도구를 컴퓨터에서 로컬로 실행되는 OpenAI의 코딩 에이전트라고 소개하고, codex를 실행해 ChatGPT 계정으로 로그인하는 방식을 안내합니다. API 키를 쓰는 방식도 있지만 추가 설정이 필요하다고 합니다. 로그인 방식이 둘이라는 것은 “로그인이 필요한 상태”와 “데이터를 기다리는 상태”를 다르게 그려야 한다는 이 글의 기준과도 맞습니다.
| 확인 경로 | 공식 안내 | 메뉴 막대 표시 원칙 |
|---|---|---|
| 사용량 설정 화면 | 현재 한도와 초기화 시각 표시 | 초기화 시각은 눌렀을 때 보여 줌 |
CLI /status | 활성 세션의 남은 한도 표시 | 값 출처를 표시하고 오래된 값은 구분 |
| 5시간 수치 | 고정 개수가 아닌 추정치 | 추정치를 확정 수치처럼 쓰지 않음 |
| 값이 없을 때 | 플랜에 따라 5시간 한도가 없을 수 있음 | 0%로 대체하지 않고 --%로 표시 |
확인 자료
기준일: 2026-10-18