EN ES TH
Guía Avanzada - v6

Claude Code
Manual Full Stack

30+ APIs, agentes en paralelo, flujos de trabajo autónomos y la arquitectura detras de un negocio nativo de IA

Donal Lynch · Online Optimisers · Versión 6 · April 2026
Prerrequisito: Startup Guide completada · 18 secciones · ~170 min
LinkedIn

0
APIs conectadas
0
Skills creados
0
Agentes en paralelo
0
Ventanas de chat
$0
Costo de infraestructura

Tabla de contenido

  1. Arsenal de APIs - 5 Pilas, 30+ APIs 12 min
  2. Orquestación multi-agente 15 min
  3. La Fábrica de Skills 14 min
  4. Modo autónomo - Bucles, Eventos, Agentes en segundo plano 12 min
  5. La Arquitectura de memoria 10 min
  6. Personas inteligentes - Tu equipo especializado 10 min
  7. Ecosistema MCP - Conectar todo y construir el tuyo 10 min
  8. LLMs locales - Cuando y cómo ejecutar modelos localmente 8 min
  9. Dominio del terminal 8 min
  10. Cloudflare - Tu motor de despliegue 10 min
  11. Del código al servidor - El pipeline de despliegue 8 min
  12. Gestionar la ventana de contexto 6 min
  13. Ejecutar 5-6 chats en paralelo 6 min
  14. Patrones avanzados de prompts 8 min
  15. Casos de uso - Lo que está pila realmente construyó 12 min
  16. Errores comunes - Qué sale mal (y cómo solucionarlo) 10 min
  17. La frontera - Agent SDK, Enjambres, Lo que viene 10 min
  18. Encontrar tu ventaja - Ganar tu primer dinero con IA 8 min
Glosario - Términos avanzados (haz clic para expandir)
TérminoEn palabras simples
OrquestadorEl Claude principal con el que hablas - planifica, delega en agentes e integra resultados
SubagenteUna instancia de Claude creada para trabajar en una tarea específica y devolver resultados al orquestador
WorktreeUna copia aislada de una rama de git - los agentes pueden trabajar sin conflictos de archivos
HooksComandos de shell que se ejecutan automáticamente antes/después de que Claude use una herramienta (pre/post)
CronUna tarea programada que se ejecuta en un temporizador (por ejemplo, cada día a las 9am)
WebhookUna URL que recibe datos cuando ocurre un evento (por ejemplo, un nuevo lead activa a Claude)
Servidor MCP personalizadoUn plugin que construyes tu mismo para dar a Claude acceso a cualquier sistema externo
Compresión de contextoCuando tu conversación se alarga, Claude resume los mensajes antiguos para liberar espacio
Enrutamiento de modelosUsar diferentes modelos de IA para diferentes tareas: Haiku para volumen económico, Sonnet zona intermedia, Opus para planificación
Haiku / Sonnet / OpusLos 3 niveles de Claude: Haiku = rápido y económico, Sonnet = equilibrado, Opus = más capaz y costoso
Fan-out / Fan-inCrear muchos agentes en paralelo (fan-out) y luego recopilar todos los resultados (fan-in)
PipelineLa salida del Agente A alimenta al Agente B, que alimenta al Agente C - cadena secuencial
R2 (Cloudflare)Almacenamiento de objetos - aloja imágenes, archivos, clones de voz. Sin costos de salida
Workers (Cloudflare)Funciones sin servidor en el borde - receptores de webhooks, proxies de API, activadores cron
KV StoreAlmacenamiento clave-valor en Cloudflare - configuración rápida y almacenamiento de estado para Workers
LLM localUn modelo de IA que se ejecuta en tu propia máquina - sin internet, sin costos de API, privacidad total

Módulo 01Arsenal de APIs - 5 Stacks, 30+ APIs

La Guía de Inicio te dio 1-2 conexiones de API. Este módulo muestra lo que ocurre cuando conectas 30+. Cada conexión no es solo una función - es un multiplicador de capacidades. Claude deja de ser un chatbot y se convierte en un sistema operativo completo para tu negocio.

Los 5 Stacks

Contenido & Social (8 APIs)
"Máquina de contenido - de la estrategia al post programado, sin cambiar de pestaña"
OpenAI Claude API Buffer Canva Instagram Graph TikTok YouTube Data Hootsuite

Genera copy, crea visuales, programa en múltiples plataformas, obtiene analíticas - todo desde un solo prompt en la terminal.

Investigación & Visibilidad (7 APIs)
"Auditorías automatizadas a escala - un prompt, panorama competitivo completo"
Search Console Ahrefs / SEMrush DataForSEO Screaming Frog Moz Firecrawl BrightLocal

Seguimiento de palabras clave, análisis de backlinks, rastreo de sitios, verificación de citaciones - conectalos y una auditoría completa toma 90 segundos.

Ventas & Alcance (7 APIs)
"De la generación de prospectos a la llamada agendada - completamente automatizado"
Apollo Hunter Instantly / Lemlist HubSpot / Pipedrive LinkedIn Calendly Fathom / Gong

Encuentra prospectos, verifica emails, envía secuencias, gestiona tratos, agenda reuniones y extrae elementos de acción de llamadas.

Operaciones & Automatización (7 APIs)
"Piloto automático de back-office - tareas, comms, facturación, sin entrada manual"
Google Workspace Slack Asana / Monday Airtable Stripe n8n / Zapier Twilio

Gestión de proyectos, mensajería de equipo, base de datos, facturación, disparadores de flujos de trabajo y notificaciones SMS.

IA & Infraestructura (8 APIs)
"Herramientas de IA personalizadas, construidas y desplegadas desde una terminal"
Anthropic OpenAI Perplexity Replicate Cloudflare Vercel ElevenLabs HeyGen

Claude como cerebro, GPT para búsqueda/visión, Perplexity para citaciones, clonación de voz, video con IA, despliegues en el edge, funciones serverless.

El Efecto Compuesto
Una API = una capacidad. Treinta APIs = capacidades que se alimentan entre sí. DataForSEO encuentra palabras clave → OpenAI prueba visibilidad en IA → Perplexity cross-verifica → Sheets almacena resultados → Gmail redacta el pitch → Instantly envía la campaña. No son 6 herramientas - es un pipeline.
Tu Stack Será Diferente
Estos son stacks de ejemplo. El tuyo reflejará tu negocio. Un gestor de canal de YouTube podría cambiar BrightLocal por TubeBuddy y Calendly por StreamYard. Un operador de e-commerce podría eliminar Apollo y agregar Shopify. Un estudio de diseño web podría agregar las APIs de Figma y Webflow. La arquitectura es la misma - elige las APIs que coincidan con tus flujos de trabajo, conectalas y deja que Claude las orqueste.

Tu Archivo .env

Plantilla genérica de .env (todos los stacks)

Crea un .env en la raíz de tu workspace. Asegúrate de que esté en .gitignore. El orden no importa - Claude los lee todos:

# -- NUCLEO DE IA -- ANTHROPIC_API_KEY=sk-ant-... OPENAI_API_KEY=sk-... PERPLEXITY_API_KEY=pplx-... # -- SEO & DATOS -- DATAFORSEO_LOGIN=... DATAFORSEO_PASSWORD=... FIRECRAWL_API_KEY=fc-... SEARCH_CONSOLE_CREDENTIALS=path/to/sa.json BRIGHTLOCAL_API_KEY=... # -- ALCANCE -- APOLLO_API_KEY=... HUNTER_API_KEY=... INSTANTLY_API_KEY=... CALENDLY_TOKEN=... # -- SOCIAL -- BUFFER_ACCESS_TOKEN=... INSTAGRAM_ACCESS_TOKEN=... YOUTUBE_API_KEY=... # -- OPERACIONES -- GOOGLE_SHEETS_CREDENTIALS=path/to/sa.json SLACK_BOT_TOKEN=xoxb-... ASANA_ACCESS_TOKEN=... AIRTABLE_API_KEY=pat... STRIPE_SECRET_KEY=sk_live_... # -- MEDIOS -- ELEVENLABS_API_KEY=... HEYGEN_API_KEY=... # -- INFRAESTRUCTURA -- CLOUDFLARE_API_TOKEN=... VERCEL_TOKEN=...

Luego en cualquier sesión: source .env carga todo. Claude ahora puede llamar a cualquiera de estas.

Punto de Control - Módulo 1

Módulo 02Orquestación Multi-Agente

Claude de un solo hilo es poderoso. Claude multi-agente es un equipo. No esperas a que una tarea termine antes de empezar la siguiente - estas ejecutando 5, 10 o 13 agentes en paralelo, cada uno siendo dueño de una parte diferente del trabajo.

