12 Faça login no Claude Code12 Faça login no Claude Code

13</h2>13</h2>

14 14 

15Após [instalar Claude Code](/docs/pt/setup#install-claude-code), execute `claude` no seu terminal. No primeiro lançamento, Claude Code abre uma janela do navegador para você fazer login.15Após [instalar Claude Code](/docs/pt/setup#install-claude-code), execute `claude` no seu terminal. No primeiro lançamento, Claude Code abre uma janela do navegador para você fazer login. Se você tiver definido a variável de ambiente `ANTHROPIC_API_KEY`, Claude Code pula o prompt de login e pede que você aprove a chave.

16 16 

17Se o navegador não abrir automaticamente, pressione `c` para copiar a URL de login para sua área de transferência, depois cole-a no seu navegador.17Se o navegador não abrir automaticamente, pressione `c` para copiar a URL de login para sua área de transferência, depois cole-a no seu navegador.

18 18 

24 24 

25* **Assinatura Claude Pro ou Max**: faça login com sua conta Claude.ai. Assine em [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).25* **Assinatura Claude Pro ou Max**: faça login com sua conta Claude.ai. Assine em [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).

26* **Claude for Teams ou Enterprise**: faça login com a conta Claude.ai que seu administrador de equipe o convidou.26* **Claude for Teams ou Enterprise**: faça login com a conta Claude.ai que seu administrador de equipe o convidou.

27* **Claude Console**: faça login com suas credenciais do Console. Seu administrador deve ter [o convidado](#claude-console-authentication) primeiro.27* **Claude Console**: faça login com suas credenciais do Console. Seu administrador deve ter [o convidado](#claude-console-authentication) primeiro. Você pode se conectar com ou sem [criar uma chave de API](#sign-in-without-an-api-key).

28* **Provedores de nuvem**: se sua organização usa [Amazon Bedrock](/docs/pt/amazon-bedrock), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) ou [Microsoft Foundry](/docs/pt/microsoft-foundry), defina as variáveis de ambiente necessárias antes de executar `claude`, ou selecione **plataforma de terceiros** no prompt de login, que inicia um assistente de configuração interativa para Bedrock e Vertex AI. Nenhum login do navegador é necessário.28* **Provedores de nuvem**: se sua organização usa [Amazon Bedrock](/docs/pt/amazon-bedrock), [Google Cloud's Agent Platform](/docs/pt/google-vertex-ai) ou [Microsoft Foundry](/docs/pt/microsoft-foundry), defina as variáveis de ambiente necessárias antes de executar `claude`, ou selecione **plataforma de terceiros** no prompt de login, que inicia um assistente de configuração interativa para Bedrock e Vertex AI. Nenhum login do navegador é necessário.

29* **Cloud gateway**: se sua organização executa um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) auto-hospedado, faça login com SSO corporativo através de `/login`. O token emitido pelo gateway é a única credencial da sessão.29* **Cloud gateway**: se sua organização executa um [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) auto-hospedado, faça login com SSO corporativo através de `/login`. O token emitido pelo gateway é a única credencial da sessão.

30 30 

31Administradores podem restringir login interativo com as configurações gerenciadas [`forceLoginMethod` e `forceLoginOrgUUID`](/docs/pt/settings#available-settings). Quando qualquer uma delas é definida, sessões autenticadas por `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` são bloqueadas na inicialização; sessões de provedores de nuvem não são afetadas.31Administradores podem direcionar qual método de login os desenvolvedores usam e exigir que logins claude.ai pertençam a uma organização específica; consulte [Restringir login à sua organização](#restrict-login-to-your-organization).

32 32 

33Para fazer logout e se autenticar novamente, digite `/logout` no prompt do Claude Code. Fazer logout também redefine seu estado de configuração de primeiro lançamento, portanto, na próxima vez que você executar `claude`, ele o guiará novamente pelo login e configuração.33Para fazer logout e se autenticar novamente, digite `/logout` no prompt do Claude Code. Fazer logout também redefine seu estado de configuração de primeiro lançamento, portanto, na próxima vez que você executar `claude`, ele o guiará novamente pelo login e configuração.

34 34 

105 </Step>105 </Step>

106</Steps>106</Steps>

107 107 

108<h4 id="sign-in-without-an-api-key">

109 Faça login sem uma chave de API

110</h4>

111 

112Você pode fazer login em sua conta do Console sem criar uma chave de API, mesmo quando sua organização não permite que desenvolvedores as criem. Escolha a conta Anthropic Console no prompt `/login` e Claude Code pergunta como você deseja fazer login. Requer Claude Code v2.1.242 ou posterior. Ambas as rotas fazem login no Console no navegador e diferem no que Claude Code armazena depois:

113 

114* **Faça login com sua conta do Console**, rotulado `(recomendado)`: Claude Code mantém o token OAuth desse login e o armazena como um [perfil Anthropic](#anthropic-profiles-and-federation-credentials). Não cria nenhuma chave de API

115* **Crie uma chave de API**, rotulado `(legado)`: Claude Code cria uma chave de API do Console para você e a armazena com suas outras credenciais

116 

117Na prática, o perfil armazena um login OAuth enquanto uma chave de API é uma credencial estática: Claude Code atualiza automaticamente o login do perfil, e quando a atualização falha, as solicitações falham com [login do perfil Anthropic expirado](/docs/pt/errors#anthropic-profile-login-expired) até que você faça login novamente.

118 

119Você não obtém a escolha em cada máquina. Claude Code cria uma chave de API sem perguntar nestes casos:

120 

121* Você executa contra um provedor de nuvem, como [Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](/docs/pt/third-party-integrations) ou [Claude Platform on AWS](/docs/pt/claude-platform-on-aws)

122* Qualquer arquivo de configurações define [`forceLoginOrgUUID`](#restrict-login-to-your-organization), ou define `forceLoginMethod` como `"claudeai"` ou `"console"`

123* Uma fonte de configurações gerenciadas em sua máquina, como o arquivo de configurações gerenciadas, um perfil MDM ou as configurações gerenciadas pelo servidor em cache, existe mas Claude Code [não consegue lê-la](/docs/pt/managed-settings#invalid-entries-in-managed-settings) e nenhuma outra fonte gerenciada fornece uma política

124 

125Desdefina `ANTHROPIC_API_KEY` antes de fazer login sem uma chave. Um perfil escrito pelo próprio login do Console do Claude Code, ou pelo `ant auth login` da CLI do Claude Platform, é o mesmo tipo de credencial, então fazer login novamente o substitui.

126 

127Depois de fazer login sem uma chave, você tem um perfil em vez de uma chave de API armazenada:

128 

129* **Qual perfil ele escreve**: Claude Code escreve o perfil nomeado por `ANTHROPIC_PROFILE`, ou seu perfil ativo, ou `default`. Se esse perfil for um perfil de federação, Claude Code recusa o login em vez de sobrescrevê-lo

130* **Do que ele faz logout**: Claude Code faz logout de qualquer login claude.ai armazenado na máquina

131* **Como desfazer**: execute `/logout`, que remove e revoga a credencial que este login escreveu

132 

133Se sua organização usa [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings), elas se aplicam a este login no Claude Code v2.1.257 ou posterior.

134 

135Tudo mais sobre perfis se aplica a este login, incluindo onde ele se classifica em relação às suas outras credenciais, a linha `Profile` que você obtém em `/status`, e os recursos que precisam de um login claude.ai. Veja [Perfis Anthropic e credenciais de federação](#anthropic-profiles-and-federation-credentials).

136 

108<h3 id="cloud-provider-authentication">137<h3 id="cloud-provider-authentication">

109 Autenticação do provedor de nuvem138 Autenticação do provedor de nuvem

110</h3>139</h3>

125 </Step>154 </Step>

126</Steps>155</Steps>

127 156 

157<h3 id="restrict-login-to-your-organization">

158 Restrinja o login à sua organização

159</h3>

160 

161Para exigir que os logins claude.ai dos desenvolvedores pertençam a uma organização Anthropic específica, defina [`forceLoginMethod`](/docs/pt/settings-reference#forceloginmethod) e [`forceLoginOrgUUID`](/docs/pt/settings-reference#forceloginorguuid) em [configurações gerenciadas](/docs/pt/managed-settings). Defina `forceLoginOrgUUID` para seu ID de organização, mostrado em [configurações de administrador claude.ai](https://claude.ai/admin-settings/organization) para organizações Claude for Teams ou Enterprise. Claude Code relata um erro para um login claude.ai em qualquer outra organização e sai na inicialização se a credencial claude.ai em uso pertencer a uma organização que não esteja listada.

162 

163Para logins do Claude Console, Claude Code usa `forceLoginOrgUUID` para pré-selecionar a organização na página de login do Console quando você o define para um único ID de organização do Console, mostrado em [platform.claude.com/settings/organization](https://platform.claude.com/settings/organization). Ele não verifica a qual organização a credencial do Console resultante pertence, no login ou na inicialização, e um desenvolvedor que fez login com uma conta do Console antes de você implantar as chaves permanece conectado.

164 

165Se você definir `forceLoginOrgUUID` em qualquer arquivo de configurações, Claude Code para de oferecer o [login do Console sem chave](#sign-in-without-an-api-key) nas sessões às quais esse arquivo se aplica e cria uma chave de API em vez disso. Para direcionar os desenvolvedores para o login claude.ai em vez disso, defina `forceLoginMethod` como `"claudeai"`.

166 

167Os desenvolvedores podem fazer login de vários caminhos: o fluxo `/login` do terminal, a [extensão VS Code](/docs/pt/vs-code), o Agent SDK, `claude setup-token`, `/install-github-app`, e [login do gateway](/docs/pt/claude-apps-gateway) para organizações que roteiamthrough a cloud gateway. No Claude Code v2.1.212 ou posterior, cada caminho aplica `forceLoginMethod`; antes da v2.1.212, apenas logins de terminal aplicavam qualquer chave. Na tela de login interativa do terminal, alcançada por `/login` ou onboarding de primeira execução, Claude Code pré-seleciona um método `claudeai` ou `console` sem aplicá-lo, então mesmo com `forceLoginMethod` definido como `"claudeai"`, um desenvolvedor ainda pode completar um login do Console lá. Os caminhos diferem em `forceLoginOrgUUID`:

168 

169* **Logins de terminal, extensão VS Code e Agent SDK**: verificam `forceLoginOrgUUID` para logins de conta claude.ai

170* **`claude setup-token` e `/install-github-app`**: aplicam apenas `forceLoginMethod`, então eles podem cunhar um token em uma organização diferente

171* **[Login do gateway](/docs/pt/claude-apps-gateway)**: selecionado por `forceLoginMethod: "gateway"` em vez de restringido por ele, e não autentica contra uma organização Anthropic, então `forceLoginOrgUUID` não se aplica; use seu provedor de identidade do gateway para restringir o acesso

172 

173Implante as chaves através de sua ferramenta de gerenciamento de dispositivos. [Configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) alcançam apenas contas que já estão autenticadas em sua organização, então elas não podem redirecionar o primeiro login de um desenvolvedor. Se sua organização também distribui configurações gerenciadas pelo servidor, defina as chaves em ambos os lugares: fontes de [configurações gerenciadas](/docs/pt/server-managed-settings#settings-precedence) não se mesclam, e as configurações gerenciadas pelo servidor em cache substituem o arquivo gerenciado pelo dispositivo, exceto por dois tipos de chaves que ainda preenchem de uma fonte perdedora:

174 

175* **O bloco `env`**: [mescla por chave](/docs/pt/server-managed-settings#per-key-exceptions-across-managed-sources) no Claude Code v2.1.223 ou posterior

176* **As [chaves de bloqueio entre fontes](/docs/pt/server-managed-settings#per-key-exceptions-across-managed-sources)**: honradas de qualquer fonte de administrador

177 

178`forceLoginMethod` e `forceLoginOrgUUID` não são nenhum dos dois, então mantenha-os em ambos os lugares.

179 

180As chaves também decidem se uma sessão que não usa uma credencial de login pode iniciar. Veja [`forceLoginOrgUUID`](/docs/pt/settings-reference#forceloginorguuid) na referência de configurações para o comportamento completo.

181 

182* **`ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper`**: bloqueado na inicialização, já que a associação à organização não pode ser verificada para uma credencial de ambiente

183* **Sessões do provedor de nuvem como Amazon Bedrock**: não bloqueadas, porque elas autenticam contra seu provedor de nuvem. Restrinja-as através de suas políticas de IAM de nuvem

184* **[Perfil Anthropic ou credenciais de federação](#anthropic-profiles-and-federation-credentials)**: não bloqueadas, e as chaves não verificam a qual organização o perfil pertence

185 

128<h2 id="credential-management">186<h2 id="credential-management">

129 Gerenciamento de credenciais187 Gerenciamento de credenciais

130</h2>188</h2>

132Claude Code gerencia com segurança suas credenciais de autenticação:190Claude Code gerencia com segurança suas credenciais de autenticação:

133 191 

134* **Local de armazenamento**:192* **Local de armazenamento**:

135 * No macOS, as credenciais são armazenadas no Keychain do macOS criptografado.193 * No macOS, as credenciais são armazenadas no Keychain do macOS criptografado. Quando o Keychain rejeita a escrita, como quando está bloqueado em uma sessão SSH, Claude Code armazena seu login em `~/.claude/.credentials.json` com modo de arquivo `0600` em vez disso, o mesmo armazenamento que usa no Linux. Um login do Console que cria uma chave de API falha até que o Keychain seja gravável. Para mover seu login de volta para o Keychain, siga [as etapas de recuperação](/docs/pt/troubleshoot-install#not-logged-in-or-token-expired).

136 * No Linux, as credenciais são armazenadas em `~/.claude/.credentials.json` com modo de arquivo `0600`.194 * No Linux, as credenciais são armazenadas em `~/.claude/.credentials.json` com modo de arquivo `0600`.

137 * No Windows, as credenciais são armazenadas em `%USERPROFILE%\.claude\.credentials.json` e herdam os controles de acesso do diretório do seu perfil de usuário, o que restringe o arquivo à sua conta de usuário por padrão.195 * No Windows, as credenciais são armazenadas em `%USERPROFILE%\.claude\.credentials.json` e herdam os controles de acesso do diretório do seu perfil de usuário, o que restringe o arquivo à sua conta de usuário por padrão.

138 * Se você definiu a variável de ambiente `CLAUDE_CONFIG_DIR` no Linux ou Windows, o arquivo `.credentials.json` fica sob esse diretório em vez disso.196 * Se você definiu a variável de ambiente `CLAUDE_CONFIG_DIR`, Claude Code mantém o arquivo `.credentials.json` sob esse diretório em vez disso, incluindo o arquivo que o fallback do macOS escreve, e chaves a entrada do Keychain do macOS para esse diretório também, então uma sessão com um `CLAUDE_CONFIG_DIR` diferente lê uma entrada diferente.

139 * Claude Code gerencia `.credentials.json` através de `/login` e `/logout`. Para rotear solicitações através de um endpoint de API personalizado, defina a variável de ambiente [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) em vez disso.197 * Claude Code gerencia `.credentials.json` através de `/login` e `/logout`. Para rotear solicitações através de um endpoint de API personalizado, defina a variável de ambiente [`ANTHROPIC_BASE_URL`](/docs/pt/env-vars) em vez disso.

140* **Tipos de autenticação suportados**: credenciais Claude.ai, credenciais da API Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth e tokens de sessão do [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway).198* **Tipos de autenticação suportados**: credenciais Claude.ai, credenciais da API Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, credenciais de perfil Anthropic e [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation), e tokens de sessão do [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway).

141* **Scripts de credenciais personalizados**: a configuração [`apiKeyHelper`](/docs/pt/settings#available-settings) pode ser configurada para executar um script de shell que retorna uma chave de API.199* **Scripts de credenciais personalizados**: configure a configuração [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) para executar um script de shell que retorna uma chave de API.

142* **Intervalos de atualização**: por padrão, `apiKeyHelper` é chamado após 5 minutos ou em resposta HTTP 401. Defina a variável de ambiente `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` para intervalos de atualização personalizados.200* **Intervalos de atualização**: Claude Code executa novamente `apiKeyHelper` após cinco minutos por padrão. Defina a variável de ambiente `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` para intervalos de atualização personalizados. Consulte [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper) para os outros casos em que Claude Code executa novamente o helper.

143* **Aviso de helper lento**: se `apiKeyHelper` levar mais de 10 segundos para retornar uma chave, Claude Code exibe um aviso na barra de prompt mostrando o tempo decorrido. Se você vir este aviso regularmente, verifique se seu script de credenciais pode ser otimizado.201* **Aviso de helper lento**: se `apiKeyHelper` levar mais de 10 segundos para retornar uma chave, Claude Code exibe um aviso na barra de prompt mostrando o tempo decorrido. Se você vir este aviso regularmente, verifique se seu script de credenciais pode ser otimizado.

144* **Falhas do helper**: quando o script sai com um erro, expira ou não imprime nada, as solicitações falham com [`Your apiKeyHelper script is failing`](/docs/pt/errors#your-apikeyhelper-script-is-failing) dentro de três tentativas. Antes da v2.1.208, as falhas do helper apareciam como um 401 genérico após cerca de dez tentativas silenciosas.202* **Falhas do helper**: quando o script sai com um erro, expira ou não imprime nada, as solicitações falham com [`Your apiKeyHelper script is failing`](/docs/pt/errors#your-apikeyhelper-script-is-failing) dentro de três tentativas. Antes da v2.1.208, as falhas do helper apareciam como um 401 genérico após cerca de dez tentativas silenciosas.

145 203 

149 Renovar um login que está expirando207 Renovar um login que está expirando

150</h3>208</h3>

151 209 

152Quando o login que você criou com `/login` está dentro de cinco dias de expiração, Claude Code mostra um aviso na inicialização: `Your login expires in 3 days · run /login to renew`. Requer Claude Code v2.1.203 ou posterior.210Quando o login que você criou com `/login` está dentro de três dias de expiração, Claude Code mostra um aviso na inicialização: `Your login expires in 3 days · run /login to renew`. Requer Claude Code v2.1.203 ou posterior. Antes da v2.1.217, o aviso aparecia cinco dias antes.

153 211 

154Execute `/login` para renovar. O aviso é informativo e nunca bloqueia uma solicitação: a autenticação continua funcionando até que o login realmente expire. O tempo de vida do login em si não muda; o aviso antecipado é o que v2.1.203 adiciona.212Execute `/login` para renovar. O aviso é informativo e nunca bloqueia uma solicitação: a autenticação continua funcionando até que o login realmente expire. O tempo de vida do login em si não muda; o aviso antecipado é o que v2.1.203 adiciona.

155 213 

156Quando o login armazenado expira e não pode ser atualizado, cada solicitação falha com [`Login expired · Please run /login`](/docs/pt/errors#login-expired) até que você se conecte novamente. Antes da v2.1.206, um login expirado aparecia como um erro de modelo em vez disso.214Quando o login armazenado expira e não pode ser atualizado, cada solicitação de modelo falha com [`Login expired · Please run /login`](/docs/pt/errors#login-expired) até que você se conecte novamente. Antes da v2.1.206, Claude Code relatava um login expirado em solicitações de modelo como um erro de modelo em vez disso.

215 

216Você pode verificar este estado antes de uma solicitação falhar: [`/status`](/docs/pt/commands) mostra uma linha `Login` lendo `Expired — log in again`, mais a organização e o email que tem salvos para o login expirado. A linha aparece apenas quando o login claude.ai ou Claude Console salvo é a credencial ativa. A linha requer Claude Code v2.1.210 ou posterior.

157 217 

158O aviso aparece apenas quando um login claude.ai ou Claude Console é a credencial ativa, e não quando um provedor de nuvem, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` fornece a credencial.218O aviso aparece apenas quando um login claude.ai ou Claude Console é a credencial ativa, e não quando um provedor de nuvem, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` fornece a credencial.

159 219 

1681. Credenciais do provedor de nuvem, quando `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` está definido. Consulte [integrações de terceiros](/docs/pt/third-party-integrations) para configuração.2281. Credenciais do provedor de nuvem, quando `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` está definido. Consulte [integrações de terceiros](/docs/pt/third-party-integrations) para configuração.

1692. Variável de ambiente `ANTHROPIC_AUTH_TOKEN`. Enviada como o cabeçalho `Authorization: Bearer`. Use isso ao rotear através de um [gateway LLM ou proxy](/docs/pt/llm-gateway) que autentica com tokens bearer em vez de chaves de API Anthropic.2292. Variável de ambiente `ANTHROPIC_AUTH_TOKEN`. Enviada como o cabeçalho `Authorization: Bearer`. Use isso ao rotear através de um [gateway LLM ou proxy](/docs/pt/llm-gateway) que autentica com tokens bearer em vez de chaves de API Anthropic.

1703. Variável de ambiente `ANTHROPIC_API_KEY`. Enviada como o cabeçalho `X-Api-Key`. Use isso para acesso direto à API Anthropic com uma chave do [Claude Console](https://platform.claude.com). No modo interativo, você é solicitado uma vez a aprovar ou recusar a chave, e sua escolha é lembrada. Para alterá-la depois, use o toggle "Use custom API key" em `/config`. O toggle aparece apenas enquanto `ANTHROPIC_API_KEY` está definido em seu ambiente. No modo não interativo (`-p`), a chave é sempre usada quando presente.2303. Variável de ambiente `ANTHROPIC_API_KEY`. Enviada como o cabeçalho `X-Api-Key`. Use isso para acesso direto à API Anthropic com uma chave do [Claude Console](https://platform.claude.com). No modo interativo, você é solicitado uma vez a aprovar ou recusar a chave, e sua escolha é lembrada. Para alterá-la depois, use o toggle "Use custom API key" em `/config`. O toggle aparece apenas enquanto `ANTHROPIC_API_KEY` está definido em seu ambiente. No modo não interativo (`-p`), a chave é sempre usada quando presente.

1714. Saída do script [`apiKeyHelper`](/docs/pt/settings#available-settings). Use isso para credenciais dinâmicas ou rotativas, como tokens de curta duração obtidos de um cofre.2314. Saída do script [`apiKeyHelper`](/docs/pt/settings-reference#apikeyhelper). Use isso para credenciais dinâmicas ou rotativas, como tokens de curta duração obtidos de um cofre.

1725. Variável de ambiente `CLAUDE_CODE_OAUTH_TOKEN`. Um token OAuth de longa duração gerado por [`claude setup-token`](#generate-a-long-lived-token). Use isso para pipelines de CI e scripts onde login do navegador não está disponível.2325. Variável de ambiente `CLAUDE_CODE_OAUTH_TOKEN`. Um token OAuth de longa duração gerado por [`claude setup-token`](#generate-a-long-lived-token). Use isso para pipelines de CI e scripts onde login do navegador não está disponível. Se você executar `/login` enquanto a variável está definida, Claude Code muda a sessão atual para o novo login, mas lê a variável novamente em cada nova sessão até que você a remova do seu perfil de shell ou do bloco `env` de um [arquivo de configurações](/docs/pt/settings).

1736. Credenciais OAuth de assinatura de `/login`. Este é o padrão para usuários Claude Pro, Max, Team e Enterprise.2336. Credenciais de perfil Anthropic e de federação, as credenciais que a CLI `ant` e Workload Identity Federation usam. Um perfil que `ant auth login` escreveu é classificado aqui apenas quando você o nomeia em `ANTHROPIC_PROFILE`; caso contrário, é classificado abaixo de `/login`. Consulte [Perfis Anthropic e credenciais de federação](#anthropic-profiles-and-federation-credentials).

2347. Credenciais OAuth de assinatura de `/login`. Este é o padrão para usuários Claude Pro, Max, Team e Enterprise.

174 235 

175Uma sessão do [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) assinada fica fora desta lista: é uma seleção de provedor como Amazon Bedrock ou Google Cloud's Agent Platform, e a supera. Quando uma sessão de gateway existe, a CLI se autentica com o token do gateway mesmo se `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` está definido, e as entradas de token bearer, chave de API e `apiKeyHelper` acima não são usadas.236Uma sessão do [gateway de aplicativos Claude](/docs/pt/claude-apps-gateway) assinada fica fora desta lista: é uma seleção de provedor como Amazon Bedrock ou Google Cloud's Agent Platform, e a supera. Quando uma sessão de gateway existe, a CLI se autentica com o token do gateway mesmo se `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` está definido, e fontes de credenciais acima como o token bearer, chave de API, `apiKeyHelper` e perfis não são usados.

176 237 

177Se você tem uma assinatura Claude ativa mas também tem `ANTHROPIC_API_KEY` definido em seu ambiente, a chave de API tem precedência uma vez aprovada. Isso pode causar falhas de autenticação se a chave pertencer a uma organização desabilitada ou expirada. Execute `unset ANTHROPIC_API_KEY` para voltar à sua assinatura e verifique `/status` para confirmar qual método está ativo. A linha `Login method` mostra sua conta de assinatura, e uma linha `API key` aparece quando uma chave de API está em uso.238Se você tem uma assinatura Claude ativa mas também tem `ANTHROPIC_API_KEY` definido em seu ambiente, a chave de API tem precedência uma vez aprovada. Isso pode causar falhas de autenticação se a chave pertencer a uma organização desabilitada ou expirada. Execute `unset ANTHROPIC_API_KEY` para voltar à sua assinatura e verifique `/status` para confirmar qual método está ativo. A linha `Login method` mostra sua conta de assinatura, e uma linha `API key` aparece quando uma chave de API está em uso.

178 239 

179[Claude Code na Web](/docs/pt/claude-code-on-the-web) sempre usa suas credenciais de assinatura. Se você definir `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN` no ambiente sandbox, isso não substitui suas credenciais de assinatura.240[Claude Code na Web](/docs/pt/claude-code-on-the-web) sempre usa suas credenciais de assinatura. Se você definir `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN` no ambiente sandbox, isso não substitui suas credenciais de assinatura.

180 241 

242<h4 id="anthropic-profiles-and-federation-credentials">

243 Perfis Anthropic e credenciais de federação

244</h4>

245 

246Um perfil é um arquivo de configuração de credencial nomeado em seu [diretório de configuração Anthropic](https://platform.claude.com/docs/en/manage-claude/wif-reference#configuration-directory), por padrão `~/.config/anthropic` no macOS e Linux ou `%APPDATA%\Anthropic` no Windows. O modo de autenticação de um perfil é `oidc_federation` quando você o configura para [Workload Identity Federation (WIF)](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) ou `user_oauth` quando [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) o escreveu ou você [se conectou a uma conta do Console sem uma chave de API](#sign-in-without-an-api-key).

247 

248Claude Code não lê perfis ou variáveis de federação em [modo bare](/docs/pt/headless#start-faster-with-bare-mode), no Claude Desktop ou em sessões na nuvem. Nessas sessões, `/status` não mostra nenhuma linha `Profile`.

249 

250Claude Code verifica três fontes nesta ordem e para na primeira que está definida. A tabela mostra o que define cada fonte e onde é classificada em relação à sua credencial `/login`.

251 

252| Fonte | Definido por | Classificação em relação a `/login` |

253| :--------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------ |

254| Perfil nomeado | `ANTHROPIC_PROFILE` | Acima, qualquer que seja o modo de autenticação do perfil |

255| Variáveis de federação | `ANTHROPIC_FEDERATION_RULE_ID` e `ANTHROPIC_ORGANIZATION_ID`, ambas definidas | Acima |

256| Perfil ativo | O arquivo [`active_config`](https://platform.claude.com/docs/en/manage-claude/wif-reference#active-profile) em seu diretório de configuração, ou um perfil nomeado `default` | Acima quando seu modo de autenticação é `oidc_federation`; abaixo de uma credencial `/login` funcionando quando seu modo de autenticação é `user_oauth` |

257 

258A regra `user_oauth` impede que um perfil `ant auth login` deixado para trás mova suas solicitações para fora da conta em que você se conectou com `/login`. Para as variáveis de federação, Claude Code também lê as outras variáveis na [referência WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#environment-variables), como `ANTHROPIC_IDENTITY_TOKEN_FILE`, quando troca seu token de identidade. Para o formato do arquivo de perfil, consulte a [referência WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#profile-configuration-file).

259 

260Para confirmar qual fonte Claude Code escolheu, execute `/status`. Uma linha `Profile` nomeia a fonte no lugar da linha `Login method`, e quando o perfil é a credencial em uso, as linhas `Organization` e `Email` mostram sua conta.

261 

262Se você iniciar Claude Code com `--debug`, ele também escreve uma linha `Using Anthropic profile auth` com o nome da fonte no log de depuração em `~/.claude/debug/<session-id>.txt`. Quando Claude Code passa por um perfil ativo `user_oauth` porque você tem uma credencial `/login` funcionando, ele escreve um aviso no log de depuração dizendo que está usando o login claude.ai em vez disso.

263 

264Quando o login de um perfil `user_oauth` expirou e Claude Code não pode renová-lo, as solicitações falham com [Anthropic profile login expired](/docs/pt/errors#anthropic-profile-login-expired).

265 

266Recursos que precisam de seu login claude.ai, como [conectores claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai) e [`/schedule`](/docs/pt/routines), não estão disponíveis enquanto uma dessas fontes está selecionada. Para impedir que Claude Code selecione uma fonte:

267 

268* **Perfil nomeado ou variáveis de federação**: desdefina `ANTHROPIC_PROFILE` ou desdefina qualquer variável de federação

269* **Perfil ativo**: execute `/logout` para um perfil `user_oauth` cuja credencial atual você escreveu [conectando-se a uma conta do Console sem uma chave de API](#sign-in-without-an-api-key), execute `ant auth logout` para um cuja credencial atual `ant auth login` escreveu, ou delete o arquivo do perfil de `configs/` em seu diretório de configuração para qualquer modo de autenticação

270 

181<h3 id="generate-a-long-lived-token">271<h3 id="generate-a-long-lived-token">

182 Gere um token de longa duração272 Gere um token de longa duração

183</h3>273</h3>

188claude setup-token278claude setup-token

189```279```

190 280 

191O comando o guia através da autorização OAuth e imprime um token no terminal. Ele não salva o token em lugar nenhum; copie-o e defina-o como a variável de ambiente `CLAUDE_CODE_OAUTH_TOKEN` onde você quiser se autenticar:281O comando abre o mesmo fluxo de autorização do navegador que `/login`, e o token é impresso no terminal depois que você aprova o acesso no navegador. Ele não salva o token em lugar nenhum; copie-o e defina-o como a variável de ambiente `CLAUDE_CODE_OAUTH_TOKEN` onde você quiser se autenticar:

192 282 

193```bash theme={null}283```bash theme={null}

194export CLAUDE_CODE_OAUTH_TOKEN=your-token284export CLAUDE_CODE_OAUTH_TOKEN=your-token

195```285```

196 286 

197Este token se autentica com sua assinatura Claude e requer um plano Pro, Max, Team ou Enterprise. Ele é limitado apenas a inferência e não pode estabelecer sessões de [Remote Control](/docs/pt/remote-control).287Este token se autentica com sua assinatura Claude e requer um plano Pro, Max, Team ou Enterprise. Ele pode apenas fazer solicitações de modelo, então não pode estabelecer sessões de [Remote Control](/docs/pt/remote-control) ou buscar [conectores claude.ai](/docs/pt/mcp#use-mcp-servers-from-claude-ai). Servidores MCP que você configura localmente ainda funcionam.

198 288 

199[Bare mode](/docs/pt/headless#start-faster-with-bare-mode) não lê `CLAUDE_CODE_OAUTH_TOKEN`. Se seu script passar `--bare`, autentique com `ANTHROPIC_API_KEY` ou um `apiKeyHelper` em vez disso.289[Bare mode](/docs/pt/headless#start-faster-with-bare-mode) não lê `CLAUDE_CODE_OAUTH_TOKEN`. Se seu script passar `--bare`, autentique com `ANTHROPIC_API_KEY` ou um `apiKeyHelper` em vez disso.