El programa de hoy

El agente que vive
en tu terminal

No sugiere código.
Actúa sobre tu repo.

5 plataformas,
una misma potencia

VS Code, JetBrains
y la recomendación de onboarding

En marcha en
tres comandos

# Node 18+ requerido
npm install -g @anthropic-ai/claude-code

# Autenticar (abre el navegador)
claude /login

# Verificar instalación
claude --version

• Abre Claude en la raíz de tu proyecto, no en cualquier carpeta
• La primera vez pedirá permisos — acéptalos todos

Planifica antes de tocar.
Shift+Tab lo activa.

Auto mode vs Plan mode:
cuándo usar cada uno

# Activar plan mode y pedir un refactor
# [Shift+Tab] → aparece "Plan mode" en el prompt
> "Refactoriza getUserById para usar async/await. Solo ese archivo."
# Claude muestra el plan — tú apruebas o rechazas antes de que toque nada

La memoria del proyecto.
Claude la lee siempre al arrancar.

Tres secciones mínimas
para cualquier proyecto

# Mi Proyecto

## Stack
- Next.js 14, TypeScript, Prisma, PostgreSQL
- Tests con Vitest, no Jest

## Reglas
- Sin `any` en TypeScript
- Commits en español, conventional commits
- No tocar /legacy sin preguntar

## Tests
npm test

Claude no solo escribe código.
También commitea y abre PRs.

Del diff al PR en dos prompts

# 1. Tienes cambios listos — pide el commit
> "Haz commit de estos cambios con mensaje descriptivo en conventional commits"

# 2. Claude lee el diff, propone: "feat: add email validation in register form"
# Tú confirmas → commit hecho

# 3. Abrir PR con contexto real (requiere gh CLI)
> "Crea un PR para esta feature. Describe qué hace y cómo testearla"

# Claude genera título, body y abre el PR en GitHub

Dos archivos que controlan todo lo que Claude puede hacer

# Global (tu máquina, no se comparte)
~/.claude/settings.json

# Proyecto (va a git, se comparte con el equipo)
<proyecto>/.claude/settings.json

{
  "defaultMode": "acceptEdits",
  "permissions": {
    "allow": ["Bash(npm run *)", "Bash(git status)", "Bash(git diff *)"],
    "deny":  ["Bash(rm -rf *)", "Bash(git push --force *)"]
  }
}

• allow — comandos que pasan sin preguntar
• deny — comandos bloqueados siempre, independientemente del modo
• defaultMode — nivel de autonomía por defecto de la sesión

Elige cuánto control cedes en cada contexto

Contexto → modo recomendado

dontAsk ≠ bypassPermissions.
La diferencia es la red de seguridad.

Estandariza el flujo del equipo
con un comando /create-pr

# Archivo: .claude/skills/create-pr.md
---
description: Crea un PR siguiendo nuestro template de equipo
---

Crea un PR con:
1. Título: [TIPO] Descripción corta
2. Body: ## Qué hace / ## Cómo testear / ## Screenshots
3. Asigna al reviewer por defecto del CODEOWNERS
4. Añade labels según el tipo de cambio

Usa `gh pr create` con .github/PULL_REQUEST_TEMPLATE.md

# Uso desde cualquier sesión del proyecto:
> /create-pr

• Archivos .md en .claude/skills/ → comando /nombre
• Se comparten en git: todo el equipo usa las mismas convenciones

Feature en curso + hotfix urgente.
Sin perder contexto en ninguno.

Mismo .git interno — los commits de uno son inmediatamente visibles en el otro. Regla práctica: si ambas tareas superan 30 min y son independientes, los worktrees te ahorran el context-switch.

Crear, usar y limpiar un worktree

# Crear el worktree en un directorio hermano
git worktree add ../mi-proyecto-hotfix hotfix/fix-login

