n8n Code Node Nedir, Nasıl Kullanılır?
n8n Code node'unun ne işe yaradığı, çalışma modları, girdi ve çıktıya erişim, yapay zekâdan kod yardımı ve sık görülen hataların çözümü.
Miraç Kuru · Yayın 12 Ekim 2026

Bu yazıda· 7 bölüm
Kısa cevap
n8n Code node'u, bir workflow'un içinde JavaScript ya da Python kodu çalıştıran node'dur. Belgelere göre bu node, veriyi dönüştürmek ve hazır node'ların karşılamadığı mantığı eklemek için kullanılır. Kod, Run Once for All Items modunda bir kez, Run Once for Each Item modunda gelen her kayıt (item) için ayrı çalışır. Yapay zekâyla kod üretmek için n8n Cloud'da Ask AI sekmesi kullanılır.
- 1
Node'u ekle
Canvas'taki bir node'un "Add node" (+) düğmesine tıkla ve açılan node panelinde (nodes panel) Code node'unu seç. Code node'unun ayar penceresi açılır.
- 2
Dili seç
Language alanında kodun dilini seç, örneğin JavaScript.
- 3
Modu seç
Kod bir kez çalışacaksa Run Once for All Items, her item için çalışacaksa Run Once for Each Item seç.
- 4
Kodu yaz
Kodu, her biri json anahtarı taşıyan nesnelerden oluşan bir dizi döndürecek biçimde yaz.
- 5
Dene
"Execute step" düğmesine tıkla ve sonucu ayar penceresindeki OUTPUT bölümünde kontrol et.
n8n Code node'u, bir workflow'un içinde JavaScript ya da Python kodu çalıştıran node'dur. Belgelere göre bu node, veriyi dönüştürmek ve hazır node'ların karşılamadığı mantığı eklemek için kullanılır. Workflow, n8n'de bir işi otomatik yapan adımların bütünüdür. Node ise workflow'un adımlarından biridir. n8n editörü, workflow'ların kurulup düzenlendiği ekrandır. Editörün ortasındaki canvas, node'ların eklenip birbirine bağlandığı çalışma alanıdır. Workflow'un ilk node'u olan trigger node, workflow'u belirli bir olayda ya da zamanda başlatır.
Kod, bilgisayara bir işi adım adım yaptıran yazılı komutlardır. JavaScript, web tarayıcılarında ve sunucularda çalışan yaygın bir programlama dilidir. Python ise veri işlemede sık kullanılan bir programlama dilidir.
n8n Code node'u ne işe yarar?
Belgelere göre n8n az kodlu (low-code) bir araçtır. Birçok iş kod yazmadan kurulur, kod ise gerektiğinde eklenir. n8n'de kod iki yerde kullanılır: Code node'unda ve expression'larda. Expression, bir node alanının değerini önceki node'ların verisinden JavaScript ile dolduran yazımdır. Code node'u ise workflow'a kodla çalışan ayrı bir adım ekler.
Item, n8n'de node'lar arasında taşınan verinin tek bir kaydıdır. Bir önceki node bir kişi listesi gönderdiyse listedeki her kişi ayrı bir item'dır. Code node'u bu item'ları okur, değiştirir ya da onlardan yeni item'lar üretir.
Örnek: Bir içerik ekibi, bir tablodan gelen video başlıklarını tek bir metinde birleştirmek ister. Ekip, Code node'una kısa bir JavaScript kodu yazar. Node, bütün başlıkları virgülle ayrılmış tek bir satır olarak sonraki node'a verir.
Temel n8n kavramları n8n nedir yazısında anlatılır.
Code node'u ne zaman hazır node yerine seçilir?
Belgelere göre bazı işler için hazır bir node ya da expression yeterlidir:
| İhtiyaç | Ne kullanılır |
|---|---|
| Veriyi bir koşula göre farklı node'lara yönlendirmek | If ya da Switch |
| Bir web adresine istek göndermek | HTTP Request |
| Diskteki bir dosyayı okumak ya da yazmak | Read/Write File From Disk |
| Aynı item'ı birden çok kez işlememek | Remove Duplicates |
| Bir alanın değerini önceki veriden doldurmak | Expression |
| Hazır node'ların yapmadığı dönüştürme ya da hesaplama | Code |
Belgelere göre Code node'u dosya sistemine erişemez ve HTTP isteği gönderemez. Credential, n8n'in bir hizmete bağlanmak için gereken giriş bilgisini sakladığı kayıttır. Code node'u credential'lara da erişemez. Kimlik doğrulama isteyen istekler için belgeler HTTP Request node'unu önerir. HTTP Request node'unun kullanımı n8n'de HTTP Request nasıl kullanılır yazısında anlatılır.
Belgelere göre node'un Settings sekmesindeki Notes ayarına bir not yazılabilir. Display note in flow ayarı açıksa n8n bu notu workflow'da node'un alt başlığı olarak gösterir. Node'un adı, canvas'ta node'un üzerine gelince görünen Node context menu'deki Rename node seçeneğiyle değiştirilir.
Örnek: Bir kişi, form yanıtlarındaki e-posta adreslerini kendi kuralına göre ayıklamak ve düzenlemek ister. Bu kural için hazır bir node bulamaz ve işi tek bir Code node'unda toplar. Node'un adını "Yanıtları düzenle" yapar ve Notes ayarına kodun ne yaptığını yazar. Workflow'u sonradan açan biri, bu adımın işini canvas'ta okur.
Code node'unda çalışma modları nelerdir?
Belgelere göre Code node'unun iki çalışma modu vardır:
| Mod | Ne yapar |
|---|---|
| Run Once for All Items | Varsayılan moddur. Kod, kaç item gelirse gelsin bir kez çalışır |
| Run Once for Each Item | Kod, gelen her item için ayrı ayrı çalışır |
Run Once for All Items modunda kod bütün item'ları aynı anda görür. Bu yüzden item'ları birleştiren ya da sayan işler bu modla yapılabilir. Her item'a aynı işlemi uygulayan işlerde Run Once for Each Item modu seçilebilir.
Örnek: Bir kişi, gelen bütün kullanıcı adlarını tek bir satırda birleştirmek ister ve Run Once for All Items modunu seçer. Başka bir kişi her item'a aynı yeni alanı eklemek ister ve Run Once for Each Item modunu seçer.
Code node'unda girdiye ve çıktıya nasıl erişilir?
Değişken, kodda bir değeri bir ad altında saklayan yapıdır. Belgelere göre n8n, veriye erişmek için hazır yöntemler ve değişkenler sunar. JavaScript'te bunlar $variableName ya da $methodName() biçiminde yazılır. Code node'unda $ yazıldığında n8n önerilen yöntem ve değişkenlerin listesini gösterir.
Dizi (array), sıralı bir değer listesidir. Nesne (object), anahtar ve değer çiftlerinden oluşan veri parçasıdır. Belgelere göre node'lar arasında taşınan bütün veri, nesnelerden oluşan bir dizidir. Her item'ın verisi json adlı anahtarın altında durur. Code node'unun döndürdüğü veri de bu yapıda olur:
[
{
"json": {
// your data goes here
}
}
]
Belgelerdeki örnek kodlar gelen bütün item'ları $input.all() ile alır. Bir item'daki alana item.json.username gibi noktalı yazımla ulaşılır. Aşağıdaki kod belgelerdeki örneklerden biridir. Kod, her item'daki username alanını tırnak içine alır ve hepsini virgülle birleştirir:
const items = $input.all();
const usernames = items.map((item) => `"${item.json.username}"`);
const result = usernames.join(", ");
return [{ json: { usernames: result } }];
İlk satırdaki items bir değişkendir ve gelen bütün item'ları tutar. Son satırdaki return komutu sonucu json yapısıyla sonraki node'a verir. Sonuç tek bir item olarak döner.
Native Python, belgelerin Code node'undaki güncel Python desteğine verdiği addır. Belgelere göre bu destek n8n 1.111.0 sürümünden beri vardır ve n8n 2 sürümünde kararlıdır. Native Python, Run Once for All Items modunda sadece _items, Run Once for Each Item modunda sadece _item değişkenini destekler.
Örnek: Bir kişinin önceki node'u, her biri bir çalışanı anlatan item'lar gönderir. Kişi Code node'unda her item'dan ad ve unvan alanlarını alır. Kod, sadece bu iki alanı taşıyan yeni item'lar döndürür.
Code node'unda yapay zekâdan kod yardımı nasıl alınır?
n8n Cloud, n8n şirketinin işlettiği sunucularda çalışan ve tarayıcıdan kullanılan sürümdür. Belgelere göre Code node'undaki yapay zekâ yardımı n8n Cloud kullanıcılarına açıktır. Kendi sunucusunda çalışan n8n'de bu özellik bulunmaz. Prompt, yapay zekâya ne istendiğini anlatan metindir. Kod şu adımlarla üretilir:
- Code node'unu aç ve Language alanında JavaScript'i seç.
- Ask AI sekmesine tıkla.
- Ask AI sekmesinde ne istediğini anlatan prompt'u yaz.
- "Generate Code" düğmesine tıkla. n8n prompt'u ChatGPT'ye gönderir ve üretilen kodu Code sekmesinde gösterir.
Belgelere göre yapay zekâ sadece verinin şemasını görür ve verinin kendisini bilmez. Şema, verideki alanların adlarını ve yapısını gösteren tariftir. Bu nedenle prompt'ta istenen alanın nerede durduğu ve boş değerlerin nasıl kontrol edileceği yazılır. Belgelere göre prompt gönderilmeden önce Code node'undan önceki node'ların çalışıp Code node'una veri vermesi gerekir.
Belgeler iyi bir prompt için şunları önerir:
- İstenen çıktıdan bir örnek ver.
- Verinin hangi işlemlerden hangi sırayla geçeceğini yaz.
- Belirsiz ifade yerine net bir ölçüt kullan, örneğin "yaşlı kullanıcılar" yerine "60 yaş ve üstündeki kullanıcılar" yaz.
- Birden çok node'un verisi kullanılacaksa bu node'ları adıyla belirt.
- Çıktının n8n'in veri yapısına uygun olmasını iste.
Örnek: Bir kişi, bir tablodan gelen ürün kayıtlarını tek bir özet metnine çevirmek ister. Ask AI sekmesine özette hangi alanların hangi sırayla yer alacağını yazar. "Generate Code" ile gelen kodu çalıştırır ve özet metnini OUTPUT bölümünde görür.
n8n Code node'unda sık görülen sorunlar nasıl çözülür?
Execution, bir workflow'un bir kez çalışmasının kaydıdır. Modül, koda eklenerek kullanılan hazır kod paketidir. Ortam değişkeni, bir programın ayarını kodunu değiştirmeden belirleyen değerdir. Belgelere göre sık görülen sorunlar ve çözümleri şunlardır:
- "Code doesn't return items properly" ya da "Code doesn't return an object" hatası, kodun beklenen yapıda veri döndürmediğini gösterir. Kodun, her biri
jsonanahtarı taşıyan nesnelerden oluşan bir dizi döndürdüğünü kontrol et. - Kod tanımsız (
undefined) bir değer döndürüyorsa, kullandığı verinin her execution'da var olduğunu ve beklenen yapıda olduğunu kontrol et. - "A 'json' property isn't an object" hatası,
jsonanahtarına nesne yerine örneğin bir dizi verildiğini gösterir.jsonanahtarının altına her zaman bir nesne koy. - "'import' and 'export' may only appear at the top level" hatası, kodda
importya daexportkullanıldığını gösterir.importsatırlarınırequirekullanacak biçimde değiştir. - "Cannot find module" hatası,
requireile istenen modülün bulunamadığını gösterir. Kendi sunucusunda çalışan n8n'de modülü n8n'in çalıştığı ortama kur. ArdındanNODE_FUNCTION_ALLOW_BUILTINveNODE_FUNCTION_ALLOW_EXTERNALortam değişkenlerini ayarla. $getCredentials is not definedya dathis.getCredentials is not a functionhatası, kodun credential'a erişmeye çalıştığını gösterir. Belgelere göre Code node'u credential'lara tasarım gereği erişemez. Kimlik doğrulama isteyen istekleri HTTP Request node'uyla yap.- Native Python,
item.json.myNewFieldgibi noktalı yazımı kabul etmez. Alanlaraitem["json"]["my_new_field"]gibi köşeli parantezle ulaş.
Örnek: Bir kişinin Code node'undaki kod, json anahtarının altına bir dizi koyar ve "A 'json' property isn't an object" hatası verir. Kişi diziyi bir nesnenin içine yerleştirir ve node'u yeniden çalıştırır. Node bu kez çıktıyı gösterir.
Sonraki adım
İçinde veri getiren bir node bulunan bir workflow aç ve bu node'un sağındaki "Add node" (+) düğmesine tıkla. Node panelinde "Code" diye ara ve Code node'unu seç. Language alanında JavaScript'i, çalışma modu olarak Run Once for All Items'ı seç. Kod alanına yukarıdaki dört satırlık örneği yapıştır ve username yerine kendi verindeki bir alanın adını yaz. "Execute step" düğmesine tıkla ve OUTPUT bölümünde tek bir item göründüğünü kontrol et.
Kurduğun bu Code node'u, workflow'larındaki veri dönüştürme işini tek yerde toplayan kalıcı bir sistemin ilk adımıdır.
Sık sorulanlar
n8n Code node'unda hangi diller kullanılır?
Belgelere göre Code node'unda JavaScript ya da Python kodu yazılır. Güncel Python desteğinin adı Native Python'dır. Bu destek n8n 1.111.0 sürümünden beri vardır ve n8n 2 sürümünde kararlıdır.
Run Once for All Items ile Run Once for Each Item arasında ne fark var?
Run Once for All Items varsayılan moddur ve kod, kaç item gelirse gelsin bir kez çalışır. Run Once for Each Item modunda kod, gelen her item için ayrı ayrı çalışır.
Code node'unda yapay zekâdan kod yardımı nasıl alınır?
Belgelere göre Code node'undaki yapay zekâ yardımı n8n Cloud kullanıcılarına açıktır. Language alanında JavaScript seçilir, Ask AI sekmesine prompt yazılır ve "Generate Code" düğmesine tıklanır. Üretilen kod, Code sekmesindeki kodun yerini alır.
Code node'u credential'lara erişebilir mi?
Belgelere göre Code node'u credential'lara tasarım gereği erişemez. Kimlik doğrulama isteyen istekler HTTP Request node'uyla yapılır.
n8n Cloud'da Code node'una modül eklenebilir mi?
Belgelere göre n8n Cloud'da JavaScript kodu için crypto ve moment modülleri hazır gelir. Bunların dışında bir modül için kendi sunucusunda çalışan n8n'e kurulum gerekir. n8n Cloud'da Python kodunda modül içe aktarılamaz.
Kaynaklar
- 1.n8n Docs, Code nodeErişim: 12 Ekim 2026
- 2.n8n Docs, Code node common issuesErişim: 12 Ekim 2026
- 3.n8n Docs, Code in n8nErişim: 12 Ekim 2026
- 4.n8n Docs, Get coding help from AIErişim: 12 Ekim 2026
- 5.n8n Docs, Work with nodesErişim: 12 Ekim 2026
İlgili yazılar

