“claude.ai connectors are disabled because ANTHROPIC_API_KEY or another auth source is set and takes precedence” é um aviso de que o Claude Code não carregou nesta sessão os conectores que você adicionou no claude.ai. A causa é que uma credencial, como a variável de ambiente ANTHROPIC_API_KEY, tem prioridade sobre o login do claude.ai que está salvo. O Claude Code em si não para, mas, se uma chave de API está em uso, o custo não sai da cota da sua assinatura: vai como cobrança por uso para a organização dona dessa chave.

claude.ai connectors are disabled because ANTHROPIC_API_KEY or another auth source is set and takes precedence over your claude.ai login · Unset it to load your organization's connectors

O trecho final “· Unset it to load your organization's connectors” faz parte do mesmo aviso. O que fazer depende de você querer ou não usar os conectores.

A primeira decisão: com qual credencial você quer trabalhar

O caminho muda se você remove a chave ou a mantém

Você não lembra de ter configurado uma chave de API
Uma chave antiga pode ter ficado na configuração do shell ou em um .env
→ Descobrir de onde ela vem
Confira com /status e nas variáveis de ambiente
Você quer os conectores (quer usar a assinatura)
Faça o login do claude.ai voltar a ser a credencial ativa
→ Remover a chave e reiniciar
O login não sumiu; continua salvo
Você usa a chave sabendo que é cobrança da API
Tudo funciona normalmente. Só os conectores ficam indisponíveis
→ O que se perde e as alternativas
Servidores MCP locais continuam funcionando
Diagrama para escolher o que verificar conforme a situação, com base na documentação oficial de autenticação e de MCP.

1. O que este aviso está dizendo

Dividindo o texto do aviso em partes, ele diz o seguinte.

Seu login não sumiu. Só não está sendo usado

claude.ai connectors are disabled
Os conectores adicionados no claude.ai não foram carregados nesta sessão
because ANTHROPIC_API_KEY or another auth source is set
Há uma chave de API, ou outra credencial, configurada
and takes precedence over your claude.ai login
Essa credencial está acima do login do claude.ai na ordem de prioridade
Unset it to load your organization's connectors
Se você a remover, os conectores da sua organização (os adicionados no claude.ai) serão carregados
O texto do aviso foi conferido na string contida no próprio Claude Code v2.1.275, e em 26 de setembro de 2026 confirmamos que a v2.1.281 usa o mesmo texto.

O que são os conectores do claude.ai

Segundo a documentação oficial de MCP do Claude Code, os servidores MCP (conectores) adicionados na tela de configuração de conectores do claude.ai ficam disponíveis automaticamente no Claude Code, desde que você esteja logado no Claude Code com sua conta do claude.ai. Ao abrir /mcp, eles aparecem na lista com uma marca indicando que vêm do claude.ai. Nos planos Team e Enterprise, só administradores podem adicionar conectores no claude.ai. No CHANGELOG oficial, esse recurso aparece na entrada da v2.1.46 como “possibilidade de usar os conectores MCP do claude.ai no Claude Code” (não há registro de publicação com esse número no npm; as versões anterior e seguinte foram publicadas em 17 e 18 de fevereiro de 2026).

O que chega por esse mecanismo são os conectores que o próprio Claude Code busca no claude.ai, em sessões no terminal, no VS Code, no JetBrains e no Agent SDK. Nas sessões na nuvem quem entrega os conectores é o host, e nas sessões locais e SSH do aplicativo de desktop do Claude é o aplicativo, então o caminho é outro. Segundo a documentação oficial de autenticação, o aplicativo de desktop e as sessões na nuvem não usam ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN nem apiKeyHelper, exceto as sessões de desktop configuradas com inferência de terceiros. Na prática, você vai encontrar este aviso ao iniciar claude no terminal ou em uma IDE.

Um aviso, não um erro

Mesmo com essa mensagem, o Claude Code não para. As requisições ao modelo continuam com a credencial que teve prioridade, e os servidores MCP configurados localmente (os adicionados via .mcp.json ou claude mcp add) continuam funcionando. O que falta são apenas os conectores do claude.ai: os itens do claude.ai não aparecem na lista de /mcp.

Desde quando funciona assim

