Claude Code, Codex, Cursor 사용량 및 비용 확인 방법

Claude Code는 플랜의 상한선에 얼마나 근접했는지 정도만 알려줄 뿐, 토큰이 어디에 사용되었는지는 잘 보여주지 않습니다. 세션에서 /usage를 입력하면 5시간 단위와 주간 상한선이 백분율 바(bar)로 표시되며, API를 사용하는 경우 현재 세션의 예상 금액이 나옵니다. 하지만 '지난주 화요일에 얼마를 사용했는지', '이번 달 어떤 프로젝트가 가장 많이 사용했는지', 'Max 플랜이 토큰 단위 결제보다 정말 더 저렴했는지'와 같은 기록은 볼 수 없습니다.

실제로 이 정보는 이미 컴퓨터 안에 있습니다. Claude Code는 모든 대화를 기록 파일에 남기며, 응답마다 모델명과 토큰 수를 정확하게 기재합니다. ccusage나 CodeBurn 같은 커맨드라인 도구들은 이 파일을 읽어 합산합니다. 저는 설치 없이 동일한 답을 보고 싶었기 때문에, 브라우저 내에서 기록을 읽는 Claude Code 사용량 분석기(Analyzer)를 만들었습니다. Codex의 기록과 Cursor의 사용량 CSV도 함께 읽을 수 있습니다.

이 글에서는 사용량 기록이 어디에 있는지, 확인하는 방법은 무엇이 있는지, 그리고 제가 실제 기록을 분석기에 넣었을 때 무엇을 알게 되었는지를 정리했습니다. 아래의 모든 수치는 해당 기록과 2026년 10월 15일 기준으로 확인한 공식 요금표를 바탕으로 합니다. 금액은 1달러=158엔으로 환산한 대략적인 값입니다.

Claude Code 사용량은 어디에 기록되나요?

Claude Code는 세션별 대화 기록을 ~/.claude/projects/ 아래에 저장합니다. 프로젝트마다 폴더가 하나씩 생기고, 하나의 세션이 하나의 .jsonl 파일(1줄에 JSON이 1개)입니다. 서브 에이전트의 대화는 해당 세션 옆에 있는 subagents/ 폴더에 들어갑니다.

모델 응답마다 usage라는 항목이 있으며, 비용과 관련된 값은 다음 5가지입니다.

• 입력 토큰 (Input tokens): 캐시되지 않은 새로운 입력 -
• 캐시 쓰기 토큰 (Cache write tokens): 프롬프트 캐시에 새로 저장한 입력 (5분용과 1시간용으로 나뉨) -
• 캐시 읽기 토큰 (Cache read tokens): 캐시에서 다시 읽은 입력 -
• 출력 토큰 (Output tokens): 모델이 작성한 답변 (사고 과정 포함) -
• 모델 (Model): 예를 들어 claude-opus-5-5

여기서 주의할 점이 두 가지 있습니다. 첫째는, 같은 응답이 스트리밍 중에 여러 줄로 나뉘어 기록되고, 세션을 재개하면 다시 복사되는 경우가 있다는 것입니다. 그대로 더하면 같은 응답을 여러 번 계산하게 됩니다. 분석기는 메시지 ID와 요청 ID를 통해 하나의 응답을 한 번만 계산합니다. 둘째는, 기록이 영원히 남아있는 것은 아니라는 점입니다. Claude Code의 공식 문서에 따르면, cleanupPeriodDays로 설정된 기간보다 더 오래된 기록은 삭제되며, 기본 설정은 30일입니다. 더 길게 보고 싶다면, 기록이 사라지기 전에 ~/.claude/settings.json에서 이 값을 늘려두는 것이 좋습니다.

Claude Code 사용량을 확인하는 4가지 방법

Claude Code の使用量を確認する4つの方法: 方法, 見られるもの, インストール, 日付・プロジェクト別の履歴, プランと API の比較, Codex・Cursor

Claude Code の使用量を確認する4つの方法: 方法, 見られるもの, インストール, 日付・プロジェクト別の履歴, プランと API の比較, Codex・Cursor