Orquestador vs Subagente

ConceptoLo que Significa
OrquestadorEl Claude principal con quien hablas. Planifica, delega, integra.
SubagenteUn Claude iniciado que trabaja en una tarea específica. Devuelve resultados al orquestador.
Agente en segundo planoUn subagente que corre sin bloquearte. Recibes una notificación cuando termina.
Agente en primer planoUn subagente que bloquea hasta completarse. Usalo cuando necesitas resultados antes del siguiente paso.
Agente en worktreeUn agente trabajando en una rama de git aislada. Sin conflictos de archivos con otros agentes.

Aquí está cómo encajan las piezas visualmente. Tú hablas con el orquestador. El orquestador delega a agentes especializados, cada uno ejecutando el modelo adecuado para el trabajo:

ORQUESTADOR
Sonnet
Con este hablas tu
Agente A
Investigación
Haiku
Agente B
Construcción
Sonnet
Agente C
Despliegue
Haiku

3 Patrones de Orquestación

Patrón 1: Fan-Out / Fan-In

Inicia N agentes para tareas independientes, espera a que todos retornen, integra resultados.

Tengo 9 perfiles de clientes en knowledge/clients/. Inicia un agente por cliente. Cada agente lee el perfil y ejecuta una revisión completa de rendimiento. Guarda resultados en deliverables/[slug]/. Adelante.

Patrón 2: Pipeline

La salida del Agente A alimenta al Agente B, que alimenta al Agente C. Secuencial pero cada agente está especializado.

Agente 1: rastrea el sitio web del prospecto con Firecrawl. Agente 2: toma esos datos y ejecuta el análisis competitivo. Agente 3: toma el análisis y construye el deck de presentación HTML. Constryelolo en pipeline.

Patrón 3: Explorar / Decidir / Ejecutar

Agentes rápidos y económicos exploran opciones (Haiku), el orquestador decide la dirección (Sonnet/Opus), los agentes de ejecución construyen el producto final (Sonnet).

Sintaxis de Lanzamiento

Claude Code responde a instrucciones de lanzamiento en lenguaje natural. Estos son los prompts que desencadenan la ejecución multi-agente:

Ejecuta esto en segundo plano: construye la biblioteca de pitches en docs/pitch-library.md mientras yo trabajo en el plan maestro.
Inicia 3 agentes en paralelo. El Agente A maneja la extracción de datos. El Agente B maneja el formato. El Agente C maneja el despliegue. Cada uno escribe en su propio directorio de salida.
Usa un worktree para esto - construye la nueva landing page en una rama separada para que no entre en conflicto con lo que estoy trabajando.

Costo & Enrutamiento de Modelos

No todas las tareas merecen el mismo cerebro. Enruta por costo y complejidad:

ModeloNivel de CostoUsar ParaPunto Optimo en Paralelo
HaikuMás bajoTransformaciones masivas, extracción, formato, limpieza de datos, resumenes10+ agentes
SonnetMedioEscritura de calidad, auditorías, contenido para clientes, depuración3-5 agentes
OpusMás altoEstrategia, arquitectura, planificación compleja, razonamiento en múltiples pasos1-2 agentes
Regla de Presupuesto
Antes de lanzar agentes en paralelo, estima el costo. 13 agentes Opus ejecutandose durante 45 minutos cada uno es una factura muy diferente a 13 agentes Haiku haciendo lo mismo. Usa Haiku por defecto para exploración, escala a Sonnet para calidad, reserva Opus para decisiones que dan forma a todo el proyecto.

Calculadora de Costo Mensual de IA

Estima tu Costo Mensual de IA

Ajusta los valores para ver tu gasto estimado, el plan recomendado y la proyección de retorno.

Costo mensual estimado en tokens $100 - $200
Plan recomendado Max 5x ($100/mes)
Horas ahorradas estimadas por semana 15 - 20 hrs
ROI a $75/hr de valor 45x - 60x
Con este nivel de uso, el plan Max 5x ($100/mes) te da el mejor valor. Si Claude te ahorra 15 horas por semana a un equivalente de $75/hora, tu retorno mensual es de $4,500 con una inversión de $100, lo que equivale a un ROI de 45x.

Modo Plough - Quemando Créditos de Forma Eficiente

Cuando tienes presupuesto de cómputo y una lista de trabajo desbloqueado, el modo plough maximiza la producción en paralelo:

Reglas del Modo Plough
  1. Cada agente tiene su propio archivo o directorio de salida. Ningún par de agentes escribe en la misma ruta. Las colisiones matan el rendimiento.
  2. El Claude principal posee las superficies compartidas - archivos de memoria, planes maestros, commits de git, índice de entregables.
  3. Entrega a cada agente una lista exhaustiva de archivos de entrada. No hagas que los agentes busquen archivos. Dales las rutas exactas.
  4. Establece limites de tiempo estrictos por agente (45-90 min). Evita sesiones desbocadas que queman créditos sin producir.
  5. Commitea por agente, no por lote. La salida de cada agente tiene su propio commit de git. Si uno falla, los demás están seguros.
Ejemplo: 5 agentes en paralelo, una sesión
AgenteTareaDestino de SalidaResultado
ADocumentos legales v2output/agent-a/Politica de privacidad (235 líneas)
BManual de operacionesdocs/ops-runbook.mdFallo a mitad
CBiblioteca de pitchesdocs/pitch-library.md1.443 líneas, 10 secciones
DCalendario de contenido v2output/agent-d/Plan de 30 días (711 líneas)
EScript semana 1docs/week1-script.mdFallo a mitad

3 de 5 produjeron salida limpia. 2 fallaron. Ese es el riesgo del paralelo - y por eso commiteas por agente. Los 3 que aterrizaron = 2.389 líneas de contenido entregable en una sola sesión.

Punto de Control - Módulo 2

Módulo 03La Fábrica de Skills

Los skills convierten tareas repetitivas en flujos de trabajo de un solo comando. En vez de explicar lo que quieres cada vez, escribes /weekly-report y Claude ejecuta todo el playbook. Un workspace maduro tiene 30-55+ skills que cubren cada tarea recurrente.

Anatomía de un Skill

weekly-report.md--- name: weekly-report description: Generate a client weekly performance summary model: claude-haiku-4-5-20251001 --- # Weekly Report Skill When invoked with /weekly-report [client-name]: ## Step 1: Gather Data - Read the client profile from knowledge/clients/[slug]/profile.md - Pull latest metrics from the tracking spreadsheet - Check for any flagged issues from the previous week ## Step 2: Analyse Performance - Compare this week vs last week on core KPIs - Highlight improvements and regressions - Note any ranking changes or traffic anomalies ## Step 3: Generate Report - Build markdown report at deliverables/[slug]/weekly/[date].md - Include: summary, KPI table, top 3 wins, top 3 actions - Tone: professional, concise, results-focused ## Step 4: Draft Delivery Email - Use templates/emails/weekly-update.md as base - Personalise with this week's highlights - Save draft to deliverables/[slug]/emails/

Referencia de Frontmatter

CampoLo que HaceEjemplo
nameEl disparador del slash command/weekly-report
descriptionSe muestra al explorar los skills disponibles con /"Genera un resumen semanal de rendimiento del cliente"
modelQué modelo ejecuta el skill al momento de correrloclaude-haiku-4-5-20251001

Encadenando Skills

Los skills pueden llamar a otros skills. Un skill de reporte mensual podría llamar internamente al skill de extracción de datos, luego al de formato, luego al de entrega:

Flujo de trabajo encadenado/monthly-report [client] → internamente ejecuta: extracción de datos desde Sheets → internamente ejecuta: análisis de rendimiento → internamente ejecuta: formatear como presentación → internamente ejecuta: redactar email de entrega → salida: reporte + email + enlace compartible

Enrutamiento de Modelos en Skills

El modelo en el frontmatter determina que Claude ejecuta el skill al correrlo. Ajusta el modelo a la complejidad de la tarea:

Tipo de SkillModeloPor que
Extracción de datos, formato, limpiezaHaikuRápido, económico, no requiere criterio
Auditorías, reportes, contenido para clientesSonnetRequiere criterio de calidad
Estrategia, arquitectura, planificación complejaOpusSe necesita razonamiento profundo
Transformaciones masivas (100+ elementos)HaikuControl de costos a escala
La Paradoja del Orquestador
El modelo en el frontmatter es el modelo de ejecución, no el de escritura. Siempre construyes skills usando Sonnet u Opus (necesitas criterio para escribir el flujo de trabajo). Pero el skill corre con el modelo que está en el frontmatter. Escribes una vez con el cerebro grande, ejecutas muchas veces con el cerebro económico.

