Remote Control

Remote Control ile Claude Code Oturumlarınıza Her Yerden Devam Edin

Claude Code artık Remote Control özelliği sayesinde, masaüstünüzde başlattığınız bir oturumu telefonunuzdan, tabletinizden veya herhangi bir tarayıcıdan sürdürmenize olanak tanıyor. Bu özellik claude.ai/code ve Claude mobil uygulaması ile uyumlu çalışır.

Not: Remote Control, araştırma önizlemesi (research preview) aşamasındadır ve tüm planlarda kullanılabilir. Team ve Enterprise planlarında varsayılan olarak kapalıdır; bir yöneticinin Claude Code yönetici ayarlarından Remote Control seçeneğini etkinleştirmesi gerekir.

Remote Control, claude.ai/code veya iOS/Android için Claude uygulamasını, makinenizde çalışan bir Claude Code oturumuna bağlar. Masanızda bir görev başlatıp, koltukta telefonunuzdan veya başka bir bilgisayardaki tarayıcıdan devam edebilirsiniz. Remote Control oturumu başlattığınızda, Claude yerel olarak çalışmaya devam eder; hiçbir şey buluta taşınmaz.

Remote Control ile şunları yapabilirsiniz:

• Tam yerel ortamınızı uzaktan kullanma: dosya sisteminiz, MCP sunucularınız, araçlarınız ve proje yapılandırmanız her zaman kullanılabilir durumdadır. @ yazarak yerel projenizdeki dosya yolları otomatik tamamlanır.
• Her iki yüzeyden aynı anda çalışma: konuşma, bağlı tüm cihazlarda senkronize kalır; terminal, tarayıcı ve telefon arasında mesaj gönderebilirsiniz.
• Kesintilerden kurtulma: dizüstü bilgisayarınız uyku moduna geçse veya ağ bağlantınız kopsa bile, makineniz tekrar çevrimiçi olduğunda oturum otomatik olarak yeniden bağlanır.

Claude Code on the web'den farklı olarak, Remote Control oturumları doğrudan makinenizde çalışır ve yerel dosya sisteminizle etkileşime girer. Web ve mobil arayüzler, yalnızca bu yerel oturuma açılan bir penceredir.

Remote Control, Claude Code v2.1.51 veya daha yenisini gerektirir. Sürümünüzü claude --version ile kontrol edebilirsiniz.

Gereksinimler (Requirements)

Remote Control'ü kullanmadan önce ortamınızın aşağıdaki koşulları karşıladığından emin olun:

• Abonelik: Pro, Max, Team ve Enterprise planlarında kullanılabilir. API anahtarları desteklenmez. Team ve Enterprise'da, bir yöneticinin önce Claude Code yönetici ayarlarından Remote Control seçeneğini etkinleştirmesi gerekir.
• Kimlik doğrulama: claude komutunu çalıştırın ve henüz yapmadıysanız /login ile claude.ai üzerinden giriş yapın.
• Çalışma alanı güveni: Proje dizininizde claude komutunu en az bir kez çalıştırarak çalışma alanı güven iletişim kutusunu kabul edin.

Remote Control Oturumu Başlatma (Start a Remote Control Session)

Remote Control oturumunu CLI veya VS Code eklentisinden başlatabilirsiniz. CLI üç farklı çağırma modu sunar; VS Code ise /remote-control komutunu kullanır.

Sunucu modu (Server mode)

Proje dizininize gidin ve şu komutu çalıştırın:

claude remote-control

Bu işlem, terminalinizde sunucu modunda çalışır ve uzak bağlantıları bekler. Başka bir cihazdan bağlanmak için kullanabileceğiniz bir oturum URL'si görüntüler. Telefonunuzdan hızlı erişim için boşluk çubuğuna basarak bir QR kodu gösterebilirsiniz. Uzak oturum etkinken, terminal bağlantı durumunu ve araç etkinliğini gösterir.

Kullanılabilir bayraklar:

Etkileşimli oturum (Interactive session)

Remote Control etkinken normal bir etkileşimli Claude Code oturumu başlatmak için --remote-control (veya --rc) bayrağını kullanın:

claude --remote-control

İsteğe bağlı olarak oturuma bir ad verebilirsiniz:

claude --remote-control "My Project"

