Mga usage limit

Ipinapakita ng ccam usage kung gaano kalaki na ang nagamit ng bawat account sa 5-oras at lingguhang limit, kasama ang oras bago mag-reset ang bawat window. Gamitin ito bago ka magsimula ng mahabang gawain, o kapag sinabi ng Claude Code na malapit na ang isang limit, para makita kung aling account ang may natitira pa. Ang ccam statusline ay ang status line command para sa Claude Code: ipinapakita nito ang pangalan ng account at usage sa loob ng Claude Code at sine-save ang mga numero para sa ccam usage.

Paggamit

ccam usage                  # every account, once
ccam u                      # the same, shorter
ccam usage --watch          # redraw every 60 seconds until Ctrl+C
ccam usage --watch=10       # redraw every 10 seconds
ccam usage -v               # add per-model weekly limits and the data source
ccam usage --json           # machine-readable, one object per account
ccam usage --source cache   # saved numbers only, no network
ccam usage --refresh        # also renew expired logins of accounts not running
ccam statusline install     # set the status line in every account's settings.json

$ ccam usage
 Account     5-hour        Resets    Weekly        Resets    As of
 1 personal  ░░░░░░░░   0% -         ██████░░  70% 2d 16h    9h 36m ago (cached)
 2 work      ██░░░░░░  24% 2h 29m    ███░░░░░  41% 3d 11h    just now (cached)
 3 side      login expired, run `ccam side` once to refresh
→ Most headroom: personal   (open it with ccam next --auto)

Sa terminal, lumalabas agad ang table na may fetching… sa bawat hilera, at iginuguhit ulit ang bawat hilera habang sumasagot ang account nito. Sinasabi ng As of kung gaano na katagal ang mga numero; ang ibig sabihin ng (cached) ay galing ang mga ito sa naka-save na file, hindi sa endpoint. Pinapangalanan ng huling linya ang account na may pinakamababang 5-oras na usage na mas mababa sa 100%, at lumalabas lang ito kapag mahigit sa isa ang account mo. Nagpapakita ng not logged in → ccam login <name> ang account na hindi naka-log in, at ng no limits (API) ang account na API key ang gamit.

Pagkatapos ng ccam statusline install, magpapakita ang Claude Code ng linya gaya ng [work] · Opus · 5h 24% · 7d 41%.

Mga option

Pumapalya ang anumang ibang value ng --source na may --source must be live or cache. Walang tinatanggap na argument ang ccam usage.

Binabasa ng ccam statusline ang status line JSON ng Claude Code mula sa standard input. Iisa ang option nito, ang --wrap <command>: isang umiiral na status line command na ang unang linya ng output ay lalagyan ng pangalan ng account sa unahan. Walang option ang ccam statusline install. Parehong tinatanggihan ng dalawa ang --dry-run na may --dry-run is not supported by `ccam statusline`; nothing was changed.

Paano ito gumagana

Galing sa dalawang lugar ang mga numero: ang hindi dokumentadong usage endpoint ng Anthropic, GET https://api.anthropic.com/api/oauth/usage, na tinatawag gamit ang sariling login ng bawat account, at ang mga value na ibinibigay ng Claude Code sa status line command nito. Nasa internal/usage ang lahat ng ito.

1. Nilo-load ng cli.usageCmd ang config.toml at bumubuo ng isang usage.Account bawat account: ang folder nito na ~/.local/share/ccam/profiles/<name>/, ang session folder nito (para makita kung tumatakbo ito) at kung in-import ito sa kinalalagyan nito.
2. Nagsisimula ang Fetcher.FetchAll ng isang goroutine bawat account. Iisang http.Client ang gamit nilang lahat, kaya muling ginagamit ang mga koneksyon sa endpoint. Puwedeng umabot nang 2 s ang pagkonekta, at may kabuuang 3 s ang bawat account. Hindi sumusunod sa mga redirect ang client, dahil ipapadala ulit ng redirect ang token sa ibang lugar, at hanggang 1 MB lang ng sagot ang binabasa nito.
3. Habang natatapos ang bawat account, iginuguhit ulit ang hilera nito. Ang account na pumapalya o hindi sumasagot sa oras ay bumabalik sa mga naka-save na numero, kaya hindi kailanman napapabagal ng isang mabagal na account ang iba.