n8n Nedir, Ne İşe Yarar?
n8n'in ne olduğu, nasıl çalıştığı, nasıl kullanıldığı, ücretlendirmesi, örnek workflow'lar ve n8n ile Make arasındaki farklar.
4 dk okuma

n8n'de HTTP Request Nasıl Kullanılır?
n8n HTTP Request node'uyla API'ye istek gönderme: kurulum adımları, curl içe aktarma, credential seçimi, Pagination ve sık görülen hata kodları.
7 dk okuma

n8n ile Google Sheets Nasıl Kullanılır?
n8n'de Google Sheets node'uyla satır ekleme, veri okuma ve güncelleme; Google Sheets Trigger, credential kurulumu ve sık görülen hatalar.
8 dk okuma

n8n Webhook Nedir, Nasıl Kullanılır?
n8n Webhook node'unun ne olduğu, test ve canlı adres farkı, kurulum adımları, cevap seçenekleri, kimlik doğrulama ve sık görülen sınırlar.
4 dk okuma

n8n'de Yapay Zekâ Ajanı Nasıl Kurulur?
n8n'de AI Agent node'uyla yapay zekâ ajanı kurma: ajan ile chain farkı, kurulum adımları, araçlar, hafıza ve aracı çalıştırmadan önce insan onayı.
4 dk okuma

