12 Inicie sesión en Claude Code12 Inicie sesión en Claude Code

13</h2>13</h2>

14 14 

15Después de [instalar Claude Code](/docs/es/setup#install-claude-code), ejecute `claude` en su terminal. En el primer lanzamiento, Claude Code abre una ventana del navegador para que inicie sesión.15Después de [instalar Claude Code](/docs/es/setup#install-claude-code), ejecute `claude` en su terminal. En el primer lanzamiento, Claude Code abre una ventana del navegador para que inicie sesión. Si ha establecido la variable de entorno `ANTHROPIC_API_KEY`, Claude Code omite el símbolo del sistema de inicio de sesión y le pide que apruebe la clave en su lugar.

16 16 

17Si el navegador no se abre automáticamente, presione `c` para copiar la URL de inicio de sesión al portapapeles y luego péguelo en su navegador.17Si el navegador no se abre automáticamente, presione `c` para copiar la URL de inicio de sesión al portapapeles y luego péguelo en su navegador.

18 18 

24 24 

25* **Suscripción Claude Pro o Max**: inicie sesión con su cuenta de Claude.ai. Suscríbase en [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).25* **Suscripción Claude Pro o Max**: inicie sesión con su cuenta de Claude.ai. Suscríbase en [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).

26* **Claude for Teams o Enterprise**: inicie sesión con la cuenta de Claude.ai que su administrador de equipo le invitó a usar.26* **Claude for Teams o Enterprise**: inicie sesión con la cuenta de Claude.ai que su administrador de equipo le invitó a usar.

27* **Claude Console**: inicie sesión con sus credenciales de Console. Su administrador debe haberle [invitado](#claude-console-authentication) primero.27* **Claude Console**: inicie sesión con sus credenciales de Console. Su administrador debe haberle [invitado](#claude-console-authentication) primero. Puede iniciar sesión con o sin [crear una clave de API](#sign-in-without-an-api-key).

28* **Proveedores de nube**: si su organización usa [Amazon Bedrock](/docs/es/amazon-bedrock), [Google Cloud's Agent Platform](/docs/es/google-vertex-ai) o [Microsoft Foundry](/docs/es/microsoft-foundry), establezca las variables de entorno requeridas antes de ejecutar `claude`, o seleccione **plataforma de terceros** en el símbolo del sistema de inicio de sesión, que inicia un asistente de configuración interactivo para Bedrock y Vertex AI. No se necesita inicio de sesión en el navegador.28* **Proveedores de nube**: si su organización usa [Amazon Bedrock](/docs/es/amazon-bedrock), [Google Cloud's Agent Platform](/docs/es/google-vertex-ai) o [Microsoft Foundry](/docs/es/microsoft-foundry), establezca las variables de entorno requeridas antes de ejecutar `claude`, o seleccione **plataforma de terceros** en el símbolo del sistema de inicio de sesión, que inicia un asistente de configuración interactivo para Bedrock y Vertex AI. No se necesita inicio de sesión en el navegador.

29* **Puerta de enlace en la nube**: si su organización ejecuta una [puerta de enlace de aplicaciones Claude](/docs/es/claude-apps-gateway) autohospedada, inicie sesión con SSO corporativo a través de `/login`. El token emitido por la puerta de enlace es la única credencial de la sesión.29* **Puerta de enlace en la nube**: si su organización ejecuta una [puerta de enlace de aplicaciones Claude](/docs/es/claude-apps-gateway) autohospedada, inicie sesión con SSO corporativo a través de `/login`. El token emitido por la puerta de enlace es la única credencial de la sesión.

30 30 

31Los administradores pueden restringir el inicio de sesión interactivo con la configuración administrada [`forceLoginMethod` y `forceLoginOrgUUID`](/docs/es/settings#available-settings). Cuando se establece cualquiera de ellas, las sesiones autenticadas por `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper` se bloquean al inicio; las sesiones de proveedores de nube no se ven afectadas.31Los administradores pueden dirigir qué método de inicio de sesión utilizan los desarrolladores y requerir que los inicios de sesión de claude.ai pertenezcan a una organización específica; consulte [Restringir el inicio de sesión a su organización](#restrict-login-to-your-organization).

32 32 

33Para cerrar sesión y volver a autenticarse, escriba `/logout` en el símbolo del sistema de Claude Code. Cerrar sesión también restablece su estado de configuración de primer lanzamiento, por lo que la próxima vez que ejecute `claude` le guiará a través del inicio de sesión y la configuración nuevamente.33Para cerrar sesión y volver a autenticarse, escriba `/logout` en el símbolo del sistema de Claude Code. Cerrar sesión también restablece su estado de configuración de primer lanzamiento, por lo que la próxima vez que ejecute `claude` le guiará a través del inicio de sesión y la configuración nuevamente.

34 34 

35Si tiene problemas para iniciar sesión, consulte [solución de problemas de autenticación](/docs/es/troubleshoot-install#login-and-authentication).35Si tiene problemas para iniciar sesión, consulte [solución de problemas de autenticación](/docs/es/troubleshoot-install#login-and-authentication).

36 36 

37<h2 id="set-up-team-authentication">37<h2 id="set-up-team-authentication">

38 Configure la autenticación del equipo38 Configurar la autenticación del equipo

39</h2>39</h2>

40 40 

41Para equipos y organizaciones, puede configurar el acceso a Claude Code de una de estas formas:41Para equipos y organizaciones, puede configurar el acceso a Claude Code de una de estas formas:

105 </Step>105 </Step>

106</Steps>106</Steps>

107 107 

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

109 Iniciar sesión sin una clave API

110</h4>

111 

112Puede iniciar sesión en su cuenta de Console sin crear una clave API, incluso cuando su organización no permite que los desarrolladores las creen. Elija la cuenta de Anthropic Console en el indicador `/login` y Claude Code le pregunta cómo desea iniciar sesión. Requiere Claude Code v2.1.242 o posterior. Ambas rutas lo inician sesión en Console en el navegador y difieren en lo que Claude Code almacena después:

113 

114* **Iniciar sesión con su cuenta de Console**, etiquetado como `(recomendado)`: Claude Code mantiene el token OAuth de ese inicio de sesión y lo almacena como un [perfil de Anthropic](#anthropic-profiles-and-federation-credentials). No crea ninguna clave API

115* **Crear una clave API**, etiquetado como `(heredado)`: Claude Code crea una clave API de Console para usted y la almacena con sus otras credenciales

116 

117En la práctica, el perfil almacena un inicio de sesión OAuth mientras que una clave API es una credencial estática: Claude Code actualiza automáticamente el inicio de sesión del perfil, y cuando la actualización falla, las solicitudes fallan con [Inicio de sesión de perfil de Anthropic expirado](/docs/es/errors#anthropic-profile-login-expired) hasta que inicie sesión nuevamente.

118 

119No obtiene la opción en cada máquina. Claude Code crea una clave API sin preguntar en estos casos:

120 

121* Ejecuta contra un proveedor de nube, como [Amazon Bedrock, Plataforma de agentes de Google Cloud o Microsoft Foundry](/docs/es/third-party-integrations) o [Claude Platform en AWS](/docs/es/claude-platform-on-aws)

122* Cualquier archivo de configuración establece [`forceLoginOrgUUID`](#restrict-login-to-your-organization), o establece `forceLoginMethod` en `"claudeai"` o `"console"`

123* Existe una fuente de configuración administrada en su máquina, como el archivo de configuración administrada, un perfil MDM o la configuración administrada por servidor en caché, pero Claude Code [no puede leerla](/docs/es/managed-settings#invalid-entries-in-managed-settings) y ninguna otra fuente administrada proporciona una política

124 

125Desestablezca `ANTHROPIC_API_KEY` antes de iniciar sesión sin una clave. Un perfil escrito por el propio inicio de sesión de Console de Claude Code, o por el `ant auth login` de la CLI de Claude Platform, es el mismo tipo de credencial, por lo que iniciar sesión nuevamente lo reemplaza.

126 

127Después de iniciar sesión sin una clave, tiene un perfil en lugar de una clave API almacenada:

128 

129* **Qué perfil escribe**: Claude Code escribe el perfil nombrado por `ANTHROPIC_PROFILE`, o su perfil activo, o `default`. Si ese perfil es un perfil de federación, Claude Code rechaza el inicio de sesión en lugar de sobrescribirlo

130* **De qué cierra sesión**: Claude Code cierra sesión de cualquier inicio de sesión de claude.ai almacenado en la máquina

131* **Cómo deshacerlo**: ejecute `/logout`, que elimina y revoca la credencial que escribió este inicio de sesión

132 

133Todo lo demás sobre perfiles se aplica a este inicio de sesión, incluido dónde se clasifica contra sus otras credenciales, la fila `Profile` que obtiene en `/status` y las características que necesitan un inicio de sesión de claude.ai. Consulte [Perfiles de Anthropic y credenciales de federación](#anthropic-profiles-and-federation-credentials).

134 

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

109 Autenticación del proveedor de nube136 Autenticación del proveedor de nube

110</h3>137</h3>

125 </Step>152 </Step>

126</Steps>153</Steps>

127 154 

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

156 Restringir el inicio de sesión a su organización

157</h3>

158 

159Para requerir que los inicios de sesión de claude.ai de los desarrolladores pertenezcan a una organización específica de Anthropic, establezca [`forceLoginMethod`](/docs/es/settings-reference#forceloginmethod) y [`forceLoginOrgUUID`](/docs/es/settings-reference#forceloginorguuid) en [configuración administrada](/docs/es/managed-settings). Establezca `forceLoginOrgUUID` en su ID de organización, que se muestra en [configuración de administrador de claude.ai](https://claude.ai/admin-settings/organization) para organizaciones de Claude for Teams o Enterprise. Claude Code reporta un error para un inicio de sesión de claude.ai en cualquier otra organización y sale al inicio si la credencial de claude.ai en uso pertenece a una organización que no está en la lista.

160 

161Para inicios de sesión de Claude Console, Claude Code usa `forceLoginOrgUUID` para preseleccionar la organización en la página de inicio de sesión de Console cuando lo establece en un único ID de organización de Console, que se muestra en [platform.claude.com/settings/organization](https://platform.claude.com/settings/organization). No verifica a qué organización pertenece la credencial de Console resultante, en el inicio de sesión o al inicio, y un desarrollador que inició sesión con una cuenta de Console antes de que implementara las claves permanece conectado.

162 

163Si establece `forceLoginOrgUUID` en cualquier archivo de configuración, Claude Code deja de ofrecer el [inicio de sesión de Console sin claves](#sign-in-without-an-api-key) en las sesiones a las que se aplica ese archivo y crea una clave API en su lugar. Para dirigir a los desarrolladores al inicio de sesión de claude.ai en su lugar, establezca `forceLoginMethod` en `"claudeai"`.

164 

165Los desarrolladores pueden iniciar sesión desde varias rutas: el flujo de terminal `/login`, la [extensión de VS Code](/docs/es/vs-code), el Agent SDK, `claude setup-token`, `/install-github-app` e [inicio de sesión de puerta de enlace](/docs/es/claude-apps-gateway) para organizaciones que enrutan a través de una puerta de enlace de nube. En Claude Code v2.1.212 o posterior, cada ruta aplica `forceLoginMethod`; antes de v2.1.212, solo los inicios de sesión de terminal aplicaban cualquiera de las claves. En la pantalla de inicio de sesión interactivo del terminal, a la que se accede mediante `/login` u onboarding de primera ejecución, Claude Code preselecciona un método `claudeai` o `console` sin aplicarlo, por lo que incluso con `forceLoginMethod` establecido en `"claudeai"`, un desarrollador aún puede completar un inicio de sesión de Console allí. Las rutas difieren en `forceLoginOrgUUID`:

166 

167* **Terminal, extensión de VS Code e inicios de sesión de Agent SDK**: verifican `forceLoginOrgUUID` para inicios de sesión de cuenta de claude.ai

168* **`claude setup-token` e `/install-github-app`**: aplican solo `forceLoginMethod`, por lo que pueden acuñar un token en una organización diferente

169* **Inicio de sesión de [puerta de enlace](/docs/es/claude-apps-gateway)**: seleccionado por `forceLoginMethod: "gateway"` en lugar de restringido por él, y no se autentica contra una organización de Anthropic, por lo que `forceLoginOrgUUID` no se aplica; use su proveedor de identidad de puerta de enlace para restringir el acceso

170 

171Implemente las claves a través de su herramienta de administración de dispositivos. [La configuración administrada por servidor](/docs/es/server-managed-settings) solo llega a cuentas que ya están autenticadas en su organización, por lo que no pueden redirigir el primer inicio de sesión de un desarrollador. Si su organización también distribuye configuración administrada por servidor, establezca las claves en ambos lugares: las fuentes de [configuración administrada no se fusionan](/docs/es/server-managed-settings#settings-precedence), y la configuración administrada por servidor en caché reemplaza el archivo administrado por dispositivo, aparte de dos tipos de claves que aún se completan desde una fuente perdedora:

172 

173* **El bloque `env`**: [se fusiona por clave](/docs/es/server-managed-settings#per-key-exceptions-across-managed-sources) en Claude Code v2.1.223 o posterior

174* **Las [claves de bloqueo entre fuentes](/docs/es/server-managed-settings#per-key-exceptions-across-managed-sources)**: honradas desde cualquier fuente de administrador

175 

176`forceLoginMethod` y `forceLoginOrgUUID` no son ninguno de estos, así que manténgalos en ambos lugares.

177 

178Las claves también deciden si una sesión que no usa una credencial de inicio de sesión puede iniciarse. Consulte [`forceLoginOrgUUID`](/docs/es/settings-reference#forceloginorguuid) en la referencia de configuración para el comportamiento completo.

179 

180* **`ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper`**: bloqueados al inicio, ya que la pertenencia a la organización no se puede verificar para una credencial de entorno

181* **Sesiones de proveedor de nube como Amazon Bedrock**: no bloqueadas, porque se autentican contra su proveedor de nube. Restrinja esas a través de sus políticas de IAM en la nube

182* **[Perfil de Anthropic o credenciales de federación](#anthropic-profiles-and-federation-credentials)**: no bloqueadas, y las claves no verifican a qué organización pertenece el perfil

183 

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

129 Gestión de credenciales185 Gestión de credenciales

130</h2>186</h2>

132Claude Code administra de forma segura sus credenciales de autenticación:188Claude Code administra de forma segura sus credenciales de autenticación:

133 189 

134* **Ubicación de almacenamiento**:190* **Ubicación de almacenamiento**:

135 * En macOS, las credenciales se almacenan en el Keychain de macOS cifrado.191 * En macOS, las credenciales se almacenan en el Keychain de macOS cifrado. Cuando el Keychain rechaza la escritura, como cuando está bloqueado en una sesión SSH, Claude Code almacena su inicio de sesión en `~/.claude/.credentials.json` con modo de archivo `0600` en su lugar, el mismo almacenamiento que utiliza en Linux. Un inicio de sesión de Console que crea una clave API falla hasta que el Keychain sea escribible. Para mover su inicio de sesión de vuelta al Keychain, siga [los pasos de recuperación](/docs/es/troubleshoot-install#not-logged-in-or-token-expired).

136 * En Linux, las credenciales se almacenan en `~/.claude/.credentials.json` con modo de archivo `0600`.192 * En Linux, las credenciales se almacenan en `~/.claude/.credentials.json` con modo de archivo `0600`.

137 * En Windows, las credenciales se almacenan en `%USERPROFILE%\.claude\.credentials.json` y heredan los controles de acceso del directorio de su perfil de usuario, lo que restringe el archivo a su cuenta de usuario de forma predeterminada.193 * En Windows, las credenciales se almacenan en `%USERPROFILE%\.claude\.credentials.json` y heredan los controles de acceso del directorio de su perfil de usuario, lo que restringe el archivo a su cuenta de usuario de forma predeterminada.

138 * Si ha establecido la variable de entorno `CLAUDE_CONFIG_DIR` en Linux o Windows, el archivo `.credentials.json` se encuentra en ese directorio en su lugar.194 * Si ha establecido la variable de entorno `CLAUDE_CONFIG_DIR`, Claude Code mantiene el archivo `.credentials.json` bajo ese directorio en su lugar, incluido el archivo que escribe la alternativa de macOS, y también asigna la entrada del Keychain de macOS a ese directorio, por lo que una sesión con un `CLAUDE_CONFIG_DIR` diferente lee una entrada diferente.

139 * Claude Code administra `.credentials.json` a través de `/login` y `/logout`. Para enrutar solicitudes a través de un punto final de API personalizado, establezca la variable de entorno [`ANTHROPIC_BASE_URL`](/docs/es/env-vars) en su lugar.195 * Claude Code administra `.credentials.json` a través de `/login` y `/logout`. Para enrutar solicitudes a través de un punto final de API personalizado, establezca la variable de entorno [`ANTHROPIC_BASE_URL`](/docs/es/env-vars) en su lugar.

140* **Tipos de autenticación admitidos**: credenciales de Claude.ai, credenciales de API de Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth y tokens de sesión de [puerta de enlace de aplicaciones Claude](/docs/es/claude-apps-gateway).196* **Tipos de autenticación admitidos**: credenciales de Claude.ai, credenciales de API de Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, credenciales de perfil de Anthropic y [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation), y tokens de sesión de [puerta de enlace de aplicaciones Claude](/docs/es/claude-apps-gateway).

141* **Scripts de credenciales personalizados**: la configuración [`apiKeyHelper`](/docs/es/settings#available-settings) se puede configurar para ejecutar un script de shell que devuelva una clave API.197* **Scripts de credenciales personalizados**: configure la configuración [`apiKeyHelper`](/docs/es/settings-reference#apikeyhelper) para ejecutar un script de shell que devuelva una clave API.

142* **Intervalos de actualización**: por defecto, `apiKeyHelper` se llama después de 5 minutos o en respuesta HTTP 401. Establezca la variable de entorno `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` para intervalos de actualización personalizados.198* **Intervalos de actualización**: Claude Code vuelve a ejecutar `apiKeyHelper` después de cinco minutos de forma predeterminada. Establezca la variable de entorno `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` para intervalos de actualización personalizados. Consulte [`apiKeyHelper`](/docs/es/settings-reference#apikeyhelper) para los otros casos en los que Claude Code vuelve a ejecutar el helper.

143* **Aviso de helper lento**: si `apiKeyHelper` tarda más de 10 segundos en devolver una clave, Claude Code muestra un aviso de advertencia en la barra de símbolo del sistema mostrando el tiempo transcurrido. Si ve este aviso regularmente, verifique si su script de credenciales se puede optimizar.199* **Aviso de helper lento**: si `apiKeyHelper` tarda más de 10 segundos en devolver una clave, Claude Code muestra un aviso de advertencia en la barra de símbolo del sistema mostrando el tiempo transcurrido. Si ve este aviso regularmente, verifique si su script de credenciales se puede optimizar.

144* **Fallos del helper**: cuando el script sale con un error, agota el tiempo de espera o no imprime nada, las solicitudes fallan con [`Your apiKeyHelper script is failing`](/docs/es/errors#your-apikeyhelper-script-is-failing) dentro de tres intentos. Antes de v2.1.208, los fallos del helper aparecían como un 401 genérico después de aproximadamente diez reintentos silenciosos.200* **Fallos del helper**: cuando el script sale con un error, agota el tiempo de espera o no imprime nada, las solicitudes fallan con [`Your apiKeyHelper script is failing`](/docs/es/errors#your-apikeyhelper-script-is-failing) dentro de tres intentos. Antes de v2.1.208, los fallos del helper aparecían como un 401 genérico después de aproximadamente diez reintentos silenciosos.

145 201 

149 Renovar un inicio de sesión que está por expirar205 Renovar un inicio de sesión que está por expirar

150</h3>206</h3>

151 207 

152Cuando el inicio de sesión que creó con `/login` está a menos de cinco días de expirar, Claude Code muestra una advertencia al inicio: `Your login expires in 3 days · run /login to renew`. Requiere Claude Code v2.1.203 o posterior.208Cuando el inicio de sesión que creó con `/login` está a menos de tres días de expirar, Claude Code muestra una advertencia al inicio: `Your login expires in 3 days · run /login to renew`. Requiere Claude Code v2.1.203 o posterior. Antes de v2.1.217, la advertencia aparecía cinco días antes.

153 209 

154Ejecute `/login` para renovar. La advertencia es informativa y nunca bloquea una solicitud: la autenticación sigue funcionando hasta que el inicio de sesión realmente expire. La duración del inicio de sesión en sí no cambia; la advertencia anticipada es lo que v2.1.203 añade.210Ejecute `/login` para renovar. La advertencia es informativa y nunca bloquea una solicitud: la autenticación sigue funcionando hasta que el inicio de sesión realmente expire. La duración del inicio de sesión en sí no cambia; la advertencia anticipada es lo que v2.1.203 añade.

155 211 

156Una vez que el inicio de sesión almacenado expira y no se puede actualizar, cada solicitud falla con [`Login expired · Please run /login`](/docs/es/errors#login-expired) hasta que inicie sesión nuevamente. Antes de v2.1.206, un inicio de sesión expirado aparecía como un error de modelo en su lugar.212Una vez que el inicio de sesión almacenado expira y no se puede actualizar, cada solicitud de modelo falla con [`Login expired · Please run /login`](/docs/es/errors#login-expired) hasta que inicie sesión nuevamente. Antes de v2.1.206, Claude Code reportaba un inicio de sesión expirado en solicitudes de modelo como un error de modelo en su lugar.

213 

214Puede verificar este estado antes de que una solicitud falle: [`/status`](/docs/es/commands) muestra una fila `Login` que dice `Expired — log in again`, más la organización y el correo electrónico que tiene guardados para el inicio de sesión expirado. La fila aparece solo cuando el inicio de sesión de claude.ai o Claude Console guardado es la credencial activa. La fila requiere Claude Code v2.1.210 o posterior.

157 215 

158La advertencia aparece solo cuando un inicio de sesión de claude.ai o Claude Console es la credencial activa, y no cuando un proveedor de nube, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper` proporciona la credencial.216La advertencia aparece solo cuando un inicio de sesión de claude.ai o Claude Console es la credencial activa, y no cuando un proveedor de nube, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper` proporciona la credencial.

159 217 

1681. Credenciales del proveedor de nube, cuando `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` o `CLAUDE_CODE_USE_FOUNDRY` está establecido. Consulte [integraciones de terceros](/docs/es/third-party-integrations) para la configuración.2261. Credenciales del proveedor de nube, cuando `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` o `CLAUDE_CODE_USE_FOUNDRY` está establecido. Consulte [integraciones de terceros](/docs/es/third-party-integrations) para la configuración.

1692. Variable de entorno `ANTHROPIC_AUTH_TOKEN`. Se envía como encabezado `Authorization: Bearer`. Use esto cuando enrute a través de una [puerta de enlace LLM o proxy](/docs/es/llm-gateway) que se autentica con tokens de portador en lugar de claves API de Anthropic.2272. Variable de entorno `ANTHROPIC_AUTH_TOKEN`. Se envía como encabezado `Authorization: Bearer`. Use esto cuando enrute a través de una [puerta de enlace LLM o proxy](/docs/es/llm-gateway) que se autentica con tokens de portador en lugar de claves API de Anthropic.

1703. Variable de entorno `ANTHROPIC_API_KEY`. Se envía como encabezado `X-Api-Key`. Use esto para acceso directo a la API de Anthropic con una clave de [Claude Console](https://platform.claude.com). En modo interactivo, se le solicita una vez que apruebe o rechace la clave, y su elección se recuerda. Para cambiarla más tarde, use el botón de alternancia "Use custom API key" en `/config`. El botón de alternancia solo aparece mientras `ANTHROPIC_API_KEY` está establecido en su entorno. En modo no interactivo (`-p`), la clave siempre se usa cuando está presente.2283. Variable de entorno `ANTHROPIC_API_KEY`. Se envía como encabezado `X-Api-Key`. Use esto para acceso directo a la API de Anthropic con una clave de [Claude Console](https://platform.claude.com). En modo interactivo, se le solicita una vez que apruebe o rechace la clave, y su elección se recuerda. Para cambiarla más tarde, use el botón de alternancia "Use custom API key" en `/config`. El botón de alternancia solo aparece mientras `ANTHROPIC_API_KEY` está establecido en su entorno. En modo no interactivo (`-p`), la clave siempre se usa cuando está presente.

1714. Salida del script [`apiKeyHelper`](/docs/es/settings#available-settings). Use esto para credenciales dinámicas o rotativas, como tokens de corta duración obtenidos de un almacén.2294. Salida del script [`apiKeyHelper`](/docs/es/settings-reference#apikeyhelper). Use esto para credenciales dinámicas o rotativas, como tokens de corta duración obtenidos de un almacén.

1725. Variable de entorno `CLAUDE_CODE_OAUTH_TOKEN`. Un token OAuth de larga duración generado por [`claude setup-token`](#generate-a-long-lived-token). Use esto para canalizaciones de CI y scripts donde el inicio de sesión del navegador no está disponible.2305. Variable de entorno `CLAUDE_CODE_OAUTH_TOKEN`. Un token OAuth de larga duración generado por [`claude setup-token`](#generate-a-long-lived-token). Use esto para canalizaciones de CI y scripts donde el inicio de sesión del navegador no está disponible. Si ejecuta `/login` mientras la variable está establecida, Claude Code cambia la sesión actual al nuevo inicio de sesión, pero lee la variable nuevamente en cada nueva sesión hasta que la elimine del perfil de su shell o del bloque `env` de un [archivo de configuración](/docs/es/settings).

1736. Credenciales OAuth de suscripción de `/login`. Este es el predeterminado para usuarios de Claude Pro, Max, Team y Enterprise.2316. Credenciales de perfil de Anthropic y de federación, las credenciales que utiliza la CLI `ant` y Workload Identity Federation. Un perfil que `ant auth login` escribió se clasifica aquí solo cuando lo nombra en `ANTHROPIC_PROFILE`; de lo contrario, se clasifica por debajo de `/login`. Consulte [Perfiles de Anthropic y credenciales de federación](#anthropic-profiles-and-federation-credentials).

2327. Credenciales OAuth de suscripción de `/login`. Este es el predeterminado para usuarios de Claude Pro, Max, Team y Enterprise.

174 233 

175Una sesión de [puerta de enlace de aplicaciones Claude](/docs/es/claude-apps-gateway) con sesión iniciada se encuentra fuera de esta lista: es una selección de proveedor como Amazon Bedrock o la Plataforma de Agentes de Google Cloud, y los supera. Cuando existe una sesión de puerta de enlace, la CLI se autentica con el token de puerta de enlace incluso si `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` o `CLAUDE_CODE_USE_FOUNDRY` está establecido, y las entradas de token de portador, clave API y `apiKeyHelper` anteriores no se utilizan.234Una sesión de [puerta de enlace de aplicaciones Claude](/docs/es/claude-apps-gateway) con sesión iniciada se encuentra fuera de esta lista: es una selección de proveedor como Amazon Bedrock o la Plataforma de Agentes de Google Cloud, y los supera. Cuando existe una sesión de puerta de enlace, la CLI se autentica con el token de puerta de enlace incluso si `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` o `CLAUDE_CODE_USE_FOUNDRY` está establecido, y las fuentes de credenciales anteriores como el token de portador, la clave API, `apiKeyHelper` y los perfiles no se utilizan.

176 235 

177Si tiene una suscripción activa de Claude pero también tiene `ANTHROPIC_API_KEY` establecido en su entorno, la clave API tiene precedencia una vez aprobada. Esto puede causar fallos de autenticación si la clave pertenece a una organización deshabilitada o expirada. Ejecute `unset ANTHROPIC_API_KEY` para volver a su suscripción y verifique `/status` para confirmar qué método está activo. La fila `Login method` muestra su cuenta de suscripción, y aparece una fila `API key` cuando se está utilizando una clave API.236Si tiene una suscripción activa de Claude pero también tiene `ANTHROPIC_API_KEY` establecido en su entorno, la clave API tiene precedencia una vez aprobada. Esto puede causar fallos de autenticación si la clave pertenece a una organización deshabilitada o expirada. Ejecute `unset ANTHROPIC_API_KEY` para volver a su suscripción y verifique `/status` para confirmar qué método está activo. La fila `Login method` muestra su cuenta de suscripción, y aparece una fila `API key` cuando se está utilizando una clave API.

178 237 

179[Claude Code en la Web](/docs/es/claude-code-on-the-web) siempre usa sus credenciales de suscripción. Si establece `ANTHROPIC_API_KEY` o `ANTHROPIC_AUTH_TOKEN` en el entorno de sandbox, no anula sus credenciales de suscripción.238[Claude Code en la Web](/docs/es/claude-code-on-the-web) siempre usa sus credenciales de suscripción. Si establece `ANTHROPIC_API_KEY` o `ANTHROPIC_AUTH_TOKEN` en el entorno de sandbox, no anula sus credenciales de suscripción.

180 239 

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

241 Perfiles de Anthropic y credenciales de federación

242</h4>

243 

244Un perfil es un archivo de configuración de credenciales nombrado en su [directorio de configuración de Anthropic](https://platform.claude.com/docs/en/manage-claude/wif-reference#configuration-directory), de forma predeterminada `~/.config/anthropic` en macOS y Linux o `%APPDATA%\Anthropic` en Windows. El modo de autenticación de un perfil es `oidc_federation` cuando lo configura para [Workload Identity Federation (WIF)](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) o `user_oauth` cuando [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) lo escribió o usted [inició sesión en una cuenta de Console sin una clave API](#sign-in-without-an-api-key).

245 

246Claude Code no lee perfiles o variables de federación en [modo bare](/docs/es/headless#start-faster-with-bare-mode), en Claude Desktop o en sesiones en la nube. En esas sesiones, `/status` no muestra ninguna fila `Profile`.

247 

248Claude Code verifica tres fuentes en este orden y se detiene en la primera que está establecida. La tabla muestra qué establece cada fuente y dónde se clasifica contra su credencial `/login`.

249 

250| Fuente | Establecido por | Clasificación contra `/login` |

251| :---------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |

252| Perfil nombrado | `ANTHROPIC_PROFILE` | Arriba, cualquiera que sea el modo de autenticación que tenga el perfil |

253| Variables de federación | `ANTHROPIC_FEDERATION_RULE_ID` y `ANTHROPIC_ORGANIZATION_ID`, ambas establecidas | Arriba |

254| Perfil activo | El archivo [`active_config`](https://platform.claude.com/docs/en/manage-claude/wif-reference#active-profile) en su directorio de configuración, o un perfil nombrado `default` | Arriba cuando su modo de autenticación es `oidc_federation`; debajo de una credencial `/login` que funciona cuando su modo de autenticación es `user_oauth` |

255 

256La regla `user_oauth` evita que un perfil `ant auth login` sobrante mueva sus solicitudes fuera de la cuenta en la que inició sesión con `/login`. Para las variables de federación, Claude Code también lee las otras variables en la [referencia de WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#environment-variables), como `ANTHROPIC_IDENTITY_TOKEN_FILE`, cuando intercambia su token de identidad. Para el formato del archivo de perfil, consulte la [referencia de WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#profile-configuration-file).

257 

258Para confirmar qué fuente eligió Claude Code, ejecute `/status`: una fila `Profile` nombra la fuente en lugar de la fila `Login method`. Si inicia Claude Code con `--debug`, también escribe una línea `Using Anthropic profile auth` con el nombre de la fuente en el registro de depuración en `~/.claude/debug/<session-id>.txt`. Cuando Claude Code pasa por un perfil activo `user_oauth` porque tiene una credencial `/login` que funciona, escribe una advertencia en el registro de depuración diciendo que está usando el inicio de sesión de claude.ai en su lugar. Cuando el inicio de sesión de un perfil `user_oauth` ha expirado y Claude Code no puede renovarlo, las solicitudes fallan con [Anthropic profile login expired](/docs/es/errors#anthropic-profile-login-expired).

259 

260Las características que necesitan su inicio de sesión de claude.ai, como [conectores de claude.ai](/docs/es/mcp#use-mcp-servers-from-claude-ai) y [`/schedule`](/docs/es/routines), no están disponibles mientras una de estas fuentes está seleccionada. Para evitar que Claude Code seleccione una fuente:

261 

262* **Perfil nombrado o variables de federación**: desestablezca `ANTHROPIC_PROFILE`, o desestablezca cualquiera de las variables de federación

263* **Perfil activo**: ejecute `/logout` para un perfil `user_oauth` cuya credencial actual escribió [iniciando sesión en una cuenta de Console sin una clave API](#sign-in-without-an-api-key), ejecute `ant auth logout` para uno cuya credencial actual escribió `ant auth login`, o elimine el archivo del perfil de `configs/` en su directorio de configuración para cualquier modo de autenticación

264 

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

182 Generar un token de larga duración266 Generar un token de larga duración

183</h3>267</h3>

188claude setup-token272claude setup-token

189```273```

190 274 

191El comando lo guía a través de la autorización OAuth e imprime un token en el terminal. No guarda el token en ningún lugar; cópielo y establézcalo como la variable de entorno `CLAUDE_CODE_OAUTH_TOKEN` donde desee autenticarse:275El comando abre el mismo flujo de autorización del navegador que `/login`, y el token se imprime en la terminal después de que apruebe el acceso en el navegador. No guarda el token en ningún lugar; cópielo y establézcalo como la variable de entorno `CLAUDE_CODE_OAUTH_TOKEN` donde desee autenticarse:

192 276 

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

194export CLAUDE_CODE_OAUTH_TOKEN=your-token278export CLAUDE_CODE_OAUTH_TOKEN=your-token

195```279```

196 280 

197Este token se autentica con su suscripción de Claude y requiere un plan Pro, Max, Team o Enterprise. Se limita solo a inferencia y no puede establecer sesiones de [Remote Control](/docs/es/remote-control).281Este token se autentica con su suscripción de Claude y requiere un plan Pro, Max, Team o Enterprise. Solo puede hacer solicitudes de modelo, por lo que no puede establecer sesiones de [Remote Control](/docs/es/remote-control) u obtener [conectores de claude.ai](/docs/es/mcp#use-mcp-servers-from-claude-ai). Los servidores MCP que configura localmente siguen funcionando.

198 282 

199[Bare mode](/docs/es/headless#start-faster-with-bare-mode) no lee `CLAUDE_CODE_OAUTH_TOKEN`. Si su script pasa `--bare`, autentíquese con `ANTHROPIC_API_KEY` o un `apiKeyHelper` en su lugar.283[Bare mode](/docs/es/headless#start-faster-with-bare-mode) no lee `CLAUDE_CODE_OAUTH_TOKEN`. Si su script pasa `--bare`, autentíquese con `ANTHROPIC_API_KEY` o un `apiKeyHelper` en su lugar.