Não consegue iniciar sessão no Claude Code? Como corrigir «Invalid code» e os erros ao colar no Mac e no Windows

O Claude Code não inicia sessão? A causa é quase sempre uma de quatro: um código de início de sessão que expirou ou foi copiado só em parte, um terminal que não cola nada no campo do código, um navegador que abriu noutro computador ou uma credencial antiga que se sobrepõe à sua sessão. A mensagem mais comum é OAuth error: Invalid code. Please make sure the full code was copied, e a própria documentação da Anthropic diz que significa que o código expirou ou ficou truncado. Se colar não fizer nada, a alternativa documentada é claude auth login, que lê o código a partir da entrada padrão em vez do campo interativo. Este guia foi verificado com o Claude Code v2.1.296, a versão mais recente a 12/10/2026.

Esta página nasceu para resolver um único erro: em abril de 2026, o Claude Code v2.1.105 estragou a colagem no campo do código do /login, e a v2.1.108 corrigiu-o logo no dia seguinte. Deparámo-nos com esse erro nós próprios, e a nossa história está mais abaixo. Desde então, a Anthropic lançou dezenas de pequenas correções de início de sessão, por isso os conselhos abaixo começam pelo que falha hoje e mantêm o erro de abril como histórico. Se está a começar no ecossistema Claude, o nosso guia sobre Claude Mythos e Project Glasswing é um bom complemento sobre o que a Anthropic está a construir a seguir.

Solução mais rápida: execute claude update, depois claude auth login, abra a ligação que aparece e cole no terminal o código completo da página do navegador, incluindo o # e tudo o que vem depois.

O essencial

• «OAuth error: Invalid code» significa que o código de início de sessão expirou ou ficou cortado ao copiá-lo. Prima Enter para tentar de novo e cole logo o novo código.
• Se colar no campo não fizer nada, execute claude auth login. A Anthropic documenta-o como a alternativa para qualquer terminal em que a colagem não chega ao campo.
• Por SSH, no WSL2 ou num contentor, o navegador abre noutro computador. Prima c para copiar o URL de início de sessão e abra-o no seu navegador local.
• Uma ANTHROPIC_API_KEY esquecida no seu perfil da shell sobrepõe-se à sua sessão Pro ou Max assim que a aprovar.
• O erro de colagem de abril de 2026 existiu da v2.1.105 à v2.1.107 e foi corrigido na v2.1.108. Hoje não volte à v2.1.104: atualize.

O Claude Code não inicia sessão? Encontre o seu erro

Encontre a linha que corresponde ao que vê no ecrã e passe para a solução. Todas as causas e soluções desta tabela vêm da documentação oficial de resolução de problemas do Claude Code ou do registo de alterações do Claude Code.

Solução 1: atualize o Claude Code para a versão mais recente

Atualizar corrige mais falhas de início de sessão do Claude Code do que qualquer outro passo, porque a Anthropic continua a lançar correções. Desde o erro de abril, o registo de alterações do Claude Code inclui correções para o URL de início de sessão que abria cortado no Windows Terminal quando mudava de linha (v2.1.191), para o URL que perdia caracteres ao ser copiado em ecrã inteiro (v2.1.234), para o atalho c por SSH (v2.1.243) e para o /login, que no Mac indicava sucesso apesar de o porta-chaves ter recusado o novo início de sessão (v2.1.290).

Se usou o instalador nativo, execute:

claude update

Se instalou com o npm, a Anthropic indica que deve atualizar assim e evitar o npm update -g, que pode não levar à versão mais recente:

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

Para reinstalar do zero, o instalador nativo é curl -fsSL https://claude.ai/install.sh | bash no macOS e no Linux, e este 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 uma sessão tiver ficado presa e depois claude para iniciar sessão de novo. As instalações via Homebrew e WinGet não se atualizam sozinhas, por isso use brew upgrade claude-code ou winget upgrade Anthropic.ClaudeCode.

Se alguma versão nova voltar a estragar o início de sessão, mude para o canal stable. A Anthropic descreve-o como uma versão com cerca de uma semana que salta as versões com regressões graves, precisamente o tipo de erro que foi o de abril.

Solução 2: cole o código no claude auth login

O claude auth login é a alternativa oficial quando colar no campo interativo de início de sessão não faz nada. Lê o código colado a partir da entrada padrão, por isso não depende da forma como o seu terminal entrega a colagem ao campo do Claude Code. Segundo a Anthropic, aplica-se ao WSL2, SSH, contentores, Windows nativo e a «qualquer terminal em que colar no campo interativo falhe».

claude auth login

Abra o URL que aparece, inicie sessão, copie o código da página do navegador, cole-o no terminal e prima Enter. Antes de mudar de comando, experimente o atalho de colar alternativo do seu terminal: no Windows Terminal costuma ser o botão direito ou Shift+Insert. Para confirmar que a sessão ficou iniciada, execute claude auth status --text.

Repare que claude login sozinho não é um comando do Claude Code. Os comandos são /login dentro de uma sessão e claude auth login a partir da shell.

Como corrigir «OAuth error: Invalid code»

«OAuth error: Invalid code. Please make sure the full code was copied» significa que o código de início de sessão expirou ou ficou truncado ao copiar e colar. É a explicação da própria Anthropic. Verifique estes pontos por ordem:

1. Recomece sem perder tempo. Prima Enter para tentar de novo, conclua o início de sessão assim que o navegador abrir e cole logo o código novo. Os códigos duram pouco, por isso um código de uma tentativa anterior pode já ter expirado.
2. Copie o código inteiro, incluindo o #. Um utilizador que analisou o erro no GitHub (issue #91157) descobriu que o código tem duas partes unidas por um # e que o Claude Code rejeita qualquer colagem sem o # e texto dos dois lados. Um duplo clique para a seleção no #, por isso arraste o rato sobre a linha inteira.
3. Abra o URL no computador certo. Numa sessão SSH, o navegador pode abrir no computador remoto. Copie o URL do terminal e abra-o no seu navegador local.
4. Não escreva o código à mão. É longo, e um único carácter errado ou escrever devagar provoca o mesmo erro.

Se o erro continuar a aparecer na versão mais recente, use o claude auth login da solução 2 para que o código chegue inteiro. Em outubro de 2026, ainda há utilizadores a reportar «Invalid code» no GitHub em ambientes específicos como o GitHub Codespaces (issue #91176), por isso procure o seu ambiente no registo de issues do Claude Code no GitHub antes de perder uma hora com isto.

Solução 3: o início de sessão falha por SSH, no WSL2 ou num contentor

Por SSH, no WSL2 ou dentro de um contentor, o navegador costuma abrir noutro anfitrião, e o redirecionamento não chega ao callback local do Claude Code. Depois de iniciar sessão, o navegador mostra um código em vez de redirecionar automaticamente. Cole esse código no terminal, no campo Paste code here if prompted.

Se não abrir nenhum navegador: prima c no campo de início de sessão para copiar o URL de OAuth completo e cole-o num navegador. Também funciona quando o URL muda de linha num terminal estreito e não dá para clicar. Desde a v2.1.243, premir c por SSH diz-lhe como o URL foi copiado em vez de anunciar sempre sucesso.

Se o WSL2 não encontrar o seu navegador: aponte a variável BROWSER para o seu navegador do Windows antes de iniciar o Claude Code.

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

Se o terminal ficar em «Waiting for authentication…»: o callback de localhost está bloqueado, o que segundo o centro de ajuda da Anthropic é comum por SSH, em devcontainers e atrás de firewalls restritas. Copie o URL, conclua o início de sessão em qualquer navegador e cole no terminal o código devolvido.

Solução 4: contorne o OAuth com uma chave de API ou um token de longa duração

Uma chave de API da Anthropic Console permite ao Claude Code saltar por completo o início de sessão no navegador. Crie uma chave na Claude Console e 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 pede-lhe uma vez que aprove a chave e depois usa-a. A utilização da chave de API é cobrada por token através da sua conta da Console, à parte de qualquer subscrição Pro ou Max, e se está a pensar se vale a pena continuar com o Claude, a nossa seleção das melhores alternativas ao Claude Cowork ajuda a decidir depressa.

A armadilha da chave de API esquecida

Uma ANTHROPIC_API_KEY aprovada tem prioridade sobre a sua sessão Pro ou Max. Se uma chave antiga de outro emprego ou projeto ainda estiver em ~/.zshrc, ~/.bashrc ou ~/.profile, o Claude Code pode falhar com This organization has been disabled mesmo com a subscrição ativa. Execute unset ANTHROPIC_API_KEY (ou Remove-Item Env:ANTHROPIC_API_KEY no PowerShell), apague a linha do seu perfil e execute /status dentro do Claude Code para confirmar que sessão está ativa.

Para pipelines de CI e servidores sem navegador, o claude setup-token gera um token de OAuth válido durante um ano e ligado à sua subscrição do Claude. Defina-o como CLAUDE_CODE_OAUTH_TOKEN. Retire essa variável do seu perfil quando deixar de precisar dela, porque o Claude Code volta a lê-la em cada nova sessão.

Solução 5: reponha o início de sessão em segurança

Uma nova autenticação limpa resolve a maioria das falhas de início de sessão sem causa clara. A reposição da Anthropic tem três passos: executar /logout, fechar o Claude Code e voltar a abri-lo com claude para iniciar sessão. Se o claude nem sequer arrancar, execute isto a partir da shell para obter um relatório de diagnóstico:

claude doctor

Não apague ~/.claude/ para «repor» o início de sessão. Essa pasta guarda as suas definições, a memória e o histórico de sessões, e no Mac o seu início de sessão normalmente nem sequer está lá: o Claude Code guarda-o no porta-chaves de início de sessão.

Quando o problema é o porta-chaves do Mac

Se o porta-chaves estiver bloqueado, o que é comum numa sessão SSH, ou se a palavra-passe dele não coincidir com a da sua conta, o Claude Code recorre a um ficheiro de texto simples, ~/.claude/.credentials.json. O claude doctor mostra então um aviso que começa por macOS Keychain is not writable. Desbloqueie o porta-chaves:

security unlock-keychain ~/Library/Keychains/login.keychain-db

Se o aviso continuar, abra o Acesso a Porta-chaves, selecione o porta-chaves login e sincronize a palavra-passe com Edit > Change Password for Keychain “login” (num Mac em português, o menu aparece traduzido). Depois execute /logout e /login para devolver o seu início de sessão ao porta-chaves cifrado. Terminar a sessão também remove os inícios de sessão guardados dos servidores MCP, por isso terá de os autorizar de novo.

O erro de colagem de abril de 2026

De 13 a 14 de abril de 2026, o Claude Code descartou sem aviso qualquer código colado no campo do /login, embora continuasse a aceitar o que se escrevia. A v2.1.105 foi publicada no npm a 13 de abril às 19:51 UTC, e a v2.1.108 chegou no dia seguinte às 18:35 UTC com esta linha no registo de alterações: «Fixed paste not working in the /login code prompt (regression in 2.1.105)». Os relatórios no GitHub apontavam para as sequências de colagem entre parênteses (bracketed paste) do terminal, que envolvem cada colagem e que o campo engolia.

Não era um problema da área de transferência, da VPN nem da conta, e reiniciar o terminal não adiantava. Outra peculiaridade da área de transferência apanha quem quer dar ao Claude Code uma captura de ecrã em vez de um código, e é disso que trata o nosso guia sobre como colar imagens no Claude Code.

Como demos com o erro (e o que resultou de facto)

Demos com o erro da primeira vez que instalámos o Claude Code num computador acabado de configurar. Ctrl+V no Windows Terminal não fazia nada. Shift+Insert e colar com o botão direito também não. Cmd+V no Mac comportava-se da mesma maneira. O campo continuava a piscar, como se a área de transferência estivesse vazia.

Perguntámos ao próprio Claude o que se passava, e sugeriu os suspeitos do costume: reiniciar o terminal, verificar a área de transferência, experimentar outra shell. Nada resultou. Escrito à mão, o código foi aceite, mas a Anthropic respondeu com um erro 401, porque um código longo escrito carácter a carácter é fácil de errar ou de deixar expirar.

Fomos a status.anthropic.com para excluir uma falha de serviço. Estava tudo verde. No registo de issues do Claude Code no GitHub encontrámos vários relatórios abertos com poucas horas de diferença (#47669, #47745, #47799, #47887), todos com a mesma falha a partir da v2.1.105, e no r/ClaudeAI havia quem batesse na mesma parede.

O que resultou para nós nesse dia foi voltar à v2.1.104, a última versão antes do erro. O início de sessão funcionou à primeira. A Anthropic lançou a correção a sério na v2.1.108 no dia seguinte.

Ainda vale a pena voltar a uma versão anterior?

Não. A v2.1.104 tem seis meses e não inclui nenhuma das correções de início de sessão da solução 1, por isso voltar a ela hoje troca um erro por vários. Se precisar mesmo de fixar uma versão, o instalador nativo aceita um número de versão, como curl -fsSL https://claude.ai/install.sh | bash -s 2.1.104, mas o canal stable da solução 1 é a forma mais segura de evitar uma nova regressão.

Se o Claude Code continuar a dar problemas e só precisar de perguntar algo ao Claude enquanto o terminal está bloqueado, o Fello AI junta o Claude, o GPT e o Gemini numa única janela de chat no seu Mac, e o seu trabalho não fica à espera de um campo de início de sessão. Para comparar opções antes de investir mais tempo, a comparação Muse Spark vs ChatGPT vs Claude vs Gemini mostra onde ganha cada modelo, e a análise Grok vs ChatGPT é uma boa referência se estiver a repensar o seu assistente de programação predefinido.

Conclusão

Em 2026, os problemas de início de sessão do Claude Code resumem-se a uma lista curta. «OAuth error: Invalid code» significa que o código expirou ou não foi copiado inteiro: tente de novo e cole o código completo, com o # incluído. Um colar que não faz nada resolve-se com claude auth login. As sessões remotas e no WSL2 precisam de abrir o URL no seu próprio computador, e uma chave de API esquecida ou um porta-chaves do Mac bloqueado explicam o resto. Atualize primeiro, porque a maioria destas falhas tem correção numa versão mais recente. Quando voltar a entrar, o nosso guia de instruções de sistema para IA ajuda a obter resultados bem melhores logo no primeiro prompt.

Perguntas frequentes