Clase 05 · Módulo 03
El nodo Code con ayuda de Claude
El nodo Code con ayuda de Claude
Qué logras en esta clase
Resuelves con código lo que ningún nodo cubre, sin escribirlo tú y sin confiar a ciegas.
- Decides cuándo hace falta el nodo Code.
- Le pides el código a Claude con lo necesario.
- Lo pruebas con casos normales y raros.
- Conoces lo que n8n 2 no le deja hacer.
02
La salida de emergencia
El nodo Code no es el camino principal. Úsalo cuando los nodos de datos y las expresiones ya no alcanzan.
03
Cuándo sí y cuándo no
| Situación | Herramienta |
|---|---|
| Renombrar, filtrar, ordenar, agrupar | Nodos de datos (clase 3) |
| Un retoque dentro de un campo | Expresión (clase 2) |
| Validar un RUT con su dígito verificador | Code |
| Reestructurar una respuesta muy anidada | Code |
| Comparar cada ítem con todos los demás | Code |
Lo bueno del código: hace cualquier cosa. Lo malo: nadie ve qué hace sin abrirlo, y alguien tiene que mantenerlo.
04
Qué entra y qué debe salir
El nodo Code sigue la misma regla que todos: recibe una lista de ítems y entrega una lista de ítems.
Lo que el código devuelve tiene que tener esa forma: una lista donde cada elemento lleva sus datos en json. Si devuelve otra cosa, el nodo siguiente no sabrá leerlo.
05
Los dos modos
| Modo | El código corre | Úsalo para |
|---|---|---|
| Run Once for All Items | Una sola vez, con toda la lista | Sumar, comparar entre ítems, reagrupar |
| Run Once for Each Item | Una vez por cada ítem | Calcular o validar algo de cada uno |
El primero es el que viene por defecto. Se cambia en el parámetro Mode del nodo.
06
Cómo lee el código la entrada
| Dentro del código | Entrega | Modo |
|---|---|---|
$input.all() | Todos los ítems | Todos a la vez |
$input.first() | El primer ítem | Todos a la vez |
$input.item | El ítem en proceso | Por cada ítem |
$json | Los datos del ítem en proceso | Por cada ítem |
No tienes que escribir esto. Tienes que reconocerlo cuando Claude te entregue el código, para saber de dónde saca los datos.
07
Un código mínimo, para aprender a leerlo
const pedidos = $input.all();
let suma = 0;
for (const p of pedidos) {
suma += p.json.total;
}
return [{ json: { total_del_dia: suma, cantidad: pedidos.length } }];Toma todos los ítems, suma el campo total de cada uno y devuelve un solo ítem con dos campos. La última línea, return, es lo que sale del nodo.
08
Tu trabajo no es escribirlo
No necesitas programar. Necesitas saber pedir el código, probarlo y leer lo suficiente para no confiar a ciegas.
09
Qué darle a Claude
- Una muestra de la entrada: dos o tres ítems copiados de la vista JSON.
- La salida exacta que esperas para esa muestra.
- El modo del nodo: todos a la vez o por cada ítem.
- El contexto: «nodo Code de n8n 2, en JavaScript, sin librerías externas».
- Qué hacer con lo raro: campos vacíos, valores inválidos.
Con la muestra, Claude usa los nombres de campo reales y no los inventa.
10
Un pedido mal hecho y uno bien hecho
| Mal | Bien |
|---|---|
| «Hazme un código de n8n que valide RUT» | «Nodo Code de n8n 2, modo por cada ítem. Entra este ítem [muestra]. Quiero que agregue un campo rut_valido verdadero o falso y conserve los demás. Si rut viene vacío, falso.» |
El primero obliga a Claude a adivinar el nombre del campo, el modo y qué devolver. El segundo no deja nada a la suerte.
11
Antes de pegar la muestra
La muestra sale de tus datos reales, y ahí hay nombres, RUT, correos y teléfonos de personas.
12
El ciclo de prueba
Ejecuta solo ese nodo, no el flujo entero. Si aparece un error, cópialo completo junto con el ítem que lo causó. Con eso Claude corrige de una; con «no funciona», no.
13
Casos raros que debes probar
El código suele funcionar con la muestra. Lo rompe lo que no le mostraste.
- Un campo vacío o que no viene.
- Un número que llega como texto.
- Una lista vacía y una lista con un solo elemento.
- Tildes, eñes y mayúsculas.
- Cero ítems de entrada.
14
Leer el código sin saber programar
Antes de dejarlo corriendo, comprueba cuatro cosas:
- Qué lee: los campos que nombra existen en tu INPUT.
- Qué devuelve: la línea
returnentrega los campos que esperas. - Qué pierde: si los demás campos del ítem siguen o desaparecen.
- Qué no debe haber: claves, contraseñas o datos de clientes escritos en el código.
Pide a Claude que lo explique línea por línea. Si la explicación no calza con tu pedido, el código tampoco.
15
Ver qué pasa adentro
Cuando el resultado no es el esperado, pide a Claude que agregue líneas console.log en los puntos clave. Muestran el valor de una variable a mitad de camino.
16
Lo que n8n 2 no le deja hacer
| Restricción | Qué usar en su lugar |
|---|---|
| No lee archivos del disco | Nodo Read/Write Files from Disk |
| No hace llamadas a internet | Nodo HTTP Request |
| No lee variables de entorno | Credenciales de n8n |
$evaluateExpression() no funciona | Calcular antes en un Edit Fields |
Además, desde la versión 2.0 el código corre en un proceso aislado del resto de n8n. Menciónale estas reglas a Claude y te dará código que las respeta.
17
Las protecciones tienen motivo
Si un tutorial antiguo te pide apagar una protección para que su código funcione, primero entiende por qué existe.
18
Por qué no leer variables de entorno
En las variables de entorno viven la clave de cifrado y los datos de la base. Si el código pudiera leerlas, un fragmento copiado de internet podría sacarlas.
Se puede permitir con N8N_BLOCK_ENV_ACCESS_IN_NODE=false, pero la recomendación oficial es guardar cada clave como credencial.
19
JavaScript o Python
| JavaScript | Python | |
|---|---|---|
| Disponible | Siempre | Exige un ejecutor externo en instalación propia |
| Librerías en n8n Cloud | crypto y moment | Ninguna |
Atajos como $input | Todos | Solo _items y _item |
Elige JavaScript. Python tiene sentido solo si ya montaste la imagen n8nio/runners y necesitas una librería que no existe en JavaScript.
20
Librerías externas
Parte del código que circula usa librerías: paquetes que alguien más escribió.
- En n8n Cloud no se pueden agregar. Solo están
cryptoymoment. - En instalación propia se pueden habilitar con configuración. La página del nodo Code enlaza la guía.
21
Devolver algo que no es una lista de ítems
Es el error más común del nodo Code: el código calcula bien, pero entrega un número suelto o un objeto sin envolver.
22
Ayuda de IA dentro de n8n
n8n tiene sus propias ayudas para generar código: una función dentro del nodo Code y, en n8n Cloud, el nodo AI Transform.
| Claude en un chat | Ayuda integrada | |
|---|---|---|
| Ve tu muestra | Si se la pegas | Según la función |
| Explica y corrige contigo | Sí | Limitado |
| Disponible | Siempre | Depende del plan y la edición |
Qué incluye tu instalación se comprueba en la documentación, sección «Get coding help from AI».
23
Deja el nodo explicado
Un nodo llamado «Code» con cuarenta líneas es una caja negra para quien venga después, incluido tú.
- Renómbralo con lo que hace: «Validar RUT».
- Pide a Claude un comentario inicial de dos líneas: qué recibe y qué devuelve.
- Guarda aparte los casos de prueba.
Cuando haya que cambiarlo, le pasas a Claude el código actual, los casos y el cambio que quieres.
24
Lo que te llevas
- El nodo Code es para lo que no resuelven nodos ni expresiones.
- Recibe y devuelve una lista de ítems; tiene dos modos y hay que elegir uno.
- A Claude se le da muestra de entrada, salida esperada, modo y restricciones.
- Se prueba con casos raros, no solo con la muestra.
- En n8n 2 el código no lee archivos, internet ni variables de entorno.
25
Hazlo ahora
Quince minutos.
- En un flujo de prueba, crea con Edit Fields un ítem con
clientey una listaproductos, cada uno connombreyprecio. - Copia el ítem desde la vista JSON.
- Pídele a Claude un código para el nodo Code que agregue un campo
totalcon la suma de precios. - Pégalo, ejecuta y compara.
- Prueba con la lista vacía y con un precio escrito como texto.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026