Tokscale: Theo Dõi Token AI Từ Terminal

Tokscale Là Gì?

Tokscale là một công cụ dòng lệnh (CLI) và giao diện terminal (TUI), viết bằng Rust, đọc dữ liệu session cục bộ từ các AI coding agent như Claude Code, Codex CLI, OpenCode, và Cursor IDE để báo cáo số token bạn đã dùng và chi phí tương ứng. Nó gộp mọi thứ vào một bảng thống kê kiểu contribution-graph duy nhất, thay vì bắt bạn mở riêng màn hình usage của từng agent.

Tính Năng Cốt Lõi Để Quản Lý Token AI

• ✓Đọc dữ liệu session cục bộ từ hơn 20 CLI và IDE coding agent — Claude Code, Codex CLI, OpenCode, Cursor IDE, Gemini CLI, Amp, Droid, Cline, Goose, Devin CLI, và nhiều hơn nữa — theo bảng client trong README, thay vì yêu cầu tích hợp API riêng với từng công cụ.
• ✓TUI tương tác xây trên Ratatui với các view Overview, Models, Daily, Hourly, Stats, và Agents, cộng thêm view Minutely tùy chọn, điều hướng bằng bàn phím và chuột, và 12 theme màu để chọn.
• ✓Tính giá theo thời gian thực, lấy từ dữ liệu pricing của LiteLLM với cache trên đĩa 1 giờ, tự động fallback sang OpenRouter, và có bảng giá riêng cho các model Cursor mới ra mắt.
• ✓Phần lõi Rust gốc xử lý việc parse và tổng hợp dữ liệu, theo README giúp xử lý nhanh hơn khoảng 10 lần nhờ quét file song song và parse JSON kiểu SIMD.
• ✓Sáu chiến lược group-by — model, client+model, client+provider+model, workspace+model, session+model, và client+session+model — bao gồm trường `sessionId` để gắn chi phí về đúng một session agent-CLI.
• ✓Biểu đồ contribution kiểu GitHub, hiển thị trực quan trên web ở cả 2D và 3D, xuất được qua lệnh `tokscale graph --output data.json`.
• ✓Báo cáo gắn theo task: tóm tắt session và gom nhóm task bằng LLM, hỗ trợ nhiều backend gồm Apple FM, Claude, Codex, Gemini, hoặc Kiro.
• ✓Bảng xếp hạng xã hội — chạy `bunx tokscale@latest submit` sẽ gửi dữ liệu usage của bạn lên và tạo một public profile để so sánh với người khác.

Bắt Đầu Với Tokscale

Tokscale được phân phối qua gói npm tên `tokscale`, một gói alias (README so sánh với cách gói `swc` hoạt động) cài đặt `@tokscale/cli`, bao gồm cả phần lõi Rust gốc đã biên dịch sẵn `@tokscale/core`. Chạy `npx tokscale@latest`, `bunx tokscale@latest`, hoặc `deno x npm:tokscale@latest` là có ngay TUI tương tác đầy đủ — không cần bước cài đặt riêng. Thêm `--light` để chỉ in bảng thay vì mở TUI. Bạn cần cài Node.js hoặc Bun; Rust toolchain chỉ cần khi muốn build native module từ source. Để build từ source: clone repo, cài Bun, chạy `bun install`, rồi `bun run build:core` để biên dịch native module (bắt buộc để CLI hoạt động — nó đảm nhận việc parse và tổng hợp file) và `bun run cli` để chạy cục bộ. README nói bản build sẵn đã đi kèm gói đã publish, nên đường build-từ-source này chỉ cần cho phát triển cục bộ.

Sử Dụng TUI Và CLI Của Tokscale

