tokentab yordamida mahalliy AI tokenlari sarfi va xarajatlarini kuzating

tokentab nima qiladi

tokentab kodlash yordamchilari tokenlardan qanday foydalanishi va taxminiy xarajatlarni qanday to‘plashi haqida tushuncha beruvchi mahalliy hisobot vositasidir. U qo‘llab-quvvatlanadigan vositalar kompyuteringizda allaqachon saqlaydigan sessiya jurnallarini o‘qiydi, so‘ng foydalanishni model, provayder, loyiha, kun va faoliyatning taxminiy turi bo‘yicha guruhlaydi.

Hisob yoki API kaliti talab qilinmaydi. Qayta ishlash kompyuteringizda amalga oshiriladi, tokentab sessiya ma’lumotlarini yuklamaydi va narxlash xizmatlariga ulanmaydi.

Qo‘llab-quvvatlanadigan vositalar va jurnal joylashuvlari

Hozirda tokentab uchta vosita uchun ishlaydigan parserlarni o‘z ichiga oladi:

• Claude Code: ~/.claude/projects/**/*.jsonl
• Codex: ~/.codex/sessions/**/rollout-*.jsonl
• Gemini CLI: ~/.gemini/tmp/**/session-*.json

Cursor uchun provayder joyi mavjud, ammo uning parseri hali tugallanmagan. Qo‘llab-quvvatlanadigan vositalardan biri o‘rnatilmagan bo‘lsa, tokentab uni shunchaki o‘tkazib yuboradi. Shu sababli hisobotlarga faqat kompyuteringizda jurnallari mavjud bo‘lgan vositalar kiritiladi.

Asosiy imkoniyatlar

• Tokenlar sonini mavjud mahalliy sessiya jurnallaridan bevosita o‘qiydi.
• Xarajatlarni mahalliy, qo‘lda yuritiladigan narxlar jadvali asosida hisoblaydi.
• Ma’lumotlarni provayder, model, loyiha, sana va faoliyat bo‘yicha guruhlaydi.
• Kundalik, oylik, barcha davrlar va maxsus sana oraliqlarini qo‘llab-quvvatlaydi.
• Terminal jadvallari yoki mashina o‘qiy oladigan JSON yaratadi.
• Faqat localhost manziliga ulanadigan brauzer boshqaruv panelini taqdim etadi.
• Chiqish boshqa buyruqqa yo‘naltirilganda terminal ranglarini avtomatik olib tashlaydi.
• Veb-freymvorkdan foydalanmaydi; boshqaruv paneli Python standart kutubxonasidagi HTTP serverida ishlaydi.

Uchinchi tomonning yagona bog‘liqligi terminal jadvallarini ko‘rsatuvchi Rich kutubxonasidir. Tahlil qilish, JSON bilan ishlash va mahalliy veb-server Python standart kutubxonasidan foydalanadi.

tokentab’ni o‘rnatish

Standart o‘rnatish

Reponi klonlang, uning katalogiga kiring va paketni faol Python muhitiga o‘rnating:

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

O‘rnatish tokentab buyrug‘ini yo‘lingizga qo‘shadi. Shundan so‘ng o‘rnatilgan buyruqni bevosita ishga tushirishingiz mumkin:

tokentab

Tahrirlanadigan manba o‘rnatilishi

Kodni ko‘rib chiqish yoki o‘zgartirishni rejalashtirsangiz, uni tahrirlanadigan rejimda o‘rnating:

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

Tahrirlanadigan o‘rnatish buyruqni ishchi nusxangiz bilan bog‘lab turadi, shuning uchun mahalliy koddagi o‘zgarishlar paketni qayta o‘rnatmasdan kuchga kiradi.

Birinchi hisobotingizni ishga tushirish

Repo katalogidan CLI’ni opsiyalarsiz ishga tushiring:

python cli.py

Standart hisobot aniqlangan barcha provayderlar va loyihalar bo‘yicha oxirgi yetti kunni qamrab oladi. Buyruqni o‘rnatgan bo‘lsangiz, unga teng chaqiruv quyidagicha:

tokentab

tokentab provayderlarning mavjud jurnal kataloglarini o‘qigani sababli hisob sozlamalari yoki ma’lumotlarni konfiguratsiya qilish talab etilmaydi. Qo‘llab-quvvatlanadigan jurnallar mavjud bo‘lmasa, kiritiladigan tegishli foydalanish ma’lumotlari ham bo‘lmaydi.

Foydalanishni vaqt bo‘yicha filtrlash

