Claude Code'da Remote Control: Yerel Oturumu Telefondan ve Tarayıcıdan Yönetme Rehberi

Claude Code'a büyük bir refactor verdiniz, testler koşuyor, ama masada oturup terminale bakmak istemiyorsunuz. Ya da mutfağa geçtiniz ve Claude tam o anda "bu dosyayı silebilir miyim?" diye izin soruyor. Remote Control, tam bu boşluğu dolduran özellik: bilgisayarınızda çalışan bir Claude Code oturumunu claude.ai/code ya da iOS/Android Claude uygulamasından takip etmenizi, mesaj göndermenizi, izinleri onaylamanızı ve fotoğraf ya da dosya eklemenizi sağlıyor. Kod yürütme ve dosya erişimi makinenizde kalıyor; telefon ve tarayıcı yalnızca o yerel oturuma açılan bir pencere. Bu yazıda resmi dokümantasyona dayanarak ön koşulları, üç başlatma modunu, bağlanma yollarını, güvenlik modelini, push bildirimlerini, sınırlamaları ve sorun gidermeyi anlatıyorum. Bulutta çalışan oturumlarla farkını netleştirmek için daha önce yazdığım Claude Code on the Web rehberine de göz atabilirsiniz.

Remote Control Nedir, Nasıl Çalışır?

Remote Control, claude.ai/code arayüzünü ya da Claude mobil uygulamasını makinenizde çalışan bir Claude Code oturumuna bağlar. Görevi masanızda başlatır, kanepeden telefonla ya da başka bir bilgisayardaki tarayıcıdan sürdürürsünüz. Remote Control açıkken Claude baştan sona yerelde çalışmaya devam eder; resmi dokümantasyon bunu şu dört yetenekle özetliyor:

• Yerel ortamınızın tamamı uzaktan kullanılabilir: dosya sisteminiz, MCP sunucularınız, araçlarınız ve proje yapılandırmanız olduğu gibi kalır; telefonda @ yazdığınızda yerel projenizdeki dosya yolları otomatik tamamlanır.
• İki yüzeyden aynı anda çalışma: konuşma ile subagent'ların ve dinamik workflow'ların ilerlemesi bağlı tüm cihazlarda senkron kalır. Terminalden, tarayıcıdan ve telefondan dönüşümlü mesaj gönderebilirsiniz.
• Telefondan görsel ve dosya gönderme: Claude uygulamasında ya da claude.ai/code'da fotoğraf veya dosya eklersiniz. Fotoğrafları Claude doğrudan mesajın parçası olarak görür; diğer dosyaları Claude Code makinenize indirir ve @ dosya referansı olarak Claude'a iletir.
• Kesintilere dayanıklılık: dizüstü bilgisayar uyursa ya da ağ koparsa makine geri geldiğinde Claude Code otomatik yeniden bağlanır. Bağlantı yeniden kurulurken mesajlar, izin istekleri ve subagent/workflow durum güncellemeleri kuyruğa alınır, bağlantı düzelince teslim edilir.

Kısacası, bulut oturumlarının aksine Remote Control oturumu sizin makinenizde koşar; web ve mobil arayüz yalnızca izleme ve yönlendirme katmanıdır.

Remote Control ile Bulut Oturumu Arasındaki Fark Nedir?

İki özellik de aynı claude.ai/code arayüzünü kullandığı için sık karıştırılıyor. Ayrım tek bir soruya indirgeniyor: oturum nerede çalışıyor?

Özellik	Remote Control	Bulut oturumu (Claude Code on the Web)
Claude nerede çalışır?	Sizin makinenizde (CLI veya VS Code)	Anthropic'in yönettiği bulut altyapısında (varsayılan)
Yerel MCP sunucuları, araçlar, proje ayarları	Olduğu gibi kullanılabilir	Bulut ortamının yapılandırmasına bağlı
Makine kapalıyken sürer mi?	Hayır, yerel süreç açık kalmalı	Evet, dizüstü kapalıyken de devam eder
Repo'nun klonlanmış olması	Gerekli, projeden başlatılır	Gerekmez, GitHub'daki repo seçilir
Ne zaman tercih edilmeli?	Yerel bir işin ortasındayken başka cihazdan devam etmek için	Yerel kurulum olmadan başlamak, klonlamadığınız bir repo üzerinde çalışmak, çok sayıda görevi paralel koşturmak için

Mobil dokümantasyon kuralı pratik biçimde veriyor: bilgisayarınız kapalı olacaksa bulut oturumu ya da proje kullanın; Remote Control ve Dispatch kendi makinenizi sürdüğü için makinenin açık kalması gerekir.

Ön Koşullar: Plan, Giriş, API Uç Noktası ve Ortam Değişkenleri

Remote Control tüm planlarda mevcut, ama başlamadan önce sağlanması gereken beş koşul var. Bunların çoğu sorun giderme bölümündeki hataların da doğrudan nedeni.

• Abonelik: Pro, Max, Team ve Enterprise planlarında kullanılabilir. API anahtarları desteklenmez. Team ve Enterprise'da özellik varsayılan olarak kapalıdır; bir Owner'ın önce claude.ai/admin-settings/claude-code adresindeki Remote Control anahtarını açması gerekir.
• Kimlik doğrulama: claude çalıştırıp /login ile claude.ai üzerinden giriş yapmış olmalısınız. Uygun giriş yoksa claude remote-control hata verip çıkar; claude --remote-control oturumu başlatır ama Remote Control hata bildirimi gösterir.
• API uç noktası: Amazon Bedrock, Google Cloud Agent Platform veya Microsoft Foundry kullanıyorsanız, ANTHROPIC_BASE_URL değişkenini api.anthropic.com dışında bir hosta (LLM gateway ya da proxy gibi) yönlendirdiyseniz ya da kurumsal bir Claude apps gateway üzerinden giriş yaptıysanız özellik kullanılamaz. Değişkeni kaldırmanız gerekir (v2.1.196 öncesinde izin veriliyordu).
• Feature-flag değerlendirmesi: DISABLE_TELEMETRY, DO_NOT_TRACK, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ve DISABLE_GROWTHBOOK değişkenlerinin her biri, Remote Control'ün kullanılabilirlik kontrolünün dayandığı feature-flag değerlendirmesini kapatır. Bunları hem kabuk ortamınızdan hem de settings.json dosyalarının env bloğundan kaldırmalısınız.
• Workspace trust: proje dizininde en az bir kez claude çalıştırıp güven diyaloğunu kabul etmiş olmalısınız. Güven diyaloğu ev dizini için kaydedilmez; Remote Control'ü her zaman bir proje dizininden başlatın.

Remote Control Oturumu Nasıl Başlatılır?

CLI üç farklı başlatma modu sunuyor; VS Code eklentisi ise /remote-control komutunu kullanıyor. Hangisini seçeceğiniz, terminalde de yazmak isteyip istemediğinize ve kaç oturum sunacağınıza bağlı.

Sunucu Modu: claude remote-control

Proje dizininizde şu komutu çalıştırın:

claude remote-control

İlk çalıştırmada Claude Code özelliğin ne yaptığını açıklar ve Enable Remote Control? (y/n) sorusuyla tek seferlik onay ister. y derseniz sunucu başlar; reddederseniz süreç sunucuyu başlatmadan çıkar ve bir sonraki çalıştırmada yeniden sorar. Sunucu modunda süreç yerel etkileşimli oturum açmadan uzaktan bağlantı bekler; ekranda oturum URL'si görünür, boşluk tuşu QR kodu açar, uzak oturum aktifken terminal bağlantı durumunu ve araç etkinliğini gösterir.

Sunucu modunun bayrakları remote-control kelimesinden sonra verilir:

Bayrak	Ne yapar?
--name "Projem"	claude.ai/code oturum listesinde görünen özel başlığı belirler.
--remote-control-session-name-prefix <önek>	Açık ad verilmediğinde otomatik üretilen adların öneki. Varsayılan makinenizin hostname'idir, myhost-graceful-unicorn gibi adlar üretir. CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX ortam değişkeni aynı işi görür.
-c, --continue	Bu dizindeki son sunucunun başladığı oturumu geri getirir. --session-id, --spawn, --capacity, --create-session-in-dir ile birleştirilemez (v2.1.200+).
--session-id <id>	Kimliğini verdiğiniz tek oturumu geri getirir; aynı kısıtlar geçerli (v2.1.200+).
--spawn <mod>	same-dir (varsayılan): tüm oturumlar aynı dizini paylaşır, aynı dosyada çakışabilir. worktree: her yeni oturum kendi git worktree'sini alır. session: tek oturum, ek bağlantıları reddeder. Çalışırken w tuşu same-dir/worktree arasında geçiş yapar.
--capacity <N>	Eşzamanlı oturum üst sınırı. Varsayılan 32. --spawn=session ile kullanılamaz.
--[no-]create-session-in-dir	Sunucu başlarken mevcut dizinde bir oturum hazırlar (varsayılan açık). --no-create-session-in-dir ile başlarsanız sunucu durunca oturumlar arşivlenir, geri getirilemez.
--permission-mode <mod>	Oturumların başlangıç izin modu, örneğin acceptEdits; manual, default'un takma adıdır.
--debug-file <yol>	Hata ayıklama günlüklerini verilen dosyaya yazar.
--verbose	Ayrıntılı bağlantı ve oturum günlüklerini gösterir.
--sandbox / --no-sandbox	Dosya sistemi ve ağ izolasyonu için sandbox'ı açar ya da kapatır. Varsayılan kapalı.

Önemli bir kural: remote-control kelimesinden önce verdiğiniz global bir claude bayrağı sunucunun yarattığı oturumlara taşınmaz. --verbose veya --model gibi zararsız bayraklara izin verilir; --settings gibi bir bayrakta Claude Code başlamayı reddeder ve kaldırılması gereken bayrağı adlandırır (v2.1.248 öncesinde unknown option hatası alınıyordu). Uygun bir hesapla giriş yapmadıysanız claude remote-control --help bile bayrak listesi yerine hata döndürür.

Etkileşimli Oturum: --remote-control Bayrağı

Terminalde de yazmaya devam etmek istiyorsanız normal etkileşimli oturumu Remote Control açık başlatın:

claude --remote-control
# kısa biçim
claude --rc
# oturuma ad vererek
claude --remote-control "Projem"

Bu mod, terminalinizde tam bir etkileşimli oturum verir ve aynı oturumu claude.ai ile Claude uygulamasından da kontrol edilebilir kılar. Sunucu modundan farkı: oturum uzaktan erişilebilirken siz de yerelde mesaj yazabilirsiniz.

Mevcut Oturumdan: /remote-control Komutu

Zaten bir Claude Code oturumundaysanız ve onu uzaktan sürdürmek istiyorsanız:

/remote-control
# kısa biçim
/rc
# başlık vererek
/remote-control Projem

Bu komut mevcut konuşma geçmişini taşıyan bir Remote Control oturumu başlatır; tek seferlik onayı henüz vermediyseniz önce Enable Remote Control diyaloğu çıkar. --verbose, --sandbox ve --no-sandbox bayrakları bu komutla kullanılamaz.

VS Code Eklentisi

Claude Code VS Code eklentisinde istem kutusuna /remote-control ya da /rc yazmanız yeterli. Remote Control açıkken istem kutusunun alt bilgisinde bir Remote Control göstergesi belirir; oturum bağlandığında bu göstergeye tıklayarak doğrudan oturuma gidebilir ya da claude.ai/code oturum listesinden bulabilirsiniz. Claude Code oturum URL'sini konuşmaya da yazar. Bağlantıyı kesmek için komutu tekrar çalıştırın. CLI'dan farklı olarak VS Code komutu ad argümanı almaz ve QR kod göstermez; oturum başlığı konuşma geçmişinizden ya da ilk isteminizden türetilir.

Başka Bir Cihazdan Nasıl Bağlanılır?

Remote Control oturumu aktifken başka bir cihazdan üç yolla bağlanabilirsiniz:

• Oturum URL'sini açın: herhangi bir tarayıcıda claude.ai/code üzerindeki oturuma doğrudan gider.
• QR kodu okutun: oturum URL'sinin yanında gösterilen QR kod, oturumu doğrudan Claude uygulamasında açar. Sunucu modunda boşluk tuşu QR görünümünü açıp kapatır.
• Oturum listesinden seçin: claude.ai/code'u ya da Claude uygulamasını açıp oturumu adıyla bulun. Mobil uygulamada gezinmedeki Code sekmesi oturum listesine götürür. Çevrimiçi oturumlar yeşil noktalı bilgisayar simgesiyle görünür.

Bağlandığınız cihaz, oturumun arka planda çalıştırdığı subagent ve workflow'ları da gösterir; cihazdan birini durdurursanız Claude Code onu makinenizde durdurur. Claude uygulaması telefonunuzda yoksa /mobile komutu doğru mağazayı açan bağlantıyı QR olarak gösterir.

Oturum Başlığı Nasıl Belirlenir?

Öncelik sırası: --name, --remote-control ya da /remote-control ile verdiğiniz ad; /rename başlığı; geçmişteki son anlamlı mesaj; son çare olarak myhost-graceful-unicorn tarzı otomatik ad (önek hostname ya da --remote-control-session-name-prefix). Oturumu claude.ai ya da uygulamadan yeniden adlandırdığınızda claude --resume ve claude agents listelerindeki ad da güncellenir (v2.1.221+).

Bağlantı Durumu ve URL Hatırlatmaları

Etkileşimli oturumda Remote Control bağlıyken terminalde /rc active göstergesi görünür. Oturum URL'sini ve QR kodu görmek için /remote-control komutunu tekrar çalıştırıp durum panelini açın; aynı panelden yerel oturum sürerken bağlantıyı kesebilirsiniz. Bağlantı koparsa Claude Code nedeni bildirimle gösterir. Neden "başka bir bağlantı oturumu devraldı", "oturum başka cihazdan sonlandırıldı ya da arşivlendi" veya "sunucu artık bu oturumu raporlamıyor" değilse /remote-control ile yeniden bağlanın; bu üç durumda komutu yalnızca oturumu geri almak istiyorsanız çalıştırın.

Claude Code, telefona geçmenin en çok işe yarayacağı iki anda URL'yi istem kutusunun üstünde hatırlatır: bir tur sunucu tarafında ayarlanan eşikten uzun sürdüğünde Still working bildirimi ve Check in from your phone bağlantısı; birkaç izin istemine yanıt verdikten sonra ise Approve tool calls from your phone bildirimi. Bu hatırlatmalar oturumlar genelinde yalnızca birkaç kez görünür, yapılandırılamaz ve kendiliğinden temizlenir.

Bağlı Cihazlar Ne Görür?

Bağlı cihaz, terminaldeki konuşmayı olduğu gibi gösterir. Sıradan mesajların ötesine geçen durumları bilmek özellikle uzun oturumlarda sürpriz yaşamamanızı sağlar:

• Sıkıştırma ve /clear: Claude Code konuşmayı sıkıştırırken bağlı cihazlar ilerlemeyi, ardından konuşmanın nerede sıkıştırıldığını gösterir. /clear çalıştırdığınızda konuşma bağlı cihazlarda da sıfırlanır.
• /resume ile konuşma değiştirme: bağlı cihaz geçilen konuşmanın başlığını ve eski geçmişini almaz; ama yeni mesajlar iki yönde de terminalde açık olan konuşmaya gider.
• /teleport ile bulut oturumu çekme: bir bulut oturumunu terminale çektiğinizde bağlı cihaz çekilen konuşmanın eski geçmişini görmez, yeni mesajlar bu konuşmaya gider.
• Diğer oturumlarınızdan mesajlar: cross-session messaging ile aynı bağlantı, farklı makinelerdeki kendi oturumlarınız ve bulut oturumlarınız arasındaki mesajları da Anthropic sunucuları üzerinden taşır (v2.1.224+). Ayrıntılar için cross-session messaging rehberine bakabilirsiniz.
• Tur ortasında gönderilen istemler: mevcut tur bitmeden cihazdan istem gönderirseniz Claude Code onu kuyruğa alır ve tur bittikten sonra cihazın transkriptinde tutar.
• Değişikliklerinizin diff'i: oturum dizini bir git deposundaysa bağlı cihazın diff paneli, commit edilmemiş değişikliklerinizi gösterir. Diff makinenizde hesaplanır; çalışma ağacı temizse dalınızın varsayılan daldan ayrıldığı noktadan itibaren değişiklikler gösterilir (v2.1.247 öncesinde yalnızca sunucu modunda).
• Model seçimi: cihazdan bir model seçtiğinizde oturum o modelde çalışır; terminaldeki /model seçici, /status ve /config de bunu gösterir (v2.1.238+). Model kontrolünden yapılan seçim yalnızca mevcut oturuma uygulanır; cihazdan /model <ad> gönderirseniz yeni oturumlar için varsayılanınız da değişir. Tanınmayan bir model adı reddedilir (v2.1.260+).
• Effort seviyesi: cihazdan /effort ya da effort kontrolüyle seviye ayarlarsanız Claude Code bunu makinenizdeki oturuma uygular ve claude.ai/code oturumun kullandığı seviyeyi gösterir. CLAUDE_CODE_EFFORT_LEVEL ile sabitlediyseniz farklı bir seçim reddedilir (v2.1.234+).

Tüm Oturumlar İçin Otomatik Bağlanma

Varsayılan olarak Remote Control yalnızca claude remote-control, claude --remote-control ya da /remote-control ile açıkça çalıştırdığınızda etkinleşir. Her etkileşimli oturumda otomatik bağlanmasını istiyorsanız Claude Code içinde /config çalıştırıp Enable Remote Control for all sessions ayarını açın. Ayar üç değer alır:

• true: etkileşimli oturum başlarken otomatik bağlanır.
• false: otomatik bağlanmayı kapatır; ancak Claude Code seçimi kullanıcı ayarlarına kaydettiği için yönetilen ayarlardaki bir true bunu geçersiz kılar. Proje ya da yerel ayarlardaki (.claude/settings.json, .claude/settings.local.json) bir false ise yönetilen true'ya rağmen otomatik bağlanmayı kapatır.
• default: seçiminizi temizler ve varsa organizasyonunuzun yönetici varsayılanını, yoksa Claude Code'un mevcut varsayılanını izler.

Aynı anahtar Desktop uygulamasında Settings > Claude Code > Enable remote control by default, VS Code eklentisinde komut menüsünün Settings bölümünde bulunur (v2.1.203+). Ayar dosyasından açmak için kullanıcı ya da yönetilen ayarlarda remoteControlAtStartup anahtarını kullanın:

// ~/.claude/settings.json
{
  "remoteControlAtStartup": true
}

Proje ve yerel ayarlardaki bir true yok sayılır; böylece depoya commit edilmiş bir dosya, depoyu açan herkes için Remote Control'ü açamaz. Otomatik bağlanma kendi claude.ai hesabınızla giriş yaptığından başkasına erişim vermez. Bu ayar açıkken her etkileşimli Claude Code süreci kendi uzak oturumunu kaydeder; tek süreçten çok oturum için sunucu modunu kullanın.

Sunucuyu Durdurduktan Sonra Oturumları Geri Getirme

claude remote-control'ü Ctrl+C ile durdurduğunuzda sunduğu oturumlar telefondan ve tarayıcıdan yanıt vermeyi bırakır. Aynı dizinde başka bir claude remote-control çalıştırmadıysanız ve bu sunucuyu --no-create-session-in-dir ile başlatmadıysanız Claude Code oturumları arşivlemez. Geri getirmek için aynı dizinde şu komutlardan birini çalıştırın:

# sunucunun sunduğu tüm oturumları geri getirir
claude remote-control

# yalnızca sunucunun başladığı oturumu geri getirir, o oturum bitince çıkar
claude remote-control --continue

# yalnızca kimliğini verdiğiniz oturumu geri getirir
claude remote-control --session-id <id>

Oturum kimliği, claude.ai/code'daki URL'de /code/ ile varsa ? arasındaki parçadır. Bu komutlar sunucu durduktan sonra yaklaşık dört saat çalışır; sonrasında yeni oturum başlatmak için claude remote-control çalıştırmanız gerekir. Aradaki sürede oturumu arşivlediyseniz --continue ve --session-id v2.1.228 ve sonrasında arşivden çıkarır.

claude --remote-control ya da /remote-control ile başlattığınız oturumu geri getirmek içinse konuşmayı claude --continue veya claude --resume ile sürdürün; Claude Code konuşmadaki yeniden bağlanma kaydına göre bağlanır. İlk terminalde Remote Control hâlâ açıkken konuşmayı ikinci bir terminalde sürdürürseniz Claude Code oturumu ilk terminalden almaz; taşımak için ikinci terminalde /remote-control çalıştırın.

Bağlantı ve Güvenlik Modeli

Yerel Claude Code oturumu yalnızca giden HTTPS istekleri yapar, makinenizde gelen port açmaz. Remote Control'ü başlattığınızda oturum Anthropic API'ye kaydolur ve iş için yoklama yapar; başka bir cihazdan bağlandığınızda sunucu, istemci ile yerel oturum arasındaki mesajları akış bağlantısı üzerinden yönlendirir.

Tüm trafik, herhangi bir Claude Code oturumuyla aynı taşıma güvenliğiyle, TLS üzerinden Anthropic API'den geçer. Bağlantı tek amaçlı, kısa ömürlü kimlik bilgileri kullanır; sunucu modunda kayıt kimlik bilgisinin süresi dolunca sunucu yeniden kaydolur ve oturumları sunmaya devam eder.

Verinin nerede tutulduğu açık biçimde belirtilmiş: Remote Control bağlıyken mesajlarınız, Claude'un yanıtları ve araç etkinliği dahil oturum transkripti Anthropic sunucularında saklanır. Bu transkript cihazlar arası senkronu ve yeniden bağlanmayı sağlar; yürütme ve dosya erişimi makinenizde kalır, transkriptler veri kullanım politikasına göre tutulur. Özelliği tamamen kapatmak için disableRemoteControl ayarını kullanın. Zero Data Retention gibi uyumluluk gereksinimi olan organizasyonlar Remote Control'ü açamaz.

Trusted Devices: Team ve Enterprise İçin Cihaz Doğrulama

Trusted Devices, Team ve Enterprise planlarında sunulan, beta aşamasındaki organizasyon çapında bir ayar. Açıldığında üyelerin Remote Control oturumlarını claude.ai, mobil uygulamalar ya da Claude Desktop'tan görüntüleyip yönlendirmeden önce cihazlarını doğrulamasını zorunlu kılar; erişimi yalnızca giriş yapmış bir hesaba değil, bilinen bir cihaza ve yakın tarihli bir kimlik doğrulamaya bağlar. İki koşul aranır:

• Kayıtlı cihaz: üyenin Remote Control için kullandığı her tarayıcı, telefon ya da masaüstü uygulaması kendi kimlik bilgisini kaydeder. Kayıt yalnızca tam bir girişten kısa süre sonra sunulur; cihaz arka planda sessizce değil, gerçek bir kimlik doğrulamanın parçası olarak listeye girer.
• Yakın tarihli giriş: üyenin girişi en fazla 18 saat eski olabilir. Her gün yeniden giriş yapmak yerine üyeler Face ID, Touch ID, Windows Hello ya da passkey ile varlıklarını doğrular; bu biyometrik adım oturumu anında yeniler.

Biyometrik kontroller cihazda çalışır; Anthropic biyometrik veri almaz, yalnızca cihazın açık anahtarı ve ad, platform, kayıt zamanı gibi meta veriler tutulur. Ayar yalnızca Remote Control'ü etkiler; terminalde ayrı kayıt adımı yoktur, CLI girişi kendi kimlik bilgisini otomatik alır.

Bir Owner ayarı claude.ai/admin-settings/claude-code adresinde Remote Control ayarının altındaki Require trusted devices anahtarıyla açar. Ayar tüm üyelere ve açıldıktan sonra başlatılan oturumlara uygulanır; takım ya da proje bazlı kapsam yoktur. Üyeler claude.ai/settings/account sayfasının Trusted devices bölümünden kayıtlı cihazlarını görüp kaldırabilir; kaldırma kimlik bilgisini anında iptal eder, cihaz yeni bir girişten sonra yeniden kaydolabilir. Kayıp bir cihazda üye giriş yapamıyorsa yönetici admin konsolundaki Sign out everywhere ile o üyenin tüm oturumlarını ve cihazlarını iptal edebilir.

Mobil Push Bildirimleri Nasıl Açılır?

Remote Control aktifken Claude telefonunuza push bildirimi gönderebilir. Ne zaman göndereceğine Claude karar verir: tipik olarak uzun süren bir görev bittiğinde ya da devam etmek için sizden bir karar gerektiğinde. İsteminizde de talep edebilirsiniz, örneğin "testler bitince bana bildir". Aşağıdaki iki açma/kapama anahtarı dışında olay bazlı bir yapılandırma yoktur. Kurulum dört adımdır:

1. iOS ya da Android için Claude uygulamasını kurun.
2. Terminaldeki Claude Code ile aynı hesap ve organizasyonla giriş yapın.
3. İşletim sisteminin bildirim izni istemini kabul edin.
4. Terminalde /config çalıştırıp Push when Claude decides (proaktif bildirimler) ve/veya Push when actions required (izin istemleri ve sorular) seçeneklerini açın. Ayar dosyasında bunlar sırasıyla agentPushNotifEnabled ve inputNeededNotifEnabled anahtarlarına karşılık gelir.

Bildirimler gelmiyorsa: /config No mobile registered gösteriyorsa telefonda Claude uygulamasını açın ki push token'ını yenilesin. iOS'ta Focus modları ve bildirim özetleri, Android'de agresif pil optimizasyonu teslimatı geciktirebilir.

Bağlı terminalde yazıyor ya da o pencereye odaklanmışken Claude Code push göndermez. v2.1.181'den itibaren CLAUDE_CLIENT_PRESENCE_FILE değişkenine bir işaret dosyası yolu vererek bunu "makinenin başındayken" durumuna genişletebilirsiniz: dosya var olduğu sürece bildirimler atlanır; ekran kilidi dinleyicisiyle dosyayı ekran açılınca oluşturup kilitlenince silebilirsiniz.

Telefondan ve Web'den Hangi Komutlar Çalışır?

Mobil ve web istemcisi bir oturumun ihtiyaç duyduğu şeylerin çoğunu karşılıyor; ama yalnızca terminal arayüzünde çalışan /plugin ve /resume gibi komutlar, argüman verseniz de vermeseniz de yalnızca yerel CLI'da çalışır. Aşağıdaki tablo resmi listeyi özetliyor:

Komut(lar)	Mobil ve web'de davranışı
/compact, /clear, /context, /usage, /exit, /usage-credits, /recap, /reload-plugins	Metin çıktısı verir. /usage-credits fatura URL'sini yazdırır.
/model, /effort, /fast, /color, /rename	Değeri argüman olarak verin: /model sonnet, /effort high.
/mcp	Mobilde sunucu durumunun metin özetini döndürür; web'de tek başına claude.ai connector dizinini açar. reconnect, enable, disable alt komutları ikisinde de çalışır.
/config	Mobilde key=value ile ayar yapar, argümansız çalıştırınca ayarlanabilir anahtarları listeler. Web'de ayarlarınızın Claude Code bölümünü açar, komuttan sonraki metni yok sayar.
/autocompact (v2.1.221+)	Pencere boyutunu argümanla verin: /autocompact 500k. Argümansız mevcut boyutu metin olarak yazdırır.
/advisor (v2.1.260+)	/advisor opus ya da kapatmak için /advisor off. Yalnızca mevcut oturuma uygulanır.
/output-style (v2.1.269+)	/output-style concise gibi stil adı verin ya da argümansız listeleyin. Yalnızca yerleşik stiller seçilebilir.

Team ve Enterprise'da mobil ya da web'den /usage-credits yöneticinize kredi isteği göndermez; onay yalnızca etkileşimli CLI'da göründüğü için komut sizi oraya yönlendirir. İzin modlarında da fark var: uygulamadan Manual, Accept edits ve Plan seçilebilir; Bypass permissions ve Auto modu seçilemez.

Sınırlamalar

• Etkileşimli süreç başına tek uzak oturum: sunucu modu dışında her Claude Code örneği aynı anda bir uzak oturumu destekler. Tek süreçten çok oturum için sunucu modunu kullanın.
• Yerel süreç çalışır kalmalı: terminali kapatır, VS Code'dan çıkar ya da claude sürecini durdurursanız oturum siz geri getirene kadar çevrimdışı olur. SSH ile bağlandığınız uzak bir makinede oturumun bağlantı koptuktan sonra da sürmesi için tmux ya da screen içinde başlatın.
• Sunucu modunda çöken oturumlar: claude remote-control'ün sunduğu bir oturum çökerse bağlı cihazdan ona bir mesaj gönderin; Claude Code oturumu yeniden sunar, sunucuyu yeniden başlatmanız gerekmez (v2.1.238+).
• Bağlı oturumda HTTP 403: VPN ya da ağ değişikliğinden sonra olabileceği gibi, makineniz ile Anthropic sunucuları arasında bir şey 403 dönerse Claude Code üç dakikaya kadar yeniden dener. Reddetmeler sürerse bağlantıyı keser ve neyin reddettiğini (ağ kenarı, proxy, VPN, güvenlik duvarı) adlandırır.
• Uzun ağ kesintisi: sunucu modunda Claude Code yaklaşık 10 dakika sonra pes eder ve süreç çıkar; yeniden claude remote-control çalıştırmanız gerekir. Etkileşimli oturumda yerelde çalışmaya devam edersiniz, Claude Code kesinti sürdüğü sürece yeniden dener ve ağ dönünce kendiliğinden bağlanır.
• Varlık kalp atışlarının başarısız olması: etkileşimli oturum could not reach the Remote Control server for about 30 minutes mesajıyla koparsa /remote-control ile yeniden bağlanın.
• İletilen diyalogların süresi dolar: izin istemleri ve AskUserQuestion soruları siz yanıtlayana kadar açık kalır. Başka türden bir diyalog (güvenlik reddi sonrası gösterilen model seçimi gibi) uzak oturuma iletildiğinde Claude Code varsayılan olarak beş dakika bekler, sonra diyaloğu kapatıp eylemsiz varsayılanıyla devam eder. dialogExpiry ayarı süreyi değiştirir ya da kapatır (v2.1.224+).

Gerçek Dünya Senaryosu: Uzun Bir Refactor'ü Kanepeden Takip Etmek

Diyelim ki bir Node.js projesinde ORM katmanını değiştirmek gibi saatler sürecek bir görev var ve masada beklemek istemiyorsunuz. Akış şöyle kurulabilir:

# 1. Proje dizinine geç ve güven diyaloğunu bir kez kabul et
cd ~/projeler/siparis-servisi
claude
# /login ile claude.ai girişini doğrula, çık

# 2. Etkileşimli oturumu Remote Control açık başlat, ad ver
claude --remote-control "ORM gecisi"

# 3. Görevi ver
> Sequelize'dan Prisma'ya geçişi planla, önce plan modunda
> şemayı çıkar, sonra modülleri tek tek taşı ve her modülde
> testleri koş. Bir modülü bitirince beni bildir.

Ardından terminalde /remote-control yazıp durum panelinden QR kodu telefonla okutursunuz; oturum Claude uygulamasının Code sekmesinde yeşil noktayla görünür. /config içinden Push when actions required açıksa Claude bir dosyayı silmek için izin istediğinde telefonunuza bildirim düşer; uygulamadan onaylarsınız, Claude makinenizde devam eder. Mutfaktan "ödeme modülünde @src/payments/repo.ts dosyasındaki sorguyu da taşımayı unutma" diye mesaj atarsınız; @ yazınca yerel dosya yolları telefonda otomatik tamamlanır. Diff panelinden commit edilmemiş değişiklikleri gözden geçirir, gerekirse /effort high ile akıl yürütme derinliğini artırırsınız. Dizüstü bir ara uykuya girse bile makine uyanınca Claude Code yeniden bağlanır ve arada gönderdiğiniz mesajları kuyruktan teslim eder. Masaya döndüğünüzde terminalde konuşma aynen sürüyor.

Aynı görevi birden çok paralel oturumla yürütmek isteseydiniz sunucu modunu --spawn worktree ile başlatmak, her oturuma ayrı bir git worktree vererek dosya çakışmalarını önlerdi:

claude remote-control --name "siparis-servisi" --spawn worktree --capacity 4

Başlangıçta mevcut dizinde bir oturum hazır olur; telefondan başlattığınız her yeni oturum kendi worktree'sinde açılır. Arka plan oturumlarını tek ekrandan izlemek için agent view rehberindeki claude agents panosunu da bu akışa ekleyebilirsiniz.

Sorun Giderme

Remote Control hatalarının neredeyse tamamı kimlik doğrulama, uç nokta ya da organizasyon politikasından kaynaklanıyor. Resmi dokümantasyondaki hata mesajlarını ve çözümlerini derledim:

Hata mesajı	Neden	Çözüm
"Remote Control requires a claude.ai subscription"	claude.ai hesabıyla giriş yapılmamış ya da ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN veya apiKeyHelper girişin önüne geçiyor; mesaj hangisinin kullanıldığını söyler.	claude auth login ile claude.ai seçeneğinden giriş yapın; adı geçen değişkeni kabuktan ve ayar dosyalarının env bloğundan kaldırın.
"Remote Control requires a full-scope login token"	claude setup-token ya da CLAUDE_CODE_OAUTH_TOKEN ile üretilmiş uzun ömürlü token kullanılıyor; bu token'lar yalnızca model isteği yapabilir.	claude auth login ile tam kapsamlı oturum token'ı alın.
"Remote Control isn't enabled for this account"	Hesap düzeyindeki uygunluk kontrolü kapalı döndü; genelde plan değişikliğinden sonra eski entitlement önbelleği.	claude auth logout ardından claude auth login; eski sürümdeyseniz güncelleyin. claude doctor hangi kontrolün başarısız olduğunu gösterir.
"Remote Control requires feature-flag evaluation"	DISABLE_TELEMETRY, DO_NOT_TRACK, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ya da DISABLE_GROWTHBOOK ayarlı; mesaj hangisi olduğunu söyler.	Değişkeni kabuktan ve settings.json env bloğundan kaldırın.
"Remote Control is only available when using Claude via api.anthropic.com"	Bedrock, Google Cloud Agent Platform, Foundry ya da özel ANTHROPIC_BASE_URL; mesaj oturumu yönlendiren değişkeni (CLAUDE_CODE_USE_BEDROCK gibi) adlandırır (v2.1.219+).	Uygun bir claude.ai girişiniz varsa adı geçen değişkeni kaldırıp oturumu yeniden başlatın.
"Remote Control is disabled by your organization's policy"	Yönetilen ayarlarda disableRemoteControl; Pro/Max hesabın eski bir Team/Enterprise organizasyonuyla girişte kalması; organizasyon politikasının makineye yüklenmemesi; HIPAA yapılandırması; ya da Owner'ın anahtarı açmaması.	/status ile plan ve organizasyonu görün, gerekirse claude auth logout ve claude auth login; claude doctor'daki Organization policy satırına bakın (v2.1.261+); HIPAA'da Anthropic desteğiyle görüşün; aksi halde Owner admin panelinden anahtarı açsın.
"Remote credentials fetch failed"	Anthropic API'den kısa ömürlü kimlik bilgisi alınamadı: giriş yok, güvenlik duvarı/proxy 443 portunu engelliyor ya da oturum yaratma daha önce başarısız oldu.	claude remote-control --verbose ile tam hatayı görün; girişi ve aboneliğin aktif olduğunu doğrulayın.
"Couldn't reconnect to your Remote Control session"	claude --resume ya da --continue sonrası yeniden bağlanma geçici bir nedenle (ağ, sunucu hatası) başarısız oldu.	/remote-control ile yeniden deneyin ya da claude --remote-control ile yeni oturum açın; yerel oturum bu arada çalışmaya devam eder.
"Previous session is unavailable — run /remote-control to start a new one"	Önceki oturum geri getirilemedi ve Claude Code kendi başına yenisini açmak yerine durdu.	/remote-control ile mevcut girişle yeni oturum başlatın. Claude Code'u yeniden başlatmadan çalıştırırsanız konuşmanın eski mesajları yeni oturuma taşınmaz.
"Your organization requires Trusted Devices … this device is not enrolled" / "session expired for trusted-device check"	Trusted Devices açık ve makine kayıtlı değil ya da giriş 18 saatten eski.	/login çalıştırın; kayıt girişin parçasıdır. Ya da claude.ai/uygulama istediğinde Face ID, Touch ID, Windows Hello veya passkey ile onaylayın.

Terminalden Uzakta Çalışmak: Hangi Yöntem Ne Zaman?

Resmi karşılaştırma tablosu, makinenizde çalışan üç yöntemi tetikleyiciye göre ayırıyor (Slack, self-hosted environments ve zamanlanmış görevler ise bulut ya da zamanlama tarafında kalıyor):

Yöntem	Tetikleyici	Claude nerede çalışır?	En uygun olduğu durum
Dispatch	Claude mobil uygulamasından görev mesajı	Makineniz (Desktop uygulaması)	Uzaktayken iş devretmek, minimum kurulum (Pro/Max)
Remote Control	claude.ai/code ya da mobil uygulamadan çalışan oturumu sürme	Makineniz (CLI ya da VS Code)	Devam eden işi başka cihazdan yönlendirmek
Channels	Telegram, Discord gibi sohbet uygulamasından ya da kendi sunucunuzdan olay	Makineniz (CLI)	CI hatası ya da sohbet mesajı gibi dış olaylara tepki vermek

Channels dış olayları çalışan oturumun içine iter, Remote Control ise sizi oturumun başına getirir; ikisi birlikte de çalışır. Ayrıntılar için Channels rehberine bakabilirsiniz.

Sıkça Sorulan Sorular

Remote Control ile Claude Code on the Web (bulut oturumu) arasındaki fark nedir?

Aynı claude.ai/code arayüzünü kullanırlar; fark oturumun nerede çalıştığıdır. Remote Control makinenizde çalışır ve yerel MCP sunucularınızla proje ayarlarınızı kullanır; bulut oturumu Anthropic altyapısında çalışır, makinenizin açık olması gerekmez. Yerel bir işin ortasındaysanız Remote Control, klonlamadığınız bir repo ya da paralel görevler için bulut oturumu.

Remote Control API anahtarıyla çalışır mı?

Hayır. Yalnızca claude.ai aboneliğiyle (Pro, Max, Team, Enterprise) çalışır. ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN ya da apiKeyHelper devredeyse hata mesajı hangisinin kullanıldığını söyler; claude setup-token ile üretilen token da yeterli değildir. Çözüm ilgili değişkeni kaldırıp claude auth login ile claude.ai girişi yapmak. Bedrock, Google Cloud Agent Platform, Foundry ve api.anthropic.com dışına yönlendirilmiş ANTHROPIC_BASE_URL kurulumlarında da kullanılamaz.

claude remote-control ile claude --remote-control arasındaki fark nedir?

İlki sunucu modudur: yerel etkileşimli oturum açmaz, uzaktan bağlantı bekler ve tek süreçten varsayılan 32'ye kadar oturum sunar; --spawn worktree ile her oturuma ayrı worktree verilebilir. İkincisi (kısaca --rc) normal etkileşimli bir oturumu aynı anda uzaktan da erişilebilir kılar; hem terminalden hem telefondan yazarsınız. Açık bir oturumu sonradan uzağa açmak için /remote-control (/rc) mevcut geçmişi taşır.

Bilgisayarım uyku moduna girerse ya da ağ koparsa oturum kaybolur mu?

Hayır. Makine geri geldiğinde Claude Code otomatik yeniden bağlanır; aradaki mesajlar, izin istekleri ve durum güncellemeleri kuyruğa alınıp teslim edilir. Süreç tamamen kapanırsa oturum çevrimdışı olur. Sunucu modunda uzun kesintide yaklaşık 10 dakika sonra süreç çıkar; etkileşimli oturum kesinti boyunca denemeye devam eder. SSH üzerinden uzak makinede tmux ya da screen kullanın.

Telefondan hangi slash komutları çalışır?

/plugin ve /resume gibi yalnızca terminal komutları çalışmaz. Çalışanlar: /compact, /clear, /context, /usage, /exit, /usage-credits, /recap, /reload-plugins; argümanla /model sonnet, /effort high, /fast, /color, /rename; /mcp ve alt komutları; /config key=value; /autocompact 500k; /advisor opus; /output-style concise. Telefondan Bypass permissions ve Auto modu seçilemez.

Remote Control kurumsal ortamda güvenli mi, veriler nerede tutulur?

Yerel oturum yalnızca giden HTTPS istekleri yapar, gelen port açmaz; trafik TLS üzerinden Anthropic API'den geçer. Bağlıyken transkript senkron için Anthropic sunucularında saklanır, yürütme ve dosya erişimi makinenizde kalır. Team/Enterprise'da özellik varsayılan kapalıdır, Owner açar; Trusted Devices ek katman sunar. ZDR gereksinimi olan organizasyonlar açamaz; disableRemoteControl ile kapatılabilir.

Özet

Remote Control, sizi çalışan Claude Code oturumunun başına getiriyor: kod yürütme, dosya erişimi, MCP sunucuları ve proje ayarları makinenizde kalırken claude.ai/code ve Claude mobil uygulaması bu oturuma bir pencere açıyor. Üç başlatma modu var: çok oturumlu sunucu modu claude remote-control, etkileşimli claude --remote-control ve mevcut oturumu taşıyan /remote-control. URL, QR kod ya da oturum listesiyle bağlanıyorsunuz; diff paneli, model ve effort seçimi, dosya ekleme, kuyruğa alınan mesajlar ve otomatik yeniden bağlanma uzaktan çalışmayı gerçekçi kılıyor. Push bildirimleri /config'deki iki anahtarla, otomatik bağlanma remoteControlAtStartup ile açılıyor. Güvenlik tarafında gelen port yok, kısa ömürlü kimlik bilgileri var, transkript Anthropic sunucularında tutuluyor ve Team/Enterprise için Trusted Devices ek katman sunuyor. Ön koşulları sağladığınızda hataların çoğu ortadan kalkıyor; kalanlar için sorun giderme tablosu ve claude doctor yeterli. Bulut oturumlarıyla karşılaştırma için Claude Code on the Web rehberine, dış olayları oturuma itmek için Channels rehberine, arka plan oturumlarını tek ekrandan yönetmek için de agent view rehberine göz atabilirsiniz.