Erros 401 e 403 no Claude Code: credenciais de autenticação inválidas, chave de API inválida, "Você não está conectado", host_not_allowed

As mensagens

API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"Invalid authentication credentials"}}
API Error: 401 invalid x-api-key
Invalid API key · Fix external API key
Not logged in · Please run /login
Login expired · Please run /login
API Error: 403 x-deny-reason: host_not_allowed
Error: Poll: Access denied (403): Account is no longer a member of the organization associated with this token.

Etapa 1: qual credencial está sendo enviada?

claude
/status                       # auth method, endpoint, model
echo $ANTHROPIC_API_KEY | cut -c1-12
echo $ANTHROPIC_BASE_URL
grep -n apiKeyHelper ~/.claude/settings.json

A precedência é simples quando você a conhece: uma ANTHROPIC_API_KEY no ambiente (ou o valor retornado por apiKeyHelper) é usada no lugar do login OAuth. Uma chave desatualizada exportada em .bashrc meses atrás, ou uma chave de outro gateway, é a causa clássica de um 401 que persiste após cada /login. Remova a variável ou defina a chave correta.

401 com uma chave de API: a chave e o endpoint não correspondem

invalid x-api-key e Invalid API key · Fix external API key significam que o endpoint não reconheceu a chave. Uma chave pertence a exatamente um endpoint: uma chave do console da Anthropic funciona apenas com api.anthropic.com; uma chave de gateway funciona apenas com o ANTHROPIC_BASE_URLdesse gateway. Enviar uma chave do console para https://aiprimetech.io ou uma chave de gateway para a Anthropic retorna 401 em ambos os casos. Verifique também se há uma quebra de linha ou aspas coladas no final da variável e se a chave não foi revogada ou substituída no painel.

curl -s https://aiprimetech.io/v1/models -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" | head -c 300
# a JSON list = key accepted; authentication_error = wrong key for this host

401 após /login: o token OAuth

API Error: 401 Invalid authentication credentials logo após um login bem-sucedido no navegador é o cenário mais relatado (#69706, aberto, Windows, assinatura Pro ativa; #44265, token indicado como expirado imediatamente após o login).

Uma pessoa que comentou na primeira discussão descobriu que o refreshToken armazenado era uma string vazia em ~/.claude/.credentials.json, o que faz toda solicitação retornar 401 até que o arquivo seja substituído por um novo login. #54443 documenta o servidor rejeitando sessões antes da expiração armazenada localmente e a chamada de renovação retornando 400, então Please run /login volta a cada poucas horas; executar várias instâncias do Claude Code na mesma conta piora a situação, pois elas competem para renovar o mesmo token. #44585: /login exibe *Login bem-sucedido* e volta imediatamente para *Sessão não iniciada*.

• /logout, depois exclua a credencial armazenada (~/.claude/.credentials.json no Linux e no Windows; o item *Claude Code-credentials* no Acesso às Chaves do macOS), depois /login em um navegador sem a extensão Claude in Chrome.
• Feche outras janelas do Claude Code, o aplicativo para desktop e as extensões de IDE antes de fazer login; eles renovam o mesmo token. A página sobre erros de OAuth aborda *Falha ao renovar o token OAuth: outro processo do Claude Code está renovando-o*.
• claude update: #54235 associou um 401 a uma versão específica e a uma variável de ambiente de sinalização beta; regressões de autenticação são corrigidas rapidamente.
• Máquina sem interface gráfica ou acessada por SSH: claude setup-token em uma máquina onde o login pelo navegador funciona, depois use o token na máquina de destino.
• Voltar a trabalhar é melhor do que depurar: com ANTHROPIC_API_KEY definida, o Claude Code nunca usa OAuth.

403: permissão para autenticar, mas não para fazer isso

• `x-deny-reason: host_not_allowed` — um proxy no caminho da solicitação recusa o destino. Observado na lista de permissões de saída do sandbox web/desktop (#93562, aberto: hosts fora de uma lista integrada recebem 403 em CONNECT mesmo com *Todos os domínios* selecionado) e em proxies corporativos. Adicione o host à lista de permissões ou execute a CLI fora do sandbox.
• 403 do proxy git do sandbox em git push para uma branch existente (#57356) — é a política do proxy git do sandbox, não o GitHub. Faça o push a partir de um terminal normal.
• `Account is no longer a member of the organization associated with this token` — o token foi emitido para uma organização da qual você saiu ou que mudou; claude remote-control costumava fazer todas as sessões falharem nesse caso (#53563). Saia da conta e entre novamente para gerar um token para a organização atual.
• 403 de um gateway — a chave é válida, mas a conta está desativada, não tem saldo para esse modelo ou o modelo não está incluído no seu plano; o corpo da resposta indica o motivo. Verifique o painel antes de alterar qualquer coisa no cliente.
• `/feedback` retornando 403 (#55348) — uma indisponibilidade no serviço desse endpoint específico; ela não afeta o modelo.

A alternativa com chave de API

unset ANTHROPIC_API_KEY ANTHROPIC_BASE_URL   # back to the subscription login
# or: bypass OAuth entirely
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

Uma chave de gateway é uma chave de API comum: sem OAuth, sem renovação de token, sem vínculo com uma organização, e a família 401 se resume a *a chave corresponde ao host?*. Se você está preso em um /login ciclo e precisa entregar hoje, essa é a saída mais rápida; sua primeira recarga com criptomoedas é dobrada (+50%).

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Perguntas frequentes

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.