alejo.santanna/recursos/paperclipGratis
Watch11.1kFork88k
GUIA.md3 secciones · 3 prompts

Tu empresa de agentes, con Paperclip

Un panel de código abierto para dirigir a tus agentes de IA como si fueran un equipo: organigrama, tareas, presupuestos y aprobaciones.

01Instalalo con Claude Code

No hace falta saber nada de terminal. Abrí Claude Code en cualquier carpeta y pegale este prompt. El link del repo va adentro, por si el prompt viaja solo.

Repositorio oficial en GitHub
github.com/paperclipai/paperclip
Abrir en GitHub ↗

Este es el link que le pasás a Claude, no el de esta página.

Pegar en Claude Code
Quiero instalar Paperclip en esta computadora y dejarlo funcionando. Repo: https://github.com/paperclipai/paperclip
Guía oficial: https://docs.paperclip.ing/reference/cli/installation/

Hacé esto en orden y avisame cómo va cada paso:

1. Revisá mi versión de Node con "node --version". Paperclip necesita Node 24.11 o más nuevo. Si tengo una más vieja, decime cuál tengo y pedime permiso antes de actualizarla (en Windows con winget, en Mac con Homebrew o nvm). Después volvé a comprobar la versión.

2. Revisá que Claude Code responda con "claude --version": los agentes de Paperclip lo usan por debajo.

3. Creá la configuración con los valores recomendados (base de datos y archivos locales, accesible solo desde esta computadora): npx paperclipai@latest onboard --yes
   Este comando deja el servidor corriendo: ejecutalo en segundo plano y esperá a que avise que está escuchando.

4. Abrime en el navegador la dirección que muestra (normalmente http://localhost:3100) y confirmame que el panel carga.

5. Si algo falla, corré "npx paperclipai doctor" y explicame el error en palabras simples antes de intentar arreglarlo.

Al final dejame un resumen corto: versión instalada, dirección del panel y cómo volver a levantarlo después de reiniciar la PC.

02Usalo con Claude Code

Paperclip no reemplaza a Claude Code: lo organiza. Vos definís un objetivo, armás el equipo y aprobás el plan. Los agentes trabajan y vos revisás desde el panel.

Las cuatro ideas que vas a ver

Empresa

Una organización de IA con un objetivo, un equipo, un tablero de tareas y un presupuesto.

Agente

Un empleado con rol, jefe y presupuesto. El primero que contratás es el CEO.

Tarea

El trabajo concreto. Cada una tiene un responsable, comentarios, archivos e historial.

Heartbeat

El momento en que un agente se despierta a trabajar: por una tarea asignada, un mensaje o un horario.

Tu primera empresa, en el panel

  1. Creá la empresa y escribile el objetivo. Por ejemplo: "conseguir los primeros 10 clientes de mi agencia".
  2. Contratá al CEO. Elegí Claude Code como motor del agente.
  3. Aprobá su estrategia. El CEO la deja en Aprobaciones; cuando la aceptás, empieza a crear tareas en el tablero.

Lo que hizo cada agente queda en Agentes, CEO, Ejecuciones, paso por paso.

Volver a abrirlo después de reiniciar

El servidor se apaga cuando cerrás la terminal o reiniciás la PC. Tus empresas y agentes no se pierden.

Pedido a Claude Code
Levantá Paperclip otra vez con "npx paperclipai@latest run" en segundo plano, esperá a que esté escuchando y abrime el panel.

Cuando no arranca

Paperclip trae un chequeo propio que revisa la configuración y repara lo que puede.

Pedido a Claude Code
Paperclip no levanta. Corré "npx paperclipai doctor --no-repair", explicame qué encontró en palabras simples y proponeme cómo arreglarlo antes de tocar nada.
Nota
Todo queda en tu computadora

No necesitás cuenta de Paperclip. La base de datos, la configuración y los registros se guardan en la carpeta .paperclip de tu usuario.

Nota
Poné un presupuesto antes de soltarlos

Los agentes gastan tokens. La documentación oficial calcula entre 5 y 20 dólares para probarlo y entre 20 y 100 por mes para una empresa activa. Fijá un presupuesto por agente y por empresa antes de activar los heartbeats: al llegar al 100 %, Paperclip los pausa solo.

03Antes de instalar

Lo que encontramos revisando el repo, la documentación oficial y una PC con Windows 11.

Lo que encontramos
Pide Node 24.11 o más nuevo

La PC donde lo revisamos tenía Node 22.14. Con Node 22 o 23 Paperclip avisa y sigue, pero la documentación aclara que eso no es soporte. Por eso el prompt revisa la versión primero y te pide permiso para actualizarla.

Lo que encontramos
En Windows, la sesión con la suscripción todavía no anda

Conectar tu suscripción de Claude desde Conectores usa una función que solo existe en Mac y Linux, y en Windows termina sin abrir el inicio de sesión (está reportado en el repo y sin resolver). Alternativas: usar una API key de Anthropic o instalar Paperclip dentro de WSL.

Lo que encontramos
En Windows, frenar una tarea la puede dejar trabada

Hay un reporte abierto: si apretás Stop mientras un agente trabaja, la tarea queda en espera y no acepta mensajes nuevos. Mientras no se arregle, evitá frenar tareas a mitad de camino; poné límites de presupuesto en su lugar.

Lo que encontramos
Por defecto, solo se abre desde tu PC

La instalación rápida lo deja accesible solo en esta computadora. Para entrar desde el celular u otra máquina hay que configurarlo en modo con usuario y contraseña (por ejemplo, con Tailscale). Pedíselo a Claude Code cuando lo necesites.

¿Lo querés a medida para tu negocio?

Armo sistemas y agentes de IA, y doy consultorías y asesorías para equipos en Latinoamérica y España.

Trabajar conmigo
Seguí con estos
RecursosTrabajar conmigo

¿Qué estás precisando ahora mismo?

Automatizar procesos en mi negocio.
→
Aprender de IA.consultorías y asesorías
→
Un proyecto más grande. Tengo presupuesto.agentes, sistemas, una construcción completa
→

Se abre WhatsApp con el mensaje ya escrito. Lo hablamos por ahí y coordinamos una llamada.