SSD Nodes Learn Hosting plans →
Mwongozo Matt ConnorNa Matt Connor

Zana za kufuatilia matumizi ya Claude Code zikilinganishwa

Linganisha vichanganuzi vya logi, dashibodi ya Anthropic na OpenTelemetry ili kufuatilia gharama za Claude Code. Jifunze kwa nini data hizi hutofautiana katika hesabu.

Kile ambacho kifuatiliaji matumizi cha Claude Code kinasoma kwa hakika

Kila kifuatiliaji matumizi cha Claude Code kinasoma moja ya vyanzo vitatu vya data, na chanzo hicho huamua swali ambalo kinaweza kujibu. Kichanganuzi cha logi (log parser) kinasoma faili za nakala za kikao (session transcript) kwenye diski yako mwenyewe. Dashibodi inasoma rekodi za matumizi ambazo Anthropic inahifadhi kwa ajili ya akaunti yako au shirika lako. Mfumo wa nyuma wa metriki (metrics backend) unasoma mtiririko wa OpenTelemetry (OTel) ambao Claude Code hutoa unapoiwasha. Vyote vitatu vinaweza kuwa sahihi kwa wakati mmoja na bado visikubaliane, kwa sababu vinahesabu vitu tofauti.

Mwongozo huu hauelezi upya tokeni. jinsi Claude Code inavyohesabu matumizi ya tokeni inashughulikia uingizaji (input), utoaji (output), uandishi wa akiba (cache writes) na usomaji wa akiba (cache reads), na hakuna dashibodi inayokuwa na maana hadi sehemu hiyo iwe wazi. Swali hapa ni finyu zaidi: kwa kila umbo la zana, inaweza kuona nini, na haiwezi kuona nini kamwe.

Kwa nini vifuatiliaji matumizi vitatu vya Claude Code vilijitokeza kwa siku moja

Vifuatiliaji vitatu tofauti vya matumizi ya Claude Code vilichapishwa katika siku moja. Hizi hazikuwa matoleo matatu ya zana moja, na hapo ndipo sehemu yenye manufaa ilipo. Kimoja kilichanganua faili za session za ndani. Kingine kilifunika skrini za matumizi ya akaunti. Cha tatu kilikuwa backend ya kufuatilia (tracing) inayohifadhiwa na mtumiaji mwenyewe.

Vilijitokeza pamoja kwa sababu gharama ya session ya wakala (agent session) iliacha kuwa dhahiri. Chat inagharimu kiasi unachoweza kuona kwenye skrini. Wakala husoma faili ishirini, huendesha suite ya majaribio, na kutuma tena mazungumzo yote katika kila hatua, kwa hivyo bili huendeshwa na muktadha ambao hukuwahi kuuchapa. Katika usajili, kiasi cha dola cha session kinachoonyeshwa na Claude Code ni makadirio ambayo Anthropic inasema hayahusiani na utozaji, na namba inayozingatiwa ni upau wa matumizi (usage bar) ambao hujaa haraka zaidi katika siku nyingine kuliko nyingine. Kila moja ya maumbo hayo matatu hujaza sehemu tofauti ya pengo hilo.

Njia 1: kichanganuzi cha logi cha ndani kinakuambia gharama ya leo

Claude Code huhifadhi kila mazungumzo kama JSON Lines (JSONL) katika ~/.claude/projects/<project>/<session-id>.jsonl, ambapo <project> ni njia ya saraka yako ya kazi ikiwa na herufi zisizo za alphanumeric zilizobadilishwa na -. Kila zamu ya msaidizi katika faili hiyo hubeba idadi ya tokeni kwa ombi lake. Kichanganuzi cha logi huijumlisha na kuipangia bei.

ccusage ndiyo inayotumiwa na watu wengi zaidi. Haihitaji usakinishaji:

npx ccusage@latest daily
npx ccusage@latest daily --breakdown
npx ccusage@latest blocks
npx ccusage@latest session --json

daily hutoa jumla kwa tarehe. --breakdown hugawanya kila mstari kulingana na modeli, ambayo ndiyo njia unayotumia kugundua kuwa mchana mmoja wa Opus unachukua sehemu kubwa ya wiki. blocks hupanga kulingana na dirisha la saa tano ambalo usajili hurejeshwa. session hutoa jumla kwa kila mazungumzo, na daily --instances hupanga kulingana na mradi ili uweze kuona ni hazina (repository) ipi inayotumia gharama kubwa. Ongeza --since na --until ili kubainisha masafa, na uendeshe npx ccusage@latest daily --help kwa umbizo la tarehe ambalo toleo lako linatarajia. Kufikia Oktoba 2026 pia husoma CLI nyingine za wakala, ikiwemo Codex na OpenCode, jambo ambalo ni muhimu ikiwa unazilinganisha. Ripoti chaguo-msingi huchanganya vyanzo vyote vilivyotambuliwa; ongeza claude kabla ya daily au session ili kulenga Claude Code pekee.

Bei hutoka kwenye jedwali la bei ya modeli, na zana hii ina njia tatu za gharama. --mode auto hutumia thamani ya costUSD ambayo Claude Code iliandika kwenye faili inapokuwepo, na huhesabu kutoka kwa idadi ya tokeni wakati haipo. --mode calculate huhesabu kila wakati kutoka kwa tokeni na kupuuza gharama yoyote iliyorekodiwa. --mode display huonyesha gharama zilizorekodiwa pekee na kuchapisha $0.00 kwa mistari ambayo haina gharama yoyote. Ikiwa jumla inaonekana si sahihi, endesha ripoti hiyo hiyo chini ya calculate na kisha chini ya display. Pengo kubwa kati yao linamaanisha kuwa maingizo mengi hayana gharama iliyorekodiwa, kwa hivyo kila kitu unachosoma ni makadirio. Ikiwa unalipa viwango vya mkataba, pricingOverrides chini ya defaults katika faili ya usanidi ya ccusage.json hubadilisha bei kwa modeli binafsi.

Data hiyo hiyo inaweza kulisha prompt yako. ccusage statusline huchapisha mstari mfupi kwa ajili ya upau wa hali wa Claude Code, uliounganishwa kwenye ~/.claude/settings.json kama amri nyingine yoyote ya mstari wa hali. Tazama kujenga mstari wa hali wa Claude Code kwa ajili ya kizuizi cha mipangilio na nyanja zinazopokelewa.

Kile ambacho kichanganuzi cha logi hakiwezi kuona ni kitu chochote ambacho hakikutokea kwenye mashine hii. Kompyuta ya pili, kikao kwenye claude.ai, kazi ya mwenzako: nakala hizo za mazungumzo huishi kwenye diski hizo. Vikao vya zamani vya terminal husafishwa baada ya siku 30 za kutokuwa na shughuli kwa chaguo-msingi chini ya cleanupPeriodDays, lakini uhifadhi unaweza kusanidiwa: tumia thamani kubwa kama 3650 ili kuhifadhi historia ya miaka mingi. Nakala za vikao vilivyoanzishwa au vilivyoendelezwa hivi karibuni katika Desktop au Cowork huhifadhiwa zaidi ya kipindi hicho kwa chaguo-msingi, na isipokuwa kama usanidi wa HIPAA.

Kuna hatari nyingine moja, na ni ya kimuundo. Nyaraka za Anthropic zinasema kuwa umbizo la ingizo ni la ndani kwa Claude Code na hubadilika kati ya matoleo, kwa hivyo hati zinazochanganua faili hizi moja kwa moja zinaweza kuharibika kwenye toleo lolote. Hiyo inatumika kwa kila zana ya umbo hili. Pia ndiyo sababu jq ya mstari mmoja iliyotengenezwa kwa mikono juu ya JSONL ni wazo mbaya kuliko inavyoonekana: vichanganuzi vilivyodumishwa hufuatilia mabadiliko ya umbizo kwa ajili yako, na mstari wako mmoja utaripoti nambari isiyo sahihi kwa kujiamini siku uwanja utakapopewa jina jipya.