Tumatakbo ang bawat account sa sarili nitong goroutine laban sa endpoint; ang nag-time out ay nagpapakita ng mga naka-save na numero nito sa halip.

Sumasagot sa oras ang personal at work at nagpapakita ng mga live na numero. Lumalampas sa 3 s ang side, kaya binabasa ng fallback() ang dalawang cache file nito at ginagamit ang pinakahuling naisulat. Iginuguhit ng usage.Table() ang mga hilera at pinipili ng usage.Best() ang account na pinapangalanan sa huling linya.

Para sa isang account, ginagawa ng Fetcher.Fetch ang mga pagsusuring ito nang sunod-sunod:

1. Sa --source cache, direkta itong pumupunta sa fallback().
2. Maliban kung nakatakda ang --no-cache, ibinabalik nang walang pagbabago ang live na resulta sa ~/.local/state/ccam/usage/<name>.json na wala pang 60 segundo (CacheTTL). Isang request bawat account lang ang gastos kapag dalawang beses na sunod na pinatakbo ang ccam usage.
3. Binabasa ng readCredentials() ang .credentials.json (o ang macOS Keychain) nang hindi ito binabago, at ang key na claudeAiOauth lang ang dine-decode. Kapag walang subscription login, not logged in ang resulta, o no limits (API) kapag may API key ang .claude.json.
4. Hindi ginagamit ang expired na access token. Kapag walang --refresh, ipinapakita ng account ang mga naka-save na numero nito na may markang expired.
5. Kung hindi, tinatawag ng ccam ang endpoint. Itinuturing na expired na login ang 401 o 403, itinuturing na error ang anumang ibang status o body na hindi nito mabasa, at parehong bumabalik ang mga ito sa mga naka-save na numero.
6. Isinusulat ang maayos na sagot sa <name>.json kasama ang oras ng pagsukat.

Binabasa ng fallback() ang parehong <name>.json at <name>.statusline.json at pinapanatili ang mas bago. Bago nito ipakita ang mga naka-save na numero, sinusuri nito ang oras ng reset ng bawat window: nagpapakita ng 0% ang window na nag-reset na mula nang i-save ang mga numero, dahil hindi na totoo ang lumang porsiyento. Kaya ang personal sa itaas ay nagpapakita ng 0% na walang oras ng reset.

May dalawang format ng response ang endpoint. May array na limits ang mas bago na may mga entry na session (5-oras), weekly_all at weekly_scoped (bawat model). May mga object na five_hour, seven_day, seven_day_opus at seven_day_sonnet ang mas luma. Binabasa ng ParseLive ang dalawa: nananaig ang array na limits, at pinupunan ng mga lumang object ang hindi nito sakop. Iniuulat bilang nagbagong format ang body na walang kahit anong limit, at sasabihin iyon sa iyo ng ccam doctor.

Pag-renew ng mga token

Nagro-rotate ang mga refresh token: kapag ni-renew ang isa, makakakuha ka ng bagong refresh token at magiging invalid ang luma. Kung ire-renew ng ccam ang login habang tumatakbo ang Claude Code bilang ang parehong account, masa-sign out ang session na iyon. Kaya binabasa lang ng ccam usage ang mga token at hindi kailanman sinusulatan, maliban kung ipapasa mo ang --refresh. Pagkatapos, ang Fetcher.refresh ay:

1. tumatanggi sa mga account na nirehistro sa kinalalagyan nila gamit ang ccam import, dahil baka ginagamit ng karaniwang claude ang login na iyon nang hindi alam ng ccam;
2. tumatanggi sa mga login na naka-store sa macOS Keychain;
3. kumukuha ng lock file, $XDG_RUNTIME_DIR/ccam/profile-<name>.refresh.lock (sa ilalim ng ~/.local/state/ccam/locks/ kapag hindi nakatakda ang variable na iyon), para hindi kailanman ma-renew nang dalawang beses ng dalawang ccam process ang parehong token;
4. habang hawak ang lock, tumatanggi kung may tumatakbong session ng account, at nilalaktawan ang request kung ni-renew na ng ibang process ang token;
5. ipinapadala ang refresh token sa token endpoint at isinusulat pabalik ang mga bagong token sa .credentials.json gamit ang fsutil.AtomicWrite, at pinapanatili ang bawat ibang key sa file.

Ang status line collector

Pinapatakbo ng Claude Code ang status line command at ipina-pipe dito ang isang JSON document. Binabasa ng ccam mula rito ang pangalan ng model at ang rate_limits:

1. Hinahanap ng runStatusline ang account mula sa CCAM_PROFILE, na itinatakda ng ccam kapag sinisimulan nito ang Claude Code, o kung hindi ay sa pagtutugma ng CLAUDE_CONFIG_DIR sa mga folder ng account.
2. Binabasa ng ParseStatusLine ang rate_limits.five_hour at rate_limits.seven_day. Walang rate limit ang JSON para sa mga account na API key ang gamit, o bago ang unang response ng session; sa ganitong kaso, walang sine-save.
3. Isinusulat ng SaveStatusLine ang ~/.local/state/ccam/usage/<name>.statusline.json. Ginagamit ito ng ccam usage kapag hindi sumasagot ang endpoint.
4. Ipi-print ng ccam ang [name] · model · 5h N% · 7d N%. Sa --wrap, pinapatakbo nito ang iyong command sa pamamagitan ng sh -c na may parehong input at ipi-print ang [name] kasunod ang unang linya ng command sa halip.

May 2 segundo ang naka-wrap na command. Pagkatapos noon, pinapatay ito at pangalan lang ng account ang ipinapakita ng linya, kaya hindi mahaharangan ng mabagal na command ang status line ng Claude Code.

Isinusulat ng ccam statusline install ang statusLine sa settings.json ng bawat account. Kapag may status line command na ang isang account, pinapanatili ito ng ccam bilang --wrap '<old command>'. Isang beses lang isinusulat ang settings.json na shine-share sa pamamagitan ng group, sa pamamagitan ng link nito, kaya nakukuha ito ng bawat account sa group. Kapag pinatakbo ulit, ipi-print ang (already set) para sa mga file na gumagamit na ng ccam.

Kaligtasan at mga espesyal na kaso

• Hindi kailanman binabago ng ccam usage ang token file maliban kung ipapasa mo ang --refresh. Kapag nag-expire ang isang login, patakbuhin nang isang beses ang account gamit ang ccam <name> at ire-renew ito ng Claude Code.
• Hindi kailanman ginagalaw ng --refresh ang mga tumatakbong account, in-import na account o Keychain login. Ipinapakita ng tinanggihang refresh ang mga naka-save na numero at ang dahilan.
• Hindi pampublikong dokumentado ang usage endpoint at puwede itong magbago. Kapag nangyari iyon, makikita mo pa rin ang mga naka-save na numero, at iuulat ng ccam doctor ang pagbabago sa format.
• Kapag walang naka-save na numero at walang sagot, ipinapakita ng hilera ang lookup failed: at ang dahilan, halimbawa no saved usage kapag may --source cache.
• Mga porsiyento at oras ng reset lang ang laman ng mga cache file, hindi kailanman mga token.

Kaugnay

• Mga usage limit at paglipat ng account
• Paglipat sa susunod na account
• Workflow kapag naabot ang usage limit
• Mga command