Modo Plan

Antes de construir algo complejo, usa /plan para que Claude elabore un plan estructurado antes de ejecutar. El modo plan obliga a Claude a pensar antes de actuar:

/plan Construye una automatización de onboarding en 3 pasos: email de bienvenida, creación de tarea en Asana, notificación en Slack al equipo.

Claude producira un plan numerado con destinos de archivos, dependencias y pasos estimados. Revisalo, apruebalo y luego Claude ejecuta. Esto evita gastar cómputo en construcciones en la dirección equivocada.

Limite de Tiempo para Planificar
Planificar no es hacer. Mantén el modo plan proporcional a la tarea. Una tarea de 5 minutos no necesita un plan de 20 minutos. Cuando el plan esté claro, ejecuta.

Hooks - Ejecuta Código Antes y Después de Cada Llamada a Herramienta

Los hooks te permiten ejecutar comandos de shell o scripts automáticamente antes o después de que Claude use cualquier herramienta. Se configuran en .claude/settings.json y se ejecutan al nivel del harness, lo que significa que corren independientemente del skill o conversación activa.

Tipo de HookCuando se EjecutaUso de Ejemplo
PreToolUseAntes de que Claude llame a cualquier herramientaRegistrar lo que Claude está por hacer
PostToolUseDespués de que Claude llama a cualquier herramientaAuto-commitear después de cada escritura de archivo
StopCuando Claude termina una respuestaEnviar notificación a Slack cuando una tarea se completa
NotificationCuando Claude tiene una actualización en segundo planoAlertar cuando un agente de larga ejecución termina
.claude/settings.json - ejemplo de hook{ "hooks": { "PostToolUse": [ { "matcher": "Write", "hooks": [ { "type": "command", "command": "echo 'File written: ' && git add -A" } ] } ] } }
El Mejor Hook para Principiantes
El hook más útil al comenzar: un hook PostToolUse en Write que prepara archivos automáticamente después de que Claude los escribe. Combinalo con un hook de commit periódico y nunca volverás a perder trabajo. Configuralo una vez y protege cada sesión desde ese momento.
Punto de Control - Módulo 3

Módulo 04Modo Autónomo - Bucles, Eventos, Agentes en Segundo Plano

Aquí es donde Claude pasa de ser una "herramienta que usas" a "un sistema que opera". Los flujos de trabajo autónomos se ejecutan sin que estes observando, reportan cuando terminan y pueden dispararse desde eventos del mundo real.

3 Patrones Autónomos

Hay tres patrones principales para el trabajo autónomo. Cada uno se adapta a un tipo diferente de tarea:

🔄
Bucle
Claude repite una tarea en un horario. Ritmo propio - intervalos más cortos cuando está activo, más largos cuando inactivo.
Ejemplo: "Verifica el estado de la construcción cada 2 minutos hasta que pase"
Agente en Segundo Plano
Corre independientemente mientras tú sigues trabajando. Recibes una notificación cuando termina.
Ejemplo: "Construye el pitch deck en segundo plano"
🎯
Basado en Eventos
Algo sucede - Claude responde automáticamente. Webhook, archivo nuevo, email, pago.
Ejemplo: "Nuevo prospecto en CRM → ejecutar auditoría → redactar alcance"

Bucles

El comando /loop le dice a Claude que repita una tarea en un horario. Claude establece su propio ritmo: elige el intervalo correcto entre iteraciones según lo que está esperando.

/loop Verifica el estado de la construcción cada 2 minutos hasta que pase, luego despliega en producción.
/loop Monitorea el sitio desplegado. Cuando la página devuelva HTTP 200, notificame y detente.

Agentes en Segundo Plano vs en Primer Plano

Entender cuándo usar agentes en primer plano vs segundo plano es la diferencia entre trabajo eficiente y trabajo desperdiciado.

ModoComportamientoUsar Cuando
Primer planoBloquea tu chat - esperas hasta que terminaNecesitas el resultado antes de tu siguiente paso. Dependencias secuenciales.
Segundo planoCorre independientemente - te notifica cuando terminaTienes otro trabajo que hacer en paralelo. Sin dependencia de la salida ahora mismo.
Cómo funcionaTu: "Construye la biblioteca de pitches en segundo plano mientras yo trabajo en el plan maestro." Claude: [inicia agente en segundo plano con la tarea de la biblioteca de pitches] Claude: [continua trabajando contigo en el plan maestro] ... [notificación]: Agente en segundo plano completado. Salida: docs/pitch-library.md (1.443 líneas)

Modos de Falla de Agentes en Segundo Plano

Los agentes en segundo plano pueden y de hecho fallan. Los tres modos de falla más comunes:

Regla Estricta
Siempre verifica la salida después de que un agente en segundo plano notifica su finalización. Abre el archivo de salida. Revisa el contenido. Confirma que es lo que pediste. Nunca asumas éxito solo porque llego la notificación. La notificación significa que el agente dejo de ejecutarse, no que produjo la salida correcta.

Patrones Basados en Eventos

Las automatizaciones más poderosas no están programadas - son disparadas. Algo sucede, Claude responde.

DisparadorLo que Hace ClaudeEjemplo
Nuevo prospecto en CRMEjecuta análisis, construye pitch deck, redacta email de alcanceWebhook de HubSpot → pipeline de Claude
Email de cliente recibidoResumir, categorizar, redactar respuestaWatch de Gmail → skill de triaje de Claude
Envío de formularioExtraer datos, actualizar rastreador, enviar confirmaciónWebhook de Typeform → Sheets + Gmail
Cron programado (9am diario)Obtener métricas de ayer, marcar anomalias, enviar resumenCron → Claude → Slack
Archivo agregado a DriveProcesar, etiquetar, mover a la ubicación correctaWatch de Drive → organizador de Claude
Pago recibidoActualizar registro de cliente, disparar secuencia de onboardingWebhook de Stripe → Claude → CRM
Empieza con Uno
No necesitas construir todos estos. Elige el flujo de trabajo que haces manualmente cada día y automatiza ese primero. Un disparador de evento bien construido ahorra más tiempo que 10 a medias.

Monitoreo & Seguridad

Monitoreo de Heartbeat

Para sistemas de agentes con muchos componentes, construye un monitor de heartbeat. Cada agente escribe una marca de tiempo en su registro de seguimiento. Un monitor verifica: si el último heartbeat tiene más de 5 minutos, alertar.

Interruptor de Emergencia

Si la tasa de errores supera un umbral en una ventana de tiempo, pausar todas las operaciones automatizadas y notificar. Esto evita costos descontrolados y fallos en cascada.

Degradación Grácil

Si una fuente de datos premium falla, produce la salida con los datos disponibles. Marca claramente los vacios en lugar de fallar toda la tarea. Cadenas de respaldo de API: si la fuente A está caída, intenta con la B, luego con la C.

Regla de Seguridad
Sin crons recurrentes ni pipelines automatizados hasta que hayas auditado el costo de créditos por ejecución. Toda automatización comienza como solo disparo manual. Pasa a programada solo después de haber visto el costo por ejecución y verificado la calidad de la salida en al menos 5 ejecuciones manuales.
Punto de Control - Módulo 4

Módulo 05La Arquitectura de Memoria

La memoria es lo que hace que Claude se sienta como un socio, no como una herramienta. A lo largo de cientos de sesiones, Claude recuerda tus preferencias, tus proyectos, tus decisiones, tus restricciones - todo almacenado como pequeños archivos markdown que se cargan al inicio de cada conversación.

Los 4 Tipos de Memoria

TipoLo que AlmacenaEjemplo
UsuarioQuien eres, tu rol, preferencias"Consultor senior, prefiere respuestas concisas, español latinoamericano, no le gusta la jerga"
RetroalimentaciónQue hacer / no hacer (correcciones y confirmaciones)"Nunca simular la base de datos en pruebas de integración" · "Siempre usar rutas absolutas de archivos"
ProyectoTrabajo activo, decisiones, plazos"Dashboard V1 en vivo, V2 planeado para el próximo sprint" · "Congelación de merges hasta el viernes"
ReferenciaDonde encontrar cosas en sistemas externos"Bugs del pipeline rastreados en Linear proyecto INGEST" · "Todas las claves API listadas en reference_apis.md"

Estos cuatro tipos cubren diferentes alcances. Aquí está cómo se relacionan con las tres capas de contexto que Claude realmente usa:

📄
CLAUDE.md
Permanente
Se carga en cada sesión. Quien eres, cómo debe Claude trabajar contigo.
Vive en: raíz del workspace
🧠
Archivos de Memoria
En Evolución
Guardados entre sesiones. En que estas trabajando, decisiones tomadas, estado del proyecto.
Vive en: ~/.claude/projects/memory/
💬
Conversación
Temporal
Solo para la sesión actual. Se comprime con el tiempo. Desaparece cuando cierras.
Vive en: la ventana de chat

MEMORY.md - El Índice

MEMORY.md se carga en cada conversación. Es un índice, no contenido - cada entrada enlaza a un archivo detallado. Mantenlo bajo 200 líneas (cualquier cosa más alla se trunca por el cargador de contexto).

MEMORY.md# Índice de Memoria ## Usuario - [user_profile.md](user_profile.md) - Rol, preferencias, estilo de comunicación ## Retroalimentación - [feedback_git.md](feedback_git.md) - Reglas y preferencias del flujo de trabajo git - [feedback_testing.md](feedback_testing.md) - Las pruebas de integración usan la DB real ## Proyecto - [project_dashboard.md](project_dashboard.md) - Dashboard de operaciones V1 en vivo - [project_onboarding.md](project_onboarding.md) - Automatización de onboarding de clientes ## Referencia - [reference_apis.md](reference_apis.md) - Todas las claves API + estado de MCP

Memoria vs CLAUDE.md vs Planes

ArchivoPropositoFrecuencia de Cambio
CLAUDE.mdIdentidad permanente del workspace y reglasRaramente - solo cuando cambia el modelo de negocio
Archivos de memoriaContexto en evolución, decisiones, estadoSemanalmente - actualizado a medida que los proyectos avanzan
Archivos de planPlan de ejecución de la tarea actualPor sesión - desechable una vez completada la tarea

No guardes detalles específicos de tareas en memoria - esos pertenecen al plan. La memoria es para cosas que importan entre sesiones.

Zonas de Colaboración

ZonaQuien la VeQue Va Aquí
SoloTu + Claude unicamenteEstrategia de negocio, finanzas, metas personales, decisiones sensibles
Compartida con socioTu + colaborador específicoEstado de proyecto compartido, decisiones conjuntas, entregables
Cara al clienteCualquiera que lea la salidaSolo contenido profesional y depurado - sin notas internas
Punto de Control - Módulo 5

Módulo 06Personas Inteligentes - Tu Equipo de Especialistas

Una instancia de Claude puede jugar muchos roles. Pero una instancia de Claude con una persona específica - con experiencia en el dominio, estilo de comunicación y marcos de decisión integrados - produce una salida dramaticamente mejor que un prompt genérico. Piensa en ello como tener un equipo de especialistas, cada uno ajustado para su dominio.

La persona correcta, la tarea correcta = calidad de salida 10xMismo modelo. Misma API. Resultados completamente diferentes.

Las 4 Personas Principales

Analista de Investigación
"Obsesionado con los datos, cita todo, nunca especula sin evidencia"

Personalidad: metódico, minucioso, ligeramente escéptico. Presenta hallazgos con fuentes. Indica niveles de confianza en cada afirmación. Por defecto va a "esto es lo que dicen los datos" sobre "esto es lo que creo."

Usar para: investigación de mercado, análisis competitivo, auditorías basadas en datos, verificación de hechos, revisión de literatura, análisis de tendencias.

Redactor Publicitario
"Persuasivo, conciso, lee la sala antes de escribir una palabra"

Personalidad: contundente, directo, alérgico al relleno. Escribe para el lector, no para el escritor. Varía el tono según el contexto - formal para propuestas, conversacional para emails, urgente para CTAs. Cada oración gana su lugar.

Usar para: secuencias de email, landing pages, propuestas, copy para redes sociales, copy de anuncios, estudios de caso, presentaciones.

Arquitecto Técnico
"Pensador de sistemas, construye para escala, alérgico a la deuda técnica"

Personalidad: pragmático, estructurado, piensa en sistemas y dependencias. Considera los casos extremos antes de construir. Prefiere soluciones simples que escalen sobre soluciones ingeniosas que fallan. Documenta las decisiones.

Usar para: decisiones de arquitectura, integraciones de API, diseño de automatización, esquema de base de datos, pipelines de despliegue, revisiones de código.

Estratega de Ventas
"Enfocado en ingresos, anticipa objeciones, siempre cerrando"

Personalidad: empático pero comercial. Piensa en términos de puntos de dolor, objeciones y disparadores de decisión. Enmarca todo desde la perspectiva del comprador. Nunca presiona - pero siempre avanza hacia una decisión.

Usar para: propuestas, manejo de objeciones, estrategia de precios, emails de ventas, preparación de llamadas de descubrimiento, secuencias de upsell, posicionamiento competitivo.

Implementación

Las personas se implementan como prompts de sistema dentro de skills o como archivos de persona independientes:

archivo de persona--- name: research-analyst description: Deep research with citations and confidence levels model: claude-sonnet-4-5-20250514 --- # Research Analyst Persona You are a Research Analyst. Your core traits: - Every claim includes a source or is flagged as inference - Confidence levels: HIGH (múltiple sources), MEDIUM (single source), LOW (inference from adjacent data) - Present findings in structured tables, not paragraphs - Flag contradictions in source material explicitly - Default output: executive summary + detailed findings + methodology note

También puedes cambiar de persona a mitad de la conversación:

Cambia al modo Estratega de Ventas. Reescribe esta propuesta enfocándote en las objeciones del comprador y los disparadores de decisión.
Personas Compuestas
Para tareas complejas, combina personas en secuencia: el Analista de Investigación reune los datos → el Estratega de Ventas los enmarca como un pitch → el Redactor Publicitario pule la salida final. Cada persona aporta una lente diferente al mismo material.
Punto de Control - Módulo 6

Módulo 07Ecosistema MCP - Conectando Todo

MCP (Model Context Protocol) es el sistema de plugins nativo de Claude Code. Cada servidor MCP le da a Claude un nuevo conjunto de herramientas - leer Google Sheets, buscar en Drive, enviar mensajes de Slack, obtener páginas web - sin salir de la terminal.

Lo que Desbloquea MCP

Sin MCP, Claude lee y escribe archivos en tu workspace. Con MCP:

El Stack Completo de MCP

Servidor MCPProveedorLo que Hace
Google DriveAnthropic (integrado)Leer/buscar archivos de Drive, Docs, Slides
Google SheetsAnthropic (integrado)Leer/escribir celdas y rangos de hojas de cálculo
Web FetchIntegradoObtener cualquier URL, extraer contenido
Web SearchIntegradoBuscar en internet en tiempo real
FirecrawlComunidadRastreos profundos de sitios, extracción estructurada
SlackComunidadLeer/enviar mensajes a canales
GitHubComunidadIssues, PRs, búsqueda de código vía API

Configuración

Ejemplo genérico de settings.json
settings.json{ "mcpServers": { "google-drive": { "command": "npx", "args": ["-y", "@anthropic/mcp-google-drive"], "env": { "GOOGLE_CREDENTIALS_PATH": "./credentials.json" } }, "google-sheets": { "command": "npx", "args": ["-y", "@anthropic/mcp-google-sheets"], "env": { "GOOGLE_CREDENTIALS_PATH": "./credentials.json" } }, "firecrawl": { "command": "npx", "args": ["-y", "@anthropic/mcp-firecrawl"], "env": { "FIRECRAWL_API_KEY": "${FIRECRAWL_API_KEY}" } }, "slack": { "command": "npx", "args": ["-y", "@anthropic/mcp-slack"], "env": { "SLACK_BOT_TOKEN": "${SLACK_BOT_TOKEN}" } } } }

Cada servidor MCP tipicamente necesita: un paquete npm o script local, autenticación (flujo OAuth o clave API) y una aprobación única cuando Claude lo usa por primera vez.

Seguridad de MCP
Solo conecta servidores MCP de proveedores verificados. Anthropic no audita servidores MCP de terceros. Revisa cada uno antes de conectarlo - tratalos como si instalaras software. Nunca permitas que un servidor MCP acceda a datos financieros sin aprobación explícita. Si una herramienta MCP solicita permisos que parecen excesivos, detente e investiga.

Construyendo tu Propio Servidor MCP

Los MCPs integrados cubren aproximadamente el 80% de los casos de uso comunes. Pero cuando necesitas que Claude hable con un sistema que no tiene un MCP existente - tu CRM, tus herramientas internas, una base de datos personalizada - construyes el tuyo. Un servidor MCP es simplemente un programa pequeno que expone herramientas a Claude vía un protocolo estándar.