O CHANGELOG da v2.1.139 (publicada no npm em 11 de maio de 2026, UTC) diz que, quando ANTHROPIC_API_KEY, apiKeyHelper ou ANTHROPIC_AUTH_TOKEN estão definidos, o Remote Control, o /schedule, os conectores MCP do claude.ai e as configurações de notificação ficam desativados mesmo com um login do claude.ai, e que é preciso remover a chave de API para usá-los. Por outro lado, o CHANGELOG não informa em qual versão este texto de aviso foi adicionado. A referência oficial de erros, em 26 de setembro de 2026, também não tem uma entrada para essa mensagem.

2. Por que uma chave de API desliga os conectores: a prioridade de autenticação

Quando há várias credenciais, o Claude Code escolhe só uma, na ordem descrita na documentação oficial de autenticação. O login da assinatura salvo com /login é o 7º, ou seja, o último. Se qualquer um dos seis acima estiver ativo, o login continua salvo, mas não é usado.

Só a última da lista consegue buscar os conectores

1
Provedor de nuvem
Quando CLAUDE_CODE_USE_BEDROCK ou similar está definido
Conectores ×
2
ANTHROPIC_AUTH_TOKEN
Token Bearer para gateways de LLM e proxies
Conectores ×
3
ANTHROPIC_API_KEY
Chave de API do Claude Console. No modo interativo, só se você a aprovou
Conectores ×
4
apiKeyHelper
Script definido no arquivo de configurações que devolve uma chave
Conectores ×
5
CLAUDE_CODE_OAUTH_TOKEN
Token de longa duração criado com claude setup-token. Só serve para requisições ao modelo
Conectores ×
6
Perfis e federação da Anthropic
ANTHROPIC_PROFILE, variáveis de federação etc.
Conectores ×
7
Login da assinatura salvo com /login
A autenticação padrão dos planos Pro, Max, Team e Enterprise
Conectores ○
Fonte: documentação oficial de autenticação do Claude Code (“Authentication precedence”) e documentação de MCP. No item 6, um perfil ativo que não foi indicado por ANTHROPIC_PROFILE pode ficar abaixo do login, dependendo do método de autenticação.

A documentação oficial de MCP também diz que os conectores do claude.ai só são buscados “quando o método de autenticação ativo é o login de uma assinatura do claude.ai”, e lista como condições em que eles não são carregados, mesmo que você já tenha feito /login, as credenciais que correspondem aos itens 1 a 6 do diagrama acima. Como remover cada uma está na seção 4.

O importante é que o login não sumiu. A credencial continua salva e só não é usada por causa da ordem de prioridade; ao remover a credencial de cima, o login salvo volta a ser usado. A documentação oficial não explica por que os conectores também são desligados mesmo havendo um login.

No modo interativo, só a chave que você aprovou tem prioridade

No modo interativo, a primeira vez que ANTHROPIC_API_KEY é encontrada, o Claude Code pergunta uma única vez se deve usá-la, e a resposta fica memorizada. Uma chave recusada não é usada. Ou seja, se este aviso aparece no modo interativo, ou você aprovou a chave em algum momento, ou há outra credencial de prioridade mais alta definida (ANTHROPIC_AUTH_TOKEN, apiKeyHelper etc.). No modo não interativo (-p), ANTHROPIC_API_KEY é sempre usada se estiver definida. Outros erros que acontecem quando uma chave de API se sobrepõe à assinatura (This organization has been disabled, Invalid API key etc.) estão reunidos no artigo sobre erros de autenticação e login do Claude Code (Not logged in / Invalid API key).

3. Veja qual credencial está em uso

O primeiro lugar para olhar é /status. Segundo a documentação oficial de autenticação, quando há um login e uma chave de API, o lado que não está em uso recebe uma marca. No CHANGELOG, essa exibição foi corrigida na v2.1.260 (publicada no npm em 3 de setembro de 2026, UTC); antes disso, as duas apareciam como se ambas estivessem ativas.

Auth token: claude.ai · not in use
API key: ANTHROPIC_API_KEY

Se estiver assim, a chave de API está em uso e o login do claude.ai não. Ao contrário, se a linha API key tiver · not in use, é o login que está em uso. Este exemplo foi montado a partir dos nomes de campo contidos no Claude Code v2.1.275; na prática também aparecem linhas como Login method, Organization e Email. A documentação oficial diz que, quando um perfil está em uso, aparece uma linha Profile no lugar de Login method.

