Cómo uso la CLI de Recurrente

La CLI de Recurrente te deja manejar tu cuenta desde la terminal: consultar pagos, crear checkouts, revisar suscripciones y todo lo que hace el API. La usas tú o un agente que corre en tu máquina, como Claude Code o Codex. La encuentras en Configuración → Integraciones → CLI de Recurrente, o en Configuración → Llaves API → Herramientas.

Instálala

Necesitas Node 20 o más reciente. Cada comando de la página tiene su botón Copiar.

1. Instala la CLI: npm install -g @recurrente/cli
2. Inicia sesión con recurrente login y pega tu llave secreta cuando te la pida.
3. Comprueba la conexión con recurrente whoami --live. Deberías ver el nombre de tu cuenta y el perfil live.

Tu llave secreta está en Configuración → Llaves API. Solo se muestra completa al crearla: si no la guardaste, crea una nueva.

Úsala

recurrente help                 # los temas
recurrente search reembolso     # busca un comando, en español o en inglés
recurrente checkouts list --items 5

Cada comando responde en JSON, así que un script o un agente lo lee sin adivinar.

Dásela a tu agente

Un agente que corre comandos, como Claude Code o Codex, usa recurrente como cualquier otro comando: no hay nada más que configurar. Si prefieres conectarlo por MCP, eso está en cómo conecto Claude o ChatGPT a mi cuenta.

Pruébala en Sandbox primero

La CLI funciona igual en un Sandbox, donde nada mueve dinero real. Entra a tu Sandbox, crea una llave TEST en Llaves API y abre la CLI desde Herramientas: son los mismos pasos, y recurrente login guarda la llave TEST aparte de la LIVE. Para abrir un Sandbox, mira cómo probar tu integración en Sandbox.

Si guardas las dos llaves, la primera que guardaste queda como la de siempre. Agrega --sandbox o --live a cada comando, como hace la página al comprobar la conexión: así no mandas a producción algo que querías probar.

Lo que conviene saber

• Mover dinero pide confirmación. Reembolsos, transferencias, retiros y cambios de cuenta bancaria se rechazan si no agregas --yes, para que una persona lo apruebe antes.
• Tu llave no queda a la vista. Se guarda en tu máquina, en ~/.recurrente/credentials.json, y solo tu usuario puede leerla. No queda en el historial de la terminal ni en lo que ve tu agente.
• Solo administradores. Si tu rol en la cuenta es soporte, cajero o solo lectura, no ves la página ni las llaves: pide que lo haga quien administre la cuenta.
• No cuesta nada. Usar la CLI no cambia tus comisiones ni tus precios.

---

¿Necesitas más ayuda? Contacta a soporte por correo [email protected] o escríbenos por WhatsApp.