Hatimaye, takwimu ya dola inahitaji onyo kuhusu usajili. Matumizi ndani ya kikomo cha mpango wako wa Pro au Max hayatozwi kwa kila tokeni, kwa hivyo nambari hiyo ni kile ambacho tokeni zako zingekugharimu kwa viwango vya orodha ya API. Inapima jinsi matumizi yako yalivyo makubwa. Si bili yako. Isipokuwa ni mikopo ya matumizi: ukiwasha, matumizi yanayozidi kikomo cha mpango yanatozwa kwa viwango vya kawaida vya API kama malipo tofauti, na claude.ai huonyesha matumizi ya mwezi huo chini ya Settings > Usage. Ikiwa swali la kweli ni mpango upi wa kuwa nao, ulinganisho huo ni zoezi lake lenyewe: tazama bili ya API dhidi ya usajili wa Claude.

Sura ya 2: skrini za matumizi zilizojengewa ndani hukuonyesha ni modeli ipi iliyotumia bajeti

Claude Code inakuja na mfumo wake wa kutoa ripoti na watu wengi hawajawahi kuufungua. Tekeleza /usage ndani ya session. Sehemu ya Session iliyo juu inaonyesha token kwa kila modeli na kiasi cha dola kwa session ya sasa, iliyohesabiwa ndani ya kifaa kutoka kwa idadi ya token kwa viwango vya kawaida vya orodha, isipokuwa kama msimamizi ameweka jedwali la modelPricing katika mipangilio iliyodhibitiwa, ambapo mstari wa Total cost unasema at your organization's configured rates. Kwa vyovyote vile, kiasi hicho ni makadirio yanayoweza kutofautiana na ankara yako, na kwenye Pro au Max, Anthropic inasema si muhimu kwa malipo kwa sababu matumizi hayo yamejumuishwa kwenye mpango. Jumla hurejeshwa upya wakati /clear inapoanzisha mazungumzo mapya.

Kwenye mpango wa Pro, Max, Team au Enterprise inayotegemea idadi ya watumiaji, skrini hiyo hiyo inaonyesha kiasi gani cha kikomo cha mpango wako ulichotumia. Mpango wa Enterprise unaotegemea matumizi hauna posho iliyojumuishwa ya kuisha, kwa sababu kila token hulipiwa kwa viwango vya API. Kwenye mipango hii, skrini pia inahusisha matumizi ya hivi karibuni na skills, subagents, plugins na MCP servers binafsi kama asilimia ya jumla. Inaashiria tabia zinazochangia 10% au zaidi ya matumizi ya hivi karibuni, kama vile muktadha mrefu (long context) au kukosa cache (cache misses). Bonyeza d au w ili kubadilisha kati ya saa 24 zilizopita na siku 7 zilizopita. Takwimu hizi ni za makadirio na zimehesabiwa kutoka kwa historia ya session ya ndani kwenye mashine hii, kwa hivyo kifaa cha pili hakihesabiwi. Posho ikimalizika, Claude Code hutaja kikomo hicho na kuonyesha muda wake wa kurejeshwa; upau wa matumizi usio na kitu haimaanishi kuwa posho imeisha. Session inaweza kusubiri na kuendelea baada ya muda wa kurejeshwa, na nini cha kufanya baada ya kufikia kikomo ni uamuzi tofauti kuhusu modeli, muktadha na mpango.

