Paperclip: Tu Empresa de Agentes IA con Claude Code
El problema que aparece cuando tienes más de un agente
Tener un solo agente de IA trabajando en tu proyecto ya es poderoso. Tener veinte es un caos.
¿Quién toma las decisiones? ¿Quién revisa el código? ¿Cómo evitas que dos agentes trabajen en el mismo ticket al mismo tiempo? ¿Cómo controlas que no se te dispare el gasto en tokens cuando un agente entra en un bucle?
Paperclip es la respuesta a todas esas preguntas. Es un framework open-source lanzado en marzo de 2026 que organiza múltiples instancias de Claude Code como si fueran los empleados de una empresa: con roles, presupuestos, flujos de aprobación y memoria de sesión persistente.
Alcanzó 30.000 estrellas en GitHub en tres semanas. La razón es sencilla: resuelve el problema correcto.
Qué es Paperclip exactamente
Paperclip no es una funcionalidad de Claude Code. Es una capa de orquestación independiente, open-source y auto-hospedada (sin cuenta en Paperclip, sin suscripción), que se instala como un servidor Node.js con interfaz React.
La idea central es esta: modela tu equipo de IA como una empresa real, con organigrama, misión, objetivos y presupuesto mensual por agente.
Cada "empleado" en Paperclip es un agente que:
- Tiene un rol definido (CEO, CTO, Backend Engineer, QA…)
- Se ejecuta sobre Claude Code como runtime
- Despierta en intervalos regulares (heartbeat)
- Trabaja en tareas asignadas, hace commits, abre PRs o revisa código
- Se detiene automáticamente cuando agota su presupuesto mensual de tokens
Lo que hace Paperclip por ti es exactamente lo que un manager hace en un equipo humano: decide qué hace cada agente, en qué orden, con qué límites, y asegura que nadie pise el trabajo de otro.
El adaptador claude-local: la integración con Claude Code
La pieza que conecta Paperclip con Claude Code se llama claude-local. Es el adaptador que indica a Paperclip cómo lanzar sesiones de Claude Code, mantenerlas entre ciclos de heartbeat y parsear sus outputs.
Lo más importante de este adaptador:
- Persistencia de sesión: cada agente mantiene su
SESSION_IDentre ejecuciones. Cuando vuelve a despertar, retoma exactamente la misma conversación de Claude Code en lugar de empezar en blanco. Esto elimina el coste de re-contextualizar en cada ciclo. - Inyección de Skills: Paperclip inyecta archivos Markdown de habilidades en la sesión de Claude Code. Tu agente de QA puede aprender a ejecutar Playwright sin que tengas que reentrenarlo; le pasas el Skill y ya sabe cómo hacerlo.
- Cambio de directorio: si el directorio de trabajo del agente cambia entre ejecuciones, se inicia una sesión nueva automáticamente para evitar confusiones de contexto.
La configuración mínima del adaptador es tener el CLI de Claude disponible (claude en PATH) y ANTHROPIC_API_KEY en el entorno. El botón "Test Environment" del dashboard de Paperclip valida que todo está correcto antes de ejecutar nada.
Arquitectura de un equipo típico
Un equipo de desarrollo con Paperclip tiene esta estructura:
CEO (Sonnet 4.6) ← Estrategia, backlog, asignación
└── CTO (Haiku 4.5) ← Decisiones técnicas, revisión de PRs
├── Backend Engineer (Sonnet 4.6) ← Claude Code: APIs, DB
├── Frontend Engineer (Sonnet 4.6) ← Claude Code: React/Next.js
└── QA Engineer (Haiku 4.5) ← Claude Code: Playwright, tests
El CEO nunca escribe código. Lee el backlog del producto, descompone features en tickets y los asigna a sus reportes directos. Usa Sonnet porque necesita razonar sobre el producto completo.
El CTO delega el trabajo técnico y revisa los PRs antes de aprobarlos. Usa Haiku porque sus tareas son más mecánicas: routing, checklist de revisión, aprobación de cambios.
Los Engineers son quienes ejecutan todo a través de Claude Code: crean ramas, escriben código, hacen commits con mensajes consistentes (gracias a un Skill de formato), abren PRs.
El QA toma el trabajo terminado de un directorio compartido, ejecuta los casos de test de forma independiente y reporta bugs de vuelta a la organización.
Usar Haiku para CTO y QA ahorra entre un 40-60% de gasto mensual frente a ejecutar Sonnet en todos los roles.
El sistema de Skills
Una de las características más prácticas de Paperclip es el sistema de Skills: archivos Markdown que enseñan a los agentes procesos repetibles sin necesidad de reentrenamiento.
Ejemplos de Skills útiles para un equipo de desarrollo:
# Skill: Commit Message Format
Siempre usa el formato Conventional Commits:
- feat(scope): descripción
- fix(scope): descripción
- docs(scope): descripción
Máximo 72 caracteres en la primera línea.
# Skill: PR Review Checklist
Antes de aprobar un PR, comprueba:
1. Tests pasando en CI
2. Descripción clara del cambio
3. Sin secrets expuestos
4. Naming conventions respetadas
Los Skills son descubribles en tiempo de ejecución. Puedes añadir uno nuevo y los agentes lo incorporan en el siguiente heartbeat, sin cambiar su prompt base ni desplegar nada.
Si ya has trabajado con agentes y subagentes en Claude Code, verás que Paperclip lleva esa idea al siguiente nivel: no es un agente que coordina subagentes de forma puntual, sino una estructura organizativa permanente con gobernanza real.
Control de costes y gobernanza
Uno de los miedos más legítimos al dejar correr agentes autónomos es el gasto descontrolado. Paperclip lo resuelve con presupuestos duros por agente:
- Defines un límite mensual de tokens para cada rol
- Cuando el agente lo agota, se detiene automáticamente
- El dashboard muestra el consumo en tiempo real por agente y por tarea
Además, Paperclip incluye puertas de aprobación (approval gates): acciones que requieren revisión humana antes de ejecutarse. Por ejemplo, puedes configurar que ningún agente pueda hacer merge a main sin tu visto bueno, o que cualquier gasto de tokens superior a un umbral dispare una notificación.
Esto lo convierte en una herramienta apta para entornos de producción real, no solo para experimentos en local.
¿Cuándo tiene sentido usar Paperclip?
Paperclip es para equipos, no para proyectos personales sencillos. La propia documentación lo dice: "si tienes un agente, probablemente no lo necesitas. Si tienes veinte, definitivamente sí."
Tiene sentido cuando:
- Estás construyendo un producto complejo que requiere backend, frontend, tests y documentación en paralelo
- Quieres que la IA trabaje mientras duermes o estás en otras tareas, con logs claros de lo que hizo
- Necesitas control de costes y transparencia por rol
- Tu equipo humano ya usa Claude Code y quieres escalar con agentes que respeten el mismo flujo de trabajo
Para integraciones de IA más específicas sobre tu stack React/Next.js, también puedes explorar cómo integramos IA en proyectos reales.
Conclusión
Paperclip es la pieza que faltaba para escalar de "un agente que me ayuda a codificar" a "un equipo de agentes que construye software de forma autónoma con mi supervisión". La combinación con Claude Code como runtime es especialmente potente porque hereda todo el contexto, las herramientas y las capacidades de edición de código que ya conoces.
Si quieres implementar esta arquitectura en tu proyecto o explorar cómo encajaría en tu flujo de trabajo, escríbeme: