Estourou o limite do Claude Code: dá para terminar a tarefa no OpenCode?

Não existe hora boa pro plano acabar, mas existe hora péssima: bem no meio da refatoração, com o agente já sabendo tudo do projeto

Fala aí, beleza? O Claude Code para quando o limite do plano estoura, só que a tarefa não para junto: o prazo continua ali, olhando pra tua cara

É nessa hora que muita gente lembra do OpenCode como plano B, um agente de codificação open source que roda no terminal e aceita provedor de modelo diferente

E ele é um plano B real mesmo, só que a troca tem preço: não é gratuita, não é indolor, e tem uma parte do teu trabalho que simplesmente não atravessa pro outro lado

Bora destrinchar isso direito?

Bateu o limite no meio da tarefa: o que está acontecendo e o que fazer agora

Sintoma 1: o Claude Code avisa que o limite do plano acabou

A causa é chata de engolir, mas é simples: nos planos Pro e Max o limite de uso é ÚNICO e compartilhado entre o Claude (app e web) e o Claude Code

Ou seja, aquele papo longo que você teve no app de manhã conta no mesmo balde da sessão de código da tarde

Muita gente jura que estourou o limite do Claude Code em duas horas de trabalho, quando na real o consumo começou bem antes, em outra janela

O primeiro passo é olhar o número em vez de adivinhar:

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

/status

O /status mostra a alocação restante do plano dentro do próprio Claude Code

Com isso na mão, você escolhe entre as três saídas que a ferramenta oferece quando o limite bate:

• esperar o reset
• fazer upgrade de plano
• habilitar créditos de uso pra continuar trabalhando, cobrados a preço padrão de API

Repara no detalhe da terceira opção: preço de API é uma coisa, preço do plano é outra

Você não está "esticando o plano", você está passando pra outro modelo de cobrança no meio do caminho

Se você ainda não tem clareza de quanto cada rota te dá de fôlego, vale entender melhor os limites do Pro e do Max antes de decidir no susto

Sintoma 2: tentou plugar a assinatura no OpenCode e o acesso foi recusado

Esse aqui é o tropeço clássico de quem procura plano B às pressas

A ideia parece ótima: já pago assinatura, então é só usar a mesma credencial no outro agente e seguir a vida, né?

Não é

A Anthropic atualizou os termos de serviço em 19/02/2026 com uma seção de autenticação e uso de credenciais que proíbe explicitamente usar tokens OAuth de assinatura (Free, Pro e Max) em ferramentas de terceiros ou no Agent SDK

E não ficou no papel: houve bloqueio técnico do lado do servidor rejeitando esses tokens fora do cliente oficial, e a cobertura das assinaturas Pro, Max e Team em ferramentas externas (o OpenCode incluído) foi encerrada em 04/04/2026

Até 19/08/2026 não há nenhuma reversão registrada

A solução, então, é uma só: quem quer usar Claude fora dos clientes oficiais autentica com chave de API e aceita cobrança por uso

Sem repasse de assinatura, sem jeitinho

Como prevenir isso na próxima vez

O hábito que salva é ridículo de simples: rodar o /status ANTES de abrir uma tarefa longa

Se a alocação restante está curta, você já sabe que aquela refatoração de duas horas não cabe, e decide o que fazer com a cabeça fria

A outra prevenção é escolher a rota de contingência antes de precisar dela

Descobrir que a assinatura não vale no outro agente às 23h de uma sexta é uma experiência que eu não desejo pra ninguém 😅

O que precisa estar pronto ANTES de você precisar do plano B

Plano B que você monta na emergência não é plano B, é improviso

Então o combinado é deixar três coisas prontas com calma:

1) O agente já instalado. Instalar ferramenta nova com a tarefa parada e o prazo correndo é o pior momento possível pra descobrir que faltava alguma coisa na máquina

2) Uma chave de API já em mãos. O OpenCode é agnóstico de modelo, funciona com provedores diferentes e até com modelos locais, então você escolhe o provedor que fizer sentido pro teu bolso e pro teu tipo de projeto

3) O contexto do projeto escrito em arquivo, não na tua cabeça. Esse é o ponto-chave da continuidade, e merece parágrafo próprio

AGENTS.md, CLAUDE.md e a escada de fallback