Bugungi faoliyat

python cli.py -today

Joriy kalendar oyi

python cli.py -month

Mavjud barcha tarix

python cli.py -p all

Muayyan sana oralig‘i

python cli.py --from 2026-06-01 --to 2026-06-15

Maxsus oraliqlar foydalanishni sprint, hisob-kitob davri, tajriba yoki boshqa belgilangan vaqt oralig‘i bilan moslashtirishda foydalidir.

Provayder yoki loyiha bo‘yicha filtrlash

Faqat Claude foydalanishini ko‘rsatish uchun provayder filtridan foydalaning:

python cli.py --provider claude

Bitta loyihaga e’tibor qaratish uchun uning nomidan foydalaning:

python cli.py --project myapp

Bu filtrlar muayyan kod bazasi yoki vosita xarajatlarini umumiy faoliyatingizdan ajratishga yordam beradi.

Mashina o‘qiy oladigan JSON’ni eksport qilish

Boshqa dastur hisobotni qayta ishlashi kerak bo‘lsa, --json opsiyasidan foydalaning:

python cli.py --json

Masalan, jq o‘rnatilgan bo‘lsa, formatlash yoki keyingi qayta ishlash uchun JSON’ni unga uzating:

python cli.py --json | jq .

tokentab odatiy chiqishi boshqa buyruqqa yo‘naltirilganda terminal ranglarini avtomatik olib tashlaydi. Bu ANSI escape kodlarisiz hisobotlarni pull-requestlar, chat xabarlari, fayllar yoki boshqa buyruqlarga joylashtirishni osonlashtiradi.

Mahalliy veb boshqaruv panelidan foydalanish

Brauzer interfeysini quyidagi buyruq bilan ishga tushiring:

python cli.py -web

tokentab http://localhost:4747 manzilini ochadi va ma’lumotlarni oylik hisob-kitob ko‘rinishida taqdim etadi: yuqorida jami summa, pastda esa batafsil bandlar ko‘rsatiladi.

Boshqaruv paneli natijalarni keshlash o‘rniga har bir so‘rovda jurnallarni diskdan o‘qiydi. Shu sababli yangi qayd etilgan sessiyalar alohida ma’lumotlar bazasini yuritmasdan ham ko‘rinishi mumkin. U faqat localhost manziliga ulanadi va ma’lumotlarni yuklamaydi. Shuningdek, tashqi shrift xizmatlaridan foydalanmaydi, shu bois interfeys tarmoq uzilganida ham ishlaydi.

Boshqa portni tanlash uchun --port opsiyasidan foydalaning. Brauzerni avtomatik ochmasdan serverni ishga tushirish uchun --no-open opsiyasini qo‘shing:

python cli.py -web --port 8080 --no-open

Token va xarajat hisob-kitoblarini tushunish

Tokenlar soni

Tokenlarning umumiy soni matn asosida taxmin qilinmaydi, balki qo‘llab-quvvatlanadigan vositalar jurnallaridan to‘g‘ridan-to‘g‘ri olinadi. tokentab kesh hisobotlaridagi farqlarni ham hisobga oladi. Claude kesh o‘qishlari va yozuvlarini alohida qayd etadi, Gemini esa keshdagi tokenlarni ham o‘z ichiga olgan kiritmalarni xabar qiladi. Bir xil tokenlar uchun ikki marta haq hisoblanmasligi uchun tokentab zarur hollarda kesh qismini olib tashlaydi.

Modellar narxlari

Narxlar tokentab/pricing/prices.py faylida million token uchun dollar ko‘rinishida mahalliy saqlanadi. Vosita tarmoq orqali joriy narxlarni so‘rash o‘rniga ataylab statik jadvaldan foydalanadi.

Modellarni moslashtirish taxminiy amalga oshiriladi, shuning uchun claude-opus-4-6-20260514 kabi sana qo‘shilgan model identifikatori umumiyroq claude-opus-4-6 yozuviga mos kelishi mumkin. Agar model $0.00 qiymatida ko‘rinsa, ehtimol uning nomi jadvaldagi nomga mos kelmagan. CLI bu holat haqida xabar beradi va modelni jimgina bepul deb hisoblamaydi.

Narxlar imkon qadar aniq taqdim etiladi. Yetkazib beruvchilar narxlarni o‘zgartirganda yoki hali tanilmaydigan yangi model nomlarini joriy qilganda mahalliy jadvalni yangilang.

Faoliyat toifalari