상한에 걸릴 것 같은지 확인하려면 /usage가 적합합니다. Pro・Max 플랜의 경우, 서브 에이전트나 MCP 서버, 캐시 미스 등 상한을 많이 사용하는 항목도 표시됩니다. 다만, 몇 주 전 기록을 되돌아보는 용도는 아닙니다. 터미널에 익숙하다면 ccusage나 CodeBurn이 편리하며, 둘 다 같은 .jsonl 파일을 읽습니다. 브라우저 분석기는 Node.js를 설치하고 싶지 않은 사람이나, 플랜과 API 비교를 한 화면에서 보고 싶은 사람에게 적합합니다.

분석기 사용 방법

ファイル選択画面と Claude Code・Codex・Cursor の記録の場所

• tokensave.app/ja/claude-code-usage 를 엽니다.
• 폴더 선택을 누르고, projects 폴더를 선택합니다. Windows에서는 폴더 선택 화면 상단 주소창에 %USERPROFILE%\.claude\projects를 붙여넣고 Enter를 누릅니다. Mac은 ⌘ + Shift + G를 눌러 ~/.claude/projects를 붙여넣습니다. - 필요하다면 Codex의 ~/.codex/sessions 폴더와 Cursor 사용량 CSV(Cursor 대시보드 → Usage → Export CSV)도 함께 넣습니다. - 결과를 확인합니다. 기간은 모두・7일・30일・이번 달로 전환할 수 있으며, 자신의 플랜을 선택하여 비교가 표시됩니다.

폴더를 선택할 때 Chrome이

분석기(Analyzer)는 선택한 플랜과 동일 기간/동일 도구의 API 비용을 비교합니다. 제 Claude 기록은 17일치입니다. Max 5×는 세금 제외 월 100달러이므로, 17일치는 약 8,950엔(56.67달러)입니다. 같은 토큰을 API로 지불할 경우 145.90달러가 되므로, 지불한 요금의 약 257%에 해당하는 API 가치를 사용하게 된 것입니다. 에이전트로 많은 작업을 할수록, 토큰 단위 결제보다 구독 방식이 확실히 저렴해졌습니다.

자신의 결과를 볼 때 주의할 점이 두 가지 있습니다.

• 플랜에는 상한선이 있습니다. Pro와 Max는 5시간마다 초기화되며, 주간 상한선도 있습니다. API로 환산된 금액이 요금의 몇 배에 달한다면, 이미 상한에 근접했을 가능성이 높으며, 그 경우 선택지는 기다리기, 상위 플랜으로 변경하기, 추가 사용량 구매하기 중 하나입니다. - 사용 빈도가 낮다면 플랜 자체가 손해가 될 수도 있습니다. 제 Codex와 Cursor는 무료 플랜이었고 각각 1.98달러와 0.29달러였습니다. 이 정도의 Codex 이용에 ChatGPT Plus(월 20달러)를 지불했다면, 요금보다 적게 사용한 것이 됩니다. 분석기는 이 경우를 주황색으로 표시합니다.

아직 Claude Code를 사용해 본 적이 없고, 기록이 아닌 예상 비용을 알고 싶다면, 작업의 크기와 일일 작업 횟수를 기반으로 한 달 비용을 계산하는 Claude Code 월별 비용 계산기(Claude Code Monthly Cost Calculator)를 사용할 수 있습니다.

Codex와 Cursor 사용량

Codex는 ~/.codex/sessions/년/월/일/ 아래에 세션별로 rollout-….jsonl 파일을 남깁니다. 응답마다 사용량을 적는 것이 아니라, 단계(step)마다 세션 전체의 누적 사용량을 기록합니다. 분석기는 단계 사이에 증가한 부분을 OpenAI API 요금으로 계산하고, 캐시 입력은 캐시 단가로 계산합니다. 제 기록에 있던 GPT-5.6 Terra는 100만 토큰당 입력 2달러, 캐시 입력 0.20달러, 출력 12달러였고, GPT-6 Luna는 각각 0.10달러, 0.01달러, 0.50달러였습니다. 아카이브된 세션은 같은 이름으로 archived_sessions/로 이동하므로, 파일명은 한 번만 계산합니다.

