ccusage

name	ccusage
description	Claude Code와 Codex CLI의 토큰 사용량 및 비용 리포트를 조회하는 스킬. "ccusage", "토큰 사용량", "usage report", "codex usage", "claude usage", "비용 리포트", "token usage", "cost report" 키워드에 반응.

ccusage Skill

Claude Code(ccusage)와 Codex(@ccusage/codex) 토큰/비용 리포트를 수동 실행합니다.

Usage

/ccusage [command] [options]

Commands

Command	Description
today	오늘 사용량 요약 (기본값)
daily	일별 리포트
monthly	월별 리포트
session	세션별 리포트
codex <scope>	Codex 전용 리포트
claude <scope>	Claude Code 전용 리포트

Options

Option	Description
--since YYYYMMDD	시작 날짜
--until YYYYMMDD	종료 날짜
--offline	오프라인 모드 (캐시된 가격 데이터 사용)
--json	JSON 출력

Examples

# 오늘 요약 (Claude + Codex 합산)
/ccusage today

# 일별 범위 리포트
/ccusage daily --since 20260201 --until 20260206 --offline

# 월별 요약
/ccusage monthly --offline

# 세션별 요약
/ccusage session --offline

# Codex 전용
/ccusage codex daily --json --since 20260201

# Claude Code 전용
/ccusage claude daily --json --since 20260201

Output

ccusage manual summary (daily)
Source         Total Tokens    Cost (USD)
------------  --------------  ----------
Codex               1,234,567   $12.3456
Claude              2,345,678   $23.4567
Combined            3,580,245   $35.8023

Implementation

Execute the script:

bash .claude/skills/ccusage/scripts/ccusage-manual.sh [command] [options]

Requirements

• Node.js (npx, node)
• ccusage@latest (npm)
• @ccusage/codex@latest (npm)

Data Source

• Claude Code: ~/.claude/projects/ 내 JSONL 세션 파일
• Codex: Codex CLI 로컬 로그

Related

• Skill: analytics - 내부 Tool/Agent 사용 통계
• Agent: analytics-reporter - 상세 분석 및 인사이트