VPS üzerinde kodlama ajanı nasıl çalıştırılır?

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

Kodlama ajanı; terminal üzerinden kod tabanınızı okuyan, değişiklikler yazan ve bunları test etmek için komutlar çalıştıran bir araçtır. Bir ajanı VPS üzerinde çalıştırmanın dizüstü bilgisayarınıza göre üç avantajı vardır: bağlantınız kesildikten sonra çalışmaya devam eder, kodunuzun ve derleme araçlarınızın hemen yanında bulunur ve kendi barındırdığınız bir modele bağlanabilir. Bir tmux oturumu içinde başlatırsanız, dizüstü bilgisayarınızı kapatabilir ve işe daha sonra devam edebilirsiniz; bu, tmux ile VPS üzerinde Claude Code çalıştırmak ile aynı yöntemdir.

Bilinen iki terminal tabanlı ajan bulunmaktadır. Aider, terminale özgü ve git odaklı bir seçenektir: her değişikliği mantıklı 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 en eski terminal kodlama ajanlarından biridir. Block tarafından geliştirilen Goose ise daha kapsamlıdır: geniş bir eklenti ekosistemine ve yerel Ollama modelleri dahil birçok sağlayıcıya desteği olan Apache-2.0 lisanslı bir ajandır ve şu anda Linux Foundation'ın Agentic AI Foundation (AAIF) bünyesinde geliştirilmektedir. Aider disiplinli ve git merkezli bir iş akışına uygundur; Goose ise geniş bir eklenti setine sahip daha genel bir asistan için uygundur.

Gereksinimler

Aider için git, tmux ve güncel bir Python sürümüne; Goose için ise 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ı veya aynı VPS üzerinde Ollama tarafından sunulan yerel bir model. Kendi kendine barındırma yöntemi, kodunuzu kendi sunucunuzda tutar ve token başına maliyet çıkarmaz; ancak yetenekli bir model için yeterli belleğe ihtiyaç duyulması maliyeti vardır.

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

Aider'ı pipx ile izole bir ortamda kurun; Ubuntu 24.04, sanal ortam dışındaki yalın pip install kullanımını engellediği için (PEP 668) pipx apt üzerinden gelir. Ardından Aider'ı projenizin içinde, bağlantı kesintilerinden etkilenmemesi için bir tmux oturumu içinde çalıştırın:

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

Bir sürüm notu: Bu kurulum Ubuntu 24.04 üzerinde gösterildiği gibi çalışır. Ubuntu 26.04 üzerinde şu an için başarısız olmaktadır; çünkü Aider'ın sabitlenmiş bağımlılıkları, 26.04'ün Python 3.14 sürümüyle derlenemeyen eski bir numpy sürümünü içermektedir. Çözüm, Aider'a kendi Python 3.12 sürümünü vermektir:

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

pipx, sadece Aider için bağımsız bir yorumlayıcı indirir ve kurulum tamamlanır. Bu durum, Aider'ın yavaşlayan yayınlanma hızının bir sonucudur; eğer bu sorun teşkil ediyorsa, Goose daha aktif olarak güncellenen seçenektir.

Çalışmaya başladığında, Ctrl-b ardından d tuşlarına basarak oturumdan ayrılın; ajan dizüstü bilgisayarınız kapalıyken çalışmaya devam eder; değişiklikleri okumak için daha sonra tmux attach -t aider ile tekrar bağlanın. Aider deponuzu okur, düzenlemeler önerir, bunları uygular ve her birini commit eder; bir değişiklik birkaç dosyayı kapsıyorsa bağlam için ekstra dosyalar çekebilir. Her değişiklik bir commit olduğu için, ajanın işlemlerini geri almak basit bir git revert işlemidir; bu, kullanımı konforlu hale getiren güvenlik ağıdır. Goose, belgelenmiş tek satırlık betiğiyle kurulur ve terminalden benzer şekilde çalışır, görevleri eklentileri aracılığıyla yürütür:

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

Barındırılan model veya kendi kendine barındırılan model

Barındırılan bir model en iyi kaliteyi sunar ve yerel donanım gerektirmez, ancak token başına maliyeti vardır ve kodunuz sağlayıcıya gönderilir. Token başına maliyetler, ajan her adımda tüm konuşmayı tekrar gönderdiği için çoğu kişinin beklediğinden daha hızlı artar. Aider ve Goose aynı şekilde faturalandırdığı için uzun bir ajan oturumunun token harcaması analizi burada da geçerlidir. Ollama aracılığıyla kendi kendine barındırılan bir model, her şeyi sunucunuzda tutar ve donanım maliyeti ödendikten sonra çalıştırmak ücretsizdir; ancak kullanışlı olacak kadar iyi bir kodlama modeli gerçek bellek gerektirir. Değerlendirilmesi gereken takas şudur: kalite ve kolaylık ile gizlilik ve maliyet.

Kendi kendine barındırma yoluna gidecekseniz, pratik soru hangi modelin sunucunuza uygun olduğudur. Kapasitesi yetmeyen bir makineye sekiz gigabaytlık bir model indirmeden önce boyutunu belirleyin:

Güvenlik: Dosyaları düzenler ve komutlar çalıştırır

Bir kodlama ajanı pasif değildir. Dosyaları yeniden yazar ve derleme ile test komutları çalıştırabilir; bu nedenle sisteminizi değiştirebilecek herhangi bir sürece göstereceğiniz özeni ona da gösterin. Üç alışkanlık risklerin çoğunu kapsar. Bir git deposu içinde çalışın; böylece her değişiklik takip edilir ve geri alınabilir (Aider bunu sizin için otomatik olarak yapar). Ajanı, en düşük yetkili kullanıcılar prensibine uyarak asla root olarak değil, sıradan yetkisiz bir kullanıcı olarak çalıştırın; böylece hatalı bir komut tüm sisteme zarar veremez. Ve sunucunun kendisini güçlendirin, çünkü bir kodlama VPS'i hala halka açık bir sunucudur: sadece anahtar ile SSH, varsayılan olarak reddeden bir güvenlik duvarı ve benzerleri. OpenClaw güçlendirme kılavuzu daha otonom bir ajan için aynı tutumu sergiler ve prensipler geçerlidir.

Bir kodlama ajanını kendi iş akışınıza entegre etmek için, Claude ile bir yapay zeka ajanı oluşturmak bir modelin araçlarınızı nasıl yönlendirdiğini gösterir; Google'ın Gemini CLI'ını bir VPS üzerinde çalıştırmak başka bir terminal seçeneğidir ve OpenHands'ı kendi kendine barındırmak daha ağır otonom yoldur. Bu alandaki en çok yıldız alan açık kaynaklı proje artık kendi kılavuzuna sahip: VPS üzerinde OpenCode çalıştırmak kurulumu aynı tmux ve yetkisiz kullanıcı modeliyle yapar.

FAQ

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

Evet. Hem Aider hem de Goose, Ollama tarafından sunulan yerel modellerle çalışır; böylece token başına maliyet olmadan ve kodunuz sunucunuzdan ayrılmadan tamamen kendi kendine barındırılan bir kodlama ajanı çalıştırabilirsiniz. Zorluk bellek kısmındadır: kullanışlı kod yazabilecek kapasitedeki bir model ciddi miktarda RAM veya VRAM gerektirir, bu nedenle kurulum yapmadan önce makinenizi modele göre boyutlandırın.

Aider mı yoksa Goose mı, hangisini kullanmalıyım?

İş akışınız terminal ve git odaklıysa ve en olgun, en düşük maliyetli seçeneği istiyorsanız Aider'ı seçin; her değişikliği otomatik olarak commit eder, böylece geçmişiniz geri alınabilir kalır. Geniş bir eklenti ekosistemine ve birçok sağlayıcıya desteği olan daha kapsamlı bir asistan istiyorsanız Goose'u seçin. Her ikisi de terminalden çalışır ve her ikisi de Ollama ile çalışır, bu nedenle her ikisi de bir VPS için uygundur.

Kendi kendine barındırılan 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 üzerinde çalışabilirken, daha güçlü bir model çok daha fazlasına ihtiyaç duyar ve uzun bağlam pencereleri bunu artırır. Belirli bir modelin ve bağlam uzunluğunun ihtiyaç duyduğu belleği tahmin etmek için yukarıdaki boyutlandırma aracını kullanın.

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

Doğru alışkanlıklarla bu yönetilebilir. Her düzenleme geri alınabilir bir commit olsun diye çalışmalarınızı bir git deposunda tutun, ajanı root yerine yetkisiz bir kullanıcı olarak çalıştırın ve VPS'i herhangi bir halka açık sunucu gibi güçlendirin. Değişiklikleri körü körüne güvenmek yerine, özellikle sisteminiz üzerinde çalıştırılmasını istediği komutları inceleyin.