Problema de início de sessão no Claude Code: como corrigir o erro «não é possível colar o código de autenticação» no macOS e no Windows

Se acabou de executar claude login, obteve o seu código de autenticação a partir do navegador e o terminal se recusa silenciosamente a colá-lo, não está a fazer nada de errado. Esta foi uma regressão conhecida que começou na v2.1.105 do Claude Code e persistiu até à v2.1.107, confirmada pelo próprio registo de alterações da Anthropic e por dezenas de relatórios de erros abertos no GitHub. O prompt de colagem ignorava a sua entrada porque o modo bracketed paste deixou de ser tratado corretamente depois de uma correção na v2.1.86 relativa ao mascaramento de tokens OAuth, e o impacto afetou simultaneamente o Terminal do macOS, o iTerm2, o Warp, o Windows Terminal, o PowerShell e o WSL2.

A boa notícia: a Anthropic lançou uma correção oficial na versão v2.1.108 do Claude Code, a 14 de abril de 2026. Atualizar para a versão mais recente resolve agora o problema de colagem para a maioria dos utilizadores. Neste guia, começamos por essa atualização, depois mostramos o caminho de reversão que nós próprios usámos antes de a correção chegar, além do fluxo de início de sessão manual oficial e das soluções específicas para cada plataforma em todos os terminais principais no macOS e no Windows. Partilhamos também exatamente o que aconteceu quando a nossa própria equipa se deparou com este erro, porque a internet está cheia de conselhos errados sobre este caso. Se é novo no ecossistema Claude, o nosso guia sobre Claude Mythos e o Projeto Glasswing é um bom complemento sobre o que a Anthropic está a construir a seguir.

Correção mais rápida: atualize o Claude Code para a v2.1.108 ou posterior. Execute npm install -g @anthropic-ai/claude-code@latest, reinicie o terminal e inicie sessão novamente.

Os principais pontos a reter

• O erro «não é possível colar o código de autenticação» do Claude Code é uma regressão de bracketed paste, não um problema de conta ou de área de transferência.
• O Claude Code v2.1.108 (14 de abril de 2026) traz a correção oficial. Atualize com npm install -g @anthropic-ai/claude-code@latest e o prompt de colagem volta a funcionar.
• O erro afetou as versões v2.1.105 a v2.1.107. Se atualizar não for uma opção, reverta para a v2.1.104, a última versão limpa antes da regressão.
• A alternativa manual é o fluxo c: pressione c no ecrã de início de sessão, abra o URL OAuth num navegador e cole de volta o código devolvido.
• Se nada disto funcionar, defina ANTHROPIC_API_KEY na sua shell e ignore completamente o OAuth.

Por que não é possível colar o código de autenticação no Claude Code

Quando executa claude ou /login, o Claude Code abre o navegador para uma aprovação OAuth da Anthropic e, depois, pede-lhe para colar no terminal o código de autenticação devolvido, no ecrã Paste code here if prompted >. Os terminais modernos envolvem o texto colado em sequências de escape especiais chamadas bracketed paste (ESC[200~ e ESC[201~). Na v2.1.105 do Claude Code, uma alteração na forma como a entrada mascarada era tratada quebrou o processamento dessas sequências, pelo que os códigos colados eram descartados silenciosamente enquanto os caracteres escritos continuavam a ser registados. A mesma falha voltou a acontecer na v2.1.107, e a Anthropic resolveu-a definitivamente na v2.1.108. O resultado, enquanto durou, foi um ecrã vazio que não aceitava o código, independentemente do número de vezes que premisse Ctrl+V, Cmd+V, Shift+Insert ou colasse através do clique direito.

Isto não é um problema de área de transferência, de VPN ou de conta. O seu código está bem. O Claude Code simplesmente não o está a ler. Este detalhe é importante porque a maioria dos guias mais antigos sobre este erro diz para «colar apenas o código, não o URL completo» ou «reiniciar o terminal» e, embora isso possa ajudar em casos excecionais, não resolve a regressão subjacente. Uma falha distinta da área de transferência afeta quem tenta dar ao Claude Code uma captura de ecrã em vez de um código de início de sessão, algo que o nosso guia sobre como colar imagens no Claude Code trata de forma independente.

Como nos deparámos com este erro (e o que realmente funcionou)

Deparámo-nos exatamente com este problema da primeira vez que instalámos o Claude Code numa máquina nova, e a correção não era óbvia. Eis o caminho que seguimos, para o caso de o seu ser parecido.

Primeiro, tentámos todos os métodos de colagem que nos ocorreram. Ctrl+V no Windows Terminal não fez nada. Shift+Insert também não fez nada. Colar com o clique direito também não fez nada. Cmd+V no macOS comportou-se da mesma forma. O ecrã ficava ali, a cintilar, como se a área de transferência estivesse vazia.

A seguir, perguntámos ao próprio Claude o que se estava a passar. Sugeriu os suspeitos habituais: reiniciar o terminal, verificar a área de transferência, experimentar outra shell. Nada mudou. Por isso, tentámos escrever o código manualmente, carácter a carácter, a partir do URL do navegador. O Claude Code aceitou a entrada e enviou-a para a Anthropic, que respondeu com um erro 401. Nesse momento ficou claro que o problema não era apenas a colagem; o código que estávamos a escrever estava a ser corrompido ou a expirar antes de chegar ao servidor.

Depois verificámos o status.anthropic.com para excluir uma indisponibilidade. Tudo estava verde. Sem incidentes. Por isso, fomos ao repositório de problemas do Claude Code no GitHub e pesquisámos, e em menos de um minuto encontrámos vários problemas abertos (#47669, #47745, #47799, #47887), todos a relatar a mesma falha de bracketed paste a partir da v2.1.105. Uma rápida verificação no Reddit confirmou-o; os utilizadores do r/ClaudeAI estavam a enfrentar o mesmo problema.

A correção que realmente funcionou para nós nessa altura foi reverter o Claude Code para a v2.1.104. O início de sessão funcionou à primeira tentativa depois disso. Uns dias mais tarde, a Anthropic lançou uma correção adequada na v2.1.108, por isso atualizar agora é o caminho mais limpo, mas a reversão continua a funcionar se precisar dela.

Correção 1: atualizar para o Claude Code v2.1.108 ou posterior (recomendado)

Esta é a correção que a Anthropic já lançou, e é a opção mais limpa se quiser manter-se numa versão suportada. A v2.1.108 (14 de abril de 2026) trata corretamente as sequências de escape do bracketed paste no ecrã /login, em todos os terminais que testámos.

Se instalou através do npm, execute:

npm install -g @anthropic-ai/claude-code@latest

Se instalou através do instalador nativo no macOS ou no Linux:

curl -fsSL https://claude.ai/install.sh | bash

No Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Depois de atualizar, reinicie o terminal, confirme a versão com claude --version, execute /logout se tinha uma sessão bloqueada e, depois, claude para iniciar uma nova sessão. A colagem deve funcionar à primeira tentativa.

Se a sua organização fixar o Claude Code numa versão mais antiga, ou se o erro persistir de alguma forma na sua máquina após a atualização, avance para a Correção 2.

Correção 2: reverter o Claude Code para a v2.1.104

Esta foi a correção que resolveu o problema para nós durante o período da regressão, e continua a funcionar se não conseguir atualizar para a v2.1.108 por qualquer motivo. A v2.1.104 é a última versão limpa antes do erro de bracketed paste.

Se instalou através do npm, execute:

npm install -g @anthropic-ai/[email protected]

Se instalou através do instalador nativo no macOS ou no Linux:

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.104

Depois de reverter, reinicie o terminal, execute /logout se tinha uma sessão bloqueada e, depois, claude para iniciar uma nova sessão. A colagem deve funcionar de imediato.

Correção 3: usar o fluxo de início de sessão manual oficial da Anthropic

Se preferir manter-se nesta versão, a documentação oficial de resolução de problemas do Claude Code da Anthropic descreve um fluxo manual que contorna o problema do campo de colagem. No ecrã de início de sessão do Claude Code, pressione a tecla c. Isto copia o URL OAuth completo para a área de transferência. Abra qualquer navegador, cole o URL, conclua o início de sessão da Anthropic e será redirecionado para uma página com o seu código.

Copie o código dessa página e volte ao terminal. A colagem deve funcionar aqui na maioria dos casos, porque o ecrã é diferente do campo de entrada danificado. Se ainda assim não funcionar, escreva o código manualmente, mas faça-o rapidamente, dentro de 60 segundos, antes de o código expirar e surgir a temida mensagem OAuth error: Invalid code. Please make sure the full code was copied.

Correção 4: desativar o bracketed paste no terminal

Se a regressão estiver no processamento do bracketed paste, desativar essa funcionalidade a nível do terminal contorna totalmente o erro.

No iTerm2 (macOS): abra Settings → Profiles → Terminal e desmarque «Applications in terminal may access clipboard» e qualquer opção relacionada com o bracketed paste. Uma alternativa da comunidade que também funciona é adicionar isto ao seu ~/.bashrc ou ~/.zshrc:

claude() { command claude "$@"; printf '\e[?2004l'; }

No Terminal.app do macOS: o bracketed paste é controlado pela shell, não pela aplicação. Execute bind 'set enable-bracketed-paste off' no bash, ou adicione set enable-bracketed-paste off ao ~/.inputrc.

No Windows Terminal: alguns utilizadores referem que "bracketedPaste": false no settings.json ajuda, embora os resultados sejam variáveis. Se não funcionar, recorra à Correção 1 ou à Correção 2.

No WSL2: a definição de bracketed paste está na shell do Linux, não no Windows. Utilize o mesmo truque do ~/.inputrc do Terminal do macOS.

Correção 5: ignorar o OAuth com uma chave de API

Se tiver uma conta na Anthropic Console, pode contornar totalmente o fluxo de início de sessão.

Obtenha uma chave de API em console.anthropic.com e, depois, exporte-a antes de executar o Claude Code:

export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude

No Windows PowerShell:

$env:ANTHROPIC_API_KEY = "sk-ant-your-key-here"
claude

O Claude Code deteta a chave e ignora o OAuth. Útil enquanto espera que o erro de colagem seja corrigido, ou se estiver numa máquina bloqueada onde os retornos do navegador estão de qualquer forma bloqueados. Note que a utilização da chave de API é faturada por token através da sua conta Console, separadamente de qualquer subscrição Pro ou Max, e, se estiver a ponderar se deve continuar com o Claude, o nosso resumo das melhores alternativas ao Claude Cowork é uma verificação rápida.

Correção 6: executar `claude doctor` e repor tudo

Se nada do que foi referido funcionar, a sua instalação está num estado estranho. Execute:

claude doctor

Este diagnóstico mostra o tipo de instalação, a versão e quaisquer erros de configuração. Se detetar problemas de autenticação, reponha completamente o Claude Code:

# macOS / Linux
rm ~/.claude.json
rm -rf ~/.claude/

No Windows:

Remove-Item $env:USERPROFILE\.claude.json -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force $env:USERPROFILE\.claude -ErrorAction SilentlyContinue

Reinstale a versão mais recente v2.1.108+ (ou reverta para a v2.1.104) e execute claude novamente.

Comportamento da colagem por terminal

A correção oficial já está disponível

A Anthropic lançou uma correção adequada no Claude Code v2.1.108 a 14 de abril de 2026, depois de duas tentativas anteriores na linha 2.1.105–2.1.107 não terem resolvido totalmente o tratamento do bracketed paste. Atualize com npm install -g @anthropic-ai/claude-code@latest, confirme com claude --version e teste o ecrã de colagem do /login no terminal da sua preferência. Se a colagem continuar a falhar, recorra à v2.1.104 através da Correção 2 ou ao fluxo manual c da Correção 3.

Se o Claude Code continuar a causar problemas e quiser comparar as suas opções antes de investir mais tempo, a comparação entre Muse Spark, ChatGPT, Claude e Gemini mostra onde cada modelo principal se destaca, e a análise entre Grok e ChatGPT é uma referência sólida se estiver a repensar totalmente o seu assistente de programação predefinido.

Conclusão

O erro «não é possível colar o código de autenticação» do Claude Code foi a regressão de bracketed paste das versões v2.1.105–v2.1.107, não um problema de área de transferência, de terminal ou de conta. Atualize para a v2.1.108 ou posterior e o ecrã de colagem volta a funcionar à primeira tentativa. Se não conseguir atualizar, a v2.1.104 continua a funcionar sem problemas, e o fluxo manual de cópia com c é uma alternativa fiável. Depois de voltar a entrar, o nosso guia sobre instruções de sistema de IA vai ajudá-lo a obter resultados visivelmente melhores já no primeiro prompt.

FAQ