Fuatilia Matumizi na Gharama za Tokeni za AI ya Ndani kwa tokentab

tokentab hufanya nini

tokentab ni zana ya kuripoti ya ndani kwa ajili ya kuelewa jinsi wasaidizi wa uandishi wa msimbo hutumia tokeni na kukusanya gharama zinazokadiriwa. Husoma kumbukumbu za vipindi ambazo zana zinazotumika tayari huhifadhi kwenye kompyuta yako, kisha hupanga matumizi kulingana na modeli, mtoa huduma, mradi, siku, na aina ya shughuli iliyokadiriwa.

Hakuna akaunti wala ufunguo wa API unaohitajika. Uchakataji hubaki kwenye mashine yako, na tokentab haitumii taarifa za vipindi kupakia mtandaoni wala kuwasiliana na huduma za bei.

Zana zinazotumika na maeneo ya kumbukumbu

Kwa sasa tokentab ina vichanganuzi vinavyofanya kazi kwa zana tatu:

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

Nafasi ya mtoa huduma kwa Cursor ipo, lakini kichanganuzi chake bado hakijakamilika. Ikiwa mojawapo ya zana zinazotumika haijasakinishwa, tokentab huiruka tu. Kwa hiyo, ripoti zinajumuisha zana ambazo kumbukumbu zake zinapatikana kwenye mashine yako pekee.

Vipengele muhimu

• Husoma moja kwa moja idadi ya tokeni kutoka kwenye kumbukumbu za vipindi zilizopo ndani ya mashine.
• Hukadiria gharama kwa kutumia jedwali la bei la ndani linalotunzwa kwa mikono.
• Hupanga data kulingana na mtoa huduma, modeli, mradi, tarehe na shughuli.
• Hutumika kwa vipindi vya kila siku, kila mwezi, muda wote, na safu maalum za tarehe.
• Hutoa majedwali ya terminal au JSON inayosomeka na mashine.
• Hutoa dashibodi ya kivinjari inayofungamana na localhost pekee.
• Huondoa rangi za terminal kiotomatiki wakati matokeo yanaelekezwa kwenye bomba.
• Haitumii mfumo wa wavuti; dashibodi huendeshwa kwenye seva ya HTTP ya maktaba ya kawaida ya Python.

Utegemezi pekee wa wahusika wengine ni Rich, unaotengeneza majedwali ya terminal. Uchambuzi, uchakataji wa JSON na seva ya wavuti ya ndani hutumia maktaba ya kawaida ya Python.

Sakinisha tokentab

Usakinishaji wa kawaida

Fanya clone ya hazina, ingia kwenye saraka yake, kisha sakinisha kifurushi kwenye mazingira yako ya Python yanayotumika:

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

Usakinishaji huongeza amri ya tokentab kwenye njia yako. Baada ya hapo, unaweza kuendesha amri iliyosakinishwa moja kwa moja:

tokentab

Usakinishaji wa msimbo unaoweza kuhaririwa

Ikiwa unapanga kukagua au kurekebisha msimbo, sakinisha katika hali inayoweza kuhaririwa:

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

Usakinishaji unaoweza kuhaririwa huweka amri ikiwa imeunganishwa na nakala yako ya kazi, hivyo mabadiliko ya msimbo wa ndani huanza kutumika bila kusakinisha tena kifurushi.

Endesha ripoti yako ya kwanza

Kutoka kwenye saraka ya hazina, endesha CLI bila chaguo:

python cli.py

Ripoti chaguomsingi inahusisha siku saba zilizopita kwa kila mtoa huduma na mradi uliogunduliwa. Ikiwa ulisakinisha amri, mwito unaolingana ni:

tokentab

Kwa kuwa tokentab husoma saraka za kumbukumbu zilizopo za watoa huduma, hakuna usanidi wa akaunti wala kitambulisho unaohitajika. Ikiwa hakuna kumbukumbu zinazotumika zilizopo, hakuna matumizi yanayolingana ya kujumuishwa.

Chuja matumizi kwa muda

Shughuli za leo

python cli.py -today

Mwezi wa sasa wa kalenda

python cli.py -month

Historia yote inayopatikana

python cli.py -p all

Kipindi maalum cha tarehe

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

Vipindi maalum vinafaa unapotaka kulinganisha matumizi na sprint, kipindi cha malipo, jaribio au muda mwingine uliobainishwa.

Chuja kwa mtoa huduma au mradi

Ili kuonyesha matumizi ya Claude pekee, tumia kichujio cha mtoa huduma:

python cli.py --provider claude

Ili kulenga mradi mmoja, tumia jina la mradi:

python cli.py --project myapp

Vichujio hivi husaidia kutenganisha gharama ya codebase au zana fulani na shughuli zako zote.

Hamisha JSON inayosomeka na mashine

Tumia --json wakati programu nyingine inahitaji kutumia ripoti:

python cli.py --json

Kwa mfano, ikiwa jq imesakinishwa, peleka JSON ndani yake kwa ajili ya uumbizaji au uchakataji zaidi:

python cli.py --json | jq .

tokentab huondoa rangi za terminal kiotomatiki wakati matokeo yake ya kawaida yanaelekezwa kwenye bomba, jambo linalorahisisha kubandika ripoti kwenye maombi ya kuvuta, jumbe za mazungumzo, faili au amri nyingine bila misimbo ya kutoroka ya ANSI.

Tumia dashibodi ya wavuti ya ndani

Anzisha kiolesura cha kivinjari kwa:

python cli.py -web

tokentab hufungua http://localhost:4747 na kuwasilisha data kama taarifa ya kila mwezi, ikiwa na jumla juu na maelezo ya vipengele hapa chini.

Dashibodi husoma kumbukumbu kutoka kwenye diski kwa kila ombi badala ya kuhifadhi matokeo kwenye akiba, hivyo vipindi vilivyorekodiwa hivi karibuni vinaweza kuonekana bila kudumisha hifadhidata tofauti. Hufungamana na localhost pekee na haipakii data. Pia huepuka huduma za fonti za nje, hivyo kiolesura kinaweza kufanya kazi hata mtandao umekatika.

Ili kuchagua mlango mwingine, tumia --port. Ili kuanzisha seva bila kufungua kivinjari kiotomatiki, ongeza --no-open:

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

Elewa hesabu za tokeni na gharama

Idadi ya tokeni

Jumla za tokeni hutoka moja kwa moja kwenye kumbukumbu za zana zinazotumika badala ya kukadiriwa kutoka kwenye maandishi. tokentab pia huzingatia tofauti katika kuripoti akiba ya tokeni. Claude huandika usomaji na uandikaji wa akiba kando, huku Gemini ikiripoti ingizo linalojumuisha tokeni zilizohifadhiwa. tokentab huondoa sehemu iliyohifadhiwa inapohitajika ili kuepuka kutoza tokeni zilezile mara mbili.

Bei za modeli

Bei huhifadhiwa ndani ya kifaa katika tokentab/pricing/prices.py kama dola kwa tokeni milioni moja. Zana hutumia jedwali tuli kimakusudi badala ya kuomba bei za sasa kupitia mtandao.

Ulinganishaji wa modeli ni wa kubadilika, hivyo kitambulisho cha modeli chenye tarehe kama claude-opus-4-6-20260514 kinaweza kuendana na ingizo la jumla zaidi la claude-opus-4-6. Ikiwa modeli inaonekana ikiwa na gharama ya $0.00, huenda jina lake halikulingana na jedwali. CLI huripoti hali hii badala ya kudhani kimya kimya kuwa modeli hiyo ni ya bure.

Bei hutolewa kwa kadiri ya jitihada zinazowezekana. Sasisha jedwali la ndani wachuuzi wanapobadilisha bei au kuanzisha majina ya modeli ambayo bado hayajatambuliwa.

Makundi ya shughuli

