Claude Code'u bir VPS'te çalıştırmak

Claude Code'u dizüstünüz yerine bir sunucuda çalıştırmak size üç şey kazandırır. Dizüstünüz kapalıyken çalışmaya devam eder. Kopan bir bağlantıdan sağ çıkar. Ve ajanı SSH anahtarlarınızın ve tarayıcı profilinizin bulunduğu makineye değil, gözden çıkarabileceğiniz bir makineye koyar. Bu rehber, yeni bir Debian veya Ubuntu makinesinde yaklaşık on beş dakika süren bir kurulumu anlatıyor. Aynı adımlar küçük değişikliklerle Alpine ve Fedora'da da çalışır.

Claude Code'u içeren bir Claude planına ihtiyacınız var: Pro, Max, Team veya Enterprise ya da bir Console hesabı. Ücretsiz claude.ai planı onu içermez. Aboneliğinizle oturum açın; yönetilecek bir API anahtarı ve üstüne faturalandırılan bir kullanım olmaz.

1. Bir makine seçin

Anthropic'in sistem gereksinimleri 4 GB veya daha fazla RAM ve bir x64 veya ARM64 işlemci listeliyor. Desteklenen Linux sistemleri Ubuntu 20.04+, Debian 10+ ve Alpine 3.19+. Pratikte projenizin araç zinciri CLI'dan daha belirleyicidir:

• 4 GB: belgelenmiş minimum, mütevazı bir projede tek bir oturum için yeterli.
• 8 GB: önemli bir şey derliyorsanız (bir bundler, bir test paketi, bir iki container) ya da aynı anda birkaç oturum çalıştırıyorsanız.
• 16 GB: birkaç ajanı paralel ya da yanlarında bir veritabanı çalıştırıyorsanız.

Hetzner, DigitalOcean, Scaleway, OVH, Vultr ve diğerlerinin hepsi çalışır; masanızın altındaki eski bir makine de öyle. Üzerinde bir terminale yazacaksanız size yakın bir bölge seçin. ARM örnekleri genellikle gigabayt başına en ucuzudur ve Claude Code onlarda yerel olarak çalışır. Kodlama ajanları için en iyi VPS rehberimiz sağlayıcıları ve boyutları karşılaştırıyor.

2. Root olmayan bir kullanıcı oluşturun

Birçok VPS imajı sizi root olarak giriş yaptırır. Ajanı root olarak çalıştırmayın. Her hatayı sistem genelinde bir hataya dönüştürür. Claude Code ayrıca root olarak bypass-permissions modunda başlamayı reddeder; yani er ya da geç normal bir kullanıcıya zaten ihtiyacınız olacak. Debian veya Ubuntu'da:

adduser dev
usermod -aG sudo dev
rsync --archive --chown=dev:dev ~/.ssh /home/dev

Fedora'da yönetici grubu sudo yerine wheel'dir. Alpine'de önce sudo veya doas kurun. Son satır, zaten giriş yaptığınız anahtarı kopyalar; böylece herhangi bir şeyi kilitlemeden önce dev olarak yeniden bağlanabilirsiniz. İlk terminali kapatmadan önce bunu ikinci bir terminalden test edin. Yeni bir VPS'in dışında kalmak, atlamaya değer bir ilk deneyimdir.

3. SSH anahtarları ve sağlamlaştırma

Hâlâ parolayla giriş yapıyorsanız önce bir anahtara geçin. Bilgisayarınızda ssh-keygen -t ed25519 ile bir tane oluşturun, ardından ssh-copy-id dev@your-server ile yükleyin. Anahtarla giriş çalıştığında /etc/ssh/sshd_config dosyasını düzenleyin:

PermitRootLogin no
PasswordAuthentication no
PubkeyAuthentication yes

