Claude Code uygulamasını tmux veya Herdr içinde çalıştırın ve telefonunuzdan kontrol edin

SSH bağlantısı kopar ve Claude Code onunla birlikte sonlanır. Telefon terminali klavyesinde Esc ve Ctrl tuşları bulunmaz. Bir saat sonra geri döndüğünüzde Claude Code, onay bekleyen bir istemde tüm bu süre boyunca boşta kalmıştır.

Bu kılavuz her üç sorunu da çözer. Claude Code uygulamasını kopan bağlantılardan etkilenmemesi için tmux veya Herdr içinde çalıştırın. Ardından bekleyen oturumları telefonunuzda önceliklendirmek ve eksik tuşları sağlamak için Collie ekleyin.

Claude Code uygulamasını tmux içinde çalışır durumda tutun

Claude Code uygulamasını bir tmux oturumu içinde başlatın. Bağlantınız koptuğunda ana makinede çalışmaya devam eder.

tmux new -s claude       # start a session named claude
claude                   # run Claude Code inside it

Ctrl+b, ardından d ile ayrılın. Daha sonra herhangi bir makineden giriş yapın ve yeniden bağlanın:

tmux attach -t claude

Oturumun sahibi SSH girişiniz yerine tmux sunucusudur; bu nedenle bağlantının kopması Claude Code uygulamasını durdurmaz. Ana makinedeki oturumları listelemek için tmux ls komutunu çalıştırın.

Herdr

Herdr, kodlama ajanları için geliştirilmiş bir terminal çalışma alanı yöneticisidir. Aynı şekilde çalışır.

curl -fsSL https://herdr.dev/install.sh | sh    # or: brew install herdr
herdr                                           # start Herdr, or reattach to it
claude                                          # in the pane Herdr opens

Ctrl+b, ardından q ile ayrılın veya terminali kapatın. Herdr sunucusu panellerinizi ve Claude Code uygulamasını çalışır durumda tutar. Yeniden bağlanmak için herdr komutunu tekrar çalıştırın.

zellij

zellij -s claude komutunu çalıştırın, claude başlatın, Ctrl o ardından d ile ayrılın ve zellij attach claude ile yeniden bağlanın. Collie yalnızca tek bir zellij oturumunu yansıtır. Bkz. zellij notları.

Aynı anda birden fazla Claude Code oturumu çalıştırın

İki ajanın aynı dosyaları düzenlememesi için her oturuma kendi penceresini ve checkout kopyasını verin.

# a second checkout, on its own branch
git worktree add ~/src/app-review -b review
tmux new-window -t claude -n review -c ~/src/app-review
claude                                     # in the new window

tmux içinde, yeni bir pencere açmak için Ctrl+b ardından c tuşuna, bunları listelemek içinse Ctrl+b ardından w tuşuna basın. Bir paneli sağa ve sola bölmek için Ctrl+b ardından % tuşuna, üst ve alt olarak bölmek içinse Ctrl+b ardından " tuşuna basın.

Herdr üzerinde, Herdr çalışırken her ajana kendi çalışma alanını verin:

herdr workspace create --label review --cwd ~/src/app-review

Birden fazla oturum çalıştırmak, bekleyen birden fazla istem oluşturur. Collie, girdi gerektiren panelleri gösterge panelinin en üstüne yerleştirir; kalan paneller ise çalışma alanına göre gruplandırılır. O paneli en üste sabitlemek için bir satırı basılı tutun. tmux ve zellij üzerinde bu sıralama, 3. adım içindeki beacon kancalarını gerektirir.

Collie ile telefonunuzdan yönetin

Collie ana makinenizde çalışır ve Herdr, tmux veya zellij panellerinizi telefonunuzun tarayıcısına yansıtır. Aynı adımlar Codex, OpenCode ve diğer tüm terminal ajanları için de geçerlidir. Yalnızca paneldeki komut değişir.

Not. Collie, tasarımı gereği makinenize uzaktan kabuk erişimi sağlar. Yüklemeden önce Güvenlik bölümünü okuyun.

• —
  Claude Code, ana makinenizde bir Herdr, tmux veya zellij panelinde çalışır. Telefonda hiçbir ajan kodu çalışmaz.
• —
  Telefonunuz, tailnet ağınız üzerinden bir tarayıcıda Collie uygulamasını açar. Gösterge paneli panelleri listeler ve bekleyen oturumları ilk sıraya koyar.
• —
  Çıktıları okur, yanıtları gönderir ve Keys tepsisinden Esc, Tab, yön tuşları veya niteleyici tuşları gönderirsiniz. Bir SSH istemcisine ihtiyacınız yoktur.
• —
  İsteğe bağlı anlık bildirimler, bir ajan girdi beklediğinde sizi uyarır.

Gereksinimler

• —
  Claude Code yüklü bir Linux veya macOS ana makinesi.
• —
  Bir terminal çoklayıcı: Herdr, tmux veya zellij. Herdr ajanları doğrudan algılar. tmux ve zellij üzerinde Collie, Linux gerektiren beacon kancalarını kullanır.
• —
  Ana makinede ve telefonda Tailscale kurulu olmalı, tailnet üzerinde HTTPS etkinleştirilmelidir. Diğer kurulumlar için bkz. Dağıtım.
• —
  Bir iPhone veya Android telefon.

1. Collie'i kurun

curl -fsSL https://colliepwa.dev/install.sh | sh

Herdr üzerinde eklentiyi doğrudan kurabilirsiniz: herdr plugin install AltanS/collie. Yükleme her iki yöntemi de kapsar.

2. Başlatın

collie start

İlk çalıştırma Herdr, tmux ve zellij kontrolü yapar, ardından seçiminizi .env dosyasına yazar. tailscale serve başlatır ve bir tailnet URL'si yazdırır. Bkz. Başlatın.

3. Claude Code'u bir bölmede çalıştırın

Herdr üzerinde bir bölme açın ve claude çalıştırın. Herdr, bölmeyi Collie için bir ajan olarak işaretler.

tmux veya zellij üzerinde, sunucu başına bir kez beacon kancalarını kurun. Bu, Collie'nin ajanları düz kabuklardan ayırt etmesini sağlar. Ardından Collie'nin yansıttığı oturumda bir pencere veya sekme açın ve Claude Code'u başlatın:

collie hooks install claude    # once per host, Linux only
tmux new-window -n claude      # or: zellij action new-tab --name claude
claude

COLLIE_MUX_ENDPOINT_TMUX değerini ayarlamadığınız sürece Collie varsayılan tmux sunucusunu yansıtır. Yukarıdaki claude oturumu otomatik olarak görünür.

Çalışan Claude Code örnekleri ayarları otomatik olarak yeniden yüklemez. Kancaları kurduktan sonra Claude Code'u yeniden başlatın. Bkz. Collie kancaları Claude'un kendi ayarlarına yazar.

4. Telefonunuzda açın

Kodu taramak için ana makinede collie qr çalıştırın veya collie url içindeki bağlantıyı açın. Telefonu aynı tailnet üzerinde tutun.

1. 01
   Telefonu eşleyin. Ana makinede collie pair çalıştırın ve QR kodunu tarayın. Eşleme, telefona bölmelerinize yazma erişimi verir (Bir cihazı eşleyin).
2. 02
   Ana ekranınıza ekleyin. Android'de, Ayarlar'ın üst kısmındaki Yükleme öğesine dokunun. iPhone'da Safari'nin paylaşım sayfasına dokunun.

5. Claude Code'u yanıtlayın

• —
  Pano, girdi gerektiren bölmeleri en üste sıralar. Açmak için birine dokunun.
• —
  Düzenleyici standart bir metin alanı kullanır, bu nedenle telefonda sesle yazma burada çalışır.
• —
  Klavyenin üstündeki eylemler satırında Tuşlar öğesine dokunun. Çekmece Esc, ok tuşları, Enter, Tab, Space, değiştiriciler, basamaklar ve F1 - F12 tuşlarını içerir. Esc ve Ctrl kombinasyonları telefon klavyesine bağlı değildir.
• —
  Claude Code düğmeleri aynı satırda yer alır: Model, Effort, Compact ve Resume. Bkz. Yapılandırma.

6. Bildirim alın (isteğe bağlı)

collie push-keys     # writes the VAPID keys to your .env
collie restart

Telefonda Collie'nin Ayarlar bölümünden bildirimleri açın. Girdi gerekiyor varsayılan olarak etkindir. iPhone'da önce Collie'yi ana ekranınıza kurun. Safari, Web Push özelliğini ana ekran web uygulamalarıyla sınırlar. Bkz. Web Push.

Bir telefondan Claude Code'a erişmenin diğer yolları

• —
  Claude Code Remote Control, Claude uygulamasını veya claude.ai/code adresini makinenizdeki bir Claude Code oturumuna bağlar ve trafiği Anthropic API'si üzerinden geçer (Anthropic belgeleri). Collie bunun yerine terminal bölmelerini yansıtır, böylece çoğullayıcınızdaki herhangi bir ajanla çalışır ve tailnet'inizde kalır.
• —
  Termius, Moshi veya Termux gibi Bir SSH uygulaması tüm terminali gösterir. Bu yöntem çalışır, ancak mobil klavyelerdeki terminal kontrolleri kullanışsızdır. Esc, Ctrl ve ok tuşları geçici çözümler gerektirir.