Cursor는 상황이 다릅니다. 제 컴퓨터에 있는 Cursor의 로컬 데이터베이스를 열어보니, 모든 대화가 토큰 수 0으로 저장되어 있었습니다. 최신 Cursor는 컴퓨터에 토큰 수를 남기지 않기 때문에, 커맨드라인 도구로도 Cursor는 글자 수(character count)를 기반으로 추정할 수밖에 없습니다. 정확한 데이터는 Cursor의 대시보드에서 사용량 내보내기(Usage Export)입니다. Usage 화면에서 Export CSV를 누르면, 날짜/시간, 모델, 캐시 쓰기를 포함하는 입력과 포함하지 않는 입력, 캐시 읽기, 출력, Cursor가 청구한 금액이 요청별로 나옵니다. 분석기는 이 금액을 그대로 사용합니다.

비용 절감 방법

비용의 대부분이 캐시와 출력에서 온다는 것을 알면, 절약하는 방법도 보입니다.

• 새로운 작업은 새로운 세션으로. /clear로 이전 문맥을 지우면, 다음 단계부터는 그것을 다시 읽지 않습니다. 세션이 길어질수록, 이전 내용 전체에 캐시 읽기 비용이 계속 발생합니다. - 평소 작업은 Sonnet으로. Sonnet 5.5는 100만 토큰당 2달러/10달러이고, Opus 5.5는 4달러/20달러이므로, 같은 세션이 API 환산으로 약 50% 저렴해집니다. - 비싼 날을 확인하기. 일별 그래프를 보면, 어느 날 어떤 작업으로 비용이 증가했는지 바로 알 수 있습니다. - 사용하지 않는 도구 정리하기. 플랜을 사용하고 있다면, /usage로 어떤 MCP 서버나 서브 에이전트가 상한을 사용하고 있는지 볼 수 있습니다.

다른 방법은 Claude Code의 토큰 절약 기술에, 상한 자체는 Claude Code 사용량 상한 요약에 모아두었습니다.

자주 묻는 질문

Claude Code의 사용 기록은 어떻게 보나요?

사용량 분석기(Usage Analyzer)에서 ~/.claude/projects 폴더를 열거나, 터미널에서 npx ccusage를 실행합니다. Claude Code의 /usage는 기록이 아니라 현재 상한을 표시합니다.

분석기가 코드를 업로드하나요?

아니요. 브라우저 탭 안에서 파일을 읽고 토큰 숫자를 합산할 뿐입니다. 어딘가로 보내지 않습니다.

API 환산 비용이 왜 플랜보다 훨씬 높게 나올까요?

에이전트는 단계별로 전체 컨텍스트를 다시 읽기 때문에 캐시된 토큰이 매우 많이 쌓입니다. 플랜은 정액제이기 때문에 실제로 그 금액을 지불하는 것이 아니라, 이 숫자는 동일한 토큰을 토큰 단위 요금으로 지불했을 경우의 금액입니다.

왜 최근 한 달치만 나오나요?

Claude Code가 초기 설정에서 30일이 지난 기록을 삭제하기 때문입니다. settings.json에서 cleanupPeriodDays를 늘리면 더 오래 보존됩니다.

Gemini CLI나 Copilot, Windsurf에도 대응하나요?

아직 대응하지 않습니다. 현재는 Claude Code, Codex, Cursor의 CSV 파일을 읽을 수 있습니다.

요약

Claude Code는 사용한 토큰을 모두 기록하고 있어, 어려운 점은 그것을 읽어내는 것입니다. /usage는 상한선에 얼마나 근접했는지, ~/.claude/projects의 기록은 돈이 어디로 갔는지 알려줍니다. 제 17일간의 에이전트 작업에서는 토큰 대부분이 캐시 로딩에서 사용되었고, 캐시 관련 비용이 API 환산액의 약 3분의 2를 차지했으며, Max 5×는 요금의 약 257% 가치를 지녔습니다. 무료 플랜으로 사용한 Codex와 Cursor를 합쳐도 몇 달러에 불과했습니다. 자신의 수치가 궁금하다면, 사용량 분석기(usage analyzer)에 폴더를 넣고 본인의 플랜과 비교해 보세요.

출처

• Claude Code 문서: .claude 디렉토리 (기록 위치 및 30일 삭제)
• Claude Code 문서: 비용 관리 (/usage)
• Anthropic API 요금 (프롬프트 캐시 단가)
• OpenAI API 요금
• Claude 플랜 · Cursor 요금
• ccusage · CodeBurn

이 글은 tokensave.app의 원 기사를 Zenn용으로 재배포한 것입니다. 자신의 기록으로 확인하고 싶다면 사용량 분석기(usage analyzer)를 열어보세요.

토론