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

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.

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.

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

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.

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.

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

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

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..."

Delega sin contaminar el contexto principal

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"

Un solo fichero que alinea a todo el equipo

Las dudas que siempre surgen

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

5 hábitos que controlan el gasto del equipo

Un prefijo que cambia
la arquitectura de ejecución

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

¿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.