Procure as variáveis de ambiente

Se a linha API key aparece e você não reconhece a chave, verifique as variáveis de ambiente no mesmo shell em que iniciou o claude. Os comandos indicados pela referência oficial de erros são estes.

# macOS, Linux
env | grep ANTHROPIC

# Windows (PowerShell)
Get-ChildItem Env:ANTHROPIC*

Há variáveis que esses comandos não mostram: CLAUDE_CODE_OAUTH_TOKEN e as variáveis de provedores de nuvem que começam com CLAUDE_CODE_USE_, como CLAUDE_CODE_USE_BEDROCK. Verifique da mesma forma se existe alguma variável que corresponda aos itens 1 a 6 do diagrama da seção 2.

De onde a chave pode vir

Se você faz unset no shell e a chave reaparece no próximo shell que abre, ela está sendo carregada em algum lugar toda vez. A documentação oficial cita estas cinco origens.

Arquivos de configuração do shell

Uma linha export ANTHROPIC_API_KEY=... em ~/.zshrc, ~/.bashrc ou ~/.profile. Às vezes sobra a chave de um emprego anterior ou de outro projeto

Configurações do Windows

O perfil do PowerShell ($PROFILE) e as variáveis de ambiente do usuário

O .env do projeto

direnv, plugins de dotenv para o shell e o terminal da IDE podem carregar uma chave antiga do .env do projeto. Ela entra mesmo que você não lembre de tê-la configurado

env nos arquivos de configurações

O env dos arquivos de configurações do Claude Code passa variáveis de ambiente para todas as sessões. Mesmo que não esteja no shell, se estiver aqui, vale

apiKeyHelper nos arquivos de configurações

Configuração de um comando que devolve a chave. Pode estar em qualquer arquivo de configurações. Enquanto existir, tem prioridade sobre o login salvo, mesmo depois de um /login

Os arquivos de configurações do Claude Code ficam em quatro lugares: ~/.claude/settings.json (todos os seus projetos), .claude/settings.json (compartilhado no projeto), .claude/settings.local.json (só você, só neste projeto) e as configurações gerenciadas distribuídas pela organização. A linha Setting sources na aba Status de /status mostra quais arquivos de configurações esta sessão carregou. Mas ela não diz de qual arquivo veio cada chave, então abra os arquivos suspeitos e procure env e apiKeyHelper.

4. Como fazer os conectores funcionarem

Estes são os passos para rodar o Claude Code com o login da assinatura e fazer ele carregar os conectores do claude.ai. Outras ferramentas ou scripts seus podem usar a mesma ANTHROPIC_API_KEY, então confira para que ela serve antes de apagá-la.

01

Remova a chave na origem

Apague a linha correspondente no lugar que você encontrou na seção 3: a linha export em um arquivo de configuração do shell, a linha da chave em um .env, ou a variável dentro de env ou o apiKeyHelper em um arquivo de configurações do Claude Code. Se você não corrigir isso, a chave volta a ser carregada no próximo shell que abrir.

02

Remova também do shell aberto agora

Mesmo corrigindo o arquivo, a variável continua no shell que já está aberto. No macOS e no Linux, unset ANTHROPIC_API_KEY; no PowerShell, Remove-Item Env:ANTHROPIC_API_KEY. Abrir um shell novo tem o mesmo efeito.

03

Reinicie o Claude Code

Uma sessão em andamento continua com a credencial com que foi iniciada. Os passos oficiais de solução de problemas também mandam reiniciar o claude depois de remover a chave. A lista de conectores também é buscada no início da sessão, então reinicie antes de seguir para o próximo passo.

04

Confira em /status e, se preciso, faça /login

Veja se a linha API key sumiu ou passou a mostrar · not in use. Se o login salvo estiver expirado, a linha Login mostra Expired — log in again. Nesse caso, ou se você estiver em uma conta diferente daquela em que registrou os conectores, escolha de novo sua conta do claude.ai com /login.

05

Confira os conectores em /mcp

Abra /mcp. Se os conectores aparecerem sob o título do claude.ai, está resolvido. A seção 5 detalha como conferir.

# Remover do shell aberto agora (macOS, Linux)
unset ANTHROPIC_API_KEY

# Remover do shell aberto agora (Windows PowerShell)
Remove-Item Env:ANTHROPIC_API_KEY

# Reiniciar e conferir na caixa de entrada do Claude Code
claude
/status
/mcp

Manter a chave, mas voltar ao login só no modo interativo

Se por algum motivo você não quer apagar a variável de ambiente, dá para mudar só o modo interativo para não usar a chave. Segundo a documentação oficial de autenticação, a aprovação da chave no modo interativo pode ser alterada depois pela opção “Use custom API key” em /config. Essa opção só aparece enquanto ANTHROPIC_API_KEY estiver no ambiente. Depois de desligá-la, reinicie o Claude Code e confira /mcp. No modo não interativo com -p, porém, a chave é sempre usada se estiver definida, então esse método não funciona.

Quando algo além da chave de API tem prioridade

  • ANTHROPIC_AUTH_TOKEN: é um token para passar por um gateway de LLM ou proxy. Se você vai continuar usando o gateway, considere que os conectores não estarão disponíveis. Se não precisa dele, remova a variável
  • apiKeyHelper: a referência oficial de erros diz que, enquanto essa configuração existir, /login não resolve. Apague-a do arquivo de configurações e depois faça /login
  • CLAUDE_CODE_OAUTH_TOKEN: se você fizer /login com ela definida, aquela sessão passa para o novo login. Mas, até você apagar a variável da configuração do shell ou do env do arquivo de configurações, ela volta a ser carregada a cada nova sessão
  • Perfis e federação: remova ANTHROPIC_PROFILE ou as variáveis de federação. Um perfil ativo pode ser removido com /logout, se foi gravado ao entrar no Console sem criar uma chave, ou com ant auth logout, se foi gravado por ant auth login. Em ambos os casos, também dá para apagar o arquivo do perfil
  • Provedores de nuvem: remova CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX e CLAUDE_CODE_USE_FOUNDRY. Se a política da empresa é usar um provedor de nuvem, fale com o administrador antes de removê-las

5. Confirme que resolveu

Não considere resolvido só porque o aviso não apareceu uma vez; confira estes três pontos.

O que /status mostra

Não há linha API key, ou ela tem · not in use. Login method mostra o plano da conta do claude.ai em que você registrou os conectores

A lista de /mcp

Os conectores aparecem sob o título do claude.ai. Os que você nunca conectou ficam recolhidos na linha Show unused connectors, no final

O aviso ao iniciar

Mesmo reiniciando, o aviso não aparece. 🟡 Ele some rápido, então olhe logo depois de iniciar

A documentação oficial de MCP diz que conectores que você ainda não conectou no claude.ai só podem ser conectados pela tela de configurações do claude.ai. Se a autenticação de um conector já conectado expirar, você pode selecionar esse servidor em /mcp e entrar de novo (referência oficial de erros). Se, logo ao iniciar, uma instabilidade momentânea de rede impedir a busca da lista de conectores, o Claude Code tenta de novo em segundo plano até 3 vezes, e os conectores aparecem assim que der certo. Se mesmo assim não aparecerem, reinicie para buscar de novo.

6. Se você decidir continuar com a chave de API

Usar uma chave de API é uma forma de uso prevista oficialmente, por exemplo quando a equipe concentra os custos na cobrança da API do Claude Console. Nesse caso, o aviso é só uma notificação de que “os conectores não estão disponíveis”, e ignorá-lo não afeta o funcionamento. Mas o que fica disponível e a forma de cobrança são diferentes do login da assinatura.

ItemLogin do claude.ai (Pro, Max, Team, Enterprise)Chave de API (ANTHROPIC_API_KEY)
CobrançaIncluída na cota do plano. Acima da cota, créditos de usoCobrada por token da organização do Console dona da chave
Freio contra uso excessivoLimites de uso do plano (janela de 5 horas, cota semanal etc.)Limite de gastos do workspace no Console
Conectores do claude.aiDisponíveisNão carregados
Servidores MCP locais (.mcp.json, claude mcp add)DisponíveisDisponíveis
Remote Control, /schedule e configurações de notificaçãoDisponíveisDesativados (a partir da v2.1.139)
Gestão de créditos de uso (/usage-credits)DisponívelIndisponível
Modo não interativo (-p)Sem chave, funciona com o loginSe houver chave, ela é sempre usada, com ou sem aprovação

Fontes: documentação oficial do Claude Code sobre gestão de custos (cobrança, limites, créditos de uso), documentação de autenticação (modo não interativo), documentação de MCP (conectores) e a v2.1.139 do CHANGELOG (Remote Control e outros). Nos planos Team e Enterprise, a cota de uso é definida por assento de cada membro e compartilhada com o chat do claude.ai.

No lugar do conector, adicione um servidor MCP localmente

Se o mesmo serviço oferece um servidor MCP remoto, você pode adicioná-lo diretamente com claude mcp add e usá-lo mesmo com a chave de API. Confira a URL de conexão nas instruções de cada serviço.

# Formato: claude mcp add --transport http <nome> <URL>
claude mcp add --transport http notion https://mcp.notion.com/mcp

Porém, segundo a documentação oficial de MCP, parte dos conectores hospedados pela Anthropic, como Microsoft 365, Gmail e Google Calendar, não permite entrar (OAuth) localmente a partir do Claude Code. O motivo é que o serviço de autenticação de origem só aceita o endereço de redirecionamento registrado pelo claude.ai. Se você adicionar um desses serviços localmente e tentar entrar, aparece is Anthropic-hosted and doesn't support local OAuth, com a orientação de conectá-lo pelo claude.ai. Ou seja, para esses serviços não há alternativa enquanto você usar a chave de API. Para diagnosticar quando um servidor MCP não conecta, veja o artigo sobre servidores MCP que não conectam no Claude Code.

Impedir que o aviso apareça

Se você decidiu não usar conectores, defina a configuração disableClaudeAiConnectors como true, e o Claude Code deixa de buscar e de conectar os conectores do claude.ai. Para uma única execução, a variável de ambiente ENABLE_CLAUDEAI_MCP_SERVERS=false tem o mesmo efeito.

Para desligar em todos os seus projetos, escreva o seguinte em ~/.claude/settings.json.

{
  "disableClaudeAiConnectors": true
}
# Desligar só nesta execução (macOS, Linux)
ENABLE_CLAUDEAI_MCP_SERVERS=false claude

🟡 A documentação oficial não fala da relação entre essa configuração e o aviso. No Claude Code v2.1.275, essa configuração é verificada antes da chave de API e, se estiver ativa, a busca para ali, então o aviso também deixa de aparecer. Ela também funciona com o login da assinatura, então não é preciso manter uma chave de API só para desligar os conectores.

Uso em CI ou scripts (-p)

No modo não interativo, ANTHROPIC_API_KEY é sempre usada se estiver definida, e o token de longa duração de claude setup-token também não consegue buscar conectores. Evite depender dos conectores do claude.ai dentro de automações e passe os servidores MCP necessários por .mcp.json ou --mcp-config. A documentação oficial de autenticação também diz que, mesmo com o token de longa duração, os servidores MCP configurados localmente funcionam.

7. Quando os conectores não aparecem mesmo sem a chave

Se /status mostra que o login está em uso, mas não há conectores em /mcp, a causa não é a ordem de prioridade. Confira estes pontos descritos na documentação oficial.

Os conectores estão desligados em algum lugar

disableClaudeAiConnectors vale se estiver como true em qualquer arquivo de configurações. Colocar false no projeto não anula um true nas suas configurações pessoais ou nas gerenciadas

Desligados individualmente

Estão listados por nome ou URL em deniedMcpServers. Conectores que você desligou por projeto em /mcp também não se conectam naquele projeto

Há um servidor local com a mesma URL

O servidor adicionado localmente tem prioridade, e o conector aparece na lista como oculto. Se quiser usar o conector, apague a duplicata local

session token rejected

Se o conector mostra connected · session token rejected, o claude.ai está recusando o login do Claude Code. Na maioria das vezes, o login expirou e não foi renovado. Faça /login e reconecte em /mcp

Gestão da organização

Nos planos Team e Enterprise, só administradores podem adicionar conectores. Se a organização marcar uma ferramenta como blocked, ela sai da lista

WSL no aplicativo de desktop

A documentação oficial diz que os conectores ainda não funcionam em sessões WSL do aplicativo de desktop

O login expirado que está por trás do session token rejected é tratado em detalhe no artigo sobre “Login expired · Please run /login”. Segundo a referência oficial de erros, refazer a autenticação do conector não resolve esse estado, porque o que foi recusado não é a autenticação do conector, e sim o login do Claude Code.

8. Relatos relacionados no GitHub

Abrimos e lemos, em 22 de setembro de 2026, duas issues relacionadas no repositório do Claude Code no GitHub. Nenhuma delas contém o texto exato do aviso deste artigo. No que lemos, em nenhuma há explicação da Anthropic sobre um defeito.

  • #58453 (aberta em 12 de maio de 2026, pedido de recurso): pede uma forma de desligar pelo Claude Code os conectores vinculados no claude.ai (Canva, Gmail, Google Drive, Google Calendar), que são carregados em todas as sessões do Claude Code e acrescentam as definições de ferramentas à entrada de cada turno. Um comentário de 14 de maio aponta que, a partir da v2.1.139, definir ANTHROPIC_API_KEY desliga os conectores, mas também desliga o /schedule e o Remote Control e passa a cobrança para a API. Em 23 de maio, uma conta com permissão de Collaborator no repositório a fechou, agrupando-a no pedido equivalente #29368. A documentação oficial atual inclui disableClaudeAiConnectors, mas não conseguimos confirmar no CHANGELOG em qual versão ele foi adicionado
  • #50537 (aberta em 18 de abril de 2026, Windows, v2.1.113): relata um aviso diferente, Auth conflict: Both a token (claude.ai) and an API key (ANTHROPIC_API_KEY) are set., e o erro Auth error: No API key available. Só há comentários de usuários, e ela foi fechada automaticamente em 26 de maio por falta de atividade. No Claude Code v2.1.275 que conferimos, não encontramos a mesma string desse aviso

O que as duas têm em comum é haver uma chave de API e um login do claude.ai no mesmo ambiente. Se você decidir antes qual dos dois pretende usar, a solução é a mesma nos dois casos: remover o que não vai usar, ou confirmar em /status que o escolhido é o que você pretendia.

9. Resumo

“claude.ai connectors are disabled because ANTHROPIC_API_KEY or another auth source is set and takes precedence” é um aviso de que uma credencial, como uma chave de API, tem prioridade sobre o login do claude.ai salvo, e por isso os conectores do claude.ai não foram carregados. O login não sumiu; só não está sendo usado por causa da ordem de prioridade. Veja na linha API key de /status qual credencial está em uso; se quiser os conectores, remova a chave na origem, reinicie e confira em /mcp.

Se você usa a chave de API de propósito, pode ignorar o aviso. Mas a cobrança passa a ser por token para a organização do Console, e o Remote Control e o /schedule ficam indisponíveis. Se você só quer desligar os conectores, use disableClaudeAiConnectors, não uma chave de API. Outros erros estão reunidos em erros comuns do Claude Code e como resolvê-los.

FAQ

P. O que significa “claude.ai connectors are disabled”?
R. É um aviso de que o Claude Code não carregou nesta sessão os conectores adicionados no claude.ai. A causa é que uma credencial, como ANTHROPIC_API_KEY, tem prioridade sobre o login do claude.ai salvo. O Claude Code continua funcionando com essa credencial.

P. Posso ignorar o aviso e continuar usando?
R. O funcionamento continua. Mas, se uma chave de API está em uso, o custo não sai da cota da assinatura: é cobrado da organização do Console dona da chave. Se você não lembra de ter configurado a chave, confira em /status e remova-a.

P. Fazer /login de novo resolve?
R. Não, enquanto a credencial de prioridade mais alta continuar lá. A documentação oficial também explica que uma ANTHROPIC_API_KEY aprovada ou um apiKeyHelper têm prioridade sobre o login, então /login não os substitui. Primeiro remova a chave ou a configuração e, se necessário, faça /login.

P. Dá para usar os conectores sem apagar a chave de API?
R. No modo interativo, sim: desligue “Use custom API key” em /config e a chave continua no ambiente sem ser usada. No modo não interativo com -p, a chave é sempre usada se estiver definida, então esse método não funciona.

Fontes primárias consultadas