Kwa timu ya zaidi ya msanidi mmoja, namba hizo huhamia kwenye akaunti. Shirika la API hupata ukurasa wa Console Cost, dashibodi ya Claude Code yenye matumizi na mistari iliyokubaliwa kwa kila mwanachama, na Claude Code Analytics API inayorejesha takwimu hizo hizo za kila siku kwa kila mtumiaji kwa kutumia ufunguo wa msimamizi (admin key). Mipango ya Teams na Enterprise hupata ripoti ya matumizi katika dashibodi ya msimamizi yenye uwezo wa kusafirisha data (CSV export), inayosasishwa kila siku; inashughulikia matumizi ya mkopo kwenye mipango ya watumiaji na matumizi kamili kwenye Enterprise inayotegemea matumizi. Enterprise huongeza API ya uchanganuzi. Ni ipi kati ya hizi unayoiona inategemea jinsi kila msanidi alivyojiunga, kwa hivyo shirika mseto husoma ripoti mbili na kuzijumlisha kwa mkono.

Kwa ajili ya kukadiria bajeti, takwimu iliyochapishwa katika nyaraka za gharama za Anthropic kufikia Oktoba 2026 ni wastani wa karibu $13 kwa kila msanidi kwa siku ya kazi na $150 hadi $250 kwa kila msanidi kwa mwezi, huku 90% ya watumiaji wakiwa chini ya $30 kwa siku ya kazi. Ichukulie hiyo kama kigezo kilichochapishwa kutoka kwa utekelezaji wa kibiashara, si kama utabiri kwa timu yako. Endesha kikundi cha majaribio na upime kabla ya kufanya makadirio ya jumla.

Dashibodi haziwezi kuona chochote chini ya kiwango cha siku na mtu binafsi. Zitakuambia kuwa Opus ilitumika zaidi siku ya Jumanne. Hazitakuambia ni prompt ipi, repository ipi au kazi ipi ya CI iliyofanya hivyo. Pia zina ucheleweshaji, kwa sababu ripoti za shirika husasishwa kila siku, kwa hivyo ni zana ya mapitio badala ya njia ya kukamata wakala anayefanya kazi bila udhibiti mchana huu. Kukamata wakala anayefanya kazi bila udhibiti kunahitaji vikomo, si ripoti, jambo ambalo ni mada ya kudhibiti gharama za wakala kwenye VPS.

Njia ya 3: stack yako ya OpenTelemetry inakuambia ni prompt ipi iliyoshuka ubora

Claude Code hutoa metrics na events za OpenTelemetry pindi tu unapowezesha telemetry na kusanidi exporters, na hii ndiyo chaguo pekee linalotiririsha data za token na gharama kwa kila mtumiaji kwenye mfumo unaouhibiti kwa muda halisi. Metrics hizo zinajumuisha claude_code.cost.usage katika USD, claude_code.token.usage katika tokens, claude_code.session.count na claude_code.active_time.total.

Metric ya token ndiyo inayovutia zaidi, kutokana na sifa zake. Kila data point hubeba type, ambayo ni input, output, cacheRead au cacheCreation, pamoja na model na query_source, ambayo ni main, subagent au auxiliary. Pia hubeba agent.name, skill.name, mcp_server.name na mcp_tool.name. Majina ya MCP servers ulizozisanidi mwenyewe na ya subagents zako binafsi hufika kama custom isipokuwa ukiweka OTEL_LOG_TOOL_DETAILS=1, ambayo pia huongeza Bash commands na tool input kwenye tool events. Hiyo inatosha kujibu maswali ambayo dashboard yoyote haiwezi kufikia: ni kiasi gani cha bili kinatokana na subagents badala ya hatua zako mwenyewe, kama MCP server moja iliongeza mara mbili input tokens zako, au kama cache reads zilipungua baada ya mtu kuhariri CLAUDE.md. Tabia ya cache ndipo mshangao unapojificha mara nyingi, na wakati prompt caching inapolipa gharama zake inaelezea kile unachokiangalia.

Marekebisho moja yanayostahili kufanywa, kwa sababu yanajitokeza katika kila mjadala kuhusu hili. Langfuse ni backend nzuri ya tracing inayoweza kujihostia, na kuiendesha kwenye VPS imeelezewa katika kujihostia Langfuse kwa ajili ya tracing ya agent. OTLP endpoint yake hukubali traces pekee. Kwa chaguo-msingi, Claude Code husafirisha metrics na log events, si spans, kwa hivyo kuelekeza OTEL_EXPORTER_OTLP_ENDPOINT kwenye Langfuse kutaacha mradi ukiwa mtupu na hakutakupa error yoyote inayosomeka. Span export ipo, lakini kama beta inayobaki imezimwa hadi utakapoweka CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1 na OTEL_TRACES_EXPORTER. Integration ya Claude Code ya Langfuse yenyewe hufuata njia tofauti: Stop hook, au plugin inayoiweka, husoma transcripts za session baada ya kila jibu na kuzibadilisha kuwa traces, kwa hivyo inashiriki mipaka ya log parser inayofanya kazi ndani ya mashine pekee. Langfuse ndiyo zana sahihi kwa ajili ya agents unazojijengea kwenye API mwenyewe, ambapo code yako mwenyewe hutengeneza kila span ikiwa na prompt, model na gharama yake. Kwa jumla ya matumizi kutoka kwa Claude Code CLI, metrics store ndiyo chaguo sahihi.

Sanidi ufuatiliaji wa matumizi ya Claude Code kwenye VPS yako

Huduma mbili zinatosha: mtoza data (collector) kwa ajili ya kupokea metriki, na Prometheus kwa ajili ya kuzihifadhi. Ziweke zote nje ya mtandao wa umma, kwa sababu port ya OTLP iliyo wazi inakubali uandishi kutoka kwa yeyote anayeipata. Andika /opt/ccmetrics/compose.yaml:

services:
  collector:
    image: otel/opentelemetry-collector-contrib:latest
    command: ["--config=/etc/otel/config.yaml"]
    volumes:
      - ./collector.yaml:/etc/otel/config.yaml:ro
    ports:
      - "10.8.0.1:4318:4318"
    restart: unless-stopped
  prometheus:
    image: prom/prometheus:latest
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml:ro
      - prom-data:/prometheus
    ports:
      - "127.0.0.1:9090:9090"
    restart: unless-stopped

volumes:
  prom-data:

10.8.0.1 ni anwani ya seva ndani ya handaki la WireGuard, kwa hivyo mtoza data anafikika kutoka kwenye mashine zako pekee na si mahali pengine popote. Anwani iliyo mbele ya port inafanya kazi ya msingi hapa, kwa sababu port za Docker zilizochapishwa hazichujwi na ufw: tazama kwa nini port za Docker zilizochapishwa hupita ufw. Kusanidi handaki lenyewe ni WireGuard VPN kwenye VPS yako.

/opt/ccmetrics/collector.yaml:

receivers:
  otlp:
    protocols:
      http:
        endpoint: 0.0.0.0:4318

processors:
  batch:

exporters:
  prometheus:
    endpoint: 0.0.0.0:8889

service:
  pipelines:
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [prometheus]

/opt/ccmetrics/prometheus.yml. Port 8889 haichapishwi kamwe kwenye host, kwa sababu Prometheus hufikia mtoza data kupitia mtandao wa Compose kwa kutumia jina la huduma:

global:
  scrape_interval: 30s

scrape_configs:
  - job_name: claude-code
    static_configs:
      - targets: ["collector:8889"]
cd /opt/ccmetrics
docker compose up -d
docker compose logs collector

Log ya mtoza data inapaswa kuishia na Everything is ready. Begin running and processing data.. Log inayosimama kwa sababu ya hitilafu ya usanidi inamaanisha kuwa YAML haikuchambuliwa, na kontena litaanza upya katika mzunguko.

