Claude Code·Codex 토큰 사용량 확인 방법
Claude Code의 토큰 사용량을 확인하려면 Claude Code에서 /usage를 실행하세요. 현재 세션의 토큰이 모델별로 나옵니다. 일별 기록과 추정 비용을 보려면 터미널에서 bunx ccusage를 실행합니다. Codex는 /status로 현재 채팅을, bunx ccusage codex daily로 기록을 볼 수 있습니다. 다만 모두 실행한 컴퓨터의 데이터만 읽습니다. 모든 컴퓨터를 합산해 iPhone에서 보고 싶다면, Nomo Pro의 활동 화면과 토큰 위젯이 일별·모델별 토큰을 연속 기록과 함께 보여줍니다.
이 글에서는 각 도구로 무엇을 볼 수 있는지, 왜 숫자가 서로 맞지 않는지, 무엇을 고르면 되는지 정리합니다.
'토큰 사용량'은 무엇을 세는가#
토큰은 몇 글자 정도의 텍스트 조각입니다. 에이전트의 요청은 네 가지 토큰으로 측정됩니다. 입력(모델에 보내는 내용), 출력(모델이 돌려주는 내용, 추론 포함), 캐시 읽기(모델이 이미 본 컨텍스트를 프롬프트 캐시에서 읽은 것), 캐시 쓰기입니다.
가장 놀라기 쉬운 것이 캐시입니다. Claude Code는 요청할 때마다 대화 전체를 보내고, 그 대부분은 캐시에서 돌아옵니다. Anthropic의 비용 문서에 나온 예시입니다.
Usage by model:
claude-sonnet-4-6: 1.2k input, 5.3k output, 940.0k cache read, 50.0k cache write ($0.55)
실제 입력과 출력은 합쳐서 6.5k인데 캐시는 100만 가까이 됩니다. 두 도구의 숫자가 10배 차이 난다면, 먼저 한쪽이 캐시를 포함하는지 확인하세요.
또 하나 구분할 점은 토큰이 곧 요금제 한도는 아니라는 것입니다. Claude Pro, Max, Ultra나 ChatGPT 요금제는 토큰 단위로 과금하지 않고, 한도는 5시간 구간과 주간 구간으로 정해집니다(한도가 초기화되는 방식). 토큰 수가 알려주는 것은 사용량이 '어디에' 쓰였는지입니다. 어떤 모델에서, 어느 날, 어떤 컴퓨터에서 썼는지 말입니다.
Claude Code에서 토큰 사용량 확인하기#
/usage를 실행하세요. 구독 요금제라면 요금제 사용량 막대, 활동 통계, 한도에 무엇이 영향을 줬는지에 대한 내역이 나옵니다. 맨 위의 Session 블록에는 위 예시처럼 현재 세션의 모델별 토큰과 정가 기준 추정 비용이 표시됩니다. /cost와 /stats는 별칭이고, /stats는 통계 탭을 바로 엽니다(명령 레퍼런스).
알아둘 점:
- 세션 단위입니다.
/clear로 새 세션을 시작하면 Session 블록의 합계가 0으로 돌아갑니다. - 내역은 컴퓨터 단위입니다. Anthropic 문서에 따르면 이 컴퓨터의 로컬 세션 기록으로 계산되며, 다른 기기나 claude.ai의 사용량은 포함되지 않습니다.
d와w로 최근 24시간과 최근 7일을 전환할 수 있습니다. /insights는 합계가 아니라 작업 방식 분석입니다. 그 컴퓨터의 최근 세션을 바탕으로 작업 습관을 정리한 HTML 보고서를 만듭니다.
Team이나 Enterprise 요금제에는 관리자용 멤버별 지출 보고서와 분석 대시보드가 있습니다. Claude Console의 API 키라면 Cost 페이지에서 같은 내용을 볼 수 있습니다.
Codex 토큰 사용량 확인하기#
Codex CLI에서는 /status가 현재 채팅의 ID, 컨텍스트 사용량, 속도 제한을 보여줍니다(Codex 명령). 컨텍스트가 얼마나 찼는지는 이것으로 충분하지만, 일별이나 모델별 기록은 남지 않습니다.
기록을 보려면 아래에서 소개하는, Claude Code와 함께 쓰는 서드파티 도구를 사용합니다.
ccusage로 일별 토큰 기록 보기#
ccusage는 Claude Code와 Codex가 원래 디스크에 남기는 세션 로그를 읽어 보고서로 만드는 오픈 소스 CLI입니다. Bun이 있으면 설치할 필요가 없습니다.
bunx ccusage # 일별 보고서(기본값)
bunx ccusage monthly # 월별로 한 줄
bunx ccusage session # 세션별로 한 줄
bunx ccusage codex daily
각 줄에는 입력, 출력, 캐시 토큰, 사용한 모델, 추정 비용이 나옵니다. 주별 보고서와 스크립트에 쓸 수 있는 JSON 출력도 있습니다.
알아둘 한계가 두 가지 있습니다. 구독 요금제라면 비용 열은 API 가격 기준 추정치이지 청구 금액이 아닙니다. 그리고 ccusage 스스로 '현재 컴퓨터의 데이터만 분석한다'고 밝히고 있습니다. 낮에는 MacBook, 밤에는 Mac mini로 개발한다면 기록이 두 개로 나뉩니다.
무엇을 쓰면 될까#
| 도구 | 볼 수 있는 것 | 범위 |
|---|---|---|
Claude Code의 /usage | 현재 세션, 요금제 막대 | 컴퓨터 한 대 |
Codex의 /status | 이 채팅의 컨텍스트, 제한 | 채팅 하나 |
bunx ccusage | 일별, 월별, 세션별 | 컴퓨터 한 대 |
| Nomo Pro | 일별·모델별, 연속 기록 | 페어링한 모든 컴퓨터 |
"이번 세션에 얼마나 썼지?"를 바로 알고 싶다면 /usage가 가장 간편합니다. 컴퓨터 한 대의 기록을 제대로 보려면 무료인 ccusage가 제격입니다. 빠진 것은 여러 컴퓨터의 합산, 그리고 터미널을 열지 않고 한눈에 확인할 곳입니다.
Nomo가 하는 일#
Nomo는 AI 코딩 에이전트를 쓰는 사람을 위한 iPhone 앱입니다. 버전 2.4.0에서 Nomo Pro에 활동 화면과 새 위젯이 추가됐고, 바로 이 데이터를 사용합니다. 각 컴퓨터의 Nomo 플러그인이 에이전트가 원래 남기는 기록을 읽어 일별 요약을 iPhone으로 보냅니다. 세는 대상은 Claude Code, Codex, OpenCode입니다.
- Nomo 토큰(위젯): 최근 14일을 모델별로 쌓은 막대와 오늘의 합계. 큰 크기에서는 지난주 대비 변화와 상위 4개 모델도 보여줍니다. 입력, 출력, 추론을 세고, 실제 작업량이 묻히지 않도록 캐시는 일부러 뺍니다.
- 활동 화면: 연속 기록과 26주간의 코딩 일자 지도, 7/14/30일 토큰 차트, 입력·출력·캐시·합계를 보여주는 모델별 표.
- 모든 컴퓨터를 합산: 토큰과 세션 수는 페어링한 컴퓨터 전체에서 더해지고, Mac 두 대에서 동시에 작업한 시간은 한 번만 셉니다.
- Nomo 활동(위젯): 연속 기록과 GitHub 스타일의 지도를 홈 화면이나 잠금 화면에. iOS 26.1 이상에서는 세션 탭의 탭 막대 위 작은 바에도 연속 기록이 표시됩니다.
- 결산: 한 주, 한 달, 한 해를 공유할 수 있는 이미지 한 장으로. 가장 바빴던 날, 가장 많이 쓴 모델, 최장 연속 기록이 들어갑니다. 프롬프트, 프로젝트 이름, 파일 경로는 들어가지 않습니다.
컴퓨터를 떠나는 것은 숫자뿐이며, 페어링 키로 종단 간 암호화됩니다. 날짜별·모델별 세션 수, 프롬프트 수, 활동한 5분 단위 구간, 토큰 수입니다. 프롬프트, 에이전트의 답변, 프로젝트 이름, 파일 경로는 보내지 않습니다. 업로드는 최대 6시간에 한 번이라 차트가 몇 시간 늦을 수 있습니다.
설정하려면 각 컴퓨터에서 bunx nomo-ai를 실행하고, 앱에서 페어링한 뒤 위젯을 추가하세요. 활동 기능에는 플러그인 2.4.0 이상이 필요합니다. 이미 Nomo가 설치된 컴퓨터에서는 같은 명령이 플러그인 업데이트 방법을 알려줍니다. App Store에서 Nomo를 받은 뒤, 문서의 Nomo 토큰과 활동 화면을 참고하세요. 같은 업데이트로 5시간·주간 한도가 초기화 전까지 버틸지 알려주는 Nomo 사용 속도 위젯과, 제공업체마다 계정을 최대 5개까지 추가하는 기능도 생겼습니다. 긴 세션이 자꾸 권한을 요청한다면 iPhone에서 Claude Code 권한 요청을 승인할 수도 있습니다.
자주 묻는 질문#
Claude Code의 /usage에 모든 컴퓨터의 사용량이 나옵니까?
아닙니다. Anthropic 문서에 따르면 이 내역은 해당 컴퓨터의 로컬 세션 기록으로 계산되며, 다른 기기나 claude.ai의 사용량은 포함되지 않습니다. 다만 요금제 사용량 막대는 계정 전체 기준입니다.
ccusage에 나오는 금액이 실제로 내는 돈입니까?
구독 요금제라면 아닙니다. Claude Pro, Max, Ultra와 ChatGPT 요금제는 토큰 단위로 과금하지 않으므로, 이 금액은 '그 토큰을 API 정가로 쓰면 얼마인지'를 보여주는 추정치입니다. 날짜별 비교에는 유용하지만 청구서는 아닙니다.
캐시 토큰 수는 왜 이렇게 큽니까?
요청할 때마다 대화 전체가 다시 전송되고, 그 대부분을 프롬프트 캐시에서 읽기 때문입니다. 캐시 읽기는 저렴하지만 쌓이면 입력과 출력보다 훨씬 큰 숫자가 됩니다. 그래서 Nomo의 토큰 차트는 캐시를 빼고, 활동 화면은 캐시를 별도 열로 보여줍니다.
Nomo는 Cursor나 Antigravity의 토큰도 셉니까?
아직은 아닙니다. Nomo 활동, Nomo 토큰, 결산이 세는 것은 Claude Code, Codex, OpenCode입니다. Cursor와 Antigravity 세션은 지금처럼 Dynamic Island와 세션 탭에 실시간으로 표시됩니다.
토큰을 세려고 Nomo가 제 프롬프트나 코드를 봅니까?
아닙니다. 플러그인은 일별 숫자만 보냅니다: 세션 수, 프롬프트 수, 활동한 5분 단위 구간, 모델별 토큰 합계입니다. 페어링 키로 종단 간 암호화되며, 중계 서버는 35일 후에 삭제합니다.
