Clase 03 · Módulo 12
Claude Code sin interfaz
Claude Code sin interfaz
Qué logras en esta clase
Usas Claude Code como un comando que corre solo, con permisos acotados y una salida que otro programa puede leer.
- Ejecutas un encargo con una sola orden.
- Apruebas de antemano solo lo necesario.
- Recibes el resultado en JSON, con su costo estimado.
02
Dos formas de usar Claude Code
| Sesión normal | Sin interfaz | |
|---|---|---|
| Cómo parte | claude | claude -p "encargo" |
| Quién responde los permisos | Tú, en pantalla | Nadie |
| Cómo termina | Cuando cierras | Sola, al entregar el resultado |
| Para qué sirve | Trabajar conversando | Que un script o un programador lo llame |
03
De conversación a comando
Con -p, Claude Code deja de ser una conversación y pasa a ser un comando más, que otro programa puede llamar.
04
La orden mínima
claude -p "Resume en cinco líneas el archivo notas.txt"-p es la forma corta de --print. Claude Code lee el encargo, trabaja en la carpeta donde lo ejecutaste, imprime la respuesta y termina.
Sin más opciones, usa tu sesión normal: la misma cuenta y el mismo plan con que abres Claude Code a diario.
05
Script fijo o Claude en cada corrida
| La tarea | Conviene |
|---|---|
| Sigue reglas exactas (renombrar, sumar, mover) | Script normal, de la clase anterior |
| Exige leer y decidir (resumir, clasificar texto libre) | claude -p |
Un script fijo da siempre el mismo resultado y no consume nada. claude -p consume uso en cada corrida y puede responder distinto ante el mismo dato. Úsalo solo donde las reglas no alcanzan.
06
Pasarle datos por tubería
Una tubería (|) entrega la salida de un comando como entrada del siguiente.
cat reclamos.txt | claude -p "Agrupa estos reclamos por causa" > resumen.txtEn PowerShell, Get-Content reclamos.txt cumple el papel de cat. El > guarda la respuesta en un archivo.
07
Nadie contesta los permisos
Sin interfaz no hay nadie que apruebe. Lo que no autorizaste de antemano, se deniega y la corrida sigue sin eso.
08
Aprobar herramientas concretas
claude -p "Corrige las faltas de ortografía de informe.md" --allowedTools "Read,Edit"Readpermite leer archivos.Editpermite modificarlos.Bashpermite ejecutar comandos en la terminal.
Admite reglas finas: Bash(git diff *) autoriza solo los comandos que empiezan así. El espacio antes del asterisco importa.
09
Modos de permiso
Con --permission-mode fijas una base para toda la corrida.
| Modo | Qué hace |
|---|---|
acceptEdits | Escribe archivos sin preguntar; otros comandos siguen requiriendo permiso |
dontAsk | Deniega todo lo que habría preguntado |
auto | Un clasificador revisa cada acción en tu lugar |
Para una tarea que solo lee y resume, dontAsk más una lista corta en --allowedTools es la combinación más cerrada.
10
Corridas sin nadie presente
claude -p "Resume los cambios de la semana" --permission-mode auto --permission-prompts none--permission-prompts none le dice a Claude Code que nadie puede responder: lo que quedaría esperando se deniega, Claude no lo reintenta y la corrida continúa.
Existe desde la versión 2.1.259. Comprueba la tuya con claude --version.
11
El mínimo necesario
La pregunta útil no es «qué podría necesitar», sino «qué es lo peor que podría hacer con este permiso sobre esta carpeta».
12
Tres formatos de salida
--output-format | Qué entrega | Para qué |
|---|---|---|
text | Solo la respuesta | Guardar en un archivo o leerla tú |
json | Respuesta más datos de la corrida | Que un programa la procese |
stream-json | Eventos, uno por línea | Mostrar el avance en vivo |
Si no indicas ninguno, usa text.
13
Qué trae el JSON
claude -p "Resume notas.txt" --output-format jsonresult: la respuesta en texto.session_id: el identificador de la sesión, para continuarla.total_cost_usd: el costo estimado de la corrida.
Ese costo lo calcula tu equipo y puede diferir de lo que se cobra. Sirve para comparar corridas, no como factura.
14
Obligar una estructura
claude -p "Clasifica el reclamo de reclamo.txt" --output-format json \
--json-schema '{"type":"object","properties":{"causa":{"type":"string"}},"required":["causa"]}'Un esquema JSON describe qué campos debe traer la respuesta (visto en el módulo 9, clase 4). El resultado llega en el campo structured_output.
15
Dónde encaja en una automatización
El script prepara los datos, llama a Claude para el paso que exige criterio y sigue con la respuesta. Claude Code es una pieza, no el proceso completo.
16
El código de salida
Todo comando termina con un número. Claude Code entrega 0 si la corrida salió bien y otro valor si falló. Un script puede leerlo y decidir: continuar, reintentar o avisar.
17
Opciones que vas a usar
--continuesigue la conversación más reciente.--resumecon unsession_idsigue una conversación concreta.--append-system-promptagrega instrucciones propias sin quitar el comportamiento normal.
La referencia de la línea de comandos lista las demás, entre ellas un tope de gasto por corrida. Revísala antes de programar algo frecuente.
18
El modo --bare
Con --bare, Claude Code parte sin cargar tus ajustes, skills, servidores MCP ni el archivo CLAUDE.md. El resultado no depende de cómo esté configurado ese equipo, y por eso es el modo recomendado para scripts.
Tiene un costo: no usa tu inicio de sesión. Exige la variable ANTHROPIC_API_KEY con una clave creada en la consola, y esa clave se paga por uso.
19
Con --bare y sin --bare
Sin --bare | Con --bare | |
|---|---|---|
| Quién paga | Tu suscripción | Saldo de API |
| Carga ajustes y skills | Sí | No |
| Conecta servidores MCP | Los de la carpeta y los tuyos | Solo los que indiques |
| Conviene para | Tareas tuyas, en tu equipo | Equipos distintos o servidores |
20
El riesgo de las carpetas ajenas
Un hook es un comando que se dispara solo durante la sesión. En una carpeta descargada de terceros, puede ser cualquier cosa. Ejecuta claude -p únicamente en carpetas que armaste tú.
21
Permisos amplios y texto ajeno
Si la tarea lee contenido que no escribiste tú, no le des permiso para ejecutar comandos ni para enviar nada.
Una salida: separar en dos corridas. Una lee y resume sin permisos; la otra actúa sobre el resumen ya revisado.
22
Mide antes de repetir
total_cost_usd dice cuánto costó cada corrida. Míralo en las primeras diez antes de programarla cada hora.
23
Lo que te llevas
claude -p "encargo"ejecuta, imprime y termina.- Lo que no apruebas con
--allowedToolso un modo de permiso, se deniega. --output-format jsonentrega resultado, sesión y costo estimado.--json-schemaobliga una estructura, enstructured_output.--barees más predecible y se paga por API.
24
Hazlo ahora
En 10 minutos, en una carpeta tuya con un archivo de texto cualquiera:
- Ejecuta
claude -ppidiendo un resumen de tres líneas del archivo. - Repite agregando
--output-format json. - Ubica
result,session_idytotal_cost_usden la salida. - Pide ahora que corrija el archivo, sin dar permisos, y observa qué se deniega.
- Repite el paso 4 con
--allowedTools "Read,Edit".
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026