TypeScript - Servidor MCP Personalizadoimport { Server } from "@modelcontextprotocol/sdk/server"; const server = new Server({ name: "my-crm-mcp" }); server.tool("check_new_leads", async () => { const leads = await fetch( "https://your-crm.com/api/leads?status=new" ); return { content: [{ type: "text", text: JSON.stringify(await leads.json()) }] }; }); server.tool("update_lead_status", async ({ id, status }) => { const result = await fetch( `https://your-crm.com/api/leads/${id}`, { method: "PATCH", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ status }) } ); return { content: [{ type: "text", text: `Lead ${id} updated to ${status}` }] }; });
Cuando Construir uno Propio
Los MCPs integrados cubren el 80% de los casos de uso. Construye el tuyo cuando necesites que Claude hable con un sistema que aún no tiene uno - tu CRM, tu base de datos propia, una API interna o una herramienta SaaS de nicho. Un MCP personalizado puede eliminar un flujo de trabajo manual completo.
Punto de Control - Módulo 7

LLMs LocalesCuándo y Cómo Ejecutar Modelos Localmente

La IA en la nube (Claude, GPT) es el motor principal. Pero hay escenarios donde ejecutar un modelo en tu propia máquina tiene sentido - privacidad, costo, trabajo sin conexión, o procesamiento masivo donde la calidad no es crítica. Esta sección cubre cuándo usar local, que herramientas usar y con que modelos comenzar.

Cuándo Usar Local vs Nube

EscenarioUsar LocalUsar Nube (Claude)
Datos sensibles (médicos, legales, financieros)SiNo
Trabajo sin conexión (vuelos, lugares remotos)SiNo
Procesamiento masivo, bajo costo (miles de elementos)SiTal vez
Razonamiento complejo y lógica de múltiples pasosNoSi
Flujos de trabajo de múltiples pasos con uso de herramientasNoSi
La calidad importa (cara al cliente, propuestas, estrategia)NoSi

3 Formas de Ejecutar Modelos Locales

Cada herramienta tiene un punto fuerte diferente. Elige según si prefieres la terminal, una interfaz visual, o la instalación más ligera posible:

HerramientaRAM NecesariaGPUMejor Para
Ollama8GB+Opcional (ayuda)Terminal primero, configuración simple, scripts
LM Studio8GB+OpcionalGUI, amigable para principiantes, explorar modelos
GPT4All4GB+No necesariaLigero, corre en casi cualquier máquina

Modelos Recomendados

ModeloTamañoRAMBueno Para
Llama 3.1 8B4.7GB8GBTareas generales, resumen
Qwen 2.5 7B4.4GB8GBCódigo, salida estructurada
Mistral 7B4.1GB8GBInferencia rápida, chat
Phi-3 Mini2.3GB4GBUltra ligero, respuestas rápidas
Gemma 2 9B5.4GB12GBMejor calidad a este tamaño

Comenzando con Ollama (2 minutos)

Terminal# Instalar Ollama (Mac) brew install ollama # Descargar y ejecutar un modelo ollama run llama3.1 # Ya estas chateando con un LLM local - sin clave API, sin costo >>> Resume este documento en 3 puntos clave...
Los Modelos Locales son Complementarios
Los modelos locales no reemplazan a Claude. Usalos para procesamiento masivo, trabajo con datos sensibles y consultas sin conexión. Para cualquier cosa que requiera razonamiento profundo, flujos de trabajo de múltiples pasos o salida de calidad - usa Claude. Un modelo local de 7B es aproximadamente equivalente a un practicante junior. Claude es el socio senior. Usa cada uno donde brillan.
Punto de Control - LLMs Locales

Módulo 08Dominio de la Terminal

Una terminal. Control total.Sin más cambio de 15 pestañas de SaaS. Todo corre por una sola interfaz.

Antes de Claude Code, una mañana típica lucía así: abrir Chrome, iniciar sesión en analíticas, cambiar a la plataforma de anuncios, abrir el rastreador de proyectos, revisar Slack, abrir el email, cambiar al CRM, abrir una hoja de cálculo, alt-tab 47 veces. Para las 10am no has hecho trabajo real.

Con Claude Code, todo el stack es accesible desde una sola ventana de terminal. Escribes lenguaje natural, Claude llama a las APIs y los resultados aparecen donde los necesitas. Sin cambio de pestañas. Sin cambio de contexto. Sin dashboards de SaaS compitiendo por tu atención.

Atajos de Poder para Laptop

Estos atajos hacen el flujo de trabajo en la terminal aún más rápido. Memoriza los que más uses:

AcciónMacWindows
Captura de pantalla (completa)Cmd+Shift+3Win+Shift+S
Captura de pantalla (área)Cmd+Shift+4Win+Shift+S
Dictado por vozFn+FnWin+H
Historial de portapapelesInstala Maccy o RaycastWin+V
Lanzador de appsCmd+SpaceWin+S
Selector de emojiCmd+Ctrl+SpaceWin+.
Cambiar ventanasCmd+TabAlt+Tab
Pegar en terminalCmd+VCtrl+Shift+V
Limpiar terminalCmd+KCtrl+L
Dictado por Voz + Claude Code
El flujo de trabajo más rápido con Claude Code es el dictado por voz en la terminal. Habla tu solicitud, deja que el dictado la transcriba, presiona Enter. Sin escribir, sin cambio de contexto. Esto es especialmente poderoso para prompts largos y detallados que tardarían minutos en escribirse.
Punto de Control - Módulo 8

CloudflareTu Motor de Despliegue

Cloudflare es la capa de infraestructura que hace que todo lo que construyes sea accesible al mundo. Cinco servicios manejan el 90% de lo que necesitas - y todos funcionan desde la terminal vía wrangler, la herramienta CLI de Cloudflare.

Pages - Despliega Cualquier Sitio Estático

Cloudflare Pages aloja sitios estáticos globalmente con HTTPS automático, dominios personalizados e invalidación de cache instantanea. Un comando despliega tu sitio en 300+ ubicaciones edge en todo el mundo.

Desplegar en Cloudflare Pageswrangler pages deploy ./my-site --project-name my-project

Eso es todo. Tu sitio está en vivo. Pages detecta automáticamente la salida del build, la sube, asigna una URL .pages.dev y puedes adjuntar un dominio personalizado en el dashboard de Cloudflare o vía la API.

Workers - Funciones Serverless en el Edge

Workers ejecuta JavaScript/TypeScript en el edge - sin servidores que gestionar, sin cold starts importantes. Perfecto para receptores de webhooks, proxies de API, disparadores cron y backends ligeros.

