PTENES
MÓDULO 2.2

🔑 Autenticación y primer uso

Ejecutar claude por primera vez, flujo de inicio de sesión, diferencia entre API key y suscripción, el prompt interactivo y cómo retomar sesiones.

6
Temas
40
Minutos
Básico
Nivel
Práctica
Tipo
1

🚀 Ejecutar claude por primera vez

Escribe claude en la terminal. En la primera ejecución, Claude Code no abre el REPL directamente: detecta que no hay credenciales e inicia el flujo de configuración inicial.

1

Detecta la falta de credenciales

Claude Code verifica ~/.claude/

Welcome to Claude Code!
To get started, you'll need to authenticate...
2

Muestra las opciones de autenticación

Elige entre una cuenta de Anthropic (OAuth) o una API key

1. Login with Anthropic account (browser)
2. Enter API key manually
>
3

Browser abierto (opción 1)

Se autentica mediante OAuth, el token se guarda localmente

Opening browser for authentication...
✓ Authentication successful
✓ Session saved to ~/.claude/
4

El REPL interactivo se abre

Listo para recibir tu primer prompt

Claude Code (claude-sonnet-4-5)
Working directory: /home/user/meu-projeto
>
2

🔐 Flujo de inicio de sesión detallado

Claude Code usa OAuth2 vía browser como método principal. Las credenciales están en ~/.claude/ y son válidas hasta que expiran (por lo general, semanas).

$ claude en auth Anthropic OAuth server Browser inicio de sesión/aprobación Token OAuth vuelve al CLI ~/.claude/ token guardado REPL listo ✓

Comandos de autenticación

# Autenticar pela primeira vez (abre browser)
claude

# Verificar status de autenticação
claude --status

# Forçar reautenticação
claude --logout
claude

# Ver onde as credenciais estão salvas
ls ~/.claude/

# Autenticar em ambiente sem browser (API key)
export ANTHROPIC_API_KEY="sk-ant-..."
claude

💡 ¿El token vence? No te preocupes

Cuando el token OAuth vence, Claude Code te avisa en la siguiente sesión y vuelve a abrir el navegador automáticamente. El flujo es idéntico al del primer inicio de sesión. Tus configuraciones e historial no se ven afectados.

3

💳 API key vs. suscripción

Dos formas de pagar por el uso. La elección correcta depende de tu volumen de uso — uso esporádico favorece la API key, uso diario intenso favorece la suscripción Claude Max.

🔑 API Key (pago por uso)

  • •Pagas por token consumido (input + output)
  • •Ideal para uso ocasional o scripts automatizados
  • •Control granular de costos
  • •Límites de rate por minuto/día
  • •Variable: ANTHROPIC_API_KEY

📋 Claude Max (suscripción)

  • •Cuota fija mensual generosa
  • •Mejor relación costo-beneficio para uso diario (8h/día)
  • •Acceso a los modelos más recientes
  • •Inicio de sesión mediante OAuth en el navegador (sin API key)
  • •La cuota se restablece mensualmente

Usar una clave de API en Claude Code

# Opção 1: variável de ambiente (sessão atual)
export ANTHROPIC_API_KEY="sk-ant-api03-..."
claude

# Opção 2: persistir no .bashrc ou .zshrc
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-..."' >> ~/.bashrc
source ~/.bashrc

# Opção 3: informar na autenticação interativa
claude
# Escolher opção 2 (Enter API key manually)
# Colar a chave quando solicitado

# Verificar qual método está sendo usado
claude --status

⚠️ Nunca expongas tu API key

No hagas git add .env o commit de archivos con ANTHROPIC_API_KEY. Añade a .gitignore. Anthropic detecta y revoca automáticamente las claves expuestas en repos públicos, pero el daño puede estar hecho.

4

💬 El prompt interactivo (REPL)

El REPL de Claude Code acepta lenguaje natural, comandos slash y referencias a archivos con @. Entender estos tres inputs multiplica tu productividad.