Kod yozish, xatolarni tuzatish, qayta ishlash, testlash, suhbatlashish va izlanish kabi faoliyat yorliqlari foydalanilgan vositalar hamda sessiyadagi birinchi xabar mazmuni asosida aniqlanadi. Bu tasnif deterministik bo‘lib, boshqa AI modeliga murojaat qilmaydi.

Faoliyat yorliqlarini qat’iy xulosalar emas, foydali ko‘rsatmalar sifatida qabul qiling. Yorliqlar umumiy tendensiyalarni ko‘rsatishga yordam beradi, ammo ishning to‘liq mazmunini faqat siz bilasiz.

Hisobotni talqin qilish

• Taxminan 80% dan past bo‘lgan barqaror keshdan foydalanish ko‘rsatkichlari: Kontekstingiz tez-tez o‘zgarayotgan yoki keshlash yoqilmagan bo‘lishi mumkin. Bir necha hafta davom etgan tendensiyaga qaraganda, bitta noodatiy sessiya kamroq ahamiyatga ega.
• Ko‘plab kichik chaqiruvlarda qimmat modelning ustunligi: Hisobot katta model tez-tez, ammo cheklangan vazifalarni bajarayotganini ko‘rsatishi mumkin. tokentab bu holatni namoyish etadi, shunda bunday foydalanish ataylab qilingan-qilinmaganini tekshirishingiz mumkin.
• Ko‘p chat yoki izlanish toifalari: Qayd etilgan faoliyatning katta qismi tahrirlashdan ko‘ra muhokama qilish yoki o‘qish bilan bog‘liq bo‘lgan. Bu o‘rinli bo‘lishi mumkin, ammo uzoqlashib ketgan sessiyalarni ham ko‘rsatishi ehtimol.

Bu tendensiyalar tekshiruvni boshlash uchun asos, yakuniy xulosa emas. Hisobotni tegishli sessiyalarda aslida nima qilganingiz bilan solishtiring.

Ilg‘or maslahat: boshqa provayder qo‘shish

Har bir provayder tokentab/providers/ ostidagi modul sifatida amalga oshirilgan. Provayder tekis UsageRecord obyektlari ro‘yxatini qaytaradigan collect() funksiyasini taqdim etadi. Umumiy yozuv tuzilmasi tokentab/types.py faylida belgilangan.

1. tokentab/providers/ ichida provayder modulini yarating.
2. Provayderning mahalliy sessiya fayllarini o‘qing va tahlil qiling.
3. Tegishli har bir foydalanish yozuvini umumiy UsageRecord shakliga o‘tkazing.
4. Yozuvlarni collect() funksiyasidan qaytaring.
5. Provayderni tokentab/providers/__init__.py fayliga qo‘shing.

Yozuvlar umumiy shakldan foydalangach, mavjud narxlash, guruhlash, CLI chiqishi va boshqaruv paneli ularni qayta ishlay oladi. README eng sodda andoza sifatida Claude parseridan foydalanishni, qo‘shimcha misollar uchun esa ishlayotgan boshqa parserlarni ko‘rib chiqishni tavsiya qiladi.

Amaliy foydalanish maslahatlari

• Yaqindagi o‘zgarishlarni aniqlash uchun standart yetti kunlik hisobotni muntazam ishga tushiring.
• Kengroq xarajatlar tendensiyalarini ko‘rib chiqishda oylik ko‘rinishdan foydalaning.
• Muayyan kod bazasini tekshirishdan oldin loyiha bo‘yicha filtrlang.
• tokentab ma’lumotlari asosida skriptlar yoki maxsus hisobotlar yaratishda JSON formatiga eksport qiling.
• Model $0.00 qiymatida ko‘rsatilganda narxlar jadvalini tekshiring.
• Vizual ko‘rib chiqish uchun boshqaruv panelidan, avtomatlashtirish yoki ulashish uchun esa CLI’dan foydalaning.

Xulosa

tokentab mahalliy Claude Code, Codex va Gemini CLI jurnallarini hisob ma’lumotlarini talab qilmaydigan yoki ma’lumotlarni kompyuteringizdan tashqariga yubormaydigan amaliy token va xarajat hisobotlariga aylantiradi. Standart yetti kunlik CLI ko‘rinishidan boshlang, natijalarni vaqt, provayder va loyiha filtrlari bilan toraytiring, so‘ng boshqa ko‘rinish kerak bo‘lganda JSON yoki localhost boshqaruv panelidan foydalaning. Loyiha MIT litsenziyasi asosida taqdim etilgan.