# Verificar los worktrees activos
git worktree list
# /ruta/mi-proyecto          abc1234 [feat/dashboard]
# /ruta/mi-proyecto-hotfix   def5678 [hotfix/fix-login]

# Abrir Claude en el worktree (terminal nueva)
cd ../mi-proyecto-hotfix && claude

# Limpiar cuando termines
git worktree remove ../mi-proyecto-hotfix
git worktree prune   # elimina referencias huérfanas

Claude conectado a tu BD,
Jira, Slack o cualquier API

# .mcp.json en la raíz del proyecto
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres",
               "${DATABASE_URL}"]
    }
  }
}

• Model Context Protocol: estándar abierto para conectar LLMs a servicios
• Casos reales: consultar BD de producción, leer tickets de Jira/Linear, interactuar con Notion
• Nunca hardcodees credenciales — usa ${VAR} con variables de entorno del sistema

Tres comandos para no quedarte sin memoria

Señal de contexto agotado: Claude repite preguntas que ya hiciste, contradice decisiones previas o da respuestas genéricas en lugar de específicas.

No son intercambiables.
Elige bien antes de ejecutar.

30 segundos que te ahorran
re-explicar 2 horas de trabajo

# Paso 1 — Antes de /clear, pide el resumen:
> "Resume qué hemos hecho, qué decisiones tomamos
   y cuál es el siguiente paso concreto."

# Paso 2 — Copia y úsalo como primer mensaje en la nueva sesión:
> "Contexto de la sesión anterior:
   [pega aquí el resumen]
   Continuamos desde aquí. El siguiente paso es [X]."

• Para tareas muy largas: escribe el estado en tasks/todo.md — Claude lo lee al inicio de cada sesión
• CLAUDE.md reduce presión sobre el contexto: se relee en cada sesión nueva sin ocupar historial
• Compact preventivo al 50 % > compact de emergencia al 90 %

Ctrl+C es el freno.
git diff es el espejo.

Tres patrones para retomar el control

Tú eres el tech lead revisando el PR.
Claude es el junior rápido.

• Prompt preciso con scope claro
• Observar mientras trabaja, no esperar a ciegas
• git diff antes de aceptar cualquier cambio
• Verificar que funciona antes de hacer commit

Sin abrir sesión.
Respuesta directa en el terminal.

# Pregunta directa
claude -p "¿Cuál es la diferencia entre margin y padding en CSS?"

# Pipe de error a Claude
npm test 2>&1 | claude -p "Tests fallidos. Explica qué falla y propón la corrección."

# Pasar archivo como contexto
cat src/utils/parser.ts | claude -p "¿Hay algún bug potencial aquí?"

# Revisar diff staged antes de commit
git diff --staged | claude -p "Revisa buscando bugs y genera un commit message convencional."

# Output JSON para scripts
git diff --staged | claude -p "Devuelve JSON: {score: 1-10, issues: []}" --output-format json

Cuatro aliases que aceleran el flujo diario

# Añadir a ~/.bashrc o ~/.zshrc

# cr — code review del diff staged
alias cr='git diff --staged | claude -p "Revisor senior: busca bugs, seguridad y legibilidad. Conciso."'

# gcm — generar commit message convencional
alias gcm='git diff --staged | claude -p "Conventional Commits. Solo el mensaje, máx 72 chars."'

# cday — resumen diario de trabajo
alias cday='git log --since="24 hours ago" --pretty=format:"%h %s" | claude -p "Resume en bullets lo que se trabajó hoy."'

# cdbg — diagnosticar log de errores
alias cdbg='f() { tail -100 "$1" | claude -p "[ERROR]/[CAUSA]/[SOLUCIÓN]"; }; f'

# Activar sin reiniciar terminal
source ~/.bashrc

Claude Code no es un modelo.
Es una interfaz a cuatro.

¿Qué modelo para qué tarea?

Cambia con /model (sesión) o el campo "model" en .claude/settings.json (persistente).

Fast Mode no es un downgrade.

Pedirle que piense antes de responder.

# No hay comando: se activa con el lenguaje del prompt
"Piensa cuidadosamente antes de responder..."
"Razona paso a paso sobre los trade-offs..."
"Evalúa todas las opciones antes de decidir..."

Cuatro cosas que vale la pena conocer

Delega sin contaminar el contexto principal

Análisis paralelo en tres frentes

Con Agent Teams (experimental) puedes lanzar sub-agentes directamente desde la sesión:

# Activar Agent Teams y abrir sesión
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude

# El agente principal puede delegar con la herramienta Task:
# Task 1 → audita seguridad en src/auth/
# Task 2 → genera tests para src/api/
# Task 3 → actualiza documentación en docs/
# Los tres corren en paralelo; el contexto principal no se satura.

Claude en CI/CD y automatización

Flag --print (o -p): ejecuta un prompt y sale. Sin interfaz interactiva. Perfecto para pipelines.

# Ejecución básica — output a stdout
claude --print "Revisa si hay vulnerabilidades en este código"

# Output estructurado para procesar con jq
claude --print --output-format json "Lista los TODO pendientes"

# Streaming JSON para pipelines largos
claude --print --output-format stream-json "Genera changelog"

Casos de uso reales en pipelines

Un solo fichero que alinea a todo el equipo

Las dudas que siempre surgen

Preguntas que vienen después del primer sprint

El comando /cost: visibilidad instantánea

Escribe /cost en cualquier momento de la sesión para ver el gasto acumulado:

Tokens used:    input: 42,300   output: 8,700
Estimated cost: $0.23
Cache hits:     18,200 tokens (saved ~$0.05)

• El coste se acumula por sesión — cada nuevo mensaje añade los tokens del contexto completo
• Los cache hits son gratuitos: prompts repetidos o contexto estable se cachea automáticamente
• Usa /compact para reducir el contexto y bajar el coste de mensajes siguientes

El coste sube cuando el contexto crece

Cuánto cuesta una sesión real

5 hábitos que controlan el gasto del equipo

Anthropic Console: visibilidad para el equipo

Settings → Billing → Spend limits
  Soft limit: $50
    → email de aviso al alcanzar umbral
  Hard limit: $150
    → Claude Code deja de procesar

Un prefijo que cambia
la arquitectura de ejecución

Tiempo de pared vs.
tiempo de trabajo

Tres casos donde multiplica de verdad

La regla de los 30 minutos

• Tarea simple y bien definida — un agente solo termina más rápido y barato
• Dependencias secuenciales estrictas — el agente B necesita el output del A; el paralelismo suma overhead
• Presupuesto ajustado — 5 agentes = 5× tokens; una tarea puede consumir la cuota del día
• Debugging fino — necesitas trazabilidad lineal paso a paso

Revisión de los últimos 3 commits
en tiempo real

# Prompt exacto para la demo:
ultracode: do a thorough code review of the last 3 commits —
check for bugs, security issues, and code quality

¿Cuándo usar ultracode?

Lo que te llevas
de Ultracode

Eres el tech lead.
Tu equipo usa Claude Code
sin reglas compartidas.

CLAUDE.md del equipo:
el contexto compartido

## Stack
- Frontend: Next.js 14 (App Router), TypeScript, Tailwind CSS
- Backend: API Routes + Prisma ORM
- Base de datos: PostgreSQL en Neon
- Deploy: Vercel (preview por PR, producción en main)

## Reglas del equipo
1. Nunca usar `any` en TypeScript. Si el tipo no está claro, crear una interfaz.
2. Los componentes van en `src/components/`, cada uno en su carpeta con index.tsx y test.
3. Antes de crear un hook, buscar si ya existe uno en `src/hooks/`.
4. Las migraciones de BD se generan con `prisma migrate dev` -- no editar manualmente.