Sasa elekeza Claude Code kwenye huduma hiyo. Kwenye kila mashine inayotumia Claude Code, ongeza hili kwenye ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "none",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://10.8.0.1:4318",
    "OTEL_METRIC_EXPORT_INTERVAL": "10000"
  }
}

Anzisha kikao, tuma ombi moja, subiri muda wa kusafirisha data (sekunde 10 hapa, sekunde 60 kwa chaguo-msingi), kisha uulize Prometheus kile kilichojifunza:

curl -s http://localhost:9090/api/v1/label/__name__/values | grep -o 'claude_code[a-z_]*'

Unapaswa kupata majina kadhaa yanayoanza na claude_code_. Exporter hubadilisha nukta kuwa mistari ya chini (underscores) na kuongeza kitengo, kwa hivyo nyuzi kamili hutegemea toleo lako la mtoza data. Matokeo matupu yanamaanisha hakuna data iliyofika. Hakikisha itifaki na port vinaendana, kwa sababu http/protobuf huenda kwenye 4318 na grpc huenda kwenye 4317, na kutolingana huku husababisha kushindwa kimya kimya. Endesha claude --debug-file /tmp/claude-debug.log na utafute kwenye faili hiyo mistari ya [3P telemetry], ambapo Claude Code huripoti hitilafu za usafirishaji wa OTel.

Kwa mashine moja na bila seva, ruka yote yaliyo hapo juu. Weka CLAUDE_CODE_ENABLE_TELEMETRY=1 na OTEL_METRICS_EXPORTER=prometheus na Claude Code itafungua sehemu ya kukusanya data (scrape endpoint) kwenye http://localhost:9464/metrics yenyewe. Wakati prometheus ndiyo exporter pekee iliyoorodheshwa, Claude Code huondoa vitengo vya USD, tokens na s kutoka kwenye metriki zilizosafirishwa ili ukusanyaji ubaki katika umbizo halali la Prometheus. Majina ya metriki hayabadiliki, na mpangilio unaochanganya exporters, kama vile otlp,prometheus, huhifadhi vitengo hivyo.

Uamuzi mmoja wa faragha huja na usanidi huu. Kwa chaguo-msingi, hesabu na metadata pekee ndizo zinazotoka kwenye mashine, hakuna maandishi ya ombi wala matokeo ya zana. OTEL_LOG_USER_PROMPTS=1 huongeza maandishi ya ombi kwenye matukio yaliyosafirishwa na pia huwezesha maandishi ya majibu ya msaidizi isipokuwa kama OTEL_LOG_ASSISTANT_RESPONSES=0 itayabatilisha. OTEL_LOG_TOOL_CONTENT=1 huongeza matokeo ya zana zilizochaguliwa kwenye trace spans, ikiwa na vizuizi na ufupishaji kwenye kikomo cha maudhui, kilicho 60 KB kwa chaguo-msingi. Bendera hizi zinaweza kufichua msimbo wa chanzo na siri katika maudhui wanayochagua; hazisafirishi kila kitu kilicho kwenye muktadha kiotomatiki. Miili kamili ya mazungumzo inahitaji mpangilio tofauti wa OTEL_LOG_RAW_API_BODIES. Washa hizo kwa makusudi, na usome kueka siri nje ya muktadha wa wakala kwanza.

Kufuatilia matumizi kwa ajili ya script na CI runs

Run zisizo za maingiliano (non-interactive) ndizo zinazowashangaza watu, kwa sababu hakuna anayekuwa akitazama skrini. claude -p pamoja na --output-format json huripoti gharama ya run hiyo katika payload ya matokeo yake:

claude -p "summarise the failing tests" --output-format json | jq '.total_cost_usd'

