Kodlama ajanlarını kendi sunucunuzda 7/24 çalıştırmak

Dizüstünüzdeki bir kodlama ajanı kapak kapandığında durur. Onu açık kalan bir makineye taşımak işin kolay kısmı. İnsanların atladığı kısımlar; denetim (süreci ne canlı tutar ve yeniden başlatmadan sonra onu ne geri getirir), paralel oturumlar arasındaki yalıtım ve ajanı donanımdan çok önce durduracak kullanım sınırları. Bu rehber Claude Code, Codex ve diğer terminal ajanları için her birini ele alıyor.

Bulut mu kendi makineniz mi

Önce bir makineye ihtiyacınız olup olmadığına karar verin. Sağlayıcılar artık ajanları sizin için çalıştırıyor:

Projeniz GitHub'daysa ve bir kurulum betiğinden derleniyorsa, sağlayıcı bulutu en az iş gerektirendir. Başlangıç noktası Anthropic'in bulut oturumları belgeleri; claude --cloud "…" terminalinizden bir tane başlatır. Ajan yalnızca sizin makinenizde olan şeylere ihtiyaç duyduğunda ya da birkaç sağlayıcının ajanlarını yan yana istediğinizde kendi makinenizi seçin. VPS satın alma rehberi boyutlandırmayı ve güncel fiyatları ele alıyor. Uykuyu kapattığınız sürece evdeki bir Mac mini de iş görür.

Süreç denetimi

Etkileşimli ajanlar terminal programlarıdır. Başka bir şey terminali tutmadıkça onunla birlikte ölürler. En basitinden en sağlamına dört seçeneğiniz var.

1. tmux

tmux new -A -s main
cd ~/src/api && claude        # detach: Ctrl-b d · re-attach: tmux attach -t main

tmux bağlantı kopmalarından sağ çıkar, yeniden başlatmalardan değil. Etkileşimli iş için doğru araçtır ve Anthropic'in belgelerinin uzak bir makinede bir Remote Control oturumunu canlı tutmak için önerdiği de budur. tmux, mosh ve Tailscale rehberimizde ajanların ihtiyaç duyduğu yapılandırma var.

2. systemd + tmux, yeniden başlatmadan sonra geri gelsin diye

Etkileşimli bir TUI'yi doğrudan bir hizmet olarak çalıştıramazsınız, çünkü bir terminale ihtiyaç duyar. Ancak systemd'nin açılışta ayrılmış bir tmux oturumu başlatmasını sağlayabilirsiniz. Normal kullanıcınızla ~/.config/systemd/user/agents.service dosyasını oluşturun:

[Unit]
Description=tmux session for coding agents

[Service]
Type=forking
ExecStart=/usr/bin/tmux new-session -d -s main
ExecStop=/usr/bin/tmux kill-session -t main

[Install]
WantedBy=default.target

systemctl --user daemon-reload
systemctl --user enable --now agents.service
sudo loginctl enable-linger "$USER"     # start user services at boot, without a login

Bu, konuşmalarınızı değil, boş bir oturumu geri getirir. Onları sürdürmek ayrı bir adımdır (aşağıdaki Yeniden başlatmada ne olur bölümüne bakın).

3. Zamanlanmış headless çalıştırmalar

Gecelik bağımlılık güncellemeleri, yeni sorunları önceliklendirme veya belgeleri yeniden oluşturma gibi tekrarlayan işler için TUI'yi atlayın. claude -p "…" veya codex exec "…" komutlarını cron'dan ya da bir systemd zamanlayıcısından çalıştırın. Orada hiçbir şeyi onaylayacak kimse yoktur; bu yüzden izin modunu ve izin listesini bilinçli olarak ayarlayın. Nasıl yapılacağını ajanları tam izinlerle güvenle çalıştırma anlatıyor.

4. Bir oturum daemon'ı

En sağlam seçenek, ajan oturumlarının sahibi olan bir süreçtir: onları başlatır, transkriptlerini tutar ve her yerden bağlanmanıza izin verir. Claude Code'un Remote Control sunucu modu (claude remote-control) bunlardan biridir. Varsayılan olarak --capacity ile yapılandırılabilen 32 eşzamanlı oturuma kadar hizmet verir, ancak onu yine tmux veya bir hizmet içinde çalıştırırsınız. agy remote-control start, Antigravity'nin daemon'ını bir işletim sistemi hizmeti olarak kaydeder. Aralarında Maude'un da bulunduğu üçüncü taraf araçlar, birkaç ajanı yöneten kendi daemon'larını kurar.

Paralel oturumlar ve worktree'ler

Aynı çalışma kopyasını düzenleyen iki ajan birbirinin değişikliklerinin üzerine yazar. Her oturuma kendi git worktree'sini, yani deponun geçmişini paylaşan ayrı bir çalışma dizini ve dalı verin:

git worktree add ../api-auth -b feature/auth
git worktree add ../api-billing -b fix/billing
# one tmux window per worktree, one agent per window

Claude Code bunu sizin için yapabilir: claude --worktree feature-auth (veya -w) yeni bir dalda .claude/worktrees/ altında bir worktree oluşturur ve oturumu onun içinde başlatır. Worktree belgelerine bakın.

Bir makinenin kaç oturumu kaldırdığı ajanların kendisine değil, ne çalıştırdıklarına bağlıdır. Kullanışlı bir pratik kural, ilk oturum için 4 GB artı derleme veya test yapan her ek oturum için 1–2 GB'tır; her worktree kendi geliştirme sunucusunu veya veritabanını çalıştırıyorsa daha fazla. Bir tane daha eklemeden önce yoğun bir saatte free -h çıktısını izleyin. Disk de birikir, çünkü her worktree kendi node_modules klasörünü alır.

Kotalar ve hız sınırları

7/24 açık bir makine ancak planınız ajanın çalışmaya devam etmesine izin veriyorsa işe yarar; bu yüzden etrafında plan yapmadan önce sınırları okuyun:

• Claude (Pro, Max). Anthropic'in kullanım sınırları makalesine göre kullanım sınırları beş saatte bir sıfırlanır ve ayrıca haftalık bir sınır vardır. Birkaç paralel oturum aynı kotadan çeker. Durumunuzu Settings → Usage altında kontrol edebilirsiniz.
• Codex (ChatGPT planları). Plus ve benzeri katmanlar kayan beş saatlik pencereler kullanır ve haftalık sınırlar da geçerli olabilir. Yerel CLI kullanımı ve bulut görevleri tek bir kotayı paylaşır. Planınız için OpenAI'ın Codex fiyat sayfasına bakın.
• API anahtarları. Plan penceresi yok, ancak token başına ödersiniz; bu yüzden kontrolden çıkan bir döngü durmak yerine para harcar. Sağlayıcı konsolunda harcama sınırları belirleyin.

Pratikte "7/24", ajanın gün boyu tam gaz çalıştığı değil, iş ve kota olduğu her an çalışabildiği anlamına gelir. Uzun görevleri siz uzaktayken sıraya koyun ve bir sonraki sıfırlamaya kadar durmasını bekleyin.

Yeniden başlatmada ne olur

Çekirdek güncellemeleri, sağlayıcı bakımları ve bellek yetersizliği nedeniyle sonlandırmaların hepsi bir şeyleri yeniden başlatır. Ajan konuşmaları diske kaydedilir, yani hiçbir şey kaybolmaz, ama hiçbir şey kendiliğinden yeniden başlamaz:

• Claude Code: claude --continue geçerli dizindeki en son konuşmayı sürdürür, claude --resume ise bir tane seçmenizi sağlar.
• Codex: codex resume --last ya da bir seçici için codex resume.
• tmux: sunucu gitmiştir ve onunla birlikte pencere düzeniniz de. Yukarıdaki systemd birimi oturumu yeniden oluşturur. tmux-resurrect gibi eklentiler düzenleri de geri yükleyebilir.

Makine kapandığında yarım kalmış bir düzenleme veya çalışan bir test gibi devam eden her şeyin elle kontrol edilmesi gerekir. Bu, ajanın sık commit etmesi için bir neden daha.

Telefonunuzdan izlemek

Sürekli açık bir ajan size tuhaf anlarda ihtiyaç duyacak: bir izin isteği, bir soru, incelenecek bitmiş bir görev. Seçenekleriniz: ücretsiz ama bildirimsiz, tmux'a bağlı bir SSH uygulaması; ajan başına çalışan sağlayıcı Remote Control uygulamaları; istekleri telefonunuzdan onaylama yazısında anlatılan bildirimler için ntfy hook'ları; ya da hepsini yapan bir uygulama.

Maude bu kurulum için yapıldı. Oturumlarınızı sunucuda 7/24 çalıştıran bir daemon'ı SSH üzerinden kurar, uygulama kapalıyken onları sürdürür ve eklediğiniz kadar sunucuda Claude Code, Codex, OpenCode, Grok Build ve Antigravity'yi yönetir. İzin ver/Reddet içeren anlık bildirimler, bekleyenlerin bulunduğu bir gelen kutusu ve oturum başına git worktree'leri, bir diff incelemesi ve bir terminal elde edersiniz. Bir ajanın kotası bittiğinde, oturumu şimdiye kadarki işin özetiyle birlikte başka bir ajana devredebilirsiniz. Her ajanın kendi planına veya API anahtarına yine ihtiyacınız var. Uygulama, 3 günlük denemeden sonra haftalık $2.99 veya 7 günlük denemeden sonra yıllık $59.99'dur.

Sıkça sorulan sorular