Clase 02 · Módulo 12
Crear scripts con Claude Code sin saber programar
Crear scripts con Claude Code sin saber programar
Qué logras en esta clase
Le encargas un script a Claude Code y lo dejas probado, sin escribir código.
- Describes el trabajo de forma que no admita dos lecturas.
- Guardas las claves fuera del script.
- Pruebas con una muestra antes de tocar datos reales.
- Revisas lo que importa antes de confiar.
02
Tu parte del trabajo
No necesitas escribir el código. Necesitas describir bien el trabajo y revisar bien el resultado.
03
Antes de empezar
- Claude Code instalado y con sesión iniciada (Claude de verdad, módulo 7).
- Node.js o Python en tu computador. Si instalaste n8n con npm, ya tienes Node.js.
- Una carpeta nueva para este script y nada más.
- Entre cinco y diez archivos de muestra que representen el trabajo real.
04
Preparar la carpeta
- Crea una carpeta con el nombre de la tarea, por ejemplo
renombrar-facturas. - Dentro, crea
muestray copia ahí algunos archivos reales. - Abre una terminal ubicada en esa carpeta.
- Ejecuta
claudepara iniciar la sesión.
Claude Code trabaja sobre la carpeta donde lo abres. Por eso conviene una carpeta por script: lo que no está ahí, no lo toca.
05
La regla de las copias
Trabaja siempre sobre copias hasta que el script haya pasado todas tus pruebas.
06
Qué debe decir tu pedido
| Parte | Qué escribes |
|---|---|
| Entrada | Qué archivos o datos recibe y dónde están |
| Salida | Qué debe quedar al terminar y dónde |
| Reglas | Cómo se transforma una cosa en la otra |
| Casos raros | Qué hacer cuando falta un dato |
| Prohibido | Lo que no debe tocar nunca |
Es el mismo orden de un buen pedido (Claude de verdad, módulo 2), aplicado a un programa.
07
Un pedido que se entiende
Tiene entrada, salida, regla, caso raro y prohibición. Lo que no digas, Claude lo decide por ti.
08
Pide el plan antes del código
- Pídele que explique, en lenguaje simple, qué pasos seguirá el script.
- Pregunta qué bibliotecas va a instalar y para qué sirve cada una.
- Corrige lo que no calce con tu proceso real.
- Recién ahí pídele que lo escriba.
09
Tres cosas que todo script debe traer
- Modo simulación: muestra lo que haría, sin hacerlo.
- Registro: un archivo de texto donde anota cada cosa que hizo y cada fallo.
- Resumen final: cuántos elementos procesó, cuántos dejó para revisar.
Claude no siempre las agrega por su cuenta. Pídelas en el encargo, con esos nombres.
10
Dónde van las claves
Una clave nunca va escrita dentro del script. Va en un archivo aparte que el script lee al partir.
11
El archivo .env
Un archivo .env es un archivo de texto con una línea por cada clave.
API_CLIENTES_CLAVE=pega-aqui-tu-clave- Pídele a Claude que el script lea sus claves desde variables de entorno.
- Pídele un
.env.examplecon los nombres y sin valores. - Copia ese archivo como
.envy pega tú la clave, en tu editor.
No pegues la clave en la conversación con Claude: no hace falta.
12
Un .env no está cifrado
- No lo mandes por correo ni por chat.
- No lo dejes en una carpeta compartida con otras personas.
- Si usas un repositorio, pide a Claude que lo excluya con
.gitignore. - Crea una clave propia para el script, con los permisos mínimos.
13
Node.js o Python
| Node.js | Python | |
|---|---|---|
| Ya lo tienes si | Instalaste n8n con npm | Lo instalaste aparte |
| Se ejecuta con | node archivo.mjs | python archivo.py |
| Punto fuerte | Mismo lenguaje del nodo Code | Planillas, PDF y datos |
El criterio simple: usa el que ya tienes instalado y díselo a Claude. Si tienes los dos, pregúntale cuál conviene para esa tarea y por qué.
14
Probar con la muestra
- Ejecuta el script en modo simulación.
- Lee lo que dice que haría. ¿Coincide con lo que tú harías a mano?
- Ejecútalo de verdad, solo sobre
muestra. - Abre los resultados uno por uno.
- Agrega a propósito un caso malo: un archivo vacío, una fecha ilegible.
El paso 5 es el que más enseña: muestra qué hace el script cuando la realidad no coopera.
15
El camino hasta los datos reales
Los originales solo entran cuando las dos filas salieron bien.
16
Que corra no significa que esté bien
Haz diez casos a mano y compara con lo que produjo. Si coinciden los diez, incluidos los raros, recién ahí empieza la confianza.
17
Qué revisar antes de confiar
| Pregunta | Por qué importa |
|---|---|
| ¿Borra o sobrescribe algo? | Es lo único que no tiene vuelta atrás |
| ¿Envía datos a internet? ¿A dónde? | Pueden ser datos de clientes |
| ¿Qué pasa si se corta a la mitad? | Debe poder correr de nuevo sin duplicar |
| ¿Qué instaló? | Cada biblioteca es código de terceros |
Hazle estas cuatro preguntas a Claude y pídele que señale la línea donde ocurre cada cosa.
18
Una segunda mirada
No reemplaza tus pruebas con la muestra. Las complementa: encuentra casos que a ti no se te ocurrió probar.
19
Cuando el script falla
- Copia el mensaje de error completo, sin resumirlo.
- Pégalo en la sesión y di qué esperabas que pasara.
- Deja que Claude proponga el arreglo y pregúntale la causa.
- Vuelve a correr la muestra entera, no solo el caso que falló.
Un arreglo puede romper algo que antes funcionaba. Por eso la muestra se corre completa cada vez.
20
El script sin instrucciones
Pide a Claude un archivo LEEME.md de media página: qué hace, cómo se ejecuta, qué necesita instalado, qué claves usa y qué hacer si falla.
21
Cuándo está listo
Un script está listo cuando otra persona puede ejecutarlo leyendo media página.
22
Lo que te llevas
- Un buen pedido tiene entrada, salida, reglas, casos raros y prohibiciones.
- Simulación, registro y resumen final se piden siempre.
- Las claves van en
.env, que no está cifrado y no se comparte. - Se prueba sobre copias, comparando contra casos hechos a mano.
- Antes de confiar: qué borra, qué envía, qué pasa si se corta, qué instala.
23
Hazlo ahora
En 15 minutos, con la tarea que marcaste en la clase anterior:
- Crea la carpeta y una
muestracon cinco copias. - Escribe el pedido con las cinco partes de la tabla.
- Pide el plan, corrígelo y pide el script con modo simulación y registro.
- Corre la simulación y compara dos casos contra lo que harías a mano.
Si los dos coinciden, agrega un caso malo y mira qué pasa.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026