5. Autenticación, cuentas y modelos de Claude

Objetivo del tema

Entender cómo Claude Code accede a los modelos de Anthropic: las vías de autenticación disponibles (suscripción, API y nubes corporativas), la familia de modelos Claude y sus perfiles, cómo seleccionar y cambiar de modelo en la práctica, y cómo controlar límites y costos.

5.1 El modelo mental: identidad, proveedor y modelo

Son tres decisiones distintas. La identidad demuestra quién eres; el proveedor determina quién procesa y factura las solicitudes; el modelo decide capacidad, velocidad y consumo. Confundirlas es la causa más habitual de cargos inesperados.

Claude Code utiliza modelos Claude, pero los nombres disponibles y su versión pueden variar según proveedor, región, plan y políticas de la organización. Por eso conviene seleccionar mediante alias y comprobar el resultado con /status.

5.2 Suscripción de Claude.ai: Pro y Max

Las suscripciones son la puerta de entrada más usada. Los planes relevantes para desarrollo son:

El uso depende de la longitud del contexto, el modelo, el esfuerzo y la complejidad de la tarea. Los límites se comparten con otras superficies de Claude y pueden incluir ventanas de sesión y topes semanales. Al alcanzar un límite puedes esperar su renovación, cambiar de plan o continuar con créditos de uso si están habilitados. Consulta /usage y Settings > Usage; no estimes capacidad contando mensajes.

5.3 Anthropic API: la Console

La vía por API funciona con claves creadas en la Console de Anthropic, con facturación por uso (créditos prepago o facturación a medida). El flujo de configuración:

export ANTHROPIC_API_KEY="sk-ant-..."

Con API pagas tanto por el contexto enviado como por la respuesta. /cost muestra tokens y gasto de la sesión; en una suscripción esa cifra no representa un cargo adicional. Para CI usa credenciales y presupuestos administrados por tu organización: no copies credenciales personales almacenadas por la CLI.

# macOS y Linux: terminal actual
unset ANTHROPIC_API_KEY

# Windows PowerShell: sesión actual
Remove-Item Env:ANTHROPIC_API_KEY

5.4 Cuentas corporativas y proveedores de nube

Para organizaciones, Claude Code se integra con las opciones empresariales de Anthropic: planes Team y Enterprise con inicio de sesión único (SSO), administración centralizada, registro de auditoría y garantías de que el contenido de los clientes no se usa para entrenar modelos.

Además, los modelos Claude pueden ejecutarse sobre la infraestructura de nube que la empresa ya tiene:

export CLAUDE_CODE_USE_BEDROCK=1   # Amazon Bedrock
export CLAUDE_CODE_USE_VERTEX=1    # Google Vertex AI
export CLAUDE_CODE_USE_FOUNDRY=1   # Microsoft Foundry

Credenciales, regiones, identificadores y permisos se configuran en cada proveedor. No asumas que un modelo disponible en la API directa aparece el mismo día en todas las nubes. Una organización también puede imponer una lista de modelos y ajustes administrados.

5.5 Gestión de sesión y credenciales

La autenticación se administra con comandos simples dentro del agente:

• /login: inicia sesión o cambia de cuenta (por ejemplo, de la personal a la del trabajo).
• /logout: cierra la sesión actual en esa máquina.
• /status: muestra la cuenta activa, el modelo configurado y el estado de conexión.

Claude Code utiliza el mecanismo seguro disponible para persistir la sesión. Las variables de entorno, archivos .env, scripts auxiliares y credenciales de nube quedan bajo tu responsabilidad. Si alternas cuentas o proveedores, revisa /status al comenzar y después de cada cambio de entorno.

5.6 La familia de modelos Claude

Claude Code trabaja con tres tamaños de modelo, cada uno con un perfil claro. Dentro de cada tamaño existen versiones generacionales (las 4.x son las actuales), que el agente selecciona automáticamente según disponibilidad:

Los alias opus, sonnet y haiku apuntan a la versión recomendada disponible para tu proveedor y se actualizan con el tiempo. Son ideales para trabajo interactivo. Para reproducibilidad estricta en CI, fija un identificador completo y planifica su actualización. Las variantes opus[1m] y sonnet[1m] sólo aparecen cuando la cuenta y el proveedor admiten contexto extendido.

5.7 Seleccionar modelo en la práctica

Tienes cuatro palancas para decidir qué modelo trabaja en cada momento:

{
  "model": "sonnet"
}

El orden de prioridad es: selección durante la sesión, bandera de arranque, ANTHROPIC_MODEL y finalmente settings.json. /model cambia la sesión actual; para guardar el valor predeterminado usa la opción correspondiente del selector o edita la configuración. Ejecuta /model default para volver a la recomendación de tu cuenta.

Un modo especialmente útil para suscriptores Max es Opus Plan Mode (/model opusplan): usa el modelo grande para razonar y planificar, y Sonnet para ejecutar la implementación. Así concentras el gasto de Opus dónde más aporta, sin renunciar a la velocidad de Sonnet en la escritura de código.

5.8 Esfuerzo de razonamiento y modelos auxiliares

En modelos compatibles, el esfuerzo controla cuánto razonamiento adaptativo puede dedicar Claude. Menor esfuerzo reduce latencia y consumo; mayor esfuerzo conviene para arquitectura, depuración difícil o migraciones delicadas.

/effort low       # tarea directa y mecánica
/effort high      # problema complejo
/effort auto      # vuelve al valor recomendado

claude --model opus --effort high

Los niveles disponibles dependen del modelo. /effort muestra el selector válido y max, cuando existe, se aplica sólo a la sesión. Las frases think, think hard y similares son texto normal del prompt: no sustituyen a /effort.

Claude Code también puede usar Haiku para funciones auxiliares. En despliegues controlados configura el alias con ANTHROPIC_DEFAULT_HAIKU_MODEL; la antigua variable ANTHROPIC_SMALL_FAST_MODEL está obsoleta.

5.9 ¿Cómo elegir el modelo adecuado?

5.10 Control de límites y costos

• En suscripción: consulta /usage con frecuencia; reparte el trabajo pesado (migraciones, refactors largos) en ventanas de uso distintas y deja lo mecánico para Haiku.
• En API: define presupuestos y alertas en la Console; revisa /cost al final de cada sesión para entender qué tipo de tareas consumen más.
• Optimiza el contexto: el mayor costo oculto es el contexto reenviado en cada turno. Usa /clear al cambiar de tema, /compact en sesiones largas y evita pegar archivos completos cuando una referencia basta.
• Prompts que ahorran: pedir un plan antes de ejecutar evita re-trabajos; pedir tests verdes antes del reporte evita idas y vueltas que se facturan.

5.11 Diagnóstico de cuenta y facturación

Antes de una tarea larga, y siempre que el consumo no coincida con lo esperado, sigue este orden:

Si cambias de identidad con /logout y /login, inicia una sesión nueva y vuelve a comprobar /status. No publiques capturas que revelen correo, identificadores de organización, saldo o fragmentos de credenciales.

5.12 Seguridad y mantenimiento

Como modelos, precios y límites cambian, revisa periódicamente la configuración oficial de modelos, la tabla de precios de la API y la documentación de tu proveedor de nube.

Conclusión: autenticar no es sólo iniciar sesión: implica saber qué identidad, proveedor, modelo y modalidad de facturación están activos. Los alias facilitan mantenerse actualizado; /model, /effort, /usage, /cost y /status permiten ajustar calidad y consumo con evidencia. En el próximo tema pondremos el agente a trabajar sobre un proyecto real creando CLAUDE.md.