Lệnh `tokscale` mặc định mở TUI; `tokscale models`, `tokscale monthly`, và `tokscale hourly` mở thẳng từng tab, còn `tokscale tui` mở TUI một cách tường minh. `tokscale --light` in ra bảng kiểu cũ thay vì TUI. Trong TUI, phím mũi tên hoặc Tab chuyển view, `g` mở dialog chọn group-by (model, client+model, client+provider+model, workspace+model, session+model, hoặc client+session+model), `s` mở dialog chọn nguồn/client, `p` xoay qua 12 theme màu, `y` copy dòng đang chọn, và `e` xuất ra JSON. Giới hạn báo cáo theo agent bằng `--client`/`-c` (cách nhau bằng dấu phẩy hoặc lặp lại flag, ví dụ `--client opencode,claude`), và theo khoảng ngày bằng `--today`, `--week`, `--month`, `--since`/`--until`, hoặc `--year`. `tokscale graph --output data.json` và `tokscale models --json` đẩy dữ liệu ra cho công cụ khác dùng. Một điều cần lưu ý: bản 4.0.0 đã bỏ các flag boolean theo từng client kiểu cũ (`--opencode`, `--claude`, v.v.); giờ dùng chúng sẽ báo lỗi, nên `--client` là cách duy nhất được hỗ trợ để lọc theo agent.

Các Công Cụ Theo Dõi Token AI Khác

Câu Hỏi Thường Gặp Về Tokscale

Vấn đề Tokscale giải quyết

Nhà phát triển dùng song song nhiều AI coding agent (chẳng hạn Claude Code cho vài dự án, Codex CLI hay Cursor cho các dự án khác) không có một nơi duy nhất để xem tổng mức sử dụng token — mỗi agent tự theo dõi và báo cáo usage theo định dạng và vị trí riêng, rải rác qua hàng chục đường dẫn khác nhau (`~/.claude/projects/`, `~/.codex/sessions/`, cache API riêng của Cursor, v.v.). README của Tokscale giải quyết trực tiếp vấn đề này bằng cách tự viết bộ đọc cho định dạng lưu session của từng agent, thay vì bắt nhà phát triển tự đối chiếu số liệu thủ công qua từng công cụ.

Trường hợp sử dụng tốt nhất

• •Một nhà phát triển dùng song song nhiều AI coding agent (ví dụ Claude Code lẫn Codex CLI và Cursor) muốn có một nơi duy nhất xem tổng chi phí token thay vì kiểm tra riêng từng màn hình usage của từng công cụ.
• •Gắn chi phí LLM theo từng session trong một multi-agent runner hoặc IDE, dùng `--group-by session,model` hoặc `client,session,model` để nối dữ liệu chi phí về đúng một `session_id`.
• •Xuất dữ liệu usage ra JSON (`tokscale --json`, `tokscale graph --output data.json`) để đưa vào dashboard nội bộ hoặc file spreadsheet.
• •Lọc chi phí theo khoảng ngày hoặc theo client để dựng báo cáo token/chi phí theo tháng hoặc theo dự án (`--since`/`--until`, `--client`, `--week`/`--month`).
• •Tham gia bảng xếp hạng toàn cầu của Tokscale bằng cách gửi dữ liệu usage và có một public profile qua lệnh `bunx tokscale@latest submit`.

Ai nên dùng — và ai nên bỏ qua

Hãy thử Tokscale nếu bạn thường xuyên chuyển qua lại giữa nhiều AI coding agent — hôm nay Claude Code, mai Codex CLI hay Cursor — và muốn có một dashboard terminal duy nhất cho tổng chi phí token thay vì ghép lại từ nhiều màn hình usage riêng lẻ. Nó cũng hợp nếu bạn thích làm việc trong TUI và muốn tách chi phí theo từng session cho một workflow nhiều agent. Bỏ qua nếu bạn chỉ dùng đúng một coding agent đã hiển thị usage rõ ràng sẵn, hoặc nếu bạn không thoải mái khi để một công cụ đọc file session cục bộ qua `~/.claude`, `~/.codex`, `~/.cursor`, và hàng chục đường dẫn tương tự để dựng báo cáo.

Repo liên quan