Documentação
Limites de uso e troca de contas
Esta página foi traduzida automaticamente do inglês. Correções são bem-vindas. Editar esta página no GitHub
ccam usage mostra quanto de cada limite, o de 5 horas e o semanal, cada conta já usou. ccam next --auto abre a conta com mais espaço, e --continue leva junto a conversa atual.
$ ccam usage
Account 5-hour Resets Weekly Resets As of
1 personal ██████░░ 72% 1h 40m ███░░░░░ 41% 3d 6h just now
2 work █░░░░░░░ 8% 4h 12m ██░░░░░░ 19% 5d 2h just now
3 side ████████ 100% 22m █████░░░ 68% 1d 9h 12m ago (cached)
→ Most headroom: work (open it with ccam next --auto)As colunas são: conta, uso de 5 horas, tempo até reiniciar, uso semanal, tempo até reiniciar e a idade dos números.
De onde vêm os números
O ccam consulta o endpoint de uso da Anthropic para todas as contas ao mesmo tempo, usando o login de cada conta. Ele espera no máximo 3 segundos por conta e mostra cada conta assim que ela responde.
Esse endpoint não é documentado publicamente e pode mudar. Quando uma solicitação falha, o ccam mostra os últimos números conhecidos e os marca como cache. Uma janela que reiniciou depois que esses números foram salvos mostra 0%. ccam doctor avisa se o formato da resposta mudou.
Números obtidos há menos de 60 segundos são reaproveitados. Opções:
| Opção | Efeito |
|---|---|
--watch [seconds] |
Atualiza continuamente, a cada 60 segundos por padrão |
--json |
Saída legível por máquina |
-v |
Também mostra os limites semanais por modelo e a origem de cada número |
--no-cache |
Sempre consulta de novo |
--source cache |
Nunca consulta; mostra apenas os números salvos |
Logins expirados
Quando o token de acesso de uma conta expira, o ccam não o renova, porque renová-lo enquanto uma sessão do Claude Code usa o mesmo login poderia desconectar essa sessão. Inicie a conta uma vez com ccam <name> e o Claude Code renova o token.
ccam usage --refresh renova os tokens expirados por conta própria, mas apenas das contas que não estão em execução. Ele nunca renova logins armazenados no Acesso às Chaves do macOS ou em um ~/.claude importado.
Uso na linha de status
ccam statusline installDepois disso, o Claude Code mostra o nome da conta e o uso dela na linha de status, por exemplo [work] · Opus · 5h 24% · 7d 41%. Se você já tem um comando de linha de status, o ccam o mantém e coloca o nome da conta na frente. A linha de status também salva os números, que o ccam usage usa quando o endpoint não responde.
Troca de conta
ccam next # the account after the one you used last
ccam next --auto # the account with the lowest 5-hour usage
ccam next --continue # the next account that shares your conversation historyccam next pula as contas que não estão com login feito, e --auto pula as contas em 100%. Para continuar uma conversa, as duas contas precisam compartilhar o histórico de conversas; consulte compartilhamento.
O guia do fluxo de trabalho para limites de uso mostra um exemplo completo.