Linux uzerinde Claude masaustu uygulamasi ve CLI kurulumu
Linux sistemlerde Claude masaustu uygulamasi, Claude Code CLI ve editor eklentilerinin kurulumunu ogrenin. Hangi ozelliklerin eksik oldugunu ve abonelik planlarini inceleyin.
Claude'un hangi bölümleri bugün Linux üzerinde yerel olarak çalışıyor
Claude, Linux üzerinde dört ayrı yüzeyde çalışır ve Ekim 2026 itibarıyla bu dört yüzey de standart bir Ubuntu veya Debian makinesinde çalışmaktadır. Masaüstü uygulaması, Anthropic'in apt deposundan yüklenir ve beta aşamasındadır. Claude Code CLI (komut satırı arayüzü) derlenmiş bir ikili dosyadır ve masaüstü uygulamasından daha fazla dağıtımda çalışır. claude.ai adresindeki web uygulaması yalnızca bir tarayıcıya ihtiyaç duyar ve API, kendi kodunuzdan çağırdığınız bir HTTPS uç noktasıdır.
macOS ve Windows'ta bulunan üç özellik, Linux masaüstü betasında eksiktir veya sınırlıdır: Claude'un ekranınızdaki uygulamaları kontrol ettiği Computer Use, sesli dikte ve Quick Entry genel kısayol tuşu. Anthropic, Computer Use ve dikte özelliklerinin Linux'ta kullanılamadığını belirtmektedir. Quick Entry kısayol tuşu bir X11 oturumunda çalışır, ancak yerel bir Wayland oturumunda masaüstü ortamınızın GlobalShortcuts portalına ihtiyaç duyar; bu portal olmadan kısayol tuşu kullanılamaz. echo $XDG_SESSION_TYPE, x11 veya wayland çıktısını verir ve hangi durumda olduğunuzu size bildirir. CLI'nın kendi sesli dikte özelliği vardır, bu nedenle dikte eksikliği Claude'un kendisinden ziyade masaüstü uygulamasındadır.
Kullanılabilirlik durumu değişebilir, bu nedenle bu sayfayı yüzeylerin bir açıklaması olarak okuyun ve planlama yapmadan önce mevcut durumu kontrol edin. Son bölüm, kontrol etmeniz gereken sayfaları listeler.
Ubuntu veya Debian üzerinde Claude masaüstü uygulamasını kurma
Belgelenen gereksinimler, x86_64 (dpkg'nın amd64 olarak adlandırdığı) veya arm64 mimarilerinde Ubuntu 22.04 veya üzeri ya da Debian 12 veya üzeridir. Diğer Debian tabanlı dağıtımlar çalışabilir ancak test edilmemiştir. Fedora ve RHEL için henüz bir paket bulunmamaktadır; bu sistemlerde CLI veya tarayıcı kullanmanız gerekir.
Kurulumu indirilen bir .deb dosyasından değil, apt deposundan yapın. Linux uygulamasının kendi güncelleme mekanizması yoktur; bu nedenle yeni sürümlere yalnızca paket yöneticiniz aracılığıyla ulaşabilirsiniz ve deponun kaydedilmesi apt upgrade'un bu sürümleri görmesini sağlar.
sudo apt install curl gnupg
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc \
https://downloads.claude.ai/claude-desktop/key.asc
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.ascgpg --show-keys, 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE parmak izini yazdırmalıdır. Depoyu kaydetmeden önce bunu karşılaştırın; kontrol etmediğiniz bir imzalama anahtarına körü körüne güvenmiş olursunuz. Eğer gpg dosyanın geçerli bir OpenPGP verisi içermediğini bildirirse, indirme işlemi başarısız olmuştur ve apt update daha sonra NO_PUBKEY BAA929FF1A7ECACE hatasıyla sonuçlanır.
Depoyu kaydetmek, /etc/apt/sources.list.d/claude-desktop.list dosyasına yazılan tek bir deb satırından ibarettir. Bu satırı Anthropic'in Linux kurulum sayfasından, code.claude.com/docs/en/desktop-linux, orada yazıldığı şekliyle kopyalayın. Depo adresi, bu prosedürde değişme olasılığı en yüksek olan kısımdır ve hafızadan yazılan bir satır, sonrasında E: Unable to locate package claude-desktop hatasıyla karşılaşmanıza neden olur. Yapıştırmadan önce satırı okuyun: arch=amd64,arm64, apt'nin başka bir mimaride hiçbir şey bulamamasının nedenidir; signed-by= ise az önce kontrol ettiğiniz anahtarlık dosyasına işaret eder ve bu anahtarı, apt'nin okuduğu diğer her şeye güvenmek yerine yalnızca bu depo ile sınırlar.
sudo apt update && sudo apt install claude-desktopUygulamayı başlatıcıdan çalıştırın veya terminalde claude-desktop komutunu girin. claude.ai hesabınızla veya şirketinizin yapılandırdığı durumlarda kurumunuzun SSO (tek oturum açma) sistemi üzerinden giriş yapın. Anthropic'in Linux kurulum sayfasında listelenen iki giriş yöntemi bunlardır; API anahtarı kullanıcıları CLI'ya yönlendirilir. Anthropic, aynı uygulamanın ikinci bir dağıtım modunu ayrı olarak belgeler: bir çıkarım sağlayıcısı (Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, bir LLM ağ geçidi veya doğrudan Anthropic API) ile yapılandırıldığında, giriş ekranı Anthropic kimlik doğrulamasını atlamayı teklif eder ve sağlayıcı, Chat, Cowork ve Code için çıkarım ve faturalandırma işlemlerini yönetir. Bu belgeler, yönetilen yapılandırma için /etc/claude-desktop/managed-settings.json şeklinde bir Linux konumu belirtir ve Linux kurulum sayfası artık üçüncü taraf dağıtım belgelerine bağlantı vermektedir. Claude Desktop yapılandırması olmayan cihazlarda, Claude Desktop 3.1623.1 ve sonraki sürümler, standart giriş ekranında "Use your Claude API account" seçeneğini sunar; buradan Claude Console ile giriş yapabilir veya önceden yapılandırma yapmadan bir API anahtarı girebilirsiniz. Claude Desktop 4.23118.0 ve sonraki sürümlerde bu bağlantı, cihaz yönetimi olmasa dahi bir kurumun diğer hesapları engellediği bilgisayar oturumlarında gizlenir.
Kendi makinenizde çalışan Cowork görevleri bir sanal makine kullanır; bu nedenle donanım sanallaştırmanın açık olması ve kullanıcınızın kvm grubunda bulunması gerekir (sudo usermod -aG kvm $USER, ardından oturumu kapatıp tekrar açın). Her Cowork görevi yerel olarak çalışmaz. 6 Ekim 2026 tarihinden itibaren, Pro, Max ve Ultra planlarındaki yeni Cowork görevleri Anthropic'in bulutunda çalışır ve bunları bilgisayarınızda tutacak bir ayar bulunmamaktadır. Birleşik Chat ve Cowork deneyimi açık olan Team ve Enterprise kurumları da görevleri bulutta çalıştırır. Bu planlarda sanal makine yalnızca bilgisayarınızda halihazırda başlatılmış görevler için önemlidir ve Anthropic, yerelde kalması gereken yeni işleri masaüstü uygulamasındaki Claude Code'a yönlendirir.
E: Unable to locate package claude-desktop, apt'nin depoyu hiç okumadığı anlamına gelir. cat /etc/apt/sources.list.d/claude-desktop.list, yazdığınız deb satırını göstermeli ve dpkg --print-architecture, amd64 veya arm64 çıktısını vermelidir; çünkü diğer mimariler için yayınlanmış bir paket bulunmamaktadır. Güncellemeler daha sonra sisteminizin geri kalanıyla birlikte sudo apt update && sudo apt upgrade üzerinden gelir.
Yalnızca tarayıcıda var olanlar
claude.ai, herhangi bir dağıtım üzerindeki güncel tarayıcılarda çalışır; bu da onu Fedora, RHEL, Arch, openSUSE ve paket bulunmayan diğer tüm sistemlerde geçerli çözüm haline getirir. Tarayıcı ayrıca web üzerinde Claude Code erişimi sağlar; burada oturum sizin makinenizde değil, bulut altyapısında çalışır: Varsayılan olarak Anthropic'in altyapısında veya oturumları oraya yönlendiren kurumunuzun kendi self-hosted ortamında. Her zaman abonelik kimlik bilgilerinizi kullanır.
Tarayıcının sınırını anlamak faydalıdır. Bir tarayıcı tek başına kendi sunucunuzdaki dosyaları okuyamaz veya üzerinde bir komut çalıştıramaz. Makinenize dokunan her şey, o makinede yazılım gerektirir; bu da CLI, masaüstü uygulaması veya yapılandırılmış bir self-hosted runner anlamına gelir. Cowork bulut oturumları, masaüstü uygulaması açık olduğu sürece bağlı yerel klasörlere erişebilir.
CLI'ın web uygulamasına kıyasla sunduğu avantajlar
claude komutunu bir dizin içerisinde başlattığınızda, araç doğrudan o dizin üzerinde çalışır. Temel fark budur ve diğer tüm özellikler bu çalışma prensibinden kaynaklanır.
- Çalışma dizininizdeki dosyaları okur ve düzenler; Manuel modda değişiklikleri uygulamadan önce onay ister. Otomatik mod, değişiklikleri arka plan güvenlik kontrolleriyle uygular ve ayarlar veya politikalar değiştirilmediği sürece mevcut etkileşimli oturumlar için varsayılan olarak gelir. İşlemleri kendiniz gözden geçirmek için
claude --permission-mode defaultile başlayın. - Kabuk komutlarını oturumun izin modunda çalıştırır; böylece bir projeyi derleyebilir, test paketini çalıştırabilir, bir log dosyasını okuyabilir veya sunucu üzerindeki bir servisi inceleyebilir.
- Etkileşimli bir oturum olmadan çalışabilir:
claude -p "read the nginx error log and summarise it"tek bir yanıt yazdırır ve çıkar; bu, cron işleri veya pipeline süreçleri için kullanılan yöntemdir. Claude Code 2.1.302 ve sonraki sürümlerde, herhangi bir izin modu ayarlanmadığında bu çalıştırmalar Manuel modda başlar ve onay mekanizması sağlamadığınız sürece onay gerektiren işlemler reddedilir; sınıflandırıcının bunları gözden geçirmesini sağlamak için--permission-mode autobayrağını kullanın. Yanıtın nasıl görüneceğini belirlemek sizin elinizdedir, çünkü bir çıktı stili her yanıtın arkasındaki sistem istemini düzenler ve etkileşimli oturumlar açıklayıcı olurken, betik tabanlı bir çalıştırmayı kısa tutabilir. - MCP (model context protocol) sunucularını
claude mcp addile bağlar; bu, modele dosya sisteminin ötesinde araçlar sağlar. - Grafiksel bir masaüstü ortamının hiç olmadığı yerlerde çalışır; bu, kiralayacağınız her VPS (sanal özel sunucu) için geçerlidir.
Son madde, bir sunucu rehberinin neden CLI ile ilgilendiğini açıklar. Kiralanan bir sunucuda SSH (secure shell) dışında hiçbir şey yoktur, bu nedenle terminal sizinle birlikte orada olabilecek tek arayüzdür. Bu şekilde çalıştırmanın kendine has kuralları vardır; Claude Code'u bir VPS üzerinde tmux içinde çalıştırmak bu konuyu tüm detaylarıyla ele alır, Claude'u günlük sistem yöneticiliği işlerinde kullanmak ise ona devredilmeye değer görevleri kapsar.
Editör entegrasyonları bu ikisi arasında yer alır. VS Code eklentisi, VS Code 1.94.0 veya üzerini gerektirir ve editör içinde farkları (diff) ve plan incelemesini görebileceğiniz grafiksel bir panel sunar. Bu panel için CLI'ın özel bir kopyasını paketler ve claude dosyasını PATH dizininize eklemez; bu nedenle entegre terminalde claude yazmak hala bağımsız kurulumu gerektirir. VS Code tabanlı editörler aynı eklentiyi Open VSX kayıt defterinden kurar; ayrıca bir JetBrains eklentisi de mevcuttur.
Linux üzerinde Claude Code çalıştırmak için Node.js gerekli mi?
Önerilen kurulum yönteminde gerekli değildir. Yerel yükleyici, derlenmiş bir ikili dosya indirir ve bu dosya Node.js üzerinde çalışmaz.
curl -fsSL https://claude.ai/install.sh | bash
claude --versionclaude --version komutu 2.1.211 (Claude Code) gibi bir sürüm numarası yazdırmalıdır. Bir sorun görünüyorsa, bir oturum başlatmadan kurulum ve ayar dosyalarınız hakkında salt okunur tanılama bilgileri yazdıran claude doctor komutunu çalıştırın.
Node.js yalnızca npm yolu kullanıldığında önemlidir. Ekim 2026 itibarıyla npm paketi Node.js 22 veya üzerini ister; daha eski bir Node.js sürümünde npm, hata vermek yerine EBADENGINE uyarısı yazdırır. Bunun nedeni, paketin platforma özgü bir bağımlılık olarak aynı yerel ikili dosyayı çekip yerine bağlamasıdır.
npm install -g @anthropic-ai/claude-codenpm 12 sürümünde, postinstall adımı varsayılan olarak atlanır ve claude çalışamaz hale gelir. Eğer npm --version komutu 12 ile başlıyorsa, yukarıdaki yerel yükleyiciyi kullanın veya yeniden yüklemeden önce kullanıcı npm yapılandırmanıza Claude Code'u allow-scripts içine ekleyin.
Bunu sudo ile çalıştırmayın. Belgeler sudo npm install -g kullanımına karşı uyarır, çünkü bu işlem global npm önekinizde root sahipli dosyalar bırakır; bu da bir sonraki ayrıcalıksız kurulumun veya güncellemenin izin hataları nedeniyle başarısız olmasına neden olur. npm global dizini yazılabilir olmadığında, arka plan otomatik güncelleme çalışmayı durdurur ve claude doctor düzeltmeleri listeler.
Anthropic ayrıca Debian, Fedora, RHEL ve Alpine için imzalı paket depoları yayınlar; bu sayede sudo apt install claude-code, https://downloads.claude.ai/keys/claude-code.asc adresindeki kendi imza anahtarıyla masaüstü paketiyle benzer şekilde çalışır.
Kurulumu kullanıcı bazlı mı yoksa sistem genelinde mi yapmalısınız?
Yerel yükleyici, kullanıcı bazlı bir kurulum gerçekleştirir. Başlatıcıyı ~/.local/bin/claude konumuna, ~/.local/share/claude/versions/ dizini içinde bir sembolik bağlantı (symlink) olarak yerleştirir; root yetkisi gerektirmez ve arka planda kendini günceller. Makinedeki her kullanıcı, ayrı bir sürümde kendi kopyasına sahip olur.
Paket yöneticisi ile yapılan kurulum ise sistem genelindedir. Tek bir binary dosyası tüm kullanıcılara hizmet eder, root yetkisi gerektirir ve Claude Code üzerinden otomatik güncelleme yapmaz. Güncelleme işlemi, makinedeki diğer tüm paketler için kullandığınız sudo apt update && sudo apt upgrade claude-code komutu ile gerçekleştirilir.
Kendi kullanıcı adınızla giriş yaptığınız ve çoğu VPS çalışmasını kapsayan makinelerde kullanıcı bazlı kurulumu tercih edin. Herkes için tek bir sürümün bulunmasını istediğiniz ve güncellemeleri kendi takviminize göre yönetmeyi tercih ettiğiniz paylaşımlı sunucularda veya makine imajlarında paket kurulumunu seçin. Yerel kurulumda, ~/.claude/settings.json içindeki iki ayar güncellemelerin nasıl davranacağını belirler:
{
"autoUpdatesChannel": "stable",
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}stable kanalı, yaklaşık bir haftalık sürümleri takip eder ve ciddi hatalar içeren sürümleri atlar. DISABLE_AUTOUPDATER ayarı yalnızca arka plan denetimini durdurur; bu sayede claude update komutu çalışmaya devam eder ve yeni bir sürümün ne zaman yükleneceği üzerinde kontrol sizde kalır. Bu durum, uzun süreli bir işlemin gözetimsiz çalıştığı ve binary dosyasının işlem sırasında değişmesini istemediğiniz sunucularda önem taşır.
SSH üzerinden giriş yapın ve oturumu açık tutun
Kiralık bir sunucuda CLI aracını ilk kez çalıştırdığınızda Linux'a özgü iki sorunla karşılaşırsınız. Giriş akışı bir tarayıcı gerektirir ancak sunucuda tarayıcı bulunmaz. Kopan bir SSH bağlantısı, o an yürüttüğünüz işi de beraberinde sonlandırır.
tmux ikinci sorunu çözer. Bir tmux oturumu bağlantınıza değil, uzak makinedeki tmux sunucusuna aittir; bu nedenle bağlantı kopsa bile süreç çalışmaya devam eder.
tmux new -s claude
claudeCtrl-b ve ardından d tuşlarına basarak oturumdan ayrılabilir, tmux attach -t claude ile daha sonra geri dönebilirsiniz.
Giriş işlemi ilk sorundur. claude komutunu çalıştırın ve terminalin yapıştırma isteminin üzerinde gösterilen özel yetkilendirme URL'sini kopyalayın. Bu URL'yi kendi bilgisayarınızdaki tarayıcıda açın. URL üzerinden giriş yaptıktan sonra tarayıcı, localhost adresine yönlendirmek yerine bir giriş kodu gösterir. Bu kodu terminaldeki Paste code here if prompted istemine yapıştırın; terminal Login successful mesajını verecektir.
Başında kimse olmadan başlaması gereken bir oturum için claude setup-token komutu aynı tarayıcı yetkilendirmesini açar ve terminale bir yıllık bir OAuth token'ı yazdırır. Bu token hiçbir yere kaydedilmez, bu yüzden kopyalayıp ihtiyaç duyduğunuz yere yerleştirin.
export CLAUDE_CODE_OAUTH_TOKEN=your-tokenBu token ücretli bir plan gerektirir ve yalnızca model istekleri yapabilir. Bunu bir yıllık ömrü olan bir parola gibi değerlendirin. Token'ın nerede saklanacağı ve bir ajanın onu okumasının nasıl engelleneceği, yapay zeka ajanlarından sırları koruma konusunun içeriğidir.
Küçük sunucular bir engelle daha karşılaşır. Kurulum yaklaşık 512 MB boş bellek gerektirir ve çalışması için belgelenen donanım gereksinimi 4 GB veya daha fazla RAM'dir. Bu nedenle, az boş belleği olan 1 GB'lık bir örnekte çekirdeğin bellek yetersizliği sonlandırıcısı (OOM killer) kurulumu durdurabilir ve yükleyici şu hatayı verir:
Setting up Claude Code...
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.Swap alanı ekleyin ve yükleyiciyi tekrar çalıştırın. Swap, çekirdeğin taşma belleği olarak kullandığı disk alanıdır. RAM'den çok daha yavaştır ancak kurulumu tamamlamak için yeterlidir.
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfileswapon dosyayı yalnızca bu önyükleme için etkinleştirir. Yeniden başlatma sonrasında da geçerli olmasını istiyorsanız /swapfile için /etc/fstab dosyasına bir satır ekleyin. Bir ajanın canlı bir sunucuda komut çalıştırmasına izin vermeden önce nelerin kısıtlanması gerektiği, Claude Code'u bir VPS üzerinde güvenli bir şekilde çalıştırma konusunun içeriğidir.
Linux üzerinde Claude kimlik bilgilerinin konumu
Linux üzerinde /login, kimlik bilgilerini 0600 dosya moduyla ~/.claude/.credentials.json dizinine yazar. macOS, aynı kimlik bilgisini normal şartlarda şifreli Keychain içinde tutar; ancak Keychain yazma işlemini reddettiğinde aynı düz metin dosyasına geri döner. Linux üzerinde bu belirteç, ev dizininizde düz bir dosya olarak tutulur ve sizin kullanıcınızla çalışan her süreç bu dosyayı okuyabilir. CLAUDE_CONFIG_DIR değişkenini ayarlamak, dosyanın bu dizin altına taşınmasını sağlar.
Bu durumdan iki sonuç çıkar. /home dosyasının yedeği aktif bir oturum içerir; dolayısıyla bu yedeği paylaşımlı bir makineye kopyalamak, dosyayı okuyabilen herkese hesabınızın erişimini vermek anlamına gelir. Ayrıca, giriş yaptığınız bir makineden oluşturulan bir makine imajı, o imajdan kopyalanan her örneğe (instance) bu oturumu taşır. Herhangi bir snapshot almadan önce /logout komutunu çalıştırın.
Kimlik bilgisi önceliği, aynı anda hem aboneliği hem de API anahtarı olan kullanıcılar için sorun yaratabilir. Shell ortamınızda ANTHROPIC_API_KEY ayarlandığında, Claude Code onayınızdan sonra bu anahtarı kullanır; bu durumda aboneliğiniz kullanılmazken anahtarınız token başına ücretlendirilir. /status komutu hangi kimlik bilgisinin aktif olduğunu gösterir, unset ANTHROPIC_API_KEY ise sizi abonelik girişi yöntemine geri döndürür.
Oturumların süresi dolar. Süre dolmadan önceki üç gün içinde başlangıç satırında Your login expires in 3 days uyarısı görünür ve bu uyarı hiçbir isteği engellemez. Süre dolduktan sonra, eğer oturum yenilenemezse, her model isteği Login expired · Please run /login hatasıyla başarısız olur. Hafta sonu boyunca başında kimsenin bulunmadığı bir oturum bırakmadan önce bunu göz önünde bulundurun; çünkü böyle bir oturum işlem yapmayı durdurur ve kendi kendine kurtulamaz.
Tek bir Claude aboneliği tüm platformları kapsar mı?
Bir ücretli plan, bazı Enterprise planlarındaki istisnalar haricinde, aynı giriş bilgileriyle tüm arayüzleri kapsar. Pro, Max, Ultra veya Team hesabı; tarayıcı üzerinden claude.ai, masaüstü uygulaması, CLI ve VS Code eklentisi için tek bir abonelik sağlar. HIPAA uyumlu olmayan kuruluşlardaki yeni veya self-servis Enterprise planları da aynı şekilde çalışır; bu planlardaki tek bir Enterprise koltuğu Claude Code erişimini içerir. Daha eski Enterprise planlarında ise koltuk türleri ayrıdır: bu planlarda Claude Code arayüzleri için Chat + Claude Code koltuğu veya eski koltuk tabanlı planlarda Premium koltuk gerekir; Chat-only veya Standard koltuklar bu erişimi sağlamaz. HIPAA uyumlu Enterprise kuruluşları da Chat ve Chat + Claude Code koltuk türlerini ayrı tutar. HIPAA uyumlu bir Enterprise planında Claude Code, Chat + Claude Code koltuğu gerektirir; terminal ve Claude Desktop'ın Code sekmesi için BAA kapsamı, HIPAA yapılandırması veya ilgili veri saklamama (zero data retention) kapsamını zorunlu kılar. VS Code, JetBrains eklentileri ve bulut oturumları HIPAA yapılandırması kapsamında değildir. Pro, Max, Ultra, Team ve koltuk tabanlı Enterprise planlarında tüm platformlar için ortak bir kullanım kotası bulunur; bu nedenle sunucunuzda uzun süreli bir CLI işlemi, masaüstü uygulamasının kalan kotasını tüketir. Herhangi bir arayüz işlem yapmayı reddettiğinde, hangi limit penceresine ulaştığınızı ve ne yapmanız gerektiğini belirlemeniz gerekir. Kullanım tabanlı (usage-based) bir Enterprise planında tükenecek bir kota yoktur: her arayüz, ilk tokendan itibaren API oranları üzerinden faturalandırılır. Ücretsiz claude.ai planı Claude Code erişimini içermez. Ücretli bir plan olmadan CLI, bir Claude Console hesabı ile giriş yapabilir veya kuruluşunuz Amazon Bedrock, Google Cloud Agent Platform ya da Microsoft Foundry kullanıyorsa, tarayıcı girişi olmaksızın bu sağlayıcı üzerinden kimlik doğrulaması yapabilir. Bir claude.ai aboneliği veya SSO girişi ile masaüstü uygulamasının Claude Code bölümleri ücretli plan gerektirir. Yukarıda açıklanan ayrı yapılandırılmış üçüncü taraf modu ve sunulduğu durumlarda yönetilmeyen cihazlardaki Claude API hesabı seçeneği, masaüstü uygulamasının Console veya sağlayıcı faturalandırmasını kullanmasına olanak tanır.
API, farklı faturalandırmaya sahip ayrı bir üründür. Bir Console hesabı, terminalde yazı yazmanızdan ziyade oluşturduğunuz bir servis için uygun olacak şekilde, gönderdiğiniz token başına faturalandırılır. ANTHROPIC_API_KEY ayarını yapmak, CLI'ı bu faturalandırma yoluna geçirir; bu bir yedekleme değil, sizin yaptığınız bir tercihtir. Standart modda masaüstü uygulaması OAuth ile giriş yapar, üçüncü taraf modunda ise kendi yapılandırmasındaki kimlik bilgilerini kullanır.
Fiyatlar ve plan limitleri sık değiştiği için burada belirtilmemiştir. Güncel rakamları takip etmek için iki sayfa mevcuttur: Claude Code'un güncel maliyeti ve ihtiyacınız olan Claude planı. Token başına faturalandırma ile aylık planı karşılaştırıyorsanız, abonelik ile API karşılaştırması başlığı başa baş noktasının nerede olduğunu açıklar.
Karşılaşacağınız kurulum hataları
curl -fsSL https://claude.ai/install.sh | bash komutu syntax error near unexpected token ile hemen başarısız oluyorsa bash'e kurulum betiği yerine proxy veya captive portal tarafından sunulan bir HTML sayfası gibi başka bir içerik aktarılmıştır; bu hatada bash'in adlandırdığı token, gerçekte ne alındığını gösterir.
bash: claude: command not found başarılı bir kurulumdan hemen sonra. İkili dosya ~/.local/bin/claude konumundadır ve bu dizin kabuğunuzun arama yolunda (PATH) bulunmamaktadır. Giriş eksik olduğunda hiçbir çıktı vermeyen echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin" komutu ile bunu doğrulayın. bash için echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc komutu ile sorunu giderin ve ardından source ~/.bashrc komutunu çalıştırın. VS Code eklentisini tek başına kurmak bu dosyayı oluşturmaz, çünkü eklenti kendi CLI kopyasını eklenti dizini içerisinde tutar.
Error loading shared library libstdc++.so.6. Kurulum programı yanlış ikili varyantı indirmiştir; bu genellikle glibc sisteminde musl derlemesi olması durumunda veya çalışma zamanı kütüphaneleri eksik olan bir musl sisteminde yaşanır. Yanlış varyant, musl çapraz derleme paketleri mevcut olduğunda ve algılama mekanizması bunları yanlış okuduğunda gerçekleşir. ldd --version 2>&1 | head -1 komutunu çalıştırın: GNU libc veya GLIBC içeren bir çıktı, glibc üzerinde olduğunuzu ve yanlış ikili dosyayı aldığınızı gösterir; bu durumda kurulumu kaldırın ve kurulum programını tekrar çalıştırın. Alpine ve diğer musl sistemlerinde çözüm bunun tam tersidir, yani apk add libgcc libstdc++ ripgrep komutudur.
Tek bir sunucuda iki adet claude kopyası. which -a claude komutu PATH değişkeninizdeki tüm eşleşmeleri listeler. Yerel kurulum, ~/.local/bin/claude konumundan ~/.local/share/claude/versions/ konumuna giden bir sembolik bağdır; eski tip yerel npm kurulumu ~/.claude/local/ altında bulunur ve npm -g ls @anthropic-ai/claude-code komutu global npm kurulumunu ortaya çıkarır. İstemediğiniz kopyaları kaldırın, çünkü PATH değişkeninizde daha önce yer alan eski bir kopya, düzeltilmiş bir hatanın hala düzeltilmemiş gibi görünmesine neden olur.
Mevcut durumun kontrol edileceği yerler
- Linux masaüstü durumu, gereksinimler ve kurulum komutları: code.claude.com/docs/en/desktop-linux
- Desteklenen dağıtımlar ve CLI için tüm kurulum yöntemleri: code.claude.com/docs/en/setup
- Hangi platformların indirilebilir bir uygulamaya sahip olduğu: claude.com/download
- Hangi planın neleri içerdiği ve maliyeti: claude.com/pricing
Claude API hesabı oturum açma politikası, katılımsız izin varsayılanları, SSH giriş akışı ve kimlik bilgisi depolama işlemleri 7 Kasım 2026 tarihinde kontrol edilmiştir; bu kılavuzdaki diğer sürüm numaraları ve tarihler Ekim 2026'ya ait anlık görüntülerdir. Yapı geçerliliğini korumaktadır: dört yüzey, ücretli olanlarda tek bir oturum açma işlemi ve CLI'ın kullanıcınıza mı yoksa tüm makineye mi ait olacağına dair tek bir karar.
FAQ
Linux için bir Claude masaüstü uygulaması var mı?
Evet. Ekim 2026 itibarıyla beta aşamasındadır ve amd64 veya arm64 mimarilerinde Ubuntu 22.04 veya üzeri ile Debian 12 veya üzeri sürümleri destekler. Anthropic'in apt deposunu ve imzalama anahtarını ekledikten sonra sudo apt install claude-desktop ile yükleyin; böylece yeni sürümler normal sistem güncellemelerinizle birlikte gelir. Linux sürümü, Claude Code sekmesi de dahil olmak üzere macOS uygulamasındaki sekmelerin aynısına sahiptir. Computer Use ve sesli dikte özellikleri henüz Linux sürümünde bulunmamaktadır. Quick Entry genel kısayol tuşu X11 üzerinde çalışır, ancak yerel bir Wayland oturumunda masaüstü ortamınızın GlobalShortcuts portalına ihtiyaç duyar. Fedora ve RHEL için paket bulunmamaktadır; bu dağıtımlarda CLI aracını veya tarayıcı üzerinden claude.ai adresini kullanın.
Linux üzerinde Claude Code çalıştırmak için Node.js gerekli mi?
Önerilen kurulum yöntemi için gerekli değildir. curl -fsSL https://claude.ai/install.sh | bash, çalışma zamanında Node.js kullanmayan derlenmiş bir ikili dosya indirir. Node.js yalnızca npm paketini yüklerseniz önem taşır; bu paket Ekim 2026 itibarıyla Node.js 22 veya üzerini gerektirir. Daha eski bir Node.js sürümünde npm bir EBADENGINE uyarısı verir ancak kurulum yine de tamamlanır, çünkü platforma özel bağımlılık olarak aynı yerel ikili dosya çekilir. Asla sudo npm install -g ile yükleme yapmayın; bu komut npm önekinizde root sahipli dosyalar bırakır ve sonraki güncellemeleri bozar.
SSH üzerinden Claude Code'a nasıl giriş yaparım?
claude komutunu çalıştırın ve terminalin yapıştırma isteminin üzerinde gösterilen yetkilendirme URL'sini kopyalayın. Bu URL'yi sunucuda değil, kendi bilgisayarınızdaki tarayıcıda açın. URL üzerinden giriş yaptıktan sonra tarayıcı, localhost adresine dönmek yerine bir giriş kodu gösterir. Bu kodu Paste code here if prompted istemine yapıştırın. Başında kimsenin bulunmadığı oturumlar için claude setup-token komutunu çalıştırın ve yazdırılan belirteci (token) gerektiği yerde CLAUDE_CODE_OAUTH_TOKEN olarak ayarlayın.
Claude Code giriş bilgilerimi Linux'ta nerede saklar?
~/.claude/.credentials.json dizininde, 0600 dosya moduyla veya bu değişkeni ayarladığınızda CLAUDE_CONFIG_DIR altında saklar. Linux'ta anahtarlık (keychain) kullanılmaz; macOS normalde şifreli Keychain kullanır ancak Keychain yazma işlemini reddettiğinde aynı düz dosyaya geri döner. Kullanıcı hesabınızla çalışan herhangi bir işlem, Linux kimlik bilgisi dosyasını okuyabilir. Bu nedenle bir /home yedeği veya makine imajı, çalışan bir giriş oturumu taşır: anlık görüntü (snapshot) almadan veya sistemi kopyalamadan önce /logout komutunu çalıştırın. Eğer ortamınızda ANTHROPIC_API_KEY de ayarlanmışsa, onay verdiğinizde bu değişken saklanan abonelik girişine göre öncelik kazanır ve /status hangisinin aktif olduğunu gösterir.
Claude Pro aboneliğim hem web uygulamasını hem de CLI aracını kapsıyor mu?
Evet. Pro, Max, Ultra veya Team planları; claude.ai, masaüstü uygulaması, CLI ve VS Code eklentisine tek bir hesapla giriş yapmanızı sağlar. Enterprise planı için de durum aynıdır, ancak eski ve HIPAA uyumlu Enterprise planları Claude Code'u yalnızca Chat + Claude Code koltukları gibi bu özelliği içeren koltuklarda sunar. HIPAA uyumlu kuruluşlar ayrı Chat ve Chat + Claude Code koltuk türleri kullanır ve yalnızca Chat + Claude Code koltukları Claude Code'u içerir. Ücretsiz claude.ai planı Claude Code'u içermez, bu nedenle terminal CLI için ücretli bir plan, bir Claude Console hesabı veya kuruluşunuzun kullandığı Amazon Bedrock, Google Cloud's Agent Platform ya da Microsoft Foundry gibi bir bulut sağlayıcısı gerekir. Masaüstü uygulaması abonelik veya SSO ile girişi ve yapılandırılmış üçüncü taraf çıkarım (inference) servislerini destekler. Claude Desktop yapılandırması olmayan cihazlarda, 3.1623.1 veya sonraki sürümler, önceden yapılandırma gerektirmeden Console girişi veya API anahtarı kabul eden bir Claude API hesabı seçeneği de sunar. 4.23118.0 veya sonraki sürümlerde, kuruluşun diğer hesapları engellediği bir bilgisayar girişinde, cihaz yönetimi olmasa bile bu bağlantı gizlenir. API, abonelikten farklı bir ürün olan Console hesabından token başına ayrı olarak faturalandırılır.