Worker Simple - Receptor de Webhookexport default { async fetch(request) { const url = new URL(request.url); if (url.pathname === "/webhook") { const data = await request.json(); // Procesar webhook entrante return new Response("OK", { status: 200 }); } return new Response("Not found", { status: 404 }); } }

R2 - Almacenamiento de Objetos

R2 es la respuesta de Cloudflare a S3 - sin tarifas de salida. Almacena imágenes, clones de voz, archivos grandes, activos de clientes, datos de respaldo. Accede vía Workers o URL directa.

DNS - Gestiona Dominios desde la Terminal

El DNS de Cloudflare es el DNS autoritativo más rápido de internet. Una vez que tus dominios esten en Cloudflare, puedes gestionar registros desde la terminal, automatizar la creación de subdominios y obtener HTTPS automático en todo.

KV - Almacén de Clave-Valor

KV es un almacén de clave-valor global accesible desde Workers. Usalo para almacenar configuración, flags de funciones, estado de sesión, respuestas de API en cache, o cualquier dato pequeno que necesite ser rápido y disponible globalmente.

El Stack de Cloudflare
Pages + Workers + R2 + KV te da una plataforma completa de despliegue y alojamiento por $0-5/mes. Sin facturas de AWS. Sin gestión de servidores. Sin contratación de DevOps. Claude Code construye el código, wrangler lo despliega, Cloudflare lo ejecuta globalmente. Esa es toda la capa de infraestructura para la mayoría de los negocios nativos de IA.
Punto de Control - Cloudflare

PipelineDel Build al Vivo - El Pipeline de Despliegue

Cada pieza de trabajo sigue el mismo pipeline de 5 etapas, del código a la URL en vivo. Entender este pipeline significa que nunca volverás a preguntarte "cómo pongo esto frente a alguien."

CONSTRUIR
Claude Code
📦
VERSIONAR
Git
🚀
DESPLEGAR
CF / GH Pages
VERIFICAR
curl → 200
🔗
COMPARTIR
URL en Vivo

El mismo pipeline aplica ya sea que estes lanzando un sitio de cliente, un dashboard interno, un reporte HTML o un deck de presentación. Aquí están los detalles de cada etapa:

EtapaHerramientaLo que Ocurre
ConstruirClaude CodeEscribe el código, HTML o activos
VersionarGitCommit + push al repositorio
DesplegarCF Pages o GH PagesAuto-despliegue en push o manual wrangler pages deploy
VerificarcurlVerificación HTTP 200 - no terminado hasta confirmar en vivo
CompartirURL en VivoEnviar al cliente, interesado, o publicar
La Verificación No Es Opcional
Un sitio no está "listo" hasta que curl devuelve HTTP 200 en la URL en vivo. Desplegar sin verificar es como se envian enlaces rotos a los clientes. Integra la verificación con curl en cada flujo de trabajo de despliegue.

Receta 1 - GitHub Pages (3 comandos)

Despliegue en GitHub Pages# 1. Commitear y hacer push git add -A && git commit -m "Deploy site update" && git push # 2. Habilitar GitHub Pages (solo la primera vez) gh repo edit --enable-pages --source branch=main --path=/docs # 3. Verificar curl -s -o /dev/null -w "%{http_code}" https://yourusername.github.io/repo-name/

Receta 2 - Cloudflare Pages (2 comandos)

Despliegue en Cloudflare Pages# 1. Desplegar wrangler pages deploy ./dist --project-name my-project # 2. Verificar curl -s -o /dev/null -w "%{http_code}" https://my-project.pages.dev
Elige Uno y Dominalo
GitHub Pages es más simple para código abierto y documentación. Cloudflare Pages es más rápido, más flexible y mejor para trabajo con clientes. Elige uno como tu opción por defecto y solo cambia cuando tengas una razón específica. Para la mayoría de los proyectos, Cloudflare Pages es la mejor opción.
Punto de Control - Pipeline de Despliegue

ContextoGestionando la Ventana de Contexto

Cada conversación de Claude Code tiene una ventana de contexto de aproximadamente 200.000 tokens (~150.000 palabras). Esto es enorme - pero no infinito. Entender cómo funciona y cuando se llena es la diferencia entre una sesión productiva de 3 horas y perder tu trabajo por compactación.

Cómo Funciona el Contexto

Todo en tu conversación ocupa contexto: tus mensajes, las respuestas de Claude, contenidos de archivos, llamadas a herramientas, resultados de herramientas, archivos de memoria, CLAUDE.md. A medida que la conversación crece, los mensajes más antiguos se comprimen o resumen para hacer espacio para los nuevos. Este proceso se llama compactación.

Señales de que tu Contexto se Está Llenando

6 Estrategias para Gestionar el Contexto

1. Divide el trabajo en sesiones enfocadas

Una tarea por chat. No uses una sola conversación para la revisión de la campaña de anuncios de la mañana y el deck de pitches de la tarde. Comienza un nuevo chat para cada tarea distinta. Esto mantiene el contexto fresco y enfocado.

2. Usa archivos de memoria para persistir el estado entre sesiones

Cualquier cosa que necesite sobrevivir entre conversaciones va en un archivo de memoria. Cuando comienzas una nueva sesión, Claude recarga automáticamente todos los archivos de memoria. El estado persiste incluso si la conversación no.

3. Carga el contexto crítico primero

CLAUDE.md carga primero en cada conversación. Pon tus reglas e identidad más importantes ahí. Es lo último que se compacta. Los archivos de memoria cargan después. Estructura tu sistema para que el contexto más crítico cargue primero.

4. Usa referencias @file en lugar de pegar contenido

Cuando Claude lee un archivo vía @file, procesa el contenido eficientemente. Cuando pegas el mismo contenido en el chat, ocupa contexto dos veces (tu mensaje + el contenido). Siempre referencia archivos en lugar de pegarlos.

5. Commitea frecuentemente

Si el contexto se comprime y Claude pierde el rastro de lo que construyó, los archivos siguen seguros en disco (y en git). Los commits frecuentes significan que nunca pierdes trabajo, incluso si la conversación se degrada.

6. Ejecuta /reflect antes de cerrar

Antes de terminar una sesión, captura el estado actual: que se hizo, que está pendiente, decisiones clave tomadas, rutas de archivos importantes. Guarda esto como un archivo de reflexión en memoria. La próxima sesión retoma exactamente donde está término.

La Trampa de la Compactación
El fallo más común: una sesión de 3 horas donde hiciste un gran trabajo en la hora 1, pero para la hora 3, Claude ha olvidado las decisiones clave de la hora 1 porque se compactaron. La solución no es un contexto más largo - son sesiones más cortas y enfocadas con el estado guardado en disco entre ellas.
Punto de Control - Ventana de Contexto

Multi-ChatEjecutando 5-6 Chats en Paralelo

El movimiento realmente poderoso no es una conversación con Claude - son 5-6 ejecutandose simultaneamente, cada una trabajando en una pieza diferente del mismo proyecto. Así es como construyes en horas lo que tardaría días de forma secuencial.

Las Reglas de los Chats en Paralelo

1. Cada chat tiene un nombre clave

Etiqueta cada chat para identificación instantanea: Chat-A: Datos, Chat-B: Diseño, Chat-C: Despliegue, Chat-D: Contenido, Chat-E: QA. El nombre clave va en el primer mensaje de cada chat para que puedas identificarlo desde la pestaña de VS Code.

2. Cada chat es dueño de archivos específicos - SIN solapamiento

Antes de lanzar chats en paralelo, asigna propiedad de archivos. Chat-A escribe en output/data/. Chat-B escribe en output/design/. Chat-C maneja deploy/. Sin excepciones.

3. El chat principal coordina e integra

Un chat es el orquestador. No produce archivos directamente - revisa la salida de otros chats, integra resultados, maneja superficies compartidas (MEMORY.md, plan maestro, commits de git) y resuelve conflictos.

4. Etiqueta el primer mensaje de cada chat

Comienza el primer mensaje de cada chat paralelo con el nombre clave y la descripción para que las pestañas de VS Code sean inmediatamente identificables:

CHAT-A: EXTRACCIÓN DE DATOS - Te encargas de toda la extracción de datos para este sprint. Tu directorio de salida es output/data/. No escribas en ningún otro directorio.

5. Commitea por chat, no por sesión

Cada chat produce sus propios commits. Si Chat-B falla, el trabajo de Chat-A y Chat-C ya está commiteado y seguro. Nunca agrupes todo el trabajo paralelo en un solo commit al final.

Regla Estricta
Ningún par de chats escribe en el mismo archivo. Las colisiones de archivos destruyen el trabajo paralelo. Si descubres que dos chats necesitan modificar el mismo archivo, detente y reestructura la propiedad. Los 5 minutos invertidos en la reasignación te ahorran una hora de depuración de conflictos combinados.
Ejemplo: build paralelo con 3 chats
ChatNombre ClavePoseeProduce
ADATOSknowledge/, output/data/Perfiles de clientes, métricas extraidas, exportaciones CSV
BDISENOoutput/design/, templates/Plantillas HTML, CSS, activos visuales
CDESPLIEGUEdeploy/, dist/Scripts de build, configs de wrangler, despliegues en vivo

El chat principal (tu) revisa la salida de cada chat, ejecuta la etapa de integración y maneja el commit final + despliegue.

Punto de Control - Multi-Chat

PromptsPatrones de Prompts Avanzados

Los buenos prompts producen buena salida. Los grandes prompts producen salida que puedes lanzar sin editar. Estos 5 patrones son la diferencia entre "casi bien" y "exactamente correcto."

Patrón 1: Prompts Compuestos

Apila rol + tarea + restricciones + formato de salida en un solo prompt estructurado. Cada capa estrecha el espacio de salida.

Prompt CompuestoEres un consultor de negocios senior escribiendo para un dueño de restaurante sin conocimientos técnicos. Tarea: Analiza el rendimiento en redes sociales de este restaurante y escribe un resumen de 1 página. Restricciones: - Sin jerga. Explica cada término técnico. - Máximo 500 palabras. - Enfócate solo en las 3 mejoras de mayor impacto. Formato de salida: ## Resumen [Descripción general en 2-3 oraciones] ## Top 3 Mejoras 1. [Mejora] - [Por que importa] - [Esfuerzo: Bajo/Medio/Alto] 2. ... 3. ... ## Próximo Paso [Una acción clara que el lector debería tomar hoy]

Patrón 2: Forzar Cadena de Pensamiento

Obliga a Claude a mostrar su razonamiento antes de dar una respuesta. Esto atrapa errores que los prompts que saltan a la respuesta pierden.

Cadena de PensamientoAntes de responder, lista tus pasos de razonamiento: 1. Qué se sobre este negocio? 2. Qué datos me faltan? 3. Qué suposiciones estoy haciendo? 4. Cuáles son los riesgos de cada opción? Luego da tu recomendación con nivel de confianza (ALTO / MEDIO / BAJO).

Patrón 3: Bucles de Autocrítica

Hace que Claude escriba un primer borrador, lo critique contra criterios específicos y luego produzca la versión final. El paso de crítica atrapa el 80% de los problemas de calidad.

AutocríticaEscribe la v1 de este email de propuesta. Luego crítica la v1 contra estos criterios: - La línea de asunto tiene menos de 60 caracteres? - La primera oración hace referencia a algo específico del prospecto? - Hay exactamente un CTA? - El tono es conversacional, no de vendedor? - Tiene menos de 100 palabras? Corrige cada problema encontrado y escribe la versión final.

Patrón 4: Salida Estructurada

Cuando necesitas salida legible por máquina o con formato consistente, específica la estructura exacta en el prompt.

Salida EstructuradaAnaliza esta transcripción de llamada de cliente y devuelve como JSON: { "summary": "descripción general en 2-3 oraciones", "sentiment": "positive | neutral | negative", "action_items": [ { "task": "descripción", "owner": "nombre", "deadline": "fecha o ASAP" } ], "follow_up_needed": true | false, "key_objections": ["objeción 1", "objeción 2"] }

Patrón 5: Meta-Prompting

En lugar de escribir el prompt tu mismo, pide a Claude que escriba el prompt. Esto funciona especialmente bien para flujos de trabajo complejos de múltiples pasos donde sabes el resultado deseado pero no la mejor forma de instruir a Claude.

Meta-PromptEscribeme un prompt que produzca un informe completo de análisis competitivo para un negocio de servicios locales. El prompt debe: - Ser utilizable con cualquier nicho de negocio - Producir una salida estructurada lista para el cliente - Incluir puntos de datos específicos a verificar - Tardar menos de 10 minutos en ejecutarse para Claude - Salida como markdown con tablas
Apila los Patrones
Estos patrones se componen. Un prompt compuesto con forzar cadena de pensamiento y salida estructurada es más poderoso que cualquier patrón solo. Empieza con prompts compuestos, agrega los otros a medida que tus necesidades se vuelvan más específicas.
Punto de Control - Patrones de Prompts

Módulo 09Casos de Éxito - Lo que Este Stack Realmente Construyó

La teoría es barata. Aquí hay 6 patrones reales que hemos ejecutado - generalizados pero con números reales.

1. Sprint de Rendimiento Multi-Cliente
9 clientes · 4 dimensiones · agentes en paralelo · 90+ archivos producidos · $15k/mes en ingresos recurrentes

Auditamos 9 clientes activos en visibilidad, salud técnica, backlinks y contenido en un solo sprint. Cada cliente recibio un deck completo de reportes HTML interactivos desplegado en una URL en vivo.

2. De Brief a Sitio Web en Vivo
1 parrafo de brief → sitio web en vivo → un solo prompt · valor potencial: $8k+ por proyecto

Desde una descripción de negocio de un parrafo hasta un sitio web completamente desplegado y responsivo con URL en vivo. Sin HTML manual. Sin FTP. Sin configuración de alojamiento.

3. Pipeline de Contenido Social
Estrategia → borradores → gráficos → programación · 15 min/semana · potencial de servicio de $8k-$15k/mes

Construimos un pipeline completo de contenido para una cadena de restaurantes: marco de estrategia, plantillas de carrusel, biblioteca de captions, calendario de publicación y skills de generación reutilizables. La ejecución semanal toma un prompt.

4. Fábrica de Clones de Voz
Muestra de 60 segundos → voz de marca → ejecuta localmente

Construimos un pipeline local de clonación de voz con múltiples motores. Una muestra de audio de 60 segundos se convierte en una voz de marca reutilizable para landing pages, audio de onboarding y narración de video.

5. Motor de Alcance Automatizado
200+ prospectos/semana · cero prospectación manual · valor de pipeline de $20k/mes

Generación de prospectos de extremo a extremo: identificación de prospectos, verificación de email, creación de secuencias personalizadas, carga de campañas y monitoreo de respuestas. El humano solo interviene cuando un prospecto responde positivamente.

6. Sistema de Ingesta de Conocimiento
60+ libros · 30+ cursos · 8 podcasts → base de conocimiento con búsqueda

Ingestamos masivamente una biblioteca profesional completa en una base de conocimiento estructurada y con búsqueda. Libros transcritos, cursos extraidos, feeds de podcasts monitoreados - todos alimentando un sistema de seguimiento con auto-sincronización.

Errores ComunesLo que Sale Mal (Y Cómo Solucionarlo)

Todos se topan con los mismos muros. Estos son los 7 errores más comunes - la mayoría los descubren de la manera difícil.

1. Quedarse sin créditos a mitad de una tarea

Lo que ocurre: Lanzaste 5 agentes Opus y quemaste tu presupuesto mensual en una tarde. Los agentes están ejecutandose, el trabajo está ocurriendo, y luego todo se detiene sin nada commiteado en disco.

Solución: doctrina de enrutamiento de modelos. Haiku para tareas masivas, Sonnet para juicios, Opus solo para planificación profunda y arquitectura. Antes de lanzar una sesión paralela, estima el costo mentalmente: cuántos agentes, que modelo, cuánto tiempo correra cada uno.

Establece un presupuesto mental por sesión antes de lanzar agentes. Si Opus cuesta 15x más que Haiku, preguntate si realmente necesitas ese nivel de razonamiento para esta tarea específica - la mayoría de las veces, no.

2. Dos agentes escribiendo el mismo archivo

Lo que ocurre: El último en escribir gana. El Agente B termina y escribe su salida en el mismo archivo en que trabajaba el Agente A. Todo lo que produjo el Agente A es silenciosamente sobreescrito. No lo notas hasta que ves el archivo y te preguntas donde fue la mitad del contenido.

Solución: cada agente tiene un archivo o directorio de salida único. Antes de lanzar agentes en paralelo, asigna a cada uno una ruta de salida explícita y sin solapamiento. El Agente A escribe en output/agent-a/. El Agente B escribe en output/agent-b/. Nunca se solapan.

El Claude principal posee todas las superficies compartidas: el índice de memoria, el archivo de plan maestro, el índice de entregables, todos los commits de git. Los subagentes solo poseen sus directorios de salida designados.

3. Saltarse la capa de identidad

Lo que ocurre: Abres Claude, comienzas a escribir tareas y obtienes salida competente pero genérica. Claude está escribiendo para un usuario hipotético, no para ti y tu negocio específico. Cada sesión comienza desde cero de contexto.

Solución: CLAUDE.md + memoria antes que cualquier cosa. La primera hora que inviertes en configurar tu identidad de workspace - quien eres, que haces, cuáles son tus restricciones, cuáles son tus preferencias - se paga de vuelta en cada conversación a partir de ese momento.

Escribe tu CLAUDE.md. Comienza tus archivos de memoria. Captura retroalimentación cuando Claude haga algo bien o mal. En una semana de uso consistente, la diferencia de calidad de salida entre un workspace configurado y uno sin configurar es notoria.

4. Tratar Claude Code como ChatGPT

Lo que ocurre: Escribes preguntas, Claude las responde, copias las respuestas. Sin archivos. Sin memoria. Sin skills. Estas usando una interfaz de línea de comandos como un navegador web ligeramente más rápido.

Solución: construye skills para tareas recurrentes, usa referencias @file, deja que Claude lea tus documentos reales. El poder de Claude Code es que vive dentro de tu sistema de archivos. Puede leer tus perfiles de clientes, tus plantillas, tus datos - sin que pegues nada. Puede escribir archivos directamente en las carpetas correctas. Puede ejecutar scripts.

Si te encuentras copiando y pegando las mismas instrucciones en Claude más de dos veces, eso es un skill esperando ser escrito. Si te encuentras pegando contenido de documentos en el chat, esa es una referencia @file esperando ser usada.

5. No commitear trabajo durante la sesión

Lo que ocurre: VS Code se cuelga. La ventana de contexto se comprime y el agente pierde el rastro de lo que construyó. Un agente en segundo plano agota el tiempo. Cierras la terminal por accidente. Si no has commiteado, se fue - o en el mejor caso, disperso en buffers sin guardar.

Solución: commitea después de cada salida significativa. Commits pequeños y frecuentes superan a un commit gigante al final de una sesión. Después de que un agente produzca un archivo, commitelo. Después de un hito clave, commitelo. Después de que un lote paralelo se complete, commitea la salida de cada agente por separado.

La regla general: si perder el trabajo desde tu último commit te haría frustrar, es hora de commitear ahora.

6. Creep de alcance en prompts de agentes

Lo que ocurre: Le das a un agente un prompt que intenta hacer todo: "construye el flujo de onboarding, actualiza el CRM, redacta la secuencia de bienvenida, crea la hoja de seguimiento y documenta el proceso." El agente produce salida mediocre en las 10 tareas y excelente en ninguna.

Solución: un entregable claro por agente. Estrecha el alcance, eleva la calidad. "Construye la secuencia de emails de bienvenida para nuevos clientes, 3 emails, guardado en templates/emails/onboarding/" es un mejor prompt que "maneja todo el tema del onboarding."

Si tienes 10 tareas, lanza 10 agentes con 10 briefs estrechos. Obtendras mejor salida en todas ellas que un agente intentando hacer malabarismos con todo a la vez.

7. Saltarse la verificación

Lo que ocurre: El agente dice "listo." Marcas la tarea como completada. Tres días después, un colega intenta acceder a la URL en vivo y obtiene un 404. O envias un reporte que aún tiene texto de marcador de posición. O el script desplegado tiene un error silencioso que solo aparece con datos reales.

Solución: "listo" significa desplegado y confirmado funcionando, no "el agente dijo que término." Haz curl a cada URL. Busca en cada archivo texto de marcador de posición. Verifica cada salida contra sus criterios de aceptación antes de marcar la tarea como completa.

Integra la verificación en tus flujos de trabajo: agrega un paso de QA después de cada despliegue, agrega un paso de verificación de marcadores después de cada generación de documento, agrega una verificación HTTP 200 después de cada lanzamiento de sitio. Que el agente termine no es la línea de meta - la salida verificada si lo es.

El Patrón
La mayoría de estos errores tienen la misma raíz: moverse rápido sin guardrails. La solución no es ir más lento - es construir los defaults correctos. Enrutamiento de modelos, rutas de salida únicas, configuración de identidad, skills, commits frecuentes, briefs estrechos y verificaciones. Construye estos habitos en tus primeras dos semanas y te protegeran durante anos.
Punto de Control - Errores Comunes

Módulo 10La Frontera - Agent SDK, Enjambres, Lo que Viene

Todo lo anterior es lo que está funcionando hoy. Esto es lo que viene - y cómo posicionarte para usarlo en el momento en que llegue.

El Claude Agent SDK

El Agent SDK de Anthropic te permite construir agentes personalizados que corren fuera de Claude Code. Piensa en ello como Claude-como-librería - escribes Python o TypeScript, llamas a la API de Claude y construyes agentes que:

Pythonfrom anthropic import Agent audit_agent = Agent( model="claude-sonnet-4-5-20250514", tools=[data_tool, crawl_tool, sheets_tool], system_prompt="You are a visibility audit specialist..." ) result = audit_agent.run( "Audit example-business.com for online visibility" )

Flujo de Enjambre - Agentes que se Alimentan Mutuamente

Un enjambre es el estado final: una red de agentes donde la salida de cada agente es la entrada de otro. Sin humanos en el ciclo para operaciones de rutina.

Agente Rastreador
Agente Analista
Agente Constructor de Pitch
Agente Redactor de Emails
Agente de Campaña
Agente de Seguimiento
Agente de Calendario
Agente de Brief Pre-Llamada
TU CIERRAS
El 80/20 de los Enjambres
No necesitas el enjambre completo para obtener valor. Construye un pipeline de 3 agentes que maneje tu flujo de trabajo más común de extremo a extremo. La mayoría de las personas nunca construiran más de 3 agentes conectados - y eso es suficiente para multiplicar por 10 su producción.

Astro - El Framework Recomendado

Cuando el HTML plano no es suficiente pero Next.js es excesivo, Astro es el punto medio ideal. Es el framework que mejor se adapta a como Claude Code construye las cosas - limpio, rápido y configuración mínima.

FrameworkMejor ParaCompatibilidad con Claude Code
AstroSitios de contenido, landing pages, blogsExcelente - limpio, rápido, simple
Next.jsApps web complejas, dashboardsBueno - más sobrecarga de configuración
HTML PlanoPáginas puntuales, decks de presentaciónExcelente - sin dependencias
Empieza con Astro
Para la mayoría de los proyectos, comienza con Astro: npm create astro@latest. Genera HTML estático por defecto (perfecto para Cloudflare Pages), soporta componentes cuando los necesitas y Claude Code genera código Astro limpio con alucinación mínima. Usa HTML plano para cosas puntuales, Astro para cualquier cosa que vayas a mantener o expandir.

La Visión

Hoy6 Meses12 Meses
Indicas a Claude que haga tareasLos agentes manejan tareas de rutina autonomamenteLos enjambres ejecutan todo tu pipeline de entrega
Revisas cada salidaSolo revisas excepcionesSolo revisas la estrategia
1 ventana de Claude a la vez5-6 chats en paralelo como rutinaFlota de agentes corriendo 24/7
APIs llamadas manualmentePipelines disparados por eventosSistemas auto-reparables con cadenas de respaldo
Memoria entre sesionesMemoria compartida entre equipos de agentesGrafo de conocimiento organizacional

Las herramientas existen hoy. La pregunta no es "podemos construir esto?" - es "que tan rápido podemos conectarlo?"

Punto de Control Final - Agentes de IA Ejecutando tu Negocio

Tu VentajaEncontrando Tu Ventaja - Haciendo tu Primer Dinero con IA

Todo en esta guía es una herramienta. Las herramientas no hacen dinero. Tu haces dinero aplicando herramientas a problemas que las personas pagarán para resolver. Aquí está cómo encontrar tu ventaja y monetizarla.

Audita Lo que Ya Sabes

Tu ventaja injusta no es Claude Code - es tu experiencia en el dominio combinada con Claude Code. Un técnico puro puede construir la herramienta. Un experto en la industria pura puede identificar el problema. Tú puedes hacer ambos. Esa combinación es rara y valiosa.

Empaquétalo como Servicio

Los servicios se venden más rápido que los productos. No construyas un SaaS el primer día. Empaqueta tu experiencia + IA en un servicio listo para usar primero:

Cobra por Valor, No por Horas

Si Claude Code te permite entregar en 2 horas lo que solía tomar 20, no cobres por 2 horas. Cobra en función del valor que recibe el cliente. Un análisis competitivo que te toma 90 segundos generar (pero tardaría un día completo para un consultor) vale lo que el consultor cobra - o más, porque lo entregas más rápido.

Construye Prueba Rápido

  1. Haz 3 proyectos al costo. Elige 3 negocios en tu nicho objetivo. Entrega el servicio gratis o al costo. Enfócate en producir grandes resultados.
  2. Recopila testimonios. Después de la entrega, pide un testimonio escrito o en video. Los resultados específicos ("duplicamos el engagement en redes sociales en 3 semanas") superan al elogio genérico.
  3. Sube el precio. Con 3 casos de estudio en mano, cobra el valor completo. La prueba hace la venta.

La Ventaja Injusta

Tu Ventaja
Tu experiencia en el dominio + herramientas de IA = algo que ningún técnico puro puede replicar. Un desarrollador puede construir la automatización. Pero no sabe que problemas vale la pena resolver, que clientes pagarán, ni cómo posicionar la oferta. Tú sí. Ese conocimiento, combinado con la velocidad de ejecución que te da Claude Code, es el foso.

Las personas que ganan con IA no son las que aprenden más herramientas. Son las que aplican la herramienta correcta a un problema real, rápido, y cobran por ello. Todo en esta guía existe para hacer ese ciclo - identificar problema, construir solución, entregar resultado, cobrar - tan corto como sea posible.

¿Quieres un Plan de Implementación de IA Personalizado?

Agenda una llamada con Donal. En 30 minutos, obtendras una hoja de ruta personalizada para integrar Claude Code en tu negocio específico - incluyendo qué APIs conectar, que skills construir primero y cómo alcanzar el retorno en tu primer mes.

Agenda Tu Llamada de Plan Personalizado →

Comienza con las guias gratuitas:

De Cero a Peligroso (Guía de Inicio)  ·  Calculadora de Migración desde ChatGPT