รีวิว tokentab — ดู token และค่าใช้จ่าย Claude Code / Codex / Gemini CLI แบบ local-first

คืออะไร

tokentab เป็นเครื่องมือสรุปค่าใช้จ่ายแบบ local-first สำหรับผู้ใช้ AI coding tools ประจำตัวครับ ตัวโปรแกรมเขียนด้วย Python อ่าน log ที่ Claude Code, Codex, Gemini CLI (และมีช่อง Cursor เตรียมไว้แต่ยังไม่เสร็จ) เขียนทิ้งไว้บนเครื่องอยู่แล้ว มาสรุปเป็นตาราง token และค่าใช้จ่าย

แนวคิดคือ "local-first" ครับ ไม่มีบัญชี ไม่มี API key และไม่มีข้อมูลออกจากเครื่อง เพราะผู้พัฒนาระบุไว้ชัดว่า "Everything runs locally" เว็บ dashboard ก็ bind แค่ localhost เท่านั้น อีกทั้งยังไม่ดึง font จาก CDN ตอนใช้จึงถอดสายเน็ตแล้วก็ยังทำงานได้

จุดเด่น

• รองรับ Claude Code, Codex และ Gemini CLI ตั้งแต่แรก ถ้าตัวไหนไม่ได้ติดตั้งก็ข้ามไปเงียบ ๆ ไม่มีตัวที่คุณไม่ได้ใช้ผสมปนมาให้เห็น
• ตัวเลข token มาจาก log ของแต่ละเครื่องมือตรง ๆ ไม่มีการเดา และมีการหัก cached tokens ออกก่อนคิดราคา เพื่อไม่ให้จ่ายซ้ำสองรอบ
• ราคาคิดเป็นตารางคงที่อยู่ในไฟล์ tokentab/pricing/prices.py ไม่เคยต่อเน็ตไปหาราคา การจับคู่ชื่อโมเดลเป็นแบบ fuzzy เช่น claude-opus-4-6-20260514 ก็ยังแมตช์ได้ ถ้าขึ้น $0.00 แปลว่าชื่อโมเดลไม่ตรงกับอะไรในตาราง และ CLI จะบอกตรง ๆ ไม่เงียบ ๆ นับเป็นฟรี
• แยกยอดได้ทั้งตามโมเดล โปรเจกต์ วัน และประเภท activity (coding / debugging / refactor / testing) ผ่าน filter อย่าง -today, -month, -p all, --provider, --project และช่วงเวลาแบบ --from / --to
• มี --json ให้ pipe ไป jq หรือเครื่องมืออื่นได้ และ -web เปิด dashboard ที่ http://localhost:4747 ซึ่งอ่านข้อมูลจากดิสก์ทุกครั้งที่ร้องขอ ตั้งใจไม่ cache เพื่อไม่เสี่ยงโชว์ตัวเลขค้าง
• เซิร์ฟเวอร์เว็บใช้ standard library ของ Python ล้วน ไม่มี Flask หรือเฟรมเวิร์กให้ติดตั้งเพิ่ม dependency ข้างนอก มีแค่ rich สำหรับตารางในเทอร์มินัล
• สีจะหายไปเองเมื่อ pipe ไปที่อื่น ทำให้เอาไปวางใน PR หรือแชทได้โดยไม่เหลือ escape code รก
• เพิ่ม provider ใหม่ได้ง่าย เพราะแต่ละตัวคือโมดูลเดียวใน tokentab/providers/ ที่มีฟังก์ชัน collect() คืนค่าเป็น list ของ UsageRecord รูปแบบเดียวกัน ต่อท้ายด้วยการเพิ่มชื่อเข้า tokentab/providers/__init__.py ฝั่ง pricing, grouping และ dashboard จะทำงานต่อเองทั้งหมด

เหมาะกับใคร

• คนที่ใช้ Claude Code, Codex หรือ Gemini CLI ทุกวัน แล้วอยากรู้ว่าเดือนนี้ใช้ไปเท่าไร งานแบบไหนกินโควตาส่วนไหน
• คนที่เปิดใช้โมเดลแพงแล้วสงสัยว่าจำเป็นจริงหรือเปล่า README มีคำอธิบายไว้ว่า cache hit ต่ำกว่า ~80% เป็นประจำ แปลว่า context ระหว่าง call ไม่นิ่ง หรือยังไม่ได้เปิด caching
• คนที่ชอบอ่านตัวเลขเอง เพราะ README ยอมรับตรง ๆ ว่า "The tool shows you the data: you know what the work actually was" ให้ข้อมูลเป็นจุดเริ่มต้น ไม่ใช่คำตัดสิน
• ทีมที่ต้องการตัวเลขแบบรันเองในเครื่อง ไม่ส่ง session log ออกไปที่ไหน

เริ่มต้นใช้งาน

ติดตั้งแล้วรันตามนี้ได้เลยครับ

git clone https://github.com/yakuikai/tokentab
cd tokentab
pip install .
python cli.py

คำสั่งอื่นที่มีอยู่ใน README:

python cli.py -today                     # just today
python cli.py -month                     # this calendar month
python cli.py -p all                    # everything you've ever run
python cli.py --provider claude         # one tool only
python cli.py --project myapp           # one project
python cli.py --from 2026-06-01 --to 2026-06-15   # a specific window
python cli.py --json | jq .             # machine-readable, pipe it wherever
python cli.py -web                       # the same thing, in a browser, with charts

ถ้าอยากรันจาก source โดยไม่ติดตั้ง:

git clone https://github.com/yakuikai/tokentab
cd tokentab
pip install -e .
tokentab

ข้อควรรู้

• License: MIT ตามที่ระบุไว้ใน README ว่า "do what you like with it" ใช้เชิงพาณิชย์ได้ แต่ถ้าจะเอาไปต่อยอด แนะนำให้เปิดดูไฟล์ LICENSE จริงอีกรอบ
• ความสดใหม่: push ล่าสุดเมื่อ 9 ต.ค. 2026 ดาว 434 ดาว และ fork 119 ครั้ง เป็นข้อมูล ณ 11 ต.ค. 2026 ปัดเป็น 434 ดาว ขณะนี้ยังไม่ archived และ open issues เป็น 0
• อายุโปรเจกต์: สร้างเมื่อ 21 ก.ย. 2026 อายุไม่ถึงเดือน แปลว่ายังอยู่ในช่วงที่ API ของ Claude Code / Codex / Gemini CLI อาจเปลี่ยนได้เรื่อย ๆ
• ราคาประมาณการเป็น best-effort: README บอกว่าตารางราคาเก็บด้วยมือ ถ้าเจอราคาค้างให้เปิด PR หรือ issue บรรทัดเดียวก็โอเค ตัว tool เองก็ยอมรับว่า "a slightly-stale number beats a crash" ถ้าชื่อโมเดลไม่ตรงในตารางจะได้ $0.00 ต้องไปเติมเอง
• ค่า activity เป็นการเดา: อิงจากว่าใช้ tool อะไรบ้างและข้อความแรกของ session เป็น deterministic ไม่มีการเรียกโมเดล เร็วและตรวจสอบเองได้ แต่ให้ถือเป็นเบาะแสไม่ใช่คำตัดสิน
• Cursor ยังใช้ไม่ได้: เป็น stub ที่เตรียมไว้เท่านั้น ยังไม่ใช่ parser จริง ตอนนี้ที่ใช้ได้เต็มคือ 3 ตัวข้างบน
• ตัวเลขช่วงแรกดูแปลกได้: ค่าใช้จ่ายคำนวณจาก log ของแต่ละ tool ไม่ใช่ใบเสร็จจากผู้ให้บริการ ถ้าเทียบกับบิลจริงแล้วไม่ตรงให้จำเรื่องนี้ไว้ด้วย

ถ้าอยากเพิ่ม AI coding tool ที่ใช้เอง ลองเปิด tokentab/providers/ ดูครับ โครงสร้างมันออกแบบมาให้เติมได้จริง

🔗 https://github.com/yakuikai/tokentab

ข้อมูลจาก GitHub ณ 11 ต.ค. 2026: ⭐ 434 | ภาษา Python | license MIT