Claude Code to jeden z najpotężniejszych asystentów programistycznych opartych na AI dostępnych obecnie, ale korzystanie z niego z lokalnego okna konsoli ma poważne ograniczenia: jesteś przywiązany do maszyny, na której jest zainstalowany, nie możesz uzyskać do niego dostępu ze swojego telefonu, a udostępnienie sesji współpracownikowi jest trudne.
sgcClaudeCodeRemote rozwiązuje wszystkie te problemy. To lekki serwer dla systemu Windows, który opakowuje Claude Code w terminal sieciowy, umożliwiając połączenie z dowolnej przeglądarki — na komputerze stacjonarnym, laptopie, tablecie lub telefonie. Wewnętrznie używa API pseudo-konsoli Windows ConPTY do obsługi prawdziwej sesji terminalowej oraz biblioteki sgcWebSockets do przesyłania strumieniowego wejścia/wyjścia terminala do przeglądarki w czasie rzeczywistym.
Ten artykuł omawia funkcje, opcje konfiguracji oraz zalety w porównaniu z uruchamianiem Claude Code bezpośrednio z konsoli.
Dlaczego warto używać Claude Code zdalnie?
sgcClaudeCodeRemote rozwiązuje najczęstsze problemy, z którymi programiści borykają się podczas pracy z Claude Code w konsoli.
|
Dostęp z dowolnego urządzenia Otwórz przeglądarkę na telefonie, tablecie lub laptopie i połącz się z Claude Code uruchomionym na swojej maszynie deweloperskiej. Bez Node.js, bez instalacji CLI — wystarczy adres URL. |
Sesje współpracy Wielu programistów może dołączyć do tej samej nazwanej sesji i widzieć dane wyjściowe Claude w czasie rzeczywistym. Wbudowane programowanie w parach — bez potrzeby używania narzędzi do udostępniania ekranu. |
Bezpieczny domyślnie Uwierzytelnianie hasłem z ochroną przed atakami brute-force, konfigurowalne limity czasu, blokowanie adresów IP i opcjonalne szyfrowanie TLS 1.3 dla wdrożeń dostępnych przez internet. |
Terminal przyjazny dla urządzeń mobilnych
Interfejs webowy jest zaprojektowany do pracy na urządzeniach mobilnych. Zoptymalizowany dotykowy pasek klawiszy na dole ekranu udostępnia specjalne klawisze wymagane przez Claude Code, których brakuje na klawiaturach mobilnych:
| Przycisk | Funkcja |
|---|---|
| Esc | Anuluj bieżącą operację lub wróć |
| Tab | Akceptuj sugestie i autouzupełnianie |
| Intro | Potwierdź wprowadzenie (klawisz Enter) |
| Ctrl | Trwały modyfikator — dotknij raz, a następnie dotknij litery, aby wykonać kombinacje takie jak Ctrl+C (przerwanie) |
| ↑ ↓ ← → | Nawiguj po historii poleceń i menu |
Pasek narzędzi używa zdarzeń pointerdown dla natychmiastowej odpowiedzi na ekranach dotykowych i zapobiega przechwytywaniu fokusu, dzięki czemu terminal pozostaje aktywny. Widok dostosowuje się do chrome mobilnej przeglądarki za pomocą dynamicznych jednostek widoku (dvh), zapewniając, że pasek jest zawsze widoczny bez przewijania.
Nazwane sesje
Każde połączenie może określić nazwę sesji (np. “backend-refactor”, “devops”, “testing”). Sesje utrzymują się przez cały czas działania serwera, więc możesz się rozłączyć i ponownie połączyć do tej samej instancji Claude Code.
- Sesje wieloklientowe. Wiele przeglądarek może jednocześnie dołączyć do tej samej sesji — każdy widzi te same dane wyjściowe terminala i może wpisywać do tej samej konsoli.
- Historia sesji. Przeglądarka zapamiętuje 10 ostatnich sesji w localStorage, z listą rozwijaną do szybkiego ponownego połączenia.
- Wskaźnik sesji. Aktywna nazwa sesji jest wyświetlana na pasku nagłówka po uwierzytelnieniu.
Uwierzytelnianie i bezpieczeństwo
sgcClaudeCodeRemote zawiera wiele warstw ochrony w standardzie:
|
Uwierzytelnianie hasłem Dostęp jest chroniony jednym wspólnym hasłem. Nazwa użytkownika nie jest wymagana — wystarczy hasło. Formularz logowania wyłącza autouzupełnianie danych uwierzytelniających przeglądarki, aby zapobiec przypadkowemu zapisaniu. |
Ochrona przed atakami brute-force Po 5 nieudanych próbach z tego samego adresu IP jest on blokowany na 5 minut. Zablokowane adresy IP są odrzucane na poziomie połączenia przed dalszym przetwarzaniem. |
|
Limit czasu uwierzytelniania Klienci muszą uwierzytelnić się w konfigurowalnym oknie czasowym (domyślnie 15 sekund). Bezczynne połączenia, które nie wysyłają poświadczeń, są automatycznie rozłączane. |
Szyfrowanie TLS 1.3 W przypadku wdrożeń dostępnych przez internet włącz TLS z plikiem certyfikatu i kluczem. Cały ruch między przeglądarką a serwerem jest szyfrowany end-to-end. |
Pomijanie monitów o uprawnienia. Pole wyboru na ekranie logowania (domyślnie zaznaczone) uruchamia Claude Code z flagą --dangerously-skip-permissions. Jest to niezbędne w przypadku sesji zdalnych, gdzie nie możesz wchodzić w interakcję z oknami dialogowymi uprawnień na konsoli serwera.
sgcClaudeCodeRemote kontra Claude Code w konsoli
Porównanie uruchamiania Claude Code lokalnie z używaniem sgcClaudeCodeRemote.
| Funkcja | Konsola | sgcClaudeCodeRemote |
|---|---|---|
| Dostęp z dowolnego urządzenia | Nie | Tak |
| Obsługa urządzeń mobilnych/tabletów | Nie | Tak (dotykowy pasek klawiszy) |
| Wielu użytkowników w tej samej sesji | Nie | Tak |
| Nazwane trwałe sesje | Nie | Tak |
| Ochrona hasłem | Nie | Tak (blokowanie brute-force) |
| Szyfrowanie TLS | Nie dot. | TLS 1.3 |
| Wymagane oprogramowanie klienta | Node.js + CLI | Tylko przeglądarka |
| Programowanie w parach | Zewnętrzne narzędzia | Wbudowane |
| Wyświetlanie opóźnienia w czasie rzeczywistym | Nie | Tak |
| Platformy klienta | Tylko ta sama maszyna | Windows, macOS, Linux, Android, iOS |
Pierwsze kroki
Pobierz sgcClaudeCodeRemote i uruchom z wiersza poleceń podając hasło:
sgcClaudeCodeRemote.exe --password MySecretPasswordNastępnie otwórz przeglądarkę i przejdź do http://adres-ip-serwera:8765/. Wpisz hasło, wybierz nazwę sesji i gotowe.
Przykłady
Niestandardowy port z wyższym limitem połączeń:
sgcClaudeCodeRemote.exe --port 9000 --password MyPass --max-conn 20Z szyfrowaniem TLS dla bezpiecznego dostępu przez internet:
sgcClaudeCodeRemote.exe --tls --tls-cert cert.pem --tls-key key.pem --password MyPassOpcje wiersza poleceń
| Opcja | Opis | Domyślnie |
|---|---|---|
--port |
Port nasłuchiwania serwera | 8765 |
--password |
Hasło dostępu (wymagane, gdy auth jest włączone) | — |
--command |
Polecenie do uruchomienia w terminalu | claude |
--cols / --rows |
Początkowe wymiary terminala | 120 × 40 |
--max-conn |
Maksymalna liczba jednoczesnych połączeń | 10 |
--timeout |
Limit czasu uwierzytelniania w sekundach | 15 |
--no-auth |
Całkowite wyłączenie uwierzytelniania | — |
--tls |
Włącz szyfrowanie TLS 1.3 | — |
--tls-cert / --tls-key |
Pliki PEM certyfikatu i klucza prywatnego | — |
--tls-password |
Hasło klucza prywatnego (jeśli zaszyfrowany) | — |
--tls-port |
Port nasłuchiwania TLS | Taki sam jak --port |
Przypadki użycia
- Praca z telefonu. Przeglądaj kod, zadawaj pytania Claude lub uruchamiaj polecenia z dowolnego miejsca — z kanapy, w pociągu lub w kawiarni.
- Współpraca zespołowa. Wielu programistów łączy się z tą samą sesją i współpracuje z Claude w czasie rzeczywistym. Bez udostępniania ekranu.
- Bezgłowe serwery budowania. Uruchom Claude Code na wydajnej zdalnej maszynie i uzyskuj do niego dostęp z cienkiego klienta lub środowiska bez terminala.
- Dema i prezentacje. Udostępnij adres URL sesji odbiorcom. Wszyscy widzą ten sam działający terminal i mogą śledzić.
- Bezpieczny zdalny dostęp. Włącz TLS, ustaw silne hasło i bezpiecznie używaj Claude Code przez internet z dowolnego miejsca.
Jak to działa
sgcClaudeCodeRemote to aplikacja konsolowa Delphi zbudowana na trzech podstawowych technologiach:
|
Windows ConPTY API pseudo-konsoli Windows 10 tworzy prawdziwą sesję terminalową z pełną obsługą sekwencji VT100/ANSI. Claude Code działa wewnątrz tej konsoli dokładnie tak, jak w normalnym oknie terminala. |
sgcWebSockets Biblioteka sgcWebSockets obsługuje całą komunikację WebSocket, serwowanie HTTP i opcjonalne szyfrowanie TLS. Ramki binarne przenoszą dane wyjściowe terminala; ramki tekstowe JSON obsługują uwierzytelnianie i komunikaty sterujące. |
xterm.js Przeglądarka renderuje terminal przy użyciu xterm.js z dodatkiem fit (automatyczne dopasowanie do okna) i dodatkiem web-links (klikalne adresy URL). Ciemny motyw pasuje do estetyki Claude Code. |
Wymagania systemowe. Serwer wymaga systemu Windows 10 w wersji 1809 lub nowszej (obsługa ConPTY) oraz zainstalowanego Claude Code na maszynie hosta. Klienci potrzebują jedynie nowoczesnej przeglądarki internetowej.
Funkcje interfejsu webowego
Jednostronicowy interfejs webowy jest bezpośrednio osadzony w pliku wykonywalnym — bez zewnętrznych plików do wdrożenia. Zawiera:
- Wskaźnik statusu. Kolorowa odznaka (zielona = połączony, czerwona = rozłączony, niebieska = wymagane logowanie, bursztynowa = łączenie) z animacją pulsu.
- Opóźnienie w czasie rzeczywistym. Wyświetla opóźnienie w obie strony w milisekundach, aktualizowane przy każdej ramce.
- Wymiary terminala. Pokazuje bieżące kolumny × wiersze i aktualizuje dynamicznie przy zmianie rozmiaru.
- Przycisk dopasowania. Natychmiast zmienia rozmiar terminala, aby wypełnił okno przeglądarki.
- Kopiowanie i wklejanie. Pełna obsługa schowka — Ctrl+C kopiuje zaznaczony tekst, Ctrl+V wkleja do terminala.
- Automatyczne ponowne połączenie. Jeśli połączenie zostanie przerwane, klient automatycznie próbuje ponownie nawiązać połączenie po 3 sekundach.
- 10 000 linii przewijania wstecz. Przewijaj w górę, aby przejrzeć poprzednie dane wyjściowe Claude Code bez utraty historii.
sgcClaudeCodeRemote jest zbudowany przy użyciu sgcWebSockets — wysokowydajnych komponentów WebSocket dla Delphi i .NET.