Claude Code, bugün mevcut olan en güçlü yapay zeka destekli kodlama asistanlarından biridir, ancak onu yerel bir konsol penceresinden kullanmanın gerçek sınırlamaları vardır: kurulu olduğu makineye bağlı kalırsınız, ona telefonunuzdan erişemezsiniz ve bir oturumu bir iş arkadaşınızla paylaşmanın kolay bir yolu yoktur.
sgcClaudeCodeRemote tüm bunları çözer. Claude Code'u web tabanlı bir terminalin içine saran ve masaüstünüzde, dizüstü bilgisayarınızda, tabletinizde veya telefonunuzda herhangi bir tarayıcıdan bağlanmanıza olanak tanıyan hafif bir Windows sunucusudur. Arka planda, gerçek bir terminal oturumu için Windows ConPTY sözde konsol (pseudo-console) API'sini ve terminal G/Ç'sini gerçek zamanlı olarak tarayıcıya aktarmak için sgcWebSockets kullanır.
Bu makale, özellikleri, yapılandırma seçeneklerini ve Claude Code'u doğrudan konsoldan çalıştırmaya kıyasla avantajları kapsamaktadır.
Claude Code Neden Uzaktan Kullanılır?
sgcClaudeCodeRemote, geliştiricilerin Claude Code ile konsolda çalışırken karşılaştıkları en yaygın zorluk noktalarını ele alır.
|
Herhangi Bir Cihazdan Erişim Telefonunuzda, tabletinizde veya dizüstü bilgisayarınızda bir tarayıcı açın ve geliştirme makinenizde çalışan Claude Code'a bağlanın. Node.js yok, CLI kurulumu yok — yalnızca bir URL. |
İşbirlikçi Oturumlar Birden fazla geliştirici aynı adlandırılmış oturuma katılabilir ve Claude'un çıktısını gerçek zamanlı olarak görebilir. Yerleşik eşli programlama — ekran paylaşım araçlarına gerek yok. |
Varsayılan Olarak Güvenli Kaba kuvvet (brute-force) korumalı parola kimlik doğrulaması, yapılandırılabilir zaman aşımları, IP engelleme ve internete açık dağıtımlar için isteğe bağlı TLS 1.3 şifrelemesi. |
Mobil Dostu Terminal
Web arayüzü, mobil cihazlarda çalışacak şekilde tasarlanmıştır. Ekranın altındaki dokunma için optimize edilmiş tuş araç çubuğu, Claude Code'un ihtiyaç duyduğu ancak mobil klavyelerde bulunmayan özel tuşları sağlar:
| Düğme | İşlev |
|---|---|
| Esc | Mevcut işlemi iptal eder veya geri döner |
| Tab | Önerileri ve otomatik tamamlamayı kabul eder |
| Intro | Girişi onaylar (Enter tuşu) |
| Ctrl | Yapışkan değiştirici — bir kez dokunun, ardından Ctrl+C (kesme) gibi kombinasyonlar için bir harfe dokunun |
| ↑ ↓ ← → | Komut geçmişinde ve menülerde gezinir |
Araç çubuğu, dokunmatik ekranlarda anında yanıt için pointerdown olaylarını kullanır ve odak çalmayı önleyerek terminalin etkin kalmasını sağlar. Görünüm alanı (viewport), dinamik görünüm alanı birimlerini (dvh) kullanarak mobil tarayıcı çerçevesine uyum sağlar ve araç çubuğunun kaydırma yapmadan her zaman görünür olmasını güvence altına alır.
Adlandırılmış Oturumlar
Her bağlantı bir oturum adı belirtebilir (örneğin “backend-refactor”, “devops”, “testing”). Oturumlar sunucunun ömrü boyunca kalıcı olur, böylece bağlantıyı kesip daha sonra aynı Claude Code örneğine yeniden bağlanabilirsiniz.
- Çok istemcili oturumlar. Birden fazla tarayıcı aynı anda aynı oturuma katılabilir — herkes aynı terminal çıktısını görür ve aynı konsola yazabilir.
- Oturum geçmişi. Tarayıcı, en son 10 oturumunuzu localStorage'da hatırlar ve hızlıca yeniden bağlanmak için bir açılır menü sunar.
- Oturum göstergesi. Etkin oturum adı, kimlik doğrulamasından sonra başlık çubuğunda görüntülenir.
Kimlik Doğrulama ve Güvenlik
sgcClaudeCodeRemote, kutudan çıktığı haliyle birden fazla koruma katmanı içerir:
|
Parola Kimlik Doğrulaması Tek bir paylaşılan parola erişimi korur. Kullanıcı adı gerekmez — yalnızca parola. Giriş formu, yanlışlıkla kaydetmeyi önlemek için tarayıcının kimlik bilgisi otomatik tamamlamasını devre dışı bırakır. |
Kaba Kuvvet Koruması Aynı IP'den yapılan 5 başarısız denemeden sonra, o adres 5 dakika boyunca engellenir. Engellenen IP'ler, daha fazla işlem yapılmadan önce bağlantı düzeyinde reddedilir. |
|
Kimlik Doğrulama Zaman Aşımı İstemciler, yapılandırılabilir bir süre içinde (varsayılan 15 saniye) kimlik doğrulaması yapmalıdır. Kimlik bilgisi göndermeyen boştaki bağlantılar otomatik olarak kesilir. |
TLS 1.3 Şifrelemesi İnternete açık dağıtımlar için, bir sertifika ve anahtar dosyasıyla TLS'yi etkinleştirin. Tarayıcı ile sunucu arasındaki tüm trafik uçtan uca şifrelenir. |
İzin istemlerini atlama. Giriş ekranındaki bir onay kutusu (varsayılan olarak işaretli) Claude Code'u --dangerously-skip-permissions bayrağıyla başlatır. Bu, sunucu konsolundaki izin iletişim kutularıyla etkileşime giremediğiniz uzak oturumlar için gereklidir.
sgcClaudeCodeRemote ile Konsol Claude Code Karşılaştırması
Claude Code'u yerel olarak çalıştırmaya karşı sgcClaudeCodeRemote üzerinden çalıştırmanın yan yana karşılaştırması.
| Özellik | Konsol | sgcClaudeCodeRemote |
|---|---|---|
| Herhangi bir cihazdan erişim | No | Yes |
| Mobil / tablet desteği | No | Evet (dokunmatik araç çubuğu) |
| Aynı oturumda birden fazla kullanıcı | No | Yes |
| Adlandırılmış kalıcı oturumlar | No | Yes |
| Parola koruması | No | Evet (kaba kuvvet engelleme) |
| TLS şifrelemesi | N/A | TLS 1.3 |
| Gerekli istemci yazılımı | Node.js + CLI | Yalnızca bir tarayıcı |
| Eşli programlama | Harici araçlar | Yerleşik |
| Gerçek zamanlı gecikme göstergesi | No | Yes |
| İstemci platformları | Yalnızca aynı makine | Windows, macOS, Linux, Android, iOS |
Başlarken
sgcClaudeCodeRemote'u indirin ve komut satırından bir parola ile çalıştırın:
sgcClaudeCodeRemote.exe --password MySecretPasswordArdından tarayıcınızı açın ve http://your-server-ip:8765/ adresine gidin. Parolayı girin, bir oturum adı seçin ve içeridesiniz.
Örnekler
Daha yüksek bağlantı sınırına sahip özel bağlantı noktası:
sgcClaudeCodeRemote.exe --port 9000 --password MyPass --max-conn 20İnternet üzerinden güvenli erişim için TLS şifrelemesiyle:
sgcClaudeCodeRemote.exe --tls --tls-cert cert.pem --tls-key key.pem --password MyPassKomut Satırı Seçenekleri
| Seçenek | Açıklama | Varsayılan |
|---|---|---|
--port |
Sunucunun dinleme bağlantı noktası | 8765 |
--password |
Erişim parolası (kimlik doğrulama etkinken zorunlu) | — |
--command |
Terminalde çalıştırılacak komut | claude |
--cols / --rows |
Başlangıç terminal boyutları | 120 × 40 |
--max-conn |
Maksimum eşzamanlı bağlantı sayısı | 10 |
--timeout |
Saniye cinsinden kimlik doğrulama zaman aşımı | 15 |
--no-auth |
Kimlik doğrulamayı tamamen devre dışı bırakır | — |
--tls |
TLS 1.3 şifrelemesini etkinleştirir | — |
--tls-cert / --tls-key |
Sertifika ve özel anahtar PEM dosyaları | — |
--tls-password |
Özel anahtar parolası (şifrelenmişse) | — |
--tls-port |
TLS dinleme bağlantı noktası | --port ile aynı |
Kullanım Senaryoları
- Telefonunuzdan çalışın. Kodu inceleyin, Claude'a sorular sorun veya herhangi bir yerden komut çalıştırın — koltukta, trende veya bir kafede.
- Ekip işbirliği. Birden fazla geliştirici aynı oturuma bağlanır ve Claude ile gerçek zamanlı olarak etkileşime girer. Ekran paylaşımına gerek yok.
- Başsız (headless) derleme sunucuları. Claude Code'u güçlü bir uzak makinede çalıştırın ve ona ince bir istemciden veya terminalsiz bir ortamdan erişin.
- Demolar ve sunumlar. İzleyicilerinizle bir oturum URL'si paylaşın. Herkes aynı canlı terminali görür ve takip eder.
- Güvenli uzaktan erişim. TLS'yi etkinleştirin, güçlü bir parola belirleyin ve Claude Code'u herhangi bir konumdan internet üzerinden güvenli bir şekilde kullanın.
Nasıl Çalışır
sgcClaudeCodeRemote, üç temel teknoloji üzerine kurulu bir Delphi konsol uygulamasıdır:
|
Windows ConPTY Windows 10 sözde konsol (pseudo-console) API'si, tam VT100/ANSI dizisi desteğiyle gerçek bir terminal oturumu oluşturur. Claude Code, normal bir terminal penceresindeki gibi tam olarak bu konsolun içinde çalışır. |
sgcWebSockets sgcWebSockets kütüphanesi tüm WebSocket iletişimini, HTTP sunumunu ve isteğe bağlı TLS şifrelemesini yönetir. İkili (binary) çerçeveler terminal çıktısını taşır; JSON metin çerçeveleri kimlik doğrulama ve kontrol mesajlarını yönetir. |
xterm.js Tarayıcı, terminali fit eklentisi (pencereye otomatik yeniden boyutlandırma) ve web-links eklentisi (tıklanabilir URL'ler) ile xterm.js kullanarak oluşturur. Koyu tema, Claude Code estetiğiyle uyumludur. |
Sistem gereksinimleri. Sunucu, Windows 10 sürüm 1809 veya üzerini (ConPTY desteği için) ve ana makinede kurulu Claude Code gerektirir. İstemcilerin yalnızca modern bir web tarayıcısına ihtiyacı vardır.
Web Arayüzü Özellikleri
Tek sayfalık web kullanıcı arayüzü doğrudan yürütülebilir dosyaya gömülüdür — dağıtılacak harici dosya yoktur. Şunları içerir:
- Durum göstergesi. Bir nabız animasyonuna sahip renk kodlu rozet (yeşil = bağlı, kırmızı = bağlantı kesildi, mavi = giriş gerekli, sarı = bağlanıyor).
- Gerçek zamanlı gecikme. Her çerçevede güncellenen, milisaniye cinsinden gidiş-dönüş gecikmesini görüntüler.
- Terminal boyutları. Mevcut sütun × satır sayısını gösterir ve yeniden boyutlandırmada dinamik olarak güncellenir.
- Fit düğmesi. Terminali tarayıcı penceresini dolduracak şekilde anında yeniden boyutlandırır.
- Kopyala ve yapıştır. Tam pano desteği — Ctrl+C seçili metni kopyalar, Ctrl+V terminale yapıştırır.
- Otomatik yeniden bağlanma. Bağlantı kesilirse, istemci 3 saniye sonra otomatik olarak yeniden bağlanmayı dener.
- 10.000 satırlık geri kaydırma. Herhangi bir geçmişi kaybetmeden önceki Claude Code çıktısını incelemek için yukarı kaydırın.
sgcClaudeCodeRemote, sgcWebSockets ile oluşturulmuştur — Delphi ve .NET için yüksek performanslı WebSocket bileşenleri.