Ardından SSH'yi yeniden başlatın: Debian ve Ubuntu'da sudo systemctl restart ssh. Fedora'da hizmetin adı sshd'dir, bu yüzden sudo systemctl restart sshd çalıştırın. Daha fazlası için fail2ban ve yalnızca SSH'ye izin veren bir güvenlik duvarı ekleyin. Makinenin genel internette olması hiç gerekmiyorsa onu bir Tailscale ağına koyun. Telefonunuz aynı ağa katılır ve ona doğrudan ulaşır.

Telefondan: SSH uygulamaları cihazda bir anahtar oluşturup ~/.ssh/authorized_keys dosyasına yapıştırmanız için açık yarısını gösterebilir. Maude bunu sizin için yapar: "Anahtarla girişi kur" düğmesi, zaten oturum açtığınız bağlantı üzerinden bir anahtar oluşturur. Açık yarısını kurar, yeni anahtarı test eder ve özel yarısını yalnızca telefonun anahtarlığında tutar.

4. Claude Code'u kurun

Anthropic artık Node.js gerektirmeyen yerel yükleyiciyi öneriyor. Onu sudo ile değil, normal kullanıcınızla çalıştırın:

curl -fsSL https://claude.ai/install.sh | bash
claude --version
claude doctor

Başlatıcıyı ~/.local/bin/claude konumuna koyar ve kendini arka planda günceller. claude doctor, bir oturum başlatmadan kurulumu ve ayarlarınızı kontrol eder. Hepsi kurulum belgelerinden bazı alternatifler:

• Sistemin paket yöneticisinin sahiplenmesini tercih ediyorsanız imzalı apt, dnf ve apk depoları. Bunlar otomatik güncellenmez; sistemin geri kalanıyla birlikte yükseltirsiniz.
• npm hâlâ çalışıyor (npm install -g @anthropic-ai/claude-code, Node.js 22 veya üstü). Aynı yerel ikili dosyayı kurar. Anthropic sudo npm install -g kullanmamayı öneriyor.
• Alpine, bash, curl, libgcc, libstdc++ ve ripgrep ile ayarlarınızda USE_BUILTIN_RIPGREP=0 gerektirir.

Eski bir rehber size önce Node kurmanızı söylediyse artık o adımı atlayabilirsiniz.

5. Tarayıcı olmadan oturum açın

claude (veya claude auth login) çalıştırın ve istemleri takip edin. Bir VPS'in tarayıcısı yoktur; bu yüzden giriş URL'sini başka herhangi bir cihazda açarsınız. Claude Code onu kopyalamak için c tuşuna basmanıza izin verir. Orada oturum açın. Tarayıcı Claude Code'un yerel geri çağrısına ulaşamadığında, ki SSH üzerinden bu normaldir, bunun yerine bir kod gösterir. Onu Paste code here if prompted satırına yapıştırın; oturum açma işlemi sunucuda tamamlanır.

Kimlik bilgisi ~/.claude/.credentials.json içine 0600 izniyle kaydedilir. Makineye buna göre davranın: o kullanıcı olarak kabuğu olan herkes Claude aboneliğinizi kullanabilir. Betikler ve CI için ayrıca CLAUDE_CODE_OAUTH_TOKEN olarak ayarladığınız bir yıllık token yazdıran claude setup-token var. Kimlik doğrulama belgelerine göre bu token yalnızca model istekleri yapabilir ve Remote Control oturumları başlatamaz.

6. Canlı tutun

Bir SSH oturumunun ön planında başlattığınız her şey o bağlantıyla birlikte ölür. Olağan çözüm tmux'tur:

sudo apt install tmux
tmux new -s work
# start claude, then detach with Ctrl-B then D
tmux attach -t work

Ayrılabilir, sinyali kaybedebilir, saatler sonra yeniden bağlanıp geri dönebilirsiniz; oturum dokunulmadan kalır. Ancak tmux yeniden başlatmadan sağ çıkmaz. Bir yeniden başlatmadan sonra claude --continue o dizindeki en son konuşmayı sürdürür. Dizüstünüzü kapattıktan sonra Claude Code'u çalışır tutma rehberimiz systemd ve oturum daemon'ları dahil diğer seçenekleri anlatıyor.

7. Aynı makine, daha fazla ajan

Claude Code çalıştıran bir sunucu, yanında diğer kodlama ajanlarını da çalıştırabilir. Her biri ana dizininize kurulur ve kendi girişini tutar; bu yüzden birbirlerinin yoluna çıkmazlar. Aynı anda çalışan her biri için RAM'de yer bırakın.

Kaynaklar: Codex kimlik doğrulaması, OpenCode belgeleri, Grok Build belgeleri, Antigravity CLI kurulumu, Ekim 2026'da kontrol edildi. Codex ve Antigravity'nin kendi adım adım rehberleri var: VPS'te Codex CLI ve sunucuda Antigravity CLI. Gemini CLI artık kişisel Google hesapları için bir seçenek değil; Google'ın yerine sunduğu araç Antigravity CLI.

8. Ona telefonunuzdan ulaşın

Bunu yapmanın, en uygulamalıdan en az uygulamalıya üç yolu var:

Bir SSH uygulaması ve tmux. tmux oturumunuza bağlı Termius, Blink veya başka bir istemci. Ücretsiz ve eksiksizdir; tam ekran bir terminali dokunmatik bir klavyeyle yönetirsiniz. Karşılaştırması burada.

Remote Control. tmux içinde claude remote-control başlatın ve oturumu Claude uygulamasının Code sekmesinden açın. Pro, Max, Team ve Enterprise'a dahildir. Anthropic'in belgeleri tam bu durum için tmux veya screen öneriyor. Yalnızca Claude için çalışır ve oturumun çıkardığı izin istekleri yanıtlamanız için telefona gelir. Uygulama oturumu Auto veya Bypass permissions moduna geçiremez.

Maude. Maude 4. ve 6. adımları sizin yerinize yapar, 5. adım ise telefonunuza taşınır. Sunucuyu adresiyle, bir ssh … komutu yapıştırarak ya da curl -fsSL https://maude.pilotdev.fr/setup | sh komutunun QR kodunu tarayarak eklersiniz. root olarak giriş yaptıysanız bir düğme 2. adımdaki root olmayan kullanıcıyı sizin için oluşturur. Maude ardından kendi daemon'ını SSH üzerinden kurar ve her ajanı test ettiğimiz ve sabitlediğimiz bir sürümde yükler. Claude, Codex veya diğerlerinde telefondan oturum açarsınız. Uygulama kapalıyken oturumlar sunucuda çalışmaya devam eder ve sunucu Maude'un relay'ine kendisi bağlanır; bu yüzden açık bir port olmadan NAT arkasında çalışır.

9. İzinlere karar verin

Şimdi ilginç soru: gözetimsizken ne kadarına izin veriyorsunuz? Yeniden kurabileceğiniz bir sunucu, onu gerçekten atılabilir olarak ele aldığınız sürece izinleri gevşetmek için doğru yerdir. Bir sınıflandırıcının güvenli eylemleri onayladığı Claude Code'un auto modu boşluğun büyük kısmını kapatır. Tam bypass'ın, 2. adımdaki root kısıtlaması dahil, kendi kuralları var. Onların kendi sayfası var: Claude Code'u tam izinlerle güvenle çalıştırma.

Telefonunuzdan çalıştırın

Sunucu hazır olduğunda, telefonunuzda Claude Code sayfası Maude'un onu nasıl yönettiğini anlatıyor. Claude tek ajanınız değilse ajanlara genel bakış sayfasından başlayın.

Sıkça sorulan sorular

Neler değişti

• 1 Ekim 2026 — Kurulum Anthropic'in yerel yükleyicisine geçirildi (Node.js artık gerekmiyor); RAM önerileri belgelenmiş 4 GB minimumla uyumlu hale getirildi; tarayıcısız girişte kod yapıştırma akışı ve setup-token eklendi; Codex, OpenCode, Grok Build ve Antigravity'yi aynı makinede çalıştırma hakkında yeni bölüm.
• 25 Temmuz 2026 — İlk yayın.