O arquivo de instruções de projeto do OpenCode é o AGENTS.md

Mas ele suporta as convenções do Claude Code como fallback, e é aí que mora a boa notícia pra quem já vive no Claude Code:

• se não existir AGENTS.md, o CLAUDE.md do projeto é usado
• se não existir ~/.config/opencode/AGENTS.md, o ~/.claude/CLAUDE.md é usado
• se os dois existirem, só o AGENTS.md vale

Repara nessa última linha, porque ela pega gente desprevenida: criou o AGENTS.md pela metade e esqueceu que tinha um CLAUDE.md completo do lado? O completo é ignorado

E se as tuas regras já vivem espalhadas pelo repositório, dá pra apontar arquivos extras pelo campo instructions no opencode.json (ou no global ~/.config/opencode/opencode.json), em vez de duplicar tudo:

{
  "instructions": ["CONTRIBUTING.md", "docs/guidelines.md", ".cursor/rules/*.md"]
}

Menos duplicação, menos regra desatualizada em dois lugares brigando entre si 🙂

O custo também precisa estar planejado

Se a tua rota de contingência for continuar no Claude Code com créditos, tem duas regras que mudam o planejamento

Os pacotes de uso podem ser comprados até um teto mensal de valor: US$ 2.000 por mês nos planos Pro e Max, e US$ 3.000 nos planos Team

E os créditos de uso comprados expiram um ano após a data da compra, sem extensão de validade e sem reembolso

Traduzindo: crédito não é poupança, é prazo de validade

Antes de comprar mais, costuma valer mais a pena apertar o consumo do que você já tem, porque dá pra gastar menos no Claude Code com hábito, não com dinheiro

Como instalar e ligar o OpenCode em poucos minutos

O OpenCode é open source, licenciado como MIT, e o repositório hoje vive em anomalyco/opencode (a URL antiga sst/opencode redireciona pra lá)

Vamos ver na prática?

1. Instale pelo script oficial:

curl -fsSL https://opencode.ai/install | bash

2. Ou, se você já tem Node na máquina, instale pelo gerenciador de pacotes:

npm install -g opencode-ai

Também funciona com bun install -g opencode-ai e pnpm install -g opencode-ai, então use o que já faz parte do teu fluxo

3. Abra a TUI e adicione o provedor de modelo com o /connect, buscando o provedor e colando a chave de API:

/connect

A lista de provedores vem do Models.dev, e a credencial adicionada por aí fica gravada em ~/.local/share/opencode/auth.json

Se você precisa apontar pra um endpoint diferente, a URL base de qualquer provedor pode ser customizada pela opção baseURL na configuração

O erro comum deste passo: tentar autenticar com a assinatura em vez de chave de API, que é exatamente o caminho bloqueado que falei lá em cima

4. Escolha o modelo:

/models

O erro comum deste passo: conectar o provedor, sair usando e esquecer de escolher o modelo, aí você fica rodando com o que estava selecionado antes e culpa a ferramenta pelo resultado

5. Alternativa ao provedor próprio: o OpenCode Zen, um gateway do próprio time do OpenCode com um conjunto curado de modelos testados pra agente de código

A conexão é pelo mesmo /connect, selecionando OpenCode Zen e colando a chave gerada em https://opencode.ai/auth (o cadastro pede dados de cobrança)

O endpoint do gateway é https://opencode.ai/zen/v1

O erro comum deste passo: ligar o Zen sem olhar a recarga automática

Ele recarrega US$ 20 quando o saldo fica abaixo de US$ 5, e isso pode ser alterado ou desligado, com limite mensal de gasto configurável

Tome cuidado! Recarga automática esquecida é aquele tipo de coisa que você só percebe na fatura

O OpenCode não vive só no terminal

Um detalhe que muita gente não sabe: além da interface de terminal (TUI), ele está disponível como aplicativo desktop e como extensão de IDE

Ou seja, se o teu incômodo com "agente de terminal" era o terminal em si, tem caminho

Como foi na prática trocar de agente com a tarefa pela metade

No vídeo abaixo eu instalo e rodo o OpenCode do zero, e algumas coisas ali valem pra quem está pensando nele como contingência

Eu instalei pelo npm, porque já tinha o Node na máquina, e a documentação oferece outras formas de instalação