Bu, terminalinizde tam bir etkileşimli oturum açar ve aynı anda claude.ai veya Claude uygulamasından da kontrol edilebilir. claude remote-control (sunucu modu) komutundan farklı olarak, oturum uzaktan da kullanılabilirken yerel olarak mesaj yazmaya devam edebilirsiniz.

Mevcut bir oturumdan (From an existing session)

Zaten bir Claude Code oturumunun içindeyseniz ve uzaktan devam etmek istiyorsanız, /remote-control (veya /rc) komutunu kullanın:

/remote-control

Özel bir oturum başlığı ayarlamak için argüman olarak bir ad ekleyin:

/remote-control My Project

Bu, mevcut konuşma geçmişinizi taşıyan bir Remote Control oturumu başlatır ve başka bir cihazdan bağlanmak için bir oturum URL'si ile QR kodu görüntüler. --verbose, --sandbox ve --no-sandbox bayrakları bu komutla kullanılamaz.

VS Code

Claude Code VS Code eklentisinde, komut kutusuna /remote-control veya /rc yazın veya / ile komut menüsünü açıp seçin. Claude Code v2.1.79 veya daha yenisi gerekir.

/remote-control

Komut kutusunun üzerinde bağlantı durumunu gösteren bir banner belirir. Bağlandıktan sonra, banner'daki Open in browser seçeneğine tıklayarak doğrudan oturuma gidebilir veya claude.ai/code adresindeki oturum listesinde bulabilirsiniz. Oturum URL'si ayrıca konuşmada da yayınlanır. Bağlantıyı kesmek için banner'daki kapatma simgesine tıklayın veya /remote-control komutunu tekrar çalıştırın.

Not: CLI'nin aksine, VS Code komutu bir ad argümanı kabul etmez veya QR kodu göstermez. Oturum başlığı, konuşma geçmişinizden veya ilk istemden türetilir.

Başka Bir Cihazdan Bağlanma (Connect from another device)

Remote Control oturumu etkinken, başka bir cihazdan bağlanmak için birkaç seçeneğiniz vardır:

• Oturum URL'sini herhangi bir tarayıcıda açarak doğrudan claude.ai/code üzerindeki oturuma gidin.
• Oturum URL'sinin yanında gösterilen QR kodunu tarayarak doğrudan Claude uygulamasında açın. claude remote-control ile boşluk çubuğuna basarak QR kodu görüntülemeyi açıp kapatabilirsiniz.
• claude.ai/code veya Claude uygulamasını açın ve oturumu adına göre oturum listesinde bulun. Claude mobil uygulamasında, oturum listesine ulaşmak için gezinme çubuğundaki Code seçeneğine dokunun. Remote Control oturumları, çevrimiçiyken yeşil durum noktası olan bir bilgisayar simgesi gösterir.

Uzak oturum başlığı şu sırayla seçilir:

1. --name, --remote-control veya /remote-control ile verdiğiniz ad
2. /rename ile ayarladığınız başlık
3. Mevcut konuşma geçmişindeki son anlamlı mesaj
4. myhost-graceful-unicorn gibi otomatik oluşturulan bir ad (burada myhost makinenizin ana bilgisayar adı veya --remote-control-session-name-prefix ile ayarladığınız ön ektir)

Açık bir ad belirtmediyseniz, bir istem gönderdiğinizde başlık isteminizi yansıtacak şekilde güncellenir.

Ortamda zaten etkin bir oturum varsa, devam etmek mi yoksa yeni bir oturum başlatmak mı istediğiniz sorulur.

Henüz Claude uygulamanız yoksa, Claude Code içinde /mobile komutunu kullanarak iOS veya Android için indirme QR kodu görüntüleyebilirsiniz.

Tüm Oturumlar İçin Remote Control'ü Etkinleştirme (Enable Remote Control for all sessions)

Varsayılan olarak Remote Control, yalnızca claude remote-control, claude --remote-control veya /remote-control komutlarını açıkça çalıştırdığınızda etkinleşir. Her etkileşimli oturumda otomatik olarak etkinleştirmek için Claude Code içinde /config komutunu çalıştırın ve Enable Remote Control for all sessions seçeneğini true yapın. Devre dışı bırakmak için false yapın.

Bu ayar açıkken, her etkileşimli Claude Code işlemi bir uzak oturum kaydeder. Birden fazla örnek çalıştırırsanız, her biri kendi ortamını ve oturumunu alır. Tek bir işlemden birden fazla eşzamanlı oturum çalıştırmak için sunucu modunu kullanın.

Bağlantı ve Güvenlik (Connection and security)

Yerel Claude Code oturumunuz yalnızca giden HTTPS istekleri yapar ve makinenizde hiçbir zaman gelen bağlantı noktası açmaz. Remote Control'ü başlattığınızda, Anthropic API'sine kaydolur ve iş için yoklama yapar (polling). Başka bir cihazdan bağlandığınızda, sunucu web veya mobil istemci ile yerel oturumunuz arasındaki mesajları bir akış bağlantısı üzerinden yönlendirir.

Tüm trafik, TLS üzerinden Anthropic API'si üzerinden geçer; bu, herhangi bir Claude Code oturumuyla aynı taşıma güvenliğidir. Bağlantı, her biri tek bir amaca yönelik ve bağımsız olarak süresi dolan birden fazla kısa ömürlü kimlik bilgisi kullanır.

Remote Control ve Claude Code on the Web Karşılaştırması

Remote Control ve Claude Code on the web, her ikisi de claude.ai/code arayüzünü kullanır. Temel fark, oturumun nerede çalıştığıdır:

• Remote Control: Makinenizde çalışır; yerel MCP sunucularınız, araçlarınız ve proje yapılandırmanız kullanılabilir durumdadır.
• Claude Code on the web: Anthropic tarafından yönetilen bulut altyapısında çalışır.

Remote Control'ü, yerel çalışmanızın ortasındayken başka bir cihazdan devam etmek istediğinizde kullanın. Claude Code on the web'i, herhangi bir yerel kurulum yapmadan bir görev başlatmak, klonlamadığınız bir depo üzerinde çalışmak veya birden fazla görevi paralel olarak yürütmek istediğinizde kullanın.

Mobil Push Bildirimleri (Mobile push notifications)

Remote Control etkinken, Claude telefonunuza push bildirimi gönderebilir. Claude, ne zaman push yapılacağına kendisi karar verir. Genellikle uzun süren bir görev tamamlandığında veya devam etmek için sizden bir karar gerektiğinde bir bildirim gönderir. Ayrıca isteminizde push talep edebilirsiniz, örneğin: notify me when the tests finish. Aşağıdaki açma/kapama anahtarı dışında, olay başına yapılandırma yoktur.

Mobil push bildirimleri, Claude Code v2.1.110 veya daha yenisini gerektirir.

Mobil push bildirimlerini ayarlamak için:

1. Claude mobil uygulamasını yükleyin: iOS veya Android için Claude uygulamasını indirin.
2. Claude Code hesabınızla giriş yapın: Terminalde Claude Code için kullandığınız hesap ve kuruluşu kullanın.
3. Bildirimlere izin verin: İşletim sisteminden gelen bildirim izni istemini kabul edin.
4. Claude Code'da push'u etkinleştirin: Terminalde /config komutunu çalıştırın ve Push when Claude decides seçeneğini etkinleştirin.

Bildirimler gelmezse:

• /config ekranında No mobile registered yazıyorsa, push token'ını yenilemesi için Claude uygulamasını telefonunuzda açın. Uyarı, Remote Control bir sonraki bağlantısında temizlenir.
• iOS'ta Odak modları ve bildirim özetleri, push'ları bastırabilir veya geciktirebilir. Ayarlar → Bildirimler → Claude bölümünü kontrol edin.
• Android'de agresif pil optimizasyonu teslimatı geciktirebilir. Claude uygulamasını sistem ayarlarında pil optimizasyonundan muaf tutun.

Sınırlamalar (Limitations)

• Etkileşimli işlem başına bir uzak oturum: Sunucu modu dışında, her Claude Code örneği aynı anda yalnızca bir uzak oturumu destekler. Tek bir işlemden birden fazla eşzamanlı oturum çalıştırmak için sunucu modunu kullanın.
• Yerel işlem çalışmaya devam etmelidir: Remote Control, yerel bir işlem olarak çalışır. Terminali kapatırsanız, VS Code'dan çıkarsanız veya claude işlemini durdurursanız, oturum sona erer.
• Uzun süreli ağ kesintisi: Makineniz uyanık ancak yaklaşık 10 dakikadan uzun süre ağa erişemezse, oturum zaman aşımına uğrar ve işlem sonlanır. Yeni bir oturum başlatmak için claude remote-control komutunu tekrar çalıştırın.
• Ultraplan, Remote Control bağlantısını keser: Bir ultraplan oturumu başlatmak, etkin Remote Control oturumunu keser çünkü her iki özellik de claude.ai/code arayüzünü kullanır ve aynı anda yalnızca biri bağlı olabilir.
• Bazı komutlar yalnızca yereldir: Terminalde etkileşimli seçici açan komutlar (/mcp, /plugin, /resume) yalnızca yerel CLI'da çalışır. Metin çıktısı üreten komutlar (/compact, /clear, /context, /usage, /exit, /extra-usage, /recap, /reload-plugins) mobil ve web'den çalışır.

Sorun Giderme (Troubleshooting)

"Remote Control requires a claude.ai subscription"

Bir claude.ai hesabıyla kimlik doğrulaması yapmamışsınız. claude auth login komutunu çalıştırın ve claude.ai seçeneğini seçin. Ortamınızda ANTHROPIC_API_KEY ayarlanmışsa, önce onu kaldırın.

"Remote Control requires a full-scope login token"

claude setup-token komutundan uzun ömürlü bir token veya CLAUDE_CODE_OAUTH_TOKEN ortam değişkeni ile kimlik doğrulaması yapmışsınız. Bu token'lar yalnızca çıkarım amaçlıdır ve Remote Control oturumları kuramaz. Bunun yerine claude auth login komutunu çalıştırarak tam kapsamlı bir oturum token'ı ile kimlik doğrulaması yapın.

"Unable to determine your organization for Remote Control eligibility"

Önbelleğe alınmış hesap bilgileriniz güncel değil veya eksik. claude auth login komutunu çalıştırarak yenileyin.

"Remote Control is not yet enabled for your account"

Uygunluk kontrolü, belirli ortam değişkenleri varken başarısız olabilir:

• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC veya DISABLE_TELEMETRY: bunları kaldırın ve tekrar deneyin.
• CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX veya CLAUDE_CODE_USE_FOUNDRY: Remote Control, claude.ai kimlik doğrulaması gerektirir ve üçüncü taraf sağlayıcılarla çalışmaz.

Bunların hiçbiri ayarlanmamışsa, yenilemek için /logout ardından /login komutlarını çalıştırın.

"Remote Control is disabled by your organization's policy"

Bu hata dört farklı nedenden kaynaklanabilir. Önce /status komutunu çalıştırarak hangi giriş yöntemini ve aboneliği kullandığınızı kontrol edin.

• API anahtarı veya Console hesabı ile kimlik doğrulaması yapmışsınız: Remote Control, claude.ai OAuth gerektirir. /login komutunu çalıştırın ve claude.ai seçeneğini seçin. Ortamınızda ANTHROPIC_API_KEY ayarlanmışsa, kaldırın.
• Team veya Enterprise yöneticiniz etkinleştirmemiş: Remote Control, bu planlarda varsayılan olarak kapalıdır. Bir yönetici, claude.ai/admin-settings/claude-code adresinde Remote Control seçeneğini açarak etkinleştirebilir. Bu, sunucu tarafı bir kuruluş ayarıdır.
• Yönetici seçeneği gri: Kuruluşunuzun Remote Control ile uyumlu olmayan bir veri saklama veya uyumluluk yapılandırması var. Bu, yönetici panelinden değiştirilemez. Seçenekleri görüşmek için Anthropic desteğine başvurun.
• Hata disableRemoteControl ifadesinden bahsediyor: BT yöneticiniz, kuruluş genelindeki seçenekten bağımsız olarak, yönetilen ayarlar aracılığıyla bu cihazda Remote Control'ü devre dışı bırakmış.

"Remote credentials fetch failed"

Claude Code, bağlantıyı kurmak için Anthropic API'sinden kısa ömürlü bir kimlik bilgisi alamadı. Tam hatayı görmek için --verbose ile yeniden çalıştırın:

claude remote-control --verbose

Yaygın nedenler:

• Giriş yapılmamış: claude komutunu çalıştırın ve /login ile claude.ai hesabınızla kimlik doğrulaması yapın. API anahtarı kimlik doğrulaması Remote Control için desteklenmez.
• Ağ veya proxy sorunu: Bir güvenlik duvarı veya proxy, giden HTTPS isteğini engelliyor olabilir. Remote Control, 443 numaralı bağlantı noktası üzerinden Anthropic API'sine erişim gerektirir.
• Oturum oluşturma başarısız: Ayrıca Session creation failed — see debug log hatasını görüyorsanız, başarısızlık kurulumun daha erken bir aşamasında gerçekleşmiştir. Aboneliğinizin aktif olduğunu kontrol edin.

Doğru Yaklaşımı Seçme (Choose the right approach)

Claude Code, terminalinizde olmadığınızda çalışmanın birkaç yolunu sunar. Bunlar, işi neyin tetiklediği, Claude'un nerede çalıştığı ve ne kadar kurulum gerektiği açısından farklılık gösterir.

İlgili Kaynaklar (Related resources)

• Claude Code on the web: Makineniz yerine Anthropic tarafından yönetilen bulut ortamlarında oturum çalıştırma
• Ultraplan: Terminalinizden bir bulut planlama oturumu başlatma ve planı tarayıcınızda inceleme
• Channels: Telegram, Discord veya iMessage'ı bir oturuma yönlendirerek Claude'un siz uzaktayken mesajlara tepki vermesini sağlama
• Dispatch: Telefonunuzdan bir görev mesajı gönderme ve bunun bir Masaüstü oturumu başlatmasını sağlama
• Authentication: /login kurulumu ve claude.ai için kimlik bilgilerini yönetme
• CLI reference: claude remote-control dahil tüm bayraklar ve komutlar
• Security: Remote Control oturumlarının Claude Code güvenlik modeline nasıl uyduğu
• Data usage: Yerel ve uzak oturumlar sırasında Anthropic API'sinden hangi verilerin geçtiği

Örnek kullanım senaryosu

Bir yazılım geliştiricisi olduğunuzu düşünün. Sabah ofiste, büyük bir özellik dalı (feature branch) üzerinde çalışıyorsunuz. Öğleden sonra evden çalışmaya geçeceksiniz ve yanınızda sadece tabletiniz var.

1. Sabah ofiste: Proje dizininize gidip claude remote-control --name "feature-x-refactor" komutunu çalıştırıyorsunuz. Terminalde sunucu modu başlıyor ve bir oturum URL'si ile QR kodu görüntüleniyor.

2. Çalışmaya başlama: Aynı terminalde normal Claude Code komutlarınızı yazıyorsunuz. Örneğin, "Refactor the authentication module to use the new API" diyerek bir görev başlatıyorsunuz. Claude, yerel dosyalarınızı okuyor, MCP sunucularınıza erişiyor ve kodu düzenlemeye başlıyor.

3. Öğle arası: Telefonunuzu çıkarıp Claude mobil uygulamasını açıyorsunuz. Code sekmesine dokunuyorsunuz. Oturum listesinde feature-x-refactor adlı oturumu görüyorsunuz (yeşil nokta, çevrimiçi olduğunu gösteriyor). Oturuma tıklıyorsunuz.

4. Mobil cihazdan devam: Telefonunuzda Claude'un yaptığı değişiklikleri görüyorsunuz. "Add unit tests for the new auth flow" yazıyorsunuz. Claude, ofisteki makinenizde çalışmaya devam ediyor ve test dosyalarını oluşturuyor. Tüm değişiklikler yerel dosya sisteminize yazılıyor.

5. Push bildirimi: Uzun süren bir test çalıştırması başlatıyorsunuz: "Run the test suite and notify me when done". Telefonunuzu cebinize koyup mutfağa gidiyorsunuz. Testler tamamlandığında telefonunuza bir push bildirimi geliyor: "Test suite completed: 42 passed, 3 failed."

6. Eve geçiş: Ofisten çıkarken dizüstü bilgisayarınızı kapatıyorsunuz. Eve geldiğinizde bilgisayarınızı açıyorsunuz. Remote Control otomatik olarak yeniden bağlanıyor. claude komutunu çalıştırdığınızda, konuşma geçmişinizin aynen kaldığını ve kaldığınız yerden devam edebildiğinizi görüyorsunuz.

Bu senaryoda hiçbir şey buluta taşınmıyor; tüm kod, MCP sunucuları ve araçlar yerel makinenizde kalıyor. Web ve mobil arayüzler yalnızca birer pencere görevi görüyor.