Lebo za shughuli kama vile uandishi wa msimbo, utatuzi wa hitilafu, urekebishaji wa muundo, majaribio, mazungumzo, na uchunguzi hukisiwa kutokana na zana zilizotumika na maneno ya ujumbe wa kwanza katika kipindi. Uainishaji huu ni wa kiamua na hauiti modeli nyingine ya AI.

Chukulia lebo za shughuli kama vidokezo muhimu badala ya hukumu za mwisho. Lebo hizi husaidia kufichua mifumo ya jumla, lakini ni wewe pekee unayejua muktadha kamili wa kazi.

Tafsiri ripoti

• Viwango thabiti vya matumizi ya akiba vilivyo chini ya takriban 80%: Muktadha wako unaweza kuwa ukibadilika mara kwa mara, au akiba huenda haijawezeshwa. Kipindi kimoja kisicho cha kawaida kina maana ndogo kuliko muundo unaodumu kwa wiki kadhaa.
• Modeli ghali inayotawala miito mingi midogo: Ripoti inaweza kufichua kuwa modeli kubwa inashughulikia kazi ndogo za mara kwa mara. tokentab huonyesha muundo huu ili uweze kuchunguza kama matumizi hayo yamekusudiwa.
• Makundi makubwa ya mazungumzo au uchunguzi: Shughuli nyingi zilizorekodiwa zilihusisha majadiliano au kusoma badala ya kuhariri. Hili linaweza kuwa sahihi, lakini pia linaweza kuangazia vipindi vilivyotawanyika.

Mifumo hii ni sehemu za kuanzia uchunguzi, si hitimisho. Linganisha ripoti na ulichokuwa ukifanya hasa katika vipindi husika.

Dokezo la kina: ongeza mtoa huduma mwingine

Kila mtoa huduma hutekelezwa kama moduli chini ya tokentab/providers/. Mtoa huduma hutoa kazi ya collect() inayorejesha orodha tambarare ya vitu vya UsageRecord. Muundo wa rekodi ya pamoja umefafanuliwa katika tokentab/types.py.

1. Unda moduli ya mtoa huduma katika tokentab/providers/.
2. Soma na uchanganue faili za vipindi vya ndani za mtoa huduma.
3. Badilisha kila ingizo husika la matumizi liwe katika muundo wa pamoja wa UsageRecord.
4. Rejesha rekodi kutoka kwa collect().
5. Ongeza mtoa huduma katika tokentab/providers/__init__.py.

Rekodi zinapotumia muundo wa pamoja, bei, upangaji wa makundi, matokeo ya CLI, na dashibodi iliyopo zinaweza kuzichakata. README inapendekeza kutumia kichanganuzi cha Claude kama kiolezo rahisi zaidi na kushauriana na vichanganuzi vingine vinavyofanya kazi kwa mifano ya ziada.

Vidokezo vya matumizi ya vitendo

• Endesha ripoti chaguomsingi ya siku saba mara kwa mara ili kugundua mabadiliko ya hivi karibuni.
• Tumia mwonekano wa kila mwezi unapokagua mifumo mipana ya matumizi.
• Chuja kwa mradi kabla ya kuchunguza msingi mahususi wa msimbo.
• Hamisha JSON unapounda hati au ripoti maalum zinazotumia data ya tokentab.
• Angalia jedwali la bei kila modeli inaporipotiwa kwa $0.00.
• Tumia dashibodi kwa ukaguzi wa kuona na CLI kwa uwekaji otomatiki au kushiriki.

Hitimisho

tokentab hubadilisha kumbukumbu za ndani za Claude Code, Codex, na Gemini CLI kuwa ripoti za vitendo za tokeni na gharama bila kuhitaji vitambulisho au kutuma data nje ya kompyuta yako. Anza na mwonekano chaguomsingi wa siku saba wa CLI, finyaza matokeo kwa vichujio vya muda, mtoa huduma, na mradi, kisha utumie JSON au dashibodi ya localhost unapohitaji uwasilishaji tofauti. Mradi unapatikana chini ya leseni ya MIT.