Um detalhe que me pegou: eu tinha desinstalado o OpenCode antes de gravar e, quando abri de novo, encontrei configuração antiga preservada, com um modelo já selecionado sem eu ter escolhido naquele momento

Daí a mania de sempre conferir o /models antes de começar, principalmente numa hora de aperto

Deixei o esforço de raciocínio num nível médio como padrão, porque quanto maior o esforço, mais token o modelo consome, e trocar de agente pra economizar gastando mais token seria meio contraditório né? haha

Meu primeiro teste foi de propósito bobo: perguntei em que pasta a gente estava e quais arquivos existiam ali

Ele respondeu o diretório e avisou que não havia arquivos ou pastas visíveis, que era exatamente a verdade

Depois pedi um portfólio pessoal de página única em HTML, CSS e JavaScript, com header, hero, cards de skills, projetos e footer, tema escuro e responsivo, só pra sentir o desempenho em código de verdade

E dá pra acompanhar o fluxo de raciocínio do modelo dentro da interface, o que ajuda MUITO a perceber cedo quando ele entendeu errado o pedido

O que atravessa e o que fica pra trás

Aqui vai o veredito honesto, que é a parte que ninguém conta quando vende "é só trocar de agente"

O que atravessa é o contexto ESCRITO: o AGENTS.md, o CLAUDE.md do projeto pelo fallback, os arquivos apontados no campo instructions, e o código que está no disco

O que NÃO atravessa é a sessão: histórico da conversa, o plano que vocês combinaram no meio do caminho, as decisões que você aprovou verbalmente, o contexto que foi sendo acumulado prompt a prompt

Eu não encontrei nenhum mecanismo documentado dos dois lados pra importar, retomar ou converter uma sessão em andamento

Então a troca dói menos quando você está no COMEÇO de uma etapa nova, com o próximo passo já claro e escrito

E dói muito quando você está no meio de uma cadeia longa de decisões que só existem no histórico da conversa

Minha opinião sobre a ferramenta em si: o Claude Code até aceita outros modelos, mas vem restringindo cada vez mais e funciona melhor com os modelos da Anthropic mesmo

O OpenCode é aberto e livre, com você no controle da escolha do modelo, e eu vejo risco real em depender de ferramenta amarrada a contrato entre empresas: se o acordo acaba, quem fica à mercê é o usuário

Na minha impressão ele não fica devendo nada pras ferramentas top do mercado

Ah, e um aviso: se você for por um caminho gratuito de modelo, é bem provável que prompts e resultados sejam compartilhados, então leia as condições antes de sair jogando código de cliente lá dentro

E trate a documentação oficial como fonte principal, acima da visão de qualquer usuário, inclusive a minha 😀

Quando vale trocar de agente e quando é melhor só esperar o reset

Nem toda tarefa interrompida pede plano B

Às vezes a decisão mais barata é fechar o notebook e voltar depois, sério

A regra de bolso que eu uso: se eu consigo escrever o próximo passo em três linhas num arquivo, a troca é tranquila

Se eu preciso de vinte minutos de conversa pra explicar onde a gente parou, é sinal de que o contexto vale mais do que o tempo de espera

Conclusão

Recapitulando o que importa

O limite do Claude Code te dá três saídas oficiais: esperar o reset, fazer upgrade ou habilitar créditos de uso a preço padrão de API, e o /status é quem te mostra quanto ainda sobra

Nos planos Pro e Max esse limite é compartilhado com o Claude no app e na web, então o consumo vem de mais lugares do que você imagina

O OpenCode é plano B de verdade: open source, MIT, agnóstico de modelo, TUI, desktop e IDE

Mas ele não aceita a tua assinatura Claude, porque os termos proíbem token OAuth de assinatura fora dos clientes oficiais e a cobertura em ferramentas externas foi encerrada em 04/04/2026, sem reversão registrada até 19/08/2026

E o plano B só funciona se estiver montado ANTES

Então o próximo passo é hoje, sem pressa: instala, roda o /connect com uma chave de API, escolhe o modelo no /models, garante o arquivo de instruções do projeto e roda uma tarefa pequenininha só pra sentir o fluxo

Assim, no dia em que o limite estourar no pior momento possível, você já sabe exatamente o que apertar

até o próximo post! 😀