INTEGRATION

ccusage to Token Battle

Token Battle supports ccusage monthly JSON as the official ranking import family. Export Claude Code, Codex CLI, or Gemini CLI usage through ccusage, preview normalized totals, submit the result, and share your monthly AI coding cost rank.

Generate an import file

(f=ccusage-claude.json; i=1; while [ -e "$f" ]; do f="ccusage-claude-$(printf '%02d' "$i").json"; i=$((i+1)); done; ccusage claude monthly --json > "$f"; echo "saved to $f")

(f=ccusage-codex.json; i=1; while [ -e "$f" ]; do f="ccusage-codex-$(printf '%02d' "$i").json"; i=$((i+1)); done; ccusage codex monthly --json > "$f"; echo "saved to $f")

(f=ccusage-gemini.json; i=1; while [ -e "$f" ]; do f="ccusage-gemini-$(printf '%02d' "$i").json"; i=$((i+1)); done; ccusage gemini monthly --json > "$f"; echo "saved to $f")

Upload the generated JSON from the Token Battle dashboard, or submit it with the Token Battle CLI. Official Claude Code and Codex direct exports are preview/diagnostic candidates, but they are not ranking-eligible in this leaderboard.

Security & Privacy

Token Battle parses ccusage monthly JSON on the server, normalizes it into ranking totals, and does not permanently store the original raw JSON.

• Stored fields are ranking-related aggregates such as total cost, token counts, model names, source slug, and period.
• Standard ccusage monthly exports do not include prompts, conversation contents, file contents, API keys, or authentication tokens.
• Do not paste non-ccusage logs, terminal output, or conversation exports.