Autenticación
Inicie sesión en Claude Code y configure la autenticación para individuos, equipos y organizaciones.
Claude Code admite múltiples métodos de autenticación según su configuración. Los usuarios individuales pueden iniciar sesión con una cuenta de Claude.ai, mientras que los equipos pueden usar Claude for Teams o Enterprise, la Claude Console, o un proveedor de nube como Amazon Bedrock, Google Vertex AI o Microsoft Foundry.
Inicie sesión en Claude Code
Después de instalar Claude Code, ejecute claude en su terminal. En el primer lanzamiento, Claude Code abre una ventana del navegador para que inicie sesión.
Si 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.
Si su navegador muestra un código de inicio de sesión en lugar de redirigirse después de que inicie sesión, péguelo en el terminal en el símbolo del sistema Paste code here if prompted. Esto sucede cuando el navegador no puede alcanzar el servidor de devolución de llamada local de Claude Code, lo cual es común en WSL2, sesiones SSH y contenedores.
Puede autenticarse con cualquiera de estos tipos de cuenta:
- Suscripción Claude Pro o Max: inicie sesión con su cuenta de Claude.ai. Suscríbase en claude.com/pricing.
- Claude for Teams o Enterprise: inicie sesión con la cuenta de Claude.ai que su administrador de equipo le invitó a usar.
- Claude Console: inicie sesión con sus credenciales de Console. Su administrador debe haberle invitado primero.
- Proveedores de nube: si su organización usa Amazon Bedrock, Google Vertex AI o Microsoft Foundry, establezca las variables de entorno requeridas antes de ejecutar
claude. No se necesita inicio de sesión en el navegador.
Para cerrar sesión y volver a autenticarse, escriba /logout en el símbolo del sistema de Claude Code.
Si tiene problemas para iniciar sesión, consulte solución de problemas de autenticación.
Configure la autenticación del equipo
Para equipos y organizaciones, puede configurar el acceso a Claude Code de una de estas formas:
- Claude for Teams o Enterprise, recomendado para la mayoría de los equipos
- Claude Console
- Amazon Bedrock
- Google Vertex AI
- Microsoft Foundry
Claude for Teams o Enterprise
Claude for Teams y Claude for Enterprise proporcionan la mejor experiencia para organizaciones que usan Claude Code. Los miembros del equipo obtienen acceso tanto a Claude Code como a Claude en la web con facturación centralizada y gestión de equipos.
- Claude for Teams: plan de autoservicio con características de colaboración, herramientas de administración y gestión de facturación. Mejor para equipos más pequeños.
- Claude for Enterprise: añade SSO, captura de dominio, permisos basados en roles, API de cumplimiento y configuración de políticas administradas para configuraciones de Claude Code en toda la organización. Mejor para organizaciones más grandes con requisitos de seguridad y cumplimiento.
Suscribirse
Suscríbase a Claude for Teams o póngase en contacto con ventas para Claude for Enterprise.
Invitar a miembros del equipo
Invite a miembros del equipo desde el panel de administración.
Instalar e iniciar sesión
Los miembros del equipo instalan Claude Code e inician sesión con sus cuentas de Claude.ai.
Autenticación de Claude Console
Para organizaciones que prefieren facturación basada en API, puede configurar el acceso a través de Claude Console.
Crear o usar una cuenta de Console
Use su cuenta de Claude Console existente o cree una nueva.
Agregar usuarios
Puede agregar usuarios mediante cualquiera de estos métodos:
- Invitar usuarios en masa desde dentro de Console: Settings -> Members -> Invite
- Configurar SSO
Asignar roles
Al invitar usuarios, asigne uno de:
- Rol Claude Code: los usuarios solo pueden crear claves API de Claude Code
- Rol Developer: los usuarios pueden crear cualquier tipo de clave API
Los usuarios completan la configuración
Cada usuario invitado necesita:
- Aceptar la invitación de Console
- Verificar requisitos del sistema
- Instalar Claude Code
- Iniciar sesión con credenciales de cuenta de Console
Autenticación del proveedor de nube
Para equipos que usan Amazon Bedrock, Google Vertex AI o Microsoft Foundry:
Seguir la configuración del proveedor
Siga la documentación de Bedrock, documentación de Vertex o documentación de Microsoft Foundry.
Distribuir configuración
Distribuya las variables de entorno e instrucciones para generar credenciales de nube a sus usuarios. Lea más sobre cómo administrar la configuración aquí.
Instalar Claude Code
Los usuarios pueden instalar Claude Code.
Gestión de credenciales
Claude Code administra de forma segura sus credenciales de autenticación:
- Ubicación de almacenamiento: en macOS, las credenciales se almacenan en el Keychain de macOS cifrado. En Linux y Windows, las credenciales se almacenan en
~/.claude/.credentials.json, o bajo$CLAUDE_CONFIG_DIRsi esa variable está establecida. En Linux, el archivo se escribe con modo0600; en Windows, hereda los controles de acceso del directorio de su perfil de usuario. - Tipos de autenticación admitidos: credenciales de Claude.ai, credenciales de API de Claude, Azure Auth, Bedrock Auth y Vertex Auth.
- Scripts de credenciales personalizados: la configuración
apiKeyHelperse puede configurar para ejecutar un script de shell que devuelva una clave API. - Intervalos de actualización: por defecto,
apiKeyHelperse llama después de 5 minutos o en respuesta HTTP 401. Establezca la variable de entornoCLAUDE_CODE_API_KEY_HELPER_TTL_MSpara intervalos de actualización personalizados. - Aviso de helper lento: si
apiKeyHelpertarda 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.
apiKeyHelper, ANTHROPIC_API_KEY y ANTHROPIC_AUTH_TOKEN se aplican solo a sesiones de CLI de terminal. Claude Desktop y sesiones remotas usan OAuth exclusivamente y no llaman a apiKeyHelper ni leen variables de entorno de clave API.
Precedencia de autenticación
Cuando hay múltiples credenciales presentes, Claude Code elige una en este orden:
- Credenciales del proveedor de nube, cuando
CLAUDE_CODE_USE_BEDROCK,CLAUDE_CODE_USE_VERTEXoCLAUDE_CODE_USE_FOUNDRYestá establecido. Consulte integraciones de terceros para la configuración. - Variable de entorno
ANTHROPIC_AUTH_TOKEN. Se envía como encabezadoAuthorization: Bearer. Use esto cuando enrute a través de una puerta de enlace LLM o proxy que se autentica con tokens de portador en lugar de claves API de Anthropic. - Variable de entorno
ANTHROPIC_API_KEY. Se envía como encabezadoX-Api-Key. Use esto para acceso directo a la API de Anthropic con una clave de Claude Console. 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. En modo no interactivo (-p), la clave siempre se usa cuando está presente. - Salida del script
apiKeyHelper. Use esto para credenciales dinámicas o rotativas, como tokens de corta duración obtenidos de un almacén. - Variable de entorno
CLAUDE_CODE_OAUTH_TOKEN. Un token OAuth de larga duración generado porclaude setup-token. Use esto para canalizaciones de CI y scripts donde el inicio de sesión del navegador no está disponible. - Credenciales OAuth de suscripción de
/login. Este es el predeterminado para usuarios de Claude Pro, Max, Team y Enterprise.
Si 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.
Claude Code en la Web siempre usa sus credenciales de suscripción. ANTHROPIC_API_KEY y ANTHROPIC_AUTH_TOKEN en el entorno de sandbox no las anulan.
Generar un token de larga duración
Para canalizaciones de CI, scripts u otros entornos donde el inicio de sesión interactivo del navegador no está disponible, genere un token OAuth de un año con claude setup-token:
claude setup-token
El 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:
export CLAUDE_CODE_OAUTH_TOKEN=your-token
Este 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.
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.