Nota do autor: o OpenCode 2.2.3 adicionou o provider Claude Agent. Neste artigo, você vai entender a diferença em relação ao plugin OAuth removido em março, aprender a conectá-lo em 3 passos e conhecer 5 limitações para decidir se vale a pena usá-lo.
Em 30 de outubro, o OpenCode lançou a versão 2.2.3 com o provider Claude Agent integrado. Para usá-lo, basta instalar o Claude Code no computador, executar claude auth login uma vez e selecionar Claude Agent em /connect no OpenCode. Assim, você pode usar sua própria assinatura do Claude para acessar os modelos. Até 31 de outubro, o anúncio oficial de @opencode já tinha cerca de 510 mil visualizações.
Isso não é o mesmo sistema OAuth que foi removido em março. A nova solução usa o binário oficial do Claude Code junto com o Claude Agent SDK. O OpenCode não lê nem armazena suas credenciais: as solicitações ao modelo são enviadas pelo processo claude no seu computador. A equipe do OpenCode diz que recebeu autorização da Anthropic, mas a Anthropic não publicou um anúncio separado.
O desenvolvedor Chen Cheng (@chenchengpro) analisou a implementação em detalhe: na inicialização, são definidos tools: [] e settingSources: [], permitindo apenas ferramentas mcp__opencode__*. Como o handler MCP não tem acesso ao tool_use_id, é preciso registrá-lo um por vez por meio do hook PreToolUse. Por isso, a leitura paralela de arquivos acaba sendo executada em sequência. O system prompt continua sendo o padrão do Claude Code, e a avaliação dele é que “o resultado certamente não é tão bom quanto usar o Claude Code diretamente”. Neste artigo, você encontra 3 passos para conectar, 5 limitações e recomendações para 3 perfis de usuários.
Observação: este artigo foi preparado com base nas notas de versão do OpenCode, no documento de design da PR #58782, na documentação oficial do Claude Code e em comentários da comunidade. Não foi realizado um teste de ponta a ponta.
Usar a assinatura do Claude no OpenCode: a resposta direta
A resposta se resume em três pontos: funciona, mas não é o método antigo e tem suas limitações.
- Pré-requisitos: OpenCode V2 na versão 2.2.3 ou superior; Claude Code instalado na mesma máquina e autenticado com
claude auth login. - Como funciona: o OpenCode usa o Claude Agent SDK para chamar o processo
claudena sua máquina. Ele não implementa seu próprio OAuth, nem lê ou armazena tokens. - Limitações: as chamadas de ferramentas passam a ser sequenciais; vários recursos do Claude Code ficam indisponíveis; e só é possível executar localmente, sem suporte a ambientes hospedados ou remotos.
Sobre ser “gratuito”, vale esclarecer: o plano gratuito do Claude não inclui o Claude Code, então não dá para usá-lo dessa forma. Você precisa de um plano Pro, Max, Ultra, Team ou Enterprise, ou de uma conta Console. E o uso não é ilimitado: ele continua contando para os limites de 5 horas e semanal da sua assinatura. A interface do OpenCode mostra $0 porque o custo já está coberto pela assinatura.
Se você não tem uma assinatura ou precisa de um ponto de acesso compartilhado para a equipe, pode usar uma API com cobrança por uso. Por exemplo, é possível chamar modelos Claude pela APIYI, em apiyi.com, usando uma interface compatível com OpenAI. Essa opção não depende de uma máquina específica nem dos limites de uma assinatura.
Por que a assinatura do Claude foi removida do OpenCode em março e voltou em outubro
A história teve quatro momentos importantes em 2026:
- 9 de janeiro: a Anthropic apertou as restrições para harnesses de terceiros. No mesmo dia, surgiu a issue #7410, “Broken Claude Max”, no OpenCode, com relatos de que o Claude Max havia começado a apresentar erros de repente.
- 20 de fevereiro: veículos internacionais noticiaram que a Anthropic havia alterado seus termos, proibindo explicitamente o uso de tokens OAuth em outros produtos, inclusive os desenvolvidos com o Agent SDK.
- 19 de março: o OpenCode fez o merge da PR #18186, “anthropic legal requests”, removeu o plugin integrado
opencode-anthropic-authe retirou a Anthropic da lista de provedores. - 30 de outubro: o Claude Agent voltou com o OpenCode 2.2.3. No mesmo dia, a versão 2.2.4 acrescentou uma configuração guiada.
A mudança está no texto dos próprios termos. Uma cópia da página jurídica e de conformidade da Anthropic arquivada no Wayback em 21 de fevereiro ainda dizia que usar tokens OAuth dos planos Free, Pro e Max em qualquer outro produto, ferramenta ou serviço, incluindo o Agent SDK, violava os termos de serviço para consumidores. Na cópia de 30 de setembro, essa frase já havia sido removida e uma exceção havia sido acrescentada: usuários finais podem entrar com suas assinaturas no binário não modificado do Claude Code, inclusive quando o Claude Code é hospedado por uma plataforma. A página de outubro manteve essa exceção.
O Claude Agent do OpenCode foi projetado justamente com base nessa exceção. Nos comentários da PR #58782, alguém perguntou se havia risco de banimento da conta. O autor, Tarquinen, respondeu que havia recebido autorização da Anthropic e que a solução estava em total conformidade com os termos. Daniel Smolsky, membro do OpenCode, também publicou no X: “Recebemos permissão”. Porém, até 31 de outubro, não foi encontrado um anúncio separado da Anthropic sobre o assunto. Portanto, por enquanto, a afirmação de que houve autorização vem apenas do OpenCode.
| Aspecto | Plugin OAuth anterior a março | Claude Agent de outubro |
|---|---|---|
| Forma de login | O próprio OpenCode usava o OAuth do claude.ai para obter um token | O usuário executa claude auth login no Claude Code instalado localmente |
| Quem faz as requisições | O OpenCode chama diretamente a API da Anthropic | O processo local claude envia as requisições pelo Agent SDK |
| Leitura ou armazenamento do token | O plugin mantém o token OAuth | Não lê nem armazena o token; /connect registra apenas a opção escolhida |
| Posição da Anthropic | Os termos de fevereiro proibiam explicitamente o uso, e o plugin foi removido em março | O OpenCode diz ter recebido autorização; os termos de setembro incluíram uma exceção, mas não houve anúncio separado |
| Risco | Risco de banimento da conta e remoção do plugin | Menor do que em março, mas a política pode mudar novamente |
É importante deixar os riscos claros. Os termos atuais reservam à Anthropic o direito de aplicar as regras sem aviso prévio e continuam proibindo terceiros de coletar, armazenar ou intermediar credenciais do Claude. Por isso, ao configurar a integração, tome dois cuidados: não instale versões antigas do plugin OAuth que circulam na internet e não deixe sua conta em uma plataforma de terceiros para executar tarefas por você.
Como o OpenCode Claude Agent funciona: fluxo e execução sequencial
O fluxo completo é: OpenCode → Claude Agent SDK → claude local → Anthropic. O OpenCode não fica entre o Claude Code e a Anthropic nem modifica as requisições. Por padrão, o executável claude é localizado no PATH, mas também é possível especificar o caminho pela variável de ambiente OPENCODE_CLAUDE_PATH.
Na inicialização, vários recursos do Claude Code são desativados ou substituídos. Dá para resumir em “três desativações, uma substituição e uma execução sequencial”:
- Desativar as ferramentas integradas: com
tools: [], nenhuma das ferramentas de leitura, escrita ou Bash do Claude Code é usada. - Desativar as configurações do usuário: com
settingSources: [], o sistema não lê~/.claudenem o diretório.claudedo projeto. Também não carrega CLAUDE.md, hooks, skills ou servidores MCP. - Permitir apenas ferramentas do OpenCode: só são aceitas ferramentas com o prefixo
mcp__opencode__*. Se o Claude chamar uma ferramenta com outro nome, receberáNo such tool available, e o OpenCode não executará a chamada. - Substituir a implementação das ferramentas: o OpenCode disponibiliza suas próprias ferramentas em um servidor MCP no mesmo processo e, durante a execução, usa suas próprias janelas de permissão. O comando de sistema continua sendo o padrão do Claude Code, com a adição de uma frase dizendo que ele está rodando no opencode, além do comando do agente escolhido e do AGENTS.md.
- Executar ferramentas sequencialmente: o handler de ferramentas do OpenCode não tem acesso ao
tool_use_iddo Claude. Por isso, o hookPreToolUseprecisa registrá-lo antes para que possa ser recuperado depois. Como o hook só consegue registrar um ID por vez, as ferramentas não podem ser marcadas para execução paralela. Assim, mesmo quando o Claude leria vários arquivos ao mesmo tempo, aqui ele passa a lê-los um por um.
O OpenCode tem seus motivos para adotar esse design. Independentemente do modelo que gerou o conteúdo, o formato do histórico da sessão é o mesmo, evitando confusão na troca de modelos. Além disso, há um único sistema global de permissões. O custo é que boa parte dos recursos originais do Claude Code deixa de estar disponível. A avaliação de Chen Cheng é: “Com tudo isso, parece que o resultado certamente não será tão bom quanto usar o Claude Code diretamente.” Vale considerar esse ponto antes de decidir se vai integrar os dois.
Há ainda alguns detalhes de funcionamento: cada sessão inicia um processo claude de longa duração, que é interrompido após 5 minutos de inatividade e retomado quando chega a próxima mensagem. As requisições que falham são repetidas pelo próprio Claude Code; o OpenCode não faz novas tentativas por conta própria.
Conecte sua assinatura do Claude ao OpenCode em 3 passos
Antes de começar, confira estes 5 requisitos:
- O OpenCode deve ser a V2, na versão 2.2.3 ou superior, e não a V1.
- O Claude Code deve estar instalado na máquina.
- A conta do Claude deve ter um plano pago ou ser uma conta do Console.
- O OpenCode e o Claude Code devem estar na mesma máquina.
- Não pode ser uma instância hospedada do OpenCode nem um workspace remoto.
Para instalar a V2, use o comando curl -fsSL https://opencode.ai/v2/install | bash. Você também pode baixar a versão para desktop.
Passo 1: Instale o Claude Code
O que você verá: execute claude --version no terminal. Se aparecer uma mensagem informando que o comando não foi encontrado, o Claude Code ainda não está instalado.
O que fazer: no macOS e no Linux, use o script oficial install.sh. No Windows, execute o script oficial install.ps1 no PowerShell. Se você já instalou o Claude Code, mas está usando uma versão antiga, execute claude update para atualizá-lo.
Como confirmar que deu certo: claude --version exibe o número da versão.
Passo 2: Faça login na sua conta do Claude
O que você verá: depois de executar claude auth login, o navegador abrirá a página de login da Anthropic.
O que fazer: faça login com sua conta paga do Claude e execute claude auth status para conferir o status.
Como confirmar que deu certo: o método de autenticação exibido é o login por assinatura, e não api_key ou none.
Cuidado com um detalhe: se a variável ANTHROPIC_API_KEY estiver definida no seu shell, o Claude Code pode priorizar a chave API e gerar cobranças por uso. Antes de fazer login, execute unset ANTHROPIC_API_KEY. Se o Claude Code perguntar se você quer usar essa chave, recuse.
Passo 3: Conecte o Claude Agent no OpenCode
O que você verá: ao digitar /connect no OpenCode, aparecerá uma lista de provedores.
O que fazer: selecione Claude Agent, não “Anthropic”. Depois, use /models para escolher um modelo Claude. A partir da versão 2.2.4, há um fluxo guiado que ajuda a copiar o comando de login, verificar a instalação e validar a conexão. Quando tudo estiver certo, você poderá escolher o modelo. Se preferir a linha de comando, também pode usar opencode auth login para fazer a mesma conexão.
Como confirmar que deu certo: você consegue selecionar um modelo Claude na lista, recebe uma resposta ao enviar um comando de teste e vê a janela de permissões do OpenCode aparecer normalmente quando uma ferramenta é chamada.
Solução de problemas
- Claude Agent não aparece na lista: execute
opencode --versionpara verificar a versão. Se for anterior à 2.2.3, atualize. Confira também se você instalou a V2. - Mensagem informando que claude não foi encontrado: verifique o
PATHou useOPENCODE_CLAUDE_PATHpara definir o caminho absoluto declaude. - A página de login abre repetidamente: alguns usuários relataram que a conexão cai depois de uma ou duas sessões e que, ao reconectar, são redirecionados para a página de login. A comunidade ainda está corrigindo o problema. Enquanto isso, execute
claude auth loginnovamente no terminal e volte para/connect. - Mensagem de limite do plano atingido: a cota de 5 horas ou a cota semanal da assinatura acabou. É preciso esperar o limite ser renovado.
- Não é possível conectar em um ambiente remoto: essa configuração não é compatível; a conexão só funciona na máquina local.
Mais um detalhe: a documentação de provedores do OpenCode V1 ainda traz o aviso antigo de que a Anthropic proíbe o uso de contas Pro/Max. Essa orientação é anterior a março. Não procure o Claude Agent no /connect da V1: ele só está disponível na V2.
5 limitações de usar a assinatura do Claude no OpenCode
| Limitação | Como se manifesta | Quem é mais afetado |
|---|---|---|
| Ferramentas em série | O hook registra apenas um tool_use_id por vez, então arquivos são lidos um a um, em vez de em paralelo |
Quem trabalha com repositórios grandes ou refatorações em vários arquivos |
| O prompt não é o do OpenCode | É usado o system prompt do Claude Code; o prompt nativo do OpenCode não entra em ação | Quem depende do comportamento padrão do agente do OpenCode |
| Faltam recursos do Claude Code | Não há /usage, auto mode, memory, cloud sessions, agent teams, entre outros |
Usuários avançados do Claude Code |
| Apenas na máquina local | Hosted e remote não são compatíveis; o claude precisa estar na mesma máquina |
Quem trabalha com desenvolvimento na nuvem, equipes remotas ou CI |
| Parâmetros e plugins limitados | Parâmetros como temperature, top-p, seed e stop não são compatíveis; o hook http.request não é executado |
Quem precisa ajustar parâmetros com precisão ou usar um gateway |
Ferramentas em série: em projetos pequenos, a diferença quase não aparece. Mas, se uma tarefa precisar examinar dezenas de arquivos, o tempo de espera será bem maior. Quem costuma fazer refatorações amplas precisa levar esse custo de tempo em conta.
O prompt não é o do OpenCode: prompts personalizados de agentes continuam funcionando, mas o prompt base é o do Claude Code. Se você já está acostumado ao comportamento do agente nativo do OpenCode, pode notar uma mudança no estilo do modelo ao fazer a troca.
Recursos ausentes: esta é a limitação de maior impacto. O documento de design lista recursos disponíveis no Claude Code que não estão presentes no OpenCode, incluindo auto mode, ultracode, auto memory, away summaries, cloud sessions, /teleport, agent teams, /loop, computer use, sandboxed Bash, notebook editing e skills nativas como /simplify e /verify.
Apenas na máquina local: o processo do Claude é interrompido após 5 minutos de inatividade e retomado na próxima mensagem. Não é possível usar essa integração em CI ou em uma máquina de desenvolvimento remota.
Parâmetros e plugins limitados: nenhum parâmetro de amostragem é compatível. A URL base e os headers só podem ser lidos do arquivo de configuração, e os plugins não podem modificá-los por requisição. Os hooks http.request e http.response também não são executados, pois as requisições são feitas pelo Claude Code.
Também há alguns pontos sobre o uso que vale observar: não é possível consultar o /usage do Claude no OpenCode; ao atingir o limite, o uso não é retomado automaticamente; e também não é possível comprar uso adicional por ali. O /usage do próprio OpenCode mostra o consumo do OpenCode Console, sem relação com a cota da sua assinatura do Claude. Além disso, há alegações de que usuários de claude -p e do SDK recebem uma cota de assinatura menor do que no uso normal do Claude Code, mas o documento de design diz explicitamente que isso “não foi verificado”. Por enquanto, não dá para tratar essa afirmação como fato.
Em resumo: se você precisa de auto mode, memory, cloud sessions, agent teams, computer use ou notebook editing, use o Claude Code diretamente. Essa solução só vale a pena se você precisa do modelo Claude junto com as ferramentas e o sistema de permissões do OpenCode e aceita a execução das ferramentas em série.
Usar o OpenCode com uma assinatura do Claude: para quem vale a pena
Dependendo do seu perfil, existem três situações:
- Já usa o OpenCode 2.x, tem uma assinatura do Claude e programa apenas na sua máquina: vale experimentar. Você pode alternar entre o Claude e outros modelos no mesmo ambiente, sem pagar separadamente pela API.
- Usa apenas o Claude Code: não complique. Use o Claude Code diretamente: ele tem mais recursos, permite executar ferramentas em paralelo e usa os comandos originais.
- Equipes, CI, desenvolvimento remoto ou quem depende de auto mode, memory e painel de limites: não use essa solução. Ela funciona apenas na máquina local, não oferece todos os recursos e não deixa os custos claros. Uma chave API ou o pagamento por uso da APIYI apiyi.com são opções mais adequadas.
| Opção | Preço (em 27/10) | Para quem |
|---|---|---|
| Claude Pro | US$ 20/mês | Uso individual leve, com limites de 5 horas e semanais |
| Claude Max / Ultra | US$ 100 / US$ 200 por mês | Usuários individuais intensivos |
| Cliente OpenCode | Gratuito e de código aberto | Todos |
| OpenCode Go (opcional) | US$ 10/mês | Quem precisa de modelos hospedados pelo OpenCode; não é obrigatório para usar o Claude Agent |
| APIYI Claude Opus 5.5 | Entrada US$ 4 / saída US$ 20 | Uso compartilhado em equipe, CI e quem precisa de custos claros |
| APIYI Claude Sonnet 5.5 / Haiku 5.5 | US$ 2/US$ 10, US$ 0,1/US$ 0,5 | Programação no dia a dia e tarefas em lote |
Os preços da APIYI na tabela são por milhão de tokens. A leitura do cache é cobrada separadamente.
💰 Sugestão para pagamento por uso: se você não tem assinatura, precisa compartilhar o acesso com a equipe ou quer acompanhar cada gasto, pode usar a APIYI apiyi.com. Ela oferece tanto o endpoint
messages(formato nativo da Anthropic) quanto o endpointchat(formato compatível com OpenAI). Preencha o base_url comhttps://api.apiyi.com/v1. Consulte a lista de modelos da plataforma para conferir os modelos e preços disponíveis.
Perguntas frequentes (FAQ)
Q1: Minha conta pode ser banida por usar uma assinatura do Claude no OpenCode?
O risco é menor do que em março: a nova solução usa o binário oficial, o OpenCode não lê o token e ela também se enquadra na exceção adicionada aos termos em setembro. Mas a afirmação de que o uso foi autorizado vem do OpenCode; a Anthropic não fez um anúncio específico e se reserva o direito de aplicar as regras sem aviso prévio. Não use os plugins OAuth antigos.
Q2: Por que não encontro o Claude Agent em /connect?
Na maioria dos casos, é um problema de versão: ela é anterior à 2.2.3 ou você ainda está usando a V1. Atualize para a versão mais recente da V2 e procure por “Claude Agent” em `/connect`, não por “Anthropic”.
Q3: O OpenCode mostra um custo de $0. É realmente grátis?
Não. O valor aparece como $0 porque o custo já está coberto pela assinatura, mas o uso continua descontando das cotas de 5 horas e semanal. Se você usar uma chave API, o OpenCode exibirá o custo com base nos preços do models.dev.
Q4: Posso usar em uma máquina de desenvolvimento remota ou na nuvem?
Não. O `claude` e o OpenCode precisam estar instalados na mesma máquina; ambientes hospedados e espaços de trabalho remotos não são compatíveis. Para uso na nuvem ou em CI, a recomendação é usar uma chave API ou pagar por uso via APIYI apiyi.com.
Q5: Como escolher entre integrar a assinatura e usar uma chave API?
A integração da assinatura é indicada para uso pessoal na máquina local, desde que você já pague por uma assinatura. A chave API não fica vinculada a uma máquina, pode ser compartilhada entre várias pessoas, oferece uma cobrança clara e não está sujeita aos limites da assinatura. Se quiser comparar o Claude com outros modelos, a APIYI apiyi.com permite alternar entre eles e fazer testes com uma única chave.
Q6: Posso usar a versão gratuita do Claude?
Não. A versão gratuita não inclui o Claude Code. É necessário ter pelo menos o plano Pro ou uma conta Team, Enterprise ou Console.
Resumo: OpenCode com assinatura Claude em 3 frases
É possível conectar: a partir da versão 2.2.3, o OpenCode usa o Agent SDK oficial para chamar o claude instalado localmente; segundo o OpenCode, a Anthropic autorizou essa integração, mas a política ainda pode mudar. Como conectar: instale o Claude Code, execute claude auth login e selecione Claude Agent em /connect. Quando não usar: se precisar de ferramentas em paralelo, de todos os recursos do Claude Code ou de acesso remoto ou em equipe, use o Claude Code diretamente ou invoque o Claude por consumo via APIYI apiyi.com.
Autor: Equipe técnica da APIYI
Dúvidas técnicas: para questões sobre a integração de modelos Claude, entre em contato conosco pela página inicial da APIYI apiyi.com. Mais documentação em docs.apiyi.com.