## Cómo ejecutar tests
pnpm test          # unit tests (Vitest)
pnpm test:e2e      # end-to-end (Playwright)

Hook de calidad:
lint automático tras cada edición

# .claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "npm run lint --silent 2>&1 | head -30"
          }
        ]
      }
    ]
  }
}

Si usas otro gestor de paquetes, sustituye el comando: pnpm lint, yarn lint, eslint src/…

Skill de equipo:
/standup cada mañana

# .claude/skills/standup.md
# /standup — Resumen diario del equipo

Cuando el usuario invoque /standup, ejecuta este flujo:

## 1. Recopilar actividad reciente
git log --since="24 hours ago" --oneline --all --author-date-order
(Si no hay commits en 24h, ampliar a 48h y avisarlo.)

## 2. Agrupar por área
Agrupa los commits por área: frontend, backend, infra, tests, docs.

## 3. Formato de salida
**Standup [fecha]**
🟢 Completado ayer: [lista agrupada por área]
🔵 En progreso: [ramas activas sin merge]
⚡ Bloqueantes detectados: [si los hay]

Criterios de éxito
y próximos pasos

La Dumb Zone empieza al 40 %

La sección Gotchas vale más
que todas las instrucciones

Los hooks bloquean.
Las instrucciones solo sugieren.

La configuración que
lo cambia todo

3 repos que merece la pena guardar

Las empresas no se conectan
a api.anthropic.com. Sus razones son estructurales.

Cuatro variables de entorno.
Sin API key de Anthropic.

# Variables requeridas
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_ACCESS_KEY_ID=your_key
export AWS_SECRET_ACCESS_KEY=your_secret
export AWS_REGION=us-east-1

Service account + cuatro variables.
Rol Vertex AI User obligatorio.

# Variables requeridas
export CLAUDE_CODE_USE_VERTEX=1
export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project
export ANTHROPIC_VERTEX_REGION=us-east5
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

API directo para agilidad.
Bedrock/Vertex para compliance.

Un archivo que configura
todo el equipo a la vez

// .claude/settings.json — commiteado en git, compartido con el equipo
{
  "model": "claude-sonnet-4-6",        // opus-4 para arquitectura compleja
  "defaultMode": "acceptEdits",    // edita archivos, pide OK para bash
  "permissions": {
    "allow": [
      "Bash(git *)", "Bash(npm run *)", "Bash(npx *)",
      "Read(**)", "Write(**)", "Edit(**)"
    ],
    "deny": [
      "Bash(rm -rf *)",               // nunca borrar recursivamente
      "Bash(git push --force *)",      // nunca forzar el historial
      "Bash(git reset --hard *)"       // nunca descartar cambios
    ]
  },
  "hooks": {
    "Stop": [{ "hooks": [{ "type": "command",
      "command": "echo \"[claude] sesión terminada — $(date)\"" }] }]
  }
}

El contexto que Claude
necesita para no improvisar

# CLAUDE.md — [NOMBRE DEL PROYECTO]

## Descripción del proyecto
[2-3 frases: qué hace, quién lo usa, core del negocio]

## Stack técnico
Framework: [Next.js v15 / Express / Django]
BD: [PostgreSQL / MongoDB]  ORM: [Prisma / Mongoose]
Auth: [NextAuth / Clerk]    Tests: [Vitest / Jest / Pytest]

## Comandos del proyecto
dev: [npm run dev]   test: [npm test]
build: [npm run build]   lint: [npm run lint]

## Convenciones del equipo
- Idioma del código: [ESPAÑOL / INGLÉS]
- Commits: Conventional Commits
- PRs: requieren [1 / 2] aprobación(es)

## Zonas protegidas — NO tocar sin consenso
- src/lib/auth/    src/lib/payments/    .env.production

Instala estos cinco y
Claude Code ya lo puede todo

Flujos especializados
que Claude ejecuta de una orden

El día 1 acaba aquí.
El aprendizaje no.