O que é e porque importa
Estás a meio de um trabalho longo e o Claude Code para com uma mensagem como “You've hit your session limit · resets 3:45pm”. Gastaste a utilização incluída na tua subscrição para esta janela de tempo e, até à hora da mensagem, não sai mais nenhum pedido. Mudar de modelo não ajuda: o limite da sessão e o semanal valem para todos os modelos.
Antes tinhas de ficar acordado até à hora certa e depois escrever “continua”. Agora o Claude Code pode esperar por ti: deixa a sessão aberta e, quando o limite é reposto, ele retoma o trabalho onde tinha parado. Na app de computador é uma caixa para marcar; no terminal já vem ligado.
Serve a quem usa o Claude Code com uma subscrição claude.ai e o deixa trabalhar muito tempo: um refactor, testes para corrigir, uma funcionalidade inteira. Não te dá mais utilização, só espera. Mas poupa-te o despertador e, de manhã, encontras o trabalho adiantado em vez de parado a meio.
1. Na app de computador: a caixa
Na app de computador do Claude, no separador Code, quando chegas ao limite da sessão aparece um cartão com o aviso. Faz assim:
- No cartão do limite, marca a caixa Auto-continue when limits reset.
- Não feches a sessão: tem de ficar aberta até à hora de retomar.
- Vê a hora: o cartão mostra Auto-resuming at seguido da hora em que o limite é reposto.
- A essa hora a app tenta de novo, sozinha, o turno que tinha sido interrompido, e o trabalho continua sem ti.
Duas coisas a saber. O cartão do limite semanal não tem esta caixa: aí esperas e retomas tu. E a caixa da app é separada da definição do terminal que vemos já a seguir: se as quiseres desligar, desligas as duas, uma a uma.
E, claro, o computador tem de ficar ligado e acordado: se entrar em repouso, nada trabalha. Eu deixo o meu ligado à corrente, com a tampa aberta.
2. No terminal: já vem ligado
No terminal não tens de fazer nada. Se entraste com uma subscrição claude.ai, a espera automática vem ligada por defeito nas sessões interativas, aquelas em que escreves tu. Só precisas da versão mais recente do Claude Code.
Quando chegas ao limite, aparecem duas linhas no fundo da sessão. A primeira diz quando o limite é reposto, a segunda quando o Claude continua. A hora aqui é um exemplo, tu vês a tua:
Usage limit reached · limit resets 3:45pm Continuing automatically at 3:45pm · esc to cancel
Deixa a sessão aberta. A partir daqui pode correr de duas maneiras:
- À hora da reposição, a segunda linha passa a Continuing shortly. Depois aparece na conversa Usage limit reset · continuing automatically, e o Claude retoma a tarefa onde tinha parado. Não volta a enviar a tua última mensagem: diz ao Claude para continuar.
- Se o computador esteve em repouso mais de meia hora, mais ou menos, e entretanto o limite foi reposto, lês Your usage limit has reset e Press enter to continue. Aqui alguém tem de carregar em Enter: sozinho não retoma. Depois de um repouso mais curto, ou que acabou antes da reposição, retoma sozinho.
Parar a espera ou desligá-la
- Para a cancelar: enquanto vês as duas linhas, carrega em Esc com o campo do prompt vazio, ou em Ctrl+C. O Claude Code confirma com uma linha que começa por Automatic continue cancelled. Para essa janela já não retoma sozinho: ou escreves tu, ou voltas a ativá-la no menu.
- O menu é /rate-limit-options. Lá encontras a opção que começa por Wait here, then continue automatically, para iniciar a espera à mão, e Don't continue automatically, para a cancelar.
- Para a desligar de vez: escreve /config e desliga Continue automatically at usage limit. É a opção que guarda autoContinueAtUsageLimit nas tuas definições de utilizador.
3. Quando não retoma sozinho
É aqui que normalmente acordas e encontras tudo parado. Os casos a conhecer:
- O limite semanal. Se a reposição for daqui a mais de 24 horas, o Claude Code não inicia a espera sozinho: abre-te o menu e podes escolhê-la tu com Wait here, then continue automatically. Na app de computador, pelo contrário, o cartão semanal nem tem a caixa.
- Os pedidos de permissão. O trabalho retomado é um turno como outro qualquer: se o Claude tiver de te pedir uma permissão, para ali e espera por ti.
- O limite que volta. Se o Claude retoma e chega outra vez ao limite, volta a pôr a espera sozinho no máximo duas vezes seguidas. Depois para com Automatic continue stopped after repeated usage-limit hits, e és tu que a reativas com /rate-limit-options.
- A sessão que muda. Se sais do Claude Code, a espera não volta quando reabres a sessão. Também acaba se escreveres tu uma mensagem, mudares de conta com /login, limpares ou rebobinares a conversa, abrires outra sessão com /resume ou passares a sessão para outro sítio: para a app de computador, para segundo plano ou para a cloud.
- Onde não existe. Nas sessões em segundo plano e nos comandos lançados com claude -p não há espera. Nem com uma chave de API, um fornecedor de cloud ou faturação por utilização: aí pagas por pedido e não há reposição nenhuma para esperar.
4. Fica de olho no consumo
Retomar sozinho não quer dizer ter mais utilização. O limite é o mesmo, o Claude só espera. Por isso, antes de o deixares trabalhar sozinho, convém saber em que ponto estás:
- /usage no terminal: mostra-te os limites do teu plano e quando são repostos. Nos planos Pro, Max, Team e Enterprise mostra-te também o que está a pesar mais nos limites.
- O anel de utilização na app de computador: está ao lado do seletor de modelo. Clica nele e vês quanto do plano já usaste. É a mesma conta para todos os sítios onde usas o Claude Code.
- O aviso antes do limite. O Claude Code pode avisar-te com uma mensagem como You've used 85% of your session limit · resets 3:45pm. Se o vês à noite, já sabes que esta noite vais precisar da espera.
- A linha de estado. Se queres a conta sempre à vista no terminal, podes pedir ao Claude para pôr os campos rate_limits numa linha de estado personalizada.
Lembra-te de que cada pedido conta ao mesmo tempo para o limite da sessão e para o semanal. Um trabalho muito pesado, feito todo de uma vez, pode gastar o semanal antes de o da sessão ser reposto. E o semanal não retoma sozinho. Para gastar menos escrevi o guia TOKEN (strikt.fit/token).
5. Antes de ires dormir
A espera resolve o limite. O resto preparas tu, antes de fechar o dia. Eu faço três coisas.
O trabalho em pequenos passos
Se o limite chega a meio de uma alteração grande, de manhã não sabes o que está acabado e o que não está. Por isso peço commits pequenos. Um commit é um ponto de gravação do projeto no git: se algo correr mal, voltas ao ponto anterior.
Trabalha em pequenos passos. Depois de cada parte acabada, corre os testes e, se passarem, faz um commit com uma mensagem que diga o que fizeste. Não faças git push.
Um ficheiro com o progresso
O Claude retoma a partir da conversa, mas um ficheiro é mais seguro: se a sessão fechar ou a espera parar, o ficheiro fica, e uma sessão nova também o pode ler.
Mantém atualizado o ficheiro PROGRESSO.md: o que acabaste, o que estás a fazer agora, o que falta e os problemas que encontraste. Atualiza-o depois de cada commit.
Se de manhã o encontrares parado, abre uma sessão nova e escreve:
Lê PROGRESSO.md e git log, diz-me em que ponto estavas e retoma a partir do primeiro passo por acabar.
As permissões antes de saíres
Um pedido de permissão para tudo até acordares, mesmo que o limite tenha sido reposto há horas. Por isso vejo o modo de permissões: no terminal mudas com Shift+Tab, na app de computador no seletor de modo. À noite uso auto se o tiver; senão, acceptEdits, que aceita sozinho as alterações aos ficheiros.
Com acceptEdits quase todos os comandos continuam a pedir permissão. Por isso, de dia, peço ao Claude para preparar as regras de que precisa e depois verifico-as com /permissions:
Vê de que comandos precisas para acabar este trabalho, como os testes e a build, e adiciona as regras allow no .claude/settings.json deste projeto. Adiciona também regras deny para git push e para os comandos rm. Mostra-me o ficheiro antes de o guardares.
Como escolher o modo, escrever regras e hooks e manter o Mac acordado a noite toda, explico passo a passo no guia NOTTE (strikt.fit/notte).
Os erros mais comuns
- Fechar a sessão ou sair do Claude Code. A espera vive na sessão aberta: se sais, não volta nem quando a reabres.
- Contar com ela no limite semanal. Se a reposição for daqui a mais de 24 horas não arranca sozinha, e na app de computador não há caixa: confirma com /usage antes de ires dormir.
- Deixá-lo em modo Manual. Ao primeiro pedido de permissão para, mesmo que o limite tenha sido reposto há horas.
- Deixar o computador entrar em repouso. Se ficar em repouso mais de meia hora, mais ou menos, no terminal alguém tem de carregar em Enter.
- Mandar-lhe uma mensagem enquanto espera. A tua mensagem toma o lugar da espera: se só queres ver, olha e não escrevas.
- Achar que é um limite mais alto. É o mesmo limite: o Claude espera e retoma, não trabalha mais.
Checklist
- Na app de computador marquei Auto-continue when limits reset
- No terminal, em /config, Continue automatically at usage limit está ligado
- Com /usage sei quando o limite é reposto, e não é o semanal
- Modo de permissões escolhido e regras allow prontas
- O Claude faz commits pequenos e atualiza o ficheiro de progresso
- Sessão aberta, computador ligado, na corrente e acordado
Perguntas frequentes
A espera automática faz-me gastar mais?
Não. Não compra utilização nem sobe o limite: espera que o que já tens seja reposto e depois continua o trabalho que tinhas pedido. Gasta o mesmo que gastaria se tivesses escrito tu “continua” à hora certa.
Recomeça do zero ou continua de onde parou?
De onde parou. No terminal, o Claude Code não volta a enviar a tua última mensagem: diz ao Claude para retomar a tarefa interrompida, com a conversa toda. Na app de computador é repetido o turno que tinha sido interrompido. Mantém o ficheiro de progresso na mesma: é a tua rede se algo correr mal.
Funciona se usar o Claude Code com uma chave de API?
Não. Com uma chave de API, um fornecedor de cloud ou faturação por utilização pagas por pedido, por isso não há um limite que seja reposto. Precisas de uma subscrição claude.ai, com a sessão iniciada no Claude Code.