✓ Qué puedes escribir

  • ✓Solicitudes en portugués: "Crea un servidor Express básico"
  • ✓Referencia a archivos: "Refactoriza @src/api.js"
  • ✓Comandos slash: /help, /clear, /status
  • ✓Mensajes largos: Shift+Enter para una nueva línea
  • ✓Contexto acumulativo: Claude recuerda la conversación

✗ Evitar en el REPL

  • ✗Solicitudes vagas sin contexto: "mejora el código"
  • ✗Tareas muy grandes en un solo prompt
  • ✗Pegar secretos/tokens directamente en el chat
  • ✗Ignorar las confirmaciones de permisos

Comandos slash más útiles

/help          # Lista todos os comandos disponíveis
/clear         # Limpa o contexto da conversa atual
/status        # Mostra modelo, uso de contexto, autenticação
/exit          # Sair do REPL (ou Ctrl+C)
/mcp           # Lista servidores MCP conectados
/init          # Gera CLAUDE.md para o projeto atual
/cost          # Mostra tokens usados na sessão

💡 Usa @ para hacer referencia a archivos

Escribir @ en el REPL se abre el autocompletado de archivos del proyecto. Puedes hacer referencia a un archivo específico sin pegar el contenido manualmente:

> Explique o que faz @src/auth/middleware.js e sugira melhorias
5

⌨️ Primeros comandos reales

Ponte manos a la obra ahora. Estas son las primeras solicitudes que le harás a Claude Code; cada una demuestra una capacidad diferente.

1. Crear un archivo

> Crie um arquivo README.md para este projeto com seções básicas

Claude pide confirmación antes de escribir → tú apruebas → archivo creado

2. Explorar el proyecto

> O que faz este projeto? Leia os arquivos principais e me explique

La lectura es segura: no requiere confirmación. Claude lee y resume el codebase

3. Ejecutar comando

> Rode os testes e me diga se todos passaram

Claude pide permiso para ejecutar bash → tú apruebas → ejecuta e informa

4. Refactorizar código

> Refatore @src/index.js para usar async/await em vez de callbacks

Claude muestra el diff antes de aplicarlo → tú revisas → apruebas o cancelas

📊 Bucle de confirmación

Toda acción que modifica archivos o ejecuta comandos pasa por una confirmación. Este es el mecanismo central de seguridad:

  • y → aprobar y ejecutar
  • n → rechazar (Claude intenta un enfoque alternativo)
  • a → aprobar todas las acciones pendientes de esta tarea
  • Ctrl+C → cancelar tarea actual
6

🔄 Salir, retomar y administrar sesiones

Las sesiones de Claude Code tienen un contexto que se puede retomar. Entender el ciclo de vida de la sesión evita perder contexto importante a mitad de un proyecto.

Comandos de sesión

# Sair do REPL
/exit          # ou Ctrl+C duas vezes

# Retomar sessão anterior do mesmo diretório
claude --resume

# Ver sessões disponíveis
claude --list-sessions

# Iniciar sessão sem histórico (limpa)
claude --no-resume

# Usar claude sem REPL (modo print, para scripts)
claude --print "Gere um script Python para ordenar arquivos por data"

# Passar contexto via stdin
cat meu_arquivo.py | claude --print "Explique este código"

✓ Buenas prácticas de sesión

  • ✓Usa /clear cuando cambies de tarea
  • ✓Retoma con --resume para continuar con los bugs
  • ✓Usa /status para ver los tokens usados

💡 Contexto y tokens

Cada sesión consume tokens de contexto. Las sesiones largas se vuelven más costosas y lentas. Usa /clear para restablecer cuando el contexto ya no sea necesario.

✅ Resumen del Módulo 2.2

✓
Primer arranque detecta la ausencia de credenciales e inicia el onboarding automático
✓
OAuth vía browser es el método más sencillo para una cuenta de Anthropic
✓
API key vía ANTHROPIC_API_KEY para automatización y CI/CD
✓
REPL acepta lenguaje natural, comandos slash y referencias @archivo
✓
Bucle de confirmación protege toda acción destructiva

Siguiente módulo:

2.3 — Configuración: settings.json y permisos. Control total del comportamiento de Claude Code en tu entorno.

← Módulo 2.1 Siguiente módulo →