Payload hiyo hubeba total_cost_usd pamoja na uchanganuzi wa kila model, hivyo basi CI job inaweza kurekodi matumizi yake yenyewe bila kuhitaji dashboard. Kama kila takwimu ya ndani, huu ni makadirio ya upande wa mteja (client-side estimate), na run inayoendeleza mazungumzo na --continue au --resume huripoti jumla ya mazungumzo yote, ikiwemo run zilizotangulia. Ambatanisha thamani hiyo kwenye faili, au itume kama metric kwenye collector iliyo hapo juu. Hii ndiyo njia rahisi zaidi ya kufuatilia matumizi inayopatikana, na inagharimu wito mmoja wa jq kwa kila run.

Njia za hitilafu na utakachokiona

Ripoti haina kitu. npx ccusage@latest daily kutochapisha safu yoyote inamaanisha kuwa haisomi mahali ambapo Claude Code inaandika. CLAUDE_CONFIG_DIR hubadilisha eneo hilo, na ccusage pia husoma kigezo hicho, kwa hivyo endesha zote mbili kwa thamani sawa. Ikiwa vipindi vya awali havipo, angalia cleanupPeriodDays: vipindi vya terminal hufutwa baada ya siku 30 za kutotumika kwa chaguo-msingi, wakati nakala za Desktop na Cowork kwa kawaida huhifadhiwa zaidi ya kipindi hicho.

Mashine mbili zinaripoti jumla tofauti. Hii inatarajiwa, na si hitilafu. Uchanganuzi wa /usage na kichanganuzi chochote cha logi zote husoma historia ya kipindi cha ndani pekee, kwa hivyo matumizi kutoka kwa kifaa kingine au kutoka kwa claude.ai hayapo katika zote mbili.

Jumla ya ndani hailingani na ankara. Takwimu za ndani huhesabiwa kutoka kwa idadi ya tokeni kwa viwango vya kawaida vya orodha isipokuwa uweke viwango vya mkataba: jedwali la modelPricing katika mipangilio inayodhibitiwa kwa /usage, au pricingOverrides kwa ccusage. Katika usajili, matumizi yaliyo ndani ya kikomo cha mpango hayatozwi kwa kila tokeni hata kidogo, na ni mikopo ya matumizi pekee ndiyo inayotozwa. Ukurasa wa Gharama za Console ndio wenye mamlaka kwa utozaji wa API.

Gharama ilipanda wakati ulifanya kazi ile ile. Angalia safu wima za cache kabla ya kitu kingine chochote. Kipindi kirefu hutuma tena historia yake yote katika kila hatua, ikitozwa kwa kiwango cha cache wakati cache ikiwa moto na kwa kiwango kamili cha ingizo mara tu inapopoa, kwa hivyo mapumziko moja marefu huchakata tena mazungumzo yote. Hilo huonekana kama nambari kubwa ya ingizo kando ya nambari ndogo ya pato, na bei ya tokeni ya ingizo dhidi ya pato inaeleza kwa nini hizo mbili hubadilika kwa kujitegemea.

Siku yenye mawakala wadogo (subagents) inaonekana haiwezekani. Kila wakala mdogo huendesha dirisha lake la muktadha, kwa hivyo matumizi ya tokeni huongezeka kulingana na idadi yao na muda ambao kila mmoja alidumu. Katika mpango, sifa ya /usage hutoa sehemu ya wakala mdogo kwa mashine hii kama asilimia. Kwa maelezo ya kila ombi, data ya OTel huwatenganisha kupitia sifa ya query_source kwenye claude_code.token.usage. Kichanganuzi cha logi kitakuonyesha jumla na kukuacha ukikisia.

FAQ

Je, ccusage inaonyesha kiasi ninachotozwa kwenye Max plan?

Hapana. Matumizi yaliyo ndani ya kikomo cha mpango wa usajili hayatozwi kwa kila token, kwa hivyo kichanganuzi cha logi (log parser) hupiga bei ya token zako kwa viwango vya kawaida vya API na kuonyesha kiasi ambacho kazi hiyo ingegharimu kupitia API. Hii ni kipimo kizuri cha kulinganisha uzito wa kazi kwa siku, na ni muhimu kwa kulinganisha miradi au modeli mbalimbali. Kwa kiasi unachodaiwa, ukurasa wa Cost kwenye Console hushughulikia malipo ya API na ukurasa wa malipo ya mpango (plan billing) hushughulikia usajili. Ikiwa una mikopo ya matumizi (usage credits) iliyowashwa, matumizi yanayozidi kikomo hutozwa kwa viwango vya kawaida vya API, na claude.ai huonyesha matumizi hayo chini ya Settings > Usage.

