Directorio / Guías / Claude Code

Automatizar tareas con Claude Code: sin pantalla y con horario

Cómo correr Claude Code sin la pantalla interactiva con claude -p, limitar sus herramientas y programarlo en tu computadora, en la nube o en GitHub. Con un ejemplo: el reporte semanal desde un CSV.

Guía paso a paso5 min de lecturaPor Rafael Schwart

Para una tarea que se repite igual cada semana no necesitas conversar con Claude: la describes una vez, la pruebas y la dejas programada. Antes de automatizarla, tiene que salir bien a mano varias veces seguidas. Si no sabes cuál elegir, empieza por qué automatizar primero.

El modo sin pantalla: claude -p

Con -p (o --print), Claude Code recibe el pedido, trabaja, imprime la respuesta y se cierra.

claude -p "¿Qué archivos hay en esta carpeta y para qué sirve cada uno?"

También lee lo que le pasas por la entrada, como cualquier comando: cat notas.txt | claude -p "resume esto en cinco puntos". Termina con código 0 si salió bien y con otro valor si falló, así un script sabe cuándo avisarte.

OpciónQué hace
--output-formattext es el predeterminado. json agrega datos de la sesión y el costo estimado. stream-json entrega evento por evento.
--tools "Read"Las únicas herramientas integradas que Claude puede usar. Con "" no tiene ninguna.
--allowedTools "Edit(reportes/**)"Lo que puede hacer sin pedir permiso. Este ejemplo permite escribir solo dentro de reportes/.
--disallowedTools "mcp__*"Quita herramientas. Este patrón quita todas las de tus servidores MCP.
--max-turns 5Limita las vueltas de trabajo.
--max-budget-usd 1Corta al llegar a ese gasto estimado. Útil si pagas por API.

En las versiones actuales, si ni la configuración ni la línea de comandos fijan un modo de permisos, claude -p arranca en modo Manual. Como nadie está para aprobar, toda acción que pediría permiso se rechaza. En una tarea sin supervisión, eso es lo que quieres.

Ejemplo: el reporte semanal desde un CSV

Cada lunes exportas las ventas a datos/ventas-semana.csv y quieres un resumen escrito. Primero haz el reporte en una sesión normal hasta que salga como lo necesitas. Después congélalo en un script. En Mac o Linux, reporte.sh:

#!/bin/bash
cd ~/reporte-ventas
claude -p "Lee datos/ventas-semana.csv y escribe un reporte en markdown:
total vendido, los 5 productos más vendidos y las filas con datos
faltantes o raros. Usa solo cifras del archivo. Si algo no se puede
calcular, dilo en vez de estimarlo." \
  --tools "Read" --disallowedTools "mcp__*" --max-turns 5 \
  > "reportes/semana-$(date +%F).md"

En Windows, reporte.ps1:

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
Set-Location "$HOME\reporte-ventas"
$fecha = Get-Date -Format "yyyy-MM-dd"
$pedido = "Lee datos/ventas-semana.csv y escribe un reporte en markdown: total vendido, los 5 productos más vendidos y las filas con datos faltantes o raros. Usa solo cifras del archivo. Si algo no se puede calcular, dilo en vez de estimarlo."
claude -p $pedido --tools "Read" --disallowedTools "mcp__*" --max-turns 5 |
  Out-File "reportes\semana-$fecha.md" -Encoding utf8

Claude solo puede leer: no edita, no ejecuta comandos y no usa conectores. El archivo lo escribe el script. Las primeras semanas, compara el total con tu hoja de cálculo. Si no coincide o el archivo es grande, pídele a Claude un script que haga las cuentas, revísalo y pásale a claude -p solo los resultados para que redacte.

Programarlo

  • El programador de tu sistema. En Mac o Linux, agrega una línea con crontab -e; 0 8 * * 1 /bin/bash $HOME/reporte-ventas/reporte.sh corre el script los lunes a las 8. Dentro del script usa la ruta completa de claude, que ves con which claude. En Windows, abre el Programador de tareas, crea una tarea semanal y como acción inicia powershell.exe con los argumentos -NoProfile -ExecutionPolicy Bypass -File "C:\Users\tu-usuario\reporte-ventas\reporte.ps1". La computadora tiene que estar encendida.
  • Tareas programadas de la app de escritorio. En la pestaña Code, entra a Scheduled y crea una tarea local. Corre en tu computadora con tus archivos, solo mientras la app está abierta y la computadora despierta. Los permisos se configuran por tarea.
  • Tareas programadas en la nube, antes llamadas rutinas. Se crean con /schedule dentro de Claude Code o desde la web. Corren aunque tu computadora esté apagada, sobre una copia nueva de un repositorio de GitHub, con un intervalo mínimo de una hora. Están en vista previa. Para este ejemplo tendrías que subir tus ventas a GitHub: con datos del negocio, prefiere una opción local.
  • GitHub Actions. La acción oficial anthropics/claude-code-action@v1 corre Claude con el horario cron de un flujo de trabajo, escrito en hora UTC. /install-github-app instala la app de GitHub de Claude y guarda la credencial; el flujo con horario lo agregas tú. Sirve cuando el trabajo ya vive en GitHub.

Seguridad: una tarea sin supervisión no puede pedir permiso

  • Dale lo mínimo. Enumera con --tools solo las herramientas que la tarea necesita y quita las de MCP. Si tiene que escribir, agrega Write a --tools y limítala a una carpeta con --allowedTools "Edit(carpeta/**)".
  • Nunca uses --dangerously-skip-permissions en una tarea programada. Salta todas las preguntas de permiso, y ahí nadie revisa lo que hace.
  • Nada que mueva dinero ni le hable a clientes. Ni pagos, ni transferencias, ni cambios de precio, ni mensajes o correos que salen solos. La tarea prepara un borrador; una persona lo revisa y lo envía.
  • Trabaja sobre una copia. Que lea una exportación, no tu sistema de ventas ni tu planilla original.
  • Desconfía del contenido de terceros. Un comentario de cliente dentro del CSV puede traer instrucciones escondidas. Con solo lectura, el daño posible es mínimo. El checklist de seguridad explica la inyección de prompts.
  • En la nube, revisa los conectores. Una tarea en la nube incluye todos tus conectores por defecto y arranca en modo Auto. Quita los que no necesita: lo que haga, lo hace con tu nombre.
  • Lee los resultados. Una automatización que nadie mira puede fallar semanas sin que te enteres.
Primero el proceso. Si a mano el reporte sale distinto cada semana, automatizarlo solo repite el desorden más rápido. Fija qué datos entran, qué sale y quién lo revisa; después ponle horario.

Las opciones completas están en la documentación oficial del modo sin pantalla y de las tareas programadas.

Sigue leyendo

Más guías.

Cada una se lee en menos de cinco minutos.

Todas las guías
Guía paso a paso · 4 min

Claude Code desde cero

Qué es Claude Code, cómo instalarlo en Windows o Mac, tu primer pedido, cómo aprobar lo que hace y los comandos que vas a usar cada día.

Guía paso a paso · 4 min

CLAUDE.md: el manual de tu proyecto

Qué es el archivo CLAUDE.md, dónde va, cómo crearlo con /init y qué escribir para que Claude no te pregunte lo mismo en cada sesión.

  Arqentia

¿Prefieres que lo armemos contigo?

Treinta minutos para ver tu operación: cómo entra el dinero, dónde se pierde tiempo y qué conviene automatizar primero. Gratis para negocios y sin compromiso.

Agendar consulta