--- title: Opciones de autenticación de la CLI url: https://platform.claude.com/docs/es/cli-sdks-libraries/cli/authentication description: Autentica la CLI de ant con inicio de sesión interactivo, claves de API, perfiles con nombre y Workload Identity Federation. --- La CLI de `ant` admite varias fuentes de credenciales. El [Quickstart](https://platform.claude.com/docs/es/cli-sdks-libraries/cli/quickstart#authentication) cubre el camino feliz de un solo comando (`ant auth login`). Esta página cubre cada opción en su totalidad. ## Inicio de sesión interactivo `ant auth login` te permite llamar a la API sin crear ni gestionar una clave de API. Abre un flujo OAuth basado en navegador contra la Claude Console y almacena las credenciales resultantes en `$ANTHROPIC_CONFIG_DIR` (consulta [Directorio de configuración](https://platform.claude.com/docs/es/manage-claude/wif-reference#configuration-directory) para conocer el valor predeterminado específico del sistema operativo). En un host remoto o en cualquier entorno sin un navegador local, pasa `--no-browser` para imprimir la URL de autorización y pegar el código devuelto de vuelta en la terminal. ```bash CLI ant auth login # En un host remoto sin navegador: ant auth login --no-browser # Vincula a un espacio de trabajo específico y omite el selector del navegador: ant auth login --workspace-id wrkspc_01... # Si el perfil con nombre que pasas con --profile no existe, # se creará un nuevo perfil con ese nombre. ant auth login --profile ``` Durante el flujo del navegador, seleccionas una organización y luego un [workspace](https://platform.claude.com/docs/es/manage-claude/workspaces). El token emitido está [limitado a ese workspace](https://platform.claude.com/docs/es/manage-claude/workspaces#api-keys-and-resource-scoping), por lo que la CLI solo puede ver los recursos que le pertenecen. Pasa `--workspace-id` para vincular directamente y omitir el selector. Para trabajar en más de un workspace, consulta [Cambiar entre workspaces](https://platform.claude.com/docs/es/cli-sdks-libraries/cli/authentication#switch-between-workspaces). El inicio de sesión interactivo está pensado para el desarrollo local y la creación de scripts en tu propia máquina. Para cargas de trabajo no interactivas como CI, servidores y contenedores, usa [Workload Identity Federation](https://platform.claude.com/docs/es/manage-claude/workload-identity-federation) en su lugar. El inicio de sesión escribe las credenciales en `credentials/.json`. El primer inicio de sesión de un perfil también crea `configs/.json` y lo establece como el perfil activo. Para eliminar las credenciales almacenadas, ejecuta `ant auth logout`, o `ant auth logout --all` para borrar todos los perfiles. ## Acceso de administrador De forma predeterminada, `ant auth login` solicita un token limitado al workspace. Para gestionar los recursos documentados en la página de la [Admin API](https://platform.claude.com/docs/es/manage-claude/admin-api), solicita el scope `org:admin` bajo un perfil dedicado: ```bash CLI ant auth login --profile admin --scope "org:admin" # Imprime un bearer token para los encabezados de Authorization: ant auth print-credentials --profile admin --access-token ``` El scope `org:admin` se otorga únicamente a los miembros de la organización con el rol de administrador, propietario o propietario principal. El token emitido tiene acceso a toda la organización, y cualquier vinculación de workspace en el perfil no lo restringe. Mantén el perfil de administrador separado de tu perfil cotidiano para que los comandos rutinarios nunca se ejecuten con acceso elevado. ## Clave de API La CLI también lee tu clave de API desde la variable de entorno `ANTHROPIC_API_KEY`. Obtén una clave desde la [Claude Console](https://platform.claude.com/settings/keys). ```bash echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.zshrc source ~/.zshrc ``` ```bash echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.bashrc source ~/.bashrc ``` ```powershell setx ANTHROPIC_API_KEY "sk-ant-api03-..." ``` Abre una nueva terminal para que el cambio surta efecto. Para anular la clave en una sola invocación, pasa `--api-key`. Para apuntar a un host de API diferente, establece `ANTHROPIC_BASE_URL` o pasa `--base-url`. Si estás usando una clave de API limitada a varios workspaces, como una [clave de cuenta personal o de servicio](https://platform.claude.com/docs/es/manage-claude/authentication#key-types), debes [especificar el workspace](https://platform.claude.com/docs/es/manage-claude/authentication#select-a-workspace) en el que ejecutar tu comando. Haz esto estableciendo una variable de entorno `ANTHROPIC_WORKSPACE_ID`, que la CLI lee automáticamente, o usando el [flag `--workspace-id`](https://platform.claude.com/docs/es/cli-sdks-libraries/cli/using#global-flags). El valor debe ser un ID `wrkspc_...`. ```bash CLI ant messages create \ --workspace-id wrkspc_01... \ --model claude-opus-5-5 \ --max-tokens 1024 \ --message '{role: user, content: "Hello, Claude"}' ``` ## Comprobar el estado de autenticación `ant auth status` imprime la fuente de credenciales que la CLI seleccionó (variable de entorno de clave de API, inicio de sesión OAuth, federación o perfil), el perfil activo, el workspace al que está vinculado el token activo y las rutas del directorio de configuración. Úsalo para diagnosticar por qué una carga de trabajo eligió la credencial o el workspace incorrectos. ```bash CLI ant auth status ``` ```text Active profile: default Config dir: ~/.config/anthropic Profile config: ~/.config/anthropic/configs/default.json Credentials: ~/.config/anthropic/credentials/default.json Credentials (active) * Profile (user_oauth) [via active_config] sk-ant-oat01-EXA... ... Workspace (active) * Workspace wrkspc_01... (Engineering) ``` Lee las filas `(active)` para ver qué fuente de credenciales y workspace ganaron. El comando informa el estado en lugar de realizar una comprobación de salud, así que no crees scripts basados en el estado de salida. Para conocer el orden completo de las fuentes de credenciales, consulta [Precedencia de credenciales](https://platform.claude.com/docs/es/manage-claude/wif-reference#credential-precedence). ## Cambiar entre workspaces Un token de inicio de sesión interactivo está vinculado a un único workspace. Para usar la CLI contra más de un workspace, inicia sesión en cada uno bajo su propio perfil con nombre y luego cambia entre ellos: ```bash CLI # 1. Crea el perfil (interactivo; elige el otro workspace en el # navegador, o pasa --workspace-id para omitir el selector): # ant auth login --profile other-ws # 2. Conviértelo en el predeterminado para los comandos siguientes: ant profile activate other-ws # 3. O selecciónalo para un solo comando sin cambiar el predeterminado: ant --profile other-ws models list ANTHROPIC_PROFILE=other-ws ant models list ``` Ejecuta [`ant auth status`](https://platform.claude.com/docs/es/cli-sdks-libraries/cli/authentication#check-authentication-status) para confirmar qué perfil y workspace están activos. Los perfiles solo se consultan cuando no hay ninguna clave de API establecida. Si `ANTHROPIC_API_KEY` está presente en tu entorno, anula todos los perfiles y estos comandos usan el workspace de esa clave (o, para una clave de varios workspaces, el workspace establecido con `ANTHROPIC_WORKSPACE_ID` o `--workspace-id`). Desactívala antes de cambiar de perfil. ## Gestionar perfiles Los subcomandos `ant profile` inspeccionan y editan el estado del perfil directamente: ```bash CLI ant profile list ant profile get --profile other-ws ant profile set workspace_id wrkspc_01... --profile other-ws ``` Las claves editables para `ant profile set` son `workspace_id`, `base_url`, `organization_id`, `scope`, `client_id` y `console_url`. Establecer `workspace_id` registra el workspace de destino en la configuración del perfil, pero no vuelve a vincular las credenciales que ya se emitieron; ejecuta `ant auth login` de nuevo bajo ese perfil para acuñar un token para el nuevo workspace. Para conocer el esquema del archivo de perfil y el bloque de federación, consulta [Archivo de configuración de perfil](https://platform.claude.com/docs/es/manage-claude/wif-reference#profile-configuration-file). Para Workload Identity Federation, consulta la [Descripción general de autenticación](https://platform.claude.com/docs/es/manage-claude/authentication) y la [referencia de WIF](https://platform.claude.com/docs/es/manage-claude/wif-reference). ## Próximos pasos Estructura de comandos, formatos de salida, transformaciones GJSON y cuerpos de solicitud Control de versiones de recursos de API, patrones de scripting y uso desde Claude Code Autenticación no interactiva para CI, servidores y contenedores