Claude Code huhifadhi wapi faili za session ambazo zana hizi husoma?

Katika ~/.claude/projects/<project>/<session-id>.jsonl, ambapo <project> ni njia ya saraka ya kazi (working directory path) yenye herufi zisizo za kawaida zilizobadilishwa na -. Kila mstari ni kitu cha JSON kwa ujumbe mmoja, matumizi ya zana, au ingizo la metadata. CLAUDE_CONFIG_DIR huhamisha saraka nzima, na cleanupPeriodDays katika settings.json hudhibiti uhifadhi, ambao kwa kawaida ni siku 30 za kutotumika kwa session za terminal; nakala za Desktop na Cowork kwa kawaida huhifadhiwa zaidi ya kipindi hicho. Anthropic huainisha muundo wa ingizo kama wa ndani na unaoweza kubadilika kati ya matoleo, kwa hivyo lichanganue kwa zana inayodumishwa badala ya hati yako mwenyewe.

Je, ninaweza kutuma telemetry ya Claude Code kwenye Langfuse?

Huwezi kutumia telemetry ya kawaida. Endpoint ya Langfuse OTLP hukubali traces, na kwa chaguo-msingi Claude Code husafirisha metrics na matukio ya logi badala ya spans, kwa hivyo data haina mahali pa kutua. Usafirishaji wa span ni kipengele cha beta ambacho lazima ukiwashe, na ujumuishaji wa Claude Code wa Langfuse hutumia Stop hook inayobadilisha nakala za session kuwa traces badala yake. Kwa jumla ya matumizi, tuma metrics za Claude Code kwenye OpenTelemetry collector na uzihifadhi katika Prometheus. Tumia Langfuse kwa mawakala unaojijengea mwenyewe kwenye API, ambapo msimbo wako hutoa spans zinazobeba prompt, modeli, na gharama.

Kwa nini namba zangu za ndani hazilingani na ukurasa wa matumizi wa Console?

Kwa sababu huhesabiwa kwa njia tofauti. /usage na vichanganuzi vya logi hujumlisha idadi ya token kutoka kwa faili za session kwenye mashine uliyopo, kisha huzipiga bei kwa viwango vya kawaida vya orodha isipokuwa viwango vya mkataba vimepangwa, kupitia modelPricing katika mipangilio iliyosimamiwa ya /usage au pricingOverrides kwa ccusage. Console hushughulikia matumizi ya shirika lako katika mashine na funguo zote; tumia ukurasa wake wa Cost kwa gharama halisi za API, kwa kuwa takwimu za matumizi za dashibodi ya Claude Code ni makadirio tu. Kutolingana ni jambo la kawaida. Kutolingana kukubwa sana kwa kawaida humaanisha kifaa cha pili, CI runner, au mwanachama mwingine wa timu anatoza kwenye akaunti hiyo hiyo.

Ninawezaje kufuatilia gharama ya uendeshaji wa claude -p katika CI?

Iendeshe kwa --output-format json na usome total_cost_usd kutoka kwa matokeo, kwa mfano kwa kutumia claude -p "..." --output-format json | jq '.total_cost_usd'. Payload hiyo hiyo inajumuisha uchanganuzi kwa kila modeli na kitambulisho cha session (session ID). Rekodi thamani hiyo kwa kila kazi na utakuwa na gharama kwa kila pipeline bila kuhitaji wakala, dashibodi, au huduma ya ziada.

Je, makala hii ilikusaidia?