VPS üzerinde kodlama ajanı çalıştırma rehberi

Neden bir VPS üzerinde kodlama ajanı çalıştırılmalı

Kodlama ajanı; kod tabanınızı okuyan, değişiklikleri yazan ve bunları test etmek için komutları doğrudan terminal üzerinden çalıştıran bir araçtır. Bir ajanı dizüstü bilgisayarınız yerine VPS üzerinde çalıştırmanın üç avantajı vardır: bağlantıyı kestiğinizde çalışmaya devam eder, kodunuzun ve derleme araçlarınızın hemen yanında konumlanır ve kendi barındırdığınız bir modelle iletişim kurabilir. Ajanı bir tmux oturumu içinde başlatırsanız, dizüstü bilgisayarınızı kapatıp çalışmaya daha sonra kaldığınız yerden devam edebilirsiniz; bu, tmux ile VPS üzerinde Claude Code çalıştırma ile aynı yöntemdir.

Terminal tabanlı iki ajanı bilmekte fayda vardır. Aider, terminale özgü ve git odaklı bir seçenektir: her değişikliği anlamlı bir mesajla otomatik olarak commit eder, böylece geçmişiniz temiz kalır ve her düzenleme geri alınabilir. Yayınlanma hızı yavaşlamış olsa da, terminal kodlama ajanları arasında en köklü olanlardan biridir. Block tarafından geliştirilen Goose ise daha kapsamlıdır: geniş bir eklenti ekosistemine sahip, yerel Ollama modelleri dahil birçok sağlayıcıyı destekleyen ve artık Linux Foundation bünyesindeki Agentic AI Foundation (AAIF) altında geliştirilen bir Apache-2.0 ajanıdır. Aider, disiplinli ve git merkezli bir iş akışına uygundur; Goose ise geniş eklenti setiyle daha genel amaçlı bir asistana ihtiyaç duyanlar için uygundur.

Gereksinimler

Aider için git, tmux ve güncel bir Python sürümüne veya Goose için Goose yükleyicisine sahip bir VPS gereklidir. Ayrıca bir modele ihtiyacınız vardır: Anthropic veya OpenAI gibi bir sağlayıcıdan alınan barındırılan bir API anahtarı ya da aynı VPS üzerinde Ollama tarafından sunulan yerel bir model. Kendi kendine barındırma yöntemi, kodunuzu kendi sunucunuzda tutmanızı sağlar ve token başına maliyet çıkarmaz; ancak bunun karşılığında yetenekli bir model için yeterli bellek kapasitesine sahip olmanız gerekir.

Aider kurulumu ve çalıştırılması

Ubuntu 24.04, sanal ortam dışındaki pip install işlemlerini (PEP 668) engellediği için Aider'i apt üzerinden gelen pipx ile yalıtılmış bir ortamda kurun. Ardından, bağlantı kesilse bile çalışmaya devam etmesi için Aider'i bir tmux oturumu içerisinde, projenizin dizininde çalıştırın:

sudo apt install pipx
pipx ensurepath
pipx install aider-chat
tmux new -s aider
cd ~/my-project
aider

Sürüm notu: Bu kurulum yöntemi Ubuntu 24.04 üzerinde gösterildiği gibi çalışır. Ubuntu 26.04 üzerinde, Aider'in sabitlenmiş bağımlılıkları Python 3.14 ile derlenemeyen eski bir numpy sürümü içerdiğinden kurulum başarısız olur. Çözüm, Aider'e kendi Python 3.12 sürümünü sağlamaktır:

pipx install --python 3.12 --fetch-missing-python aider-chat

pipx, yalnızca Aider için bağımsız bir yorumlayıcı indirir ve kurulum tamamlanır. Bu durum, Aider'in yavaşlayan sürüm döngüsünün bir belirtisidir; eğer bu durum sizin için sorun teşkil ediyorsa, daha aktif bir şekilde sürdürülen Goose tercih edilebilir.

Aider çalışmaya başladığında, Ctrl-b ve ardından d tuşlarına basarak oturumdan ayrılın; böylece dizüstü bilgisayarınızı kapatsanız bile aracı çalışmaya devam eder. Daha sonra ne değişiklik yaptığını görmek için tmux attach -t aider komutuyla oturuma tekrar bağlanın. İkinci bir tmux penceresi açarak başka bir aracı çalıştırmanıza hiçbir engel yoktur. Eğer her ikisi de Claude Code ise, iki oturum işi manuel olarak aktarmanıza gerek kalmadan kendi aralarında paslaşabilir. Aider deponuzu okur, düzenlemeler önerir, bunları uygular ve her birini commit eder; bir değişiklik birden fazla dosyayı kapsadığında bağlam sağlamak için ek dosyaları içeri aktarabilir. Her değişiklik bir commit olduğu için, aracı geri almak basit bir git revert işlemidir; bu da aracı kullanmayı güvenli kılan temel güvenlik önlemidir. Goose, belgelenmiş tek satırlık betiği ile kurulur ve terminal üzerinden benzer şekilde çalışarak görevleri eklentileri aracılığıyla yönetir:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

Barındırılan model veya self-hosted model

Barındırılan bir model size en iyi kaliteyi sunar ve yerel donanım gerektirmez, ancak token başına maliyet çıkarır ve kodunuz sağlayıcıya gönderilir. Token başına maliyetler çoğu kişinin beklediğinden daha hızlı artar, çünkü ajan her adımda tüm konuşmayı yeniden gönderir. Aider ve Goose aynı şekilde faturalandırma yaptığı için, Claude Code tarafından hazırlanan uzun bir ajan oturumunun gerçekte ne kadar token harcadığına dair analiz burada da geçerlidir. Ollama aracılığıyla kullanılan self-hosted bir model, her şeyi sunucunuzda tutar ve donanım maliyeti karşılandıktan sonra çalıştırması ücretsizdir; ancak faydalı olacak kadar iyi bir kodlama modeli ciddi miktarda bellek gerektirir. Tartmanız gereken denge budur: kalite ve kolaylık ile gizlilik ve maliyet.

Self-hosted yöntemini seçerseniz, pratik soru hangi modelin sunucunuza uygun olduğudur. Bu sırada context window değerini izleyin; çünkü Ollama varsayılan olarak küçük bir değer kullanır ve daha uzun olan her şeyi sessizce kırpar. Bir kodlama ajanı için bu, az önce okuduğu dosyaların istemden (prompt) düşmesi anlamına gelir: num_ctx değerini artırmak bu sorunu çözer ve ihtiyaç duyulan daha büyük KV önbelleği, bütçelemeniz gereken belleğin bir parçasıdır. Sekiz gigabaytlık bir modeli, onu barındıramayacak bir makineye indirmeden önce boyutlandırmasını yapın:

Güvenlik: dosya düzenleme ve komut çalıştırma

Bir kodlama ajanı pasif değildir. Dosyaları yeniden yazar ve derleme veya test komutlarını çalıştırabilir; bu nedenle, sisteminizi değiştirme yetkisi olan herhangi bir sürece gösterdiğiniz özeni bu ajana da gösterin. Üç alışkanlık risklerin büyük kısmını kapsar. Her değişikliğin izlenebilir ve geri alınabilir olması için bir git deposu içinde çalışın; Aider bunu sizin için otomatik olarak yapar. Ajanı, en az yetkili kullanıcılar ilkesini izleyerek, asla root olarak değil, sıradan ve yetkisiz bir kullanıcı olarak çalıştırın; böylece hatalı bir komut tüm sisteme zarar veremez. Sunucunun kendisini de koruma altına alın, çünkü kodlama için kullanılan bir VPS sonuçta herkese açık bir sunucudur: sadece anahtar tabanlı SSH, varsayılan olarak reddeden bir güvenlik duvarı ve diğer önlemleri uygulayın. OpenClaw sıkılaştırma rehberi, daha otonom bir ajan için aynı duruşu sergiler ve ilkeler burada da geçerlidir.

Bir kodlama ajanını kendi iş akışınıza entegre etmek için, Claude ile yapay zeka ajanı oluşturma rehberi bir modelin araçlarınızı nasıl yönettiğini gösterir; Google Gemini CLI'yı bir VPS üzerinde çalıştırma başka bir terminal seçeneğidir ve OpenHands'i kendi sunucunuzda barındırma daha kapsamlı ve otonom bir yoldur. Bu alandaki en popüler açık kaynak projesinin de kendi rehberi mevcuttur: OpenCode'u bir VPS üzerinde çalıştırma, kurulumu aynı tmux ve yetkisiz kullanıcı düzeniyle gerçekleştirir.

FAQ

Ücretli bir API yerine yerel bir modelle kodlama ajanı çalıştırabilir miyim?

Evet. Hem Aider hem de Goose, Ollama tarafından sunulan yerel modellerle çalışabilir; böylece kodlama ajanını tamamen kendi sunucunuzda, token başına ücret ödemeden ve kodlarınız sunucunuzdan dışarı çıkmadan çalıştırabilirsiniz. Buradaki kısıtlayıcı faktör bellektir: faydalı kod yazabilecek kapasitedeki bir model ciddi miktarda RAM veya VRAM gerektirir, bu nedenle işe başlamadan önce makinenizi modelin ihtiyaçlarına göre boyutlandırın.

Aider mı yoksa Goose mu kullanmalıyım?

İş akışınız terminal ve git odaklıysa ve en olgun, en düşük ek yük getiren seçeneği istiyorsanız Aider'ı seçin; Aider her değişikliği otomatik olarak commit eder, böylece geçmişiniz her zaman geri alınabilir durumda kalır. Geniş bir eklenti ekosistemine sahip ve birçok sağlayıcıyı destekleyen daha kapsamlı bir asistan istiyorsanız Goose'u seçin. Her ikisi de terminal üzerinden çalışır ve Ollama ile uyumludur, dolayısıyla her ikisi de bir VPS üzerinde kullanım için uygundur.

Kendi sunucumda barındırdığım bir kodlama modeli için ne kadar belleğe ihtiyacım var?

Bu, modelin boyutuna ve ne kadar kuantize edildiğine bağlıdır. Küçük bir kuantize model birkaç gigabayt ile çalışabilirken, daha güçlü bir model çok daha fazlasını gerektirir; ayrıca uzun bağlam pencereleri (context windows) bellek kullanımını artırır. Belirli bir model ve bağlam uzunluğu için gereken belleği tahmin etmek amacıyla indirme işleminden önce yukarıdaki boyutlandırma aracını kullanın.

Bir yapay zeka ajanının kodlarımı düzenlemesine ve komut çalıştırmasına izin vermek güvenli mi?

Doğru alışkanlıklarla bu durum yönetilebilir. Çalışmalarınızı bir git deposunda tutun, böylece her düzenleme geri alınabilir bir commit olur; ajanı root yerine yetkisiz bir kullanıcı olarak çalıştırın ve VPS'inizi halka açık herhangi bir sunucuyu koruduğunuz gibi sıkılaştırın. Ajanın commit ettiği değişiklikleri körü körüne güvenmek yerine inceleyin; özellikle sisteminiz üzerinde çalıştırmak istediği komutlara dikkat edin.