Source: https://aiprimetech.io/pt/claude-code/errors/auth-401-403/

[Início](/pt/) › [Claude Code](/pt/claude-code/) › [Erros](/pt/claude-code/errors/) › autenticação 401 / 403

[Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/claude-code/zh/)

Última atualização: 11 de outubro de 2026

# 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

401 significa que a credencial enviada pelo Claude Code não foi aceita; 403 significa que ela foi aceita, mas a solicitação não foi permitida. Quase todos os relatos de 401 no rastreador se resumem a *qual* credencial foi enviada, pois o Claude Code pode manter três ao mesmo tempo: um login OAuth, uma ANTHROPIC_API_KEY no ambiente e uma apiKeyHelper nas configurações. Comece descobrindo qual delas está ativa.

## TLDR
- /status mostra o método de autenticação e o endpoint ativos. Uma chave de API no ambiente sempre tem precedência sobre /login.
- invalid x-api-key / Invalid API key · Fix external API key — a chave não pertence ao endpoint em ANTHROPIC_BASE_URL.
- 401 Invalid authentication credentials após /login — o token OAuth foi revogado ou renovado incorretamente; saia da conta, remova a credencial armazenada e entre novamente.
- 403 — um proxy, uma regra de saída do sandbox ou o vínculo com a organização bloqueou a solicitação; a credencial está correta.

## 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](https://github.com/anthropics/claude-code/issues/69706), aberto, Windows, assinatura Pro ativa; [#44265](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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](/pt/claude-code/errors/oauth-error/) aborda *Falha ao renovar o token OAuth: outro processo do Claude Code está renovando-o*.
- claude update: [#54235](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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%).

## Cansado de lidar com esse problema?

Execute o Claude Code pelo gateway da AI Prime Tech: os mesmos modelos Claude nas contas upstream do próprio gateway, duas variáveis de ambiente para fazer a mudança, e novas contas recebem $5 em crédito gratuito para a API com o código FIXIT — sem cartão.

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

[Crie uma conta com o código FIXIT](/register?promo=FIXIT)

## Perguntas frequentes

Como corrigir 'Erro de API: 401 Credenciais de autenticação inválidas' no Claude Code?

Verifique /status para identificar a credencial ativa. Remova a definição de um ANTHROPIC_API_KEY desatualizado ou execute /logout, exclua ~/.claude/.credentials.json (Chaves no macOS) e execute /login novamente com as outras instâncias do Claude Code fechadas. Como alternativa, uma chave de API dispensa completamente o OAuth.Por que o Claude Code diz que a chave de API é inválida?

A chave não pertence ao endpoint em ANTHROPIC_BASE_URL. Uma chave do console exige api.anthropic.com; uma chave de gateway exige a URL desse gateway. Verifique também se há espaços em branco colados e se a chave foi revogada.Por que o Claude Code continua pedindo para eu executar /login?

O token OAuth está sendo rejeitado antes de sua expiração local ou a renovação falha, muitas vezes porque vários processos do Claude Code compartilham um token. Feche os outros, saia, limpe a credencial armazenada, entre novamente e atualize a CLI.O que significa 403 x-deny-reason: host_not_allowed?

Um proxy (a lista de permissões de saída do sandbox ou um proxy corporativo) recusou o host de destino. Suas credenciais estão corretas; permita o host ou execute fora do sandbox.

## Execute o Claude Code no gateway

Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código FIXIT.[Obter uma chave de API](/register?promo=FIXIT) [Ver planos ilimitados](/pt/plans/)

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.

## Mais guias do Claude Code

[Erros do Claude Code e como corrigi-los](/pt/claude-code/errors/)["Erro de API: 500" no Claude Code: o que significa e o que realmente resolve](/pt/claude-code/errors/api-error-500/)[Erro "Sobrecarregado" no Claude (erro 529 de API): o que significa e o que fazer](/pt/claude-code/errors/overloaded-529/)[Erro 400 da API do Claude Code: prompt longo demais, concorrência no uso de ferramentas e os demais](/pt/claude-code/errors/api-error-400/)[Erros de OAuth no Claude Code: tempo limite de 15000ms excedido e código de status 500](/pt/claude-code/errors/oauth-error/)["O processo do Claude Code foi encerrado com o código 1": como encontrar o erro real e corrigi-lo](/pt/claude-code/errors/process-exited-code-1/)["O prompt é longo demais", "A entrada é longa demais para o modelo solicitado" e "Limite de contexto atingido" no Claude: o que preenche a janela e como liberar espaço](/pt/claude-code/errors/prompt-too-long/)[Limite de uso do Claude atingido: limites de sessão, semanais e do Opus, "limites especificados de uso da API", "o saldo de créditos é insuficiente" — e o que fazer](/pt/claude-code/errors/usage-limit-reached/)[Erros de conexão no Claude Code: ECONNRESET, conexão perdida durante a resposta, "Aguardando resposta da API", "Não foi possível conectar à API", erros de certificado SSL](/pt/claude-code/errors/connection-lost/)[O Claude Code trava, fica preso ou para de responder: como descobrir onde travou e sair dessa situação](/pt/claude-code/errors/claude-code-hangs/)[Claude.ai não funciona: "Algo deu errado", restrições de capacidade, "limite de 5 horas atingido", "erro ao fazer login" e os demais](/pt/claude-code/errors/claude-ai-not-working/)