Beş dakikada kurun

Bu kılavuz telefonunuza Collie kurulumunu yapar. Bilgisayarınıza üç araç kurun, Collie uygulamasını başlatın ve telefonunuzu eşleyin.

Önerilen kurulumu kullanır: ön kapı olarak Tailscale, çoğullayıcı olarak Herdr ve kurulum betiği. Diğer kurulumlar için Yükleme bölümüne bakın.

Not. Collie, tasarımı gereği makinenize uzaktan kabuk erişimi sağlar. Kurmadan önce Güvenlik belgesini okuyun.

Gereksinimler

• —
  Bir Linux veya macOS bilgisayar (ana makine). Mac için Apple Silicon ve macOS 13 veya daha yenisi gerekir.
• —
  Bir iPhone veya Android telefon.
• —
  Bir Tailscale hesabı.

1. Tailscale uygulamasını kurun

Tailscale, ana makineyi ve telefonunuzu tek bir özel ağda, tailnet ağınızda birbirine bağlar. Collie uygulamasına yalnızca bu ağ üzerinden erişilebilir.

Bir Linux ana makinesinde:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up --operator=$USER

--operator=$USER, Collie uygulamasının 4. adımda ihtiyaç duyduğu tailscale serve komutunu kullanıcınızın çalıştırmasına izin verir.

Bir Mac üzerinde, tailscale.com/download adresinden Tailscale uygulamasını kurun ve oturum açın. Uygulama ayarlarından tailscale komutunu kurun. Collie bu komutu çağırır.

Ardından tailnet ağını ve telefonu ayarlayın:

1. 01
   yönetici konsolu sayfasını açın ve HTTPS'i etkinleştirin seçeneğini belirleyin. Collie bunu gerektirir.
2. 02
   Telefonunuza Tailscale uygulamasını kurun. Aynı hesapla oturum açın.

2. Herdr uygulamasını kurun

Herdr, bağlantınız kesildiğinde ana makinedeki terminal panellerini ve kodlama ajanlarını çalışır durumda tutar. Collie bu panelleri telefonunuzda gösterir.

curl -fsSL https://herdr.dev/install.sh | sh    # or: brew install herdr
herdr

Herdr bir panel açar. Ajanınızı orada başlatın, örneğin claude. Herdr uygulamasını çalışır durumda bırakın.

3. Collie uygulamasını kurun

Ana makinede ikinci bir terminal açın ve kurulum betiğini çalıştırın:

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

Betik, collie ikili dosyasını ~/.local/bin dizinine kaydeder. sudo kullanmaz. Kabuğunuz collie komutunu bulamazsa, ~/.local/bin dizinini PATH ortam değişkeninize ekleyin. Ayrıntılar Standalone bölümünde yer almaktadır.

4. Collie uygulamasını başlatın

COLLIE_MUX=herdr collie start

start, Collie uygulamasını arka planda çalıştırır ve tailscale serve ile tailnet ağınızda kullanıma sunar. Çoğullayıcı olarak herdr kaydeder. Sonraki çalıştırmalarda yalnızca collie start gerekir. Hazır olduğunda Collie çalışıyor yazdırır ve tailnet satırında URL adresinizi gösterir, örneğin https://myhost.tail1234.ts.net.

SSH ile erişilen uzak bir Linux ana makinesinde, oturumu kapattıktan sonra Collie uygulamasının çalışmaya devam etmesini sağlayın:

loginctl enable-linger $USER

5. Collie uygulamasını telefonunuza yükleyin ve eşleyin

collie qr

1. 01
   Collie'yi tarayıcıda açmak için telefonunuzun kamerasıyla QR kodunu tarayın.
2. 02
   Bir uygulama gibi tam ekran açılması için Collie'yi ana ekranınıza ekleyin. - iPhone: Safari'de Paylaş simgesine, ardından Ana Ekrana Ekle ve Ekle seçeneklerine dokunun. - Android: Chrome'da Collie Ayarlar sayfasını açın ve üst karttaki Yükleme seçeneğine dokunun.
3. 03
   Yeni simgeden Collie'yi açın.
4. 04
   10 dakika geçerli olan 8 karakterlik bir kod yazdırmak için ana makinede collie pair komutunu çalıştırın.
5. 05
   Collie içinde Ayarlar → Sistem → Eşlenen cihazlar bölümünü açın.
6. 06
   Kodu ve örneğin my phone gibi bir ad girin, ardından Bu cihazı eşle seçeneğine dokunun.

Eşlemeyi tarayıcı sekmesinde değil, ana ekran uygulamasında yapın. iPhone'da ana ekran uygulaması, Safari'den ayrı olarak kendi depolama alanını tutar. Safari'de yapılan bir eşleme buraya aktarılmaz.

Bir cihaz eşlendiğinde yalnızca eşlenen cihazlar panellerinize yazabilir. O zamana kadar tailnet ağınızdaki herhangi bir cihaz yazabilir. start sonrasında hemen eşleyin. Başka kişilerle paylaşılan bir tailnet üzerinde COLLIE_TRUSTED_USER (Yapılandırma) ayarını da yapın.

Kontrol paneli Herdr panellerinizi listeler. Girdi bekleyen paneller ilk sırada görünür. Çıktıyı görüntülemek ve yanıt vermek için bir panele dokunun.

Sonraki adımlar

• —
  Telefonunuzda tmux veya Herdr içinde Claude Code, Claude Code ile tam bir günlük kullanımı adım adım açıklar.
• —
  Web Push, bir agent girdi gerektirdiğinde bildirim ekler.
• —
  Yapılandırma, Collie'nin COLLIE_TRUSTED_USER ile tailnet kullanıcınıza nasıl sınırlandırılacağını belgeler.
• —
  Sorun giderme sık karşılaşılan hataları ele alır.