# Claude Code Remote Control: kod QR i praca z telefonu

> Instrukcja krok po kroku, jak połączyć Claude Code z telefonem za pomocą /rc i kodu QR. Polecenia, ograniczenia, bezpieczeństwo i 6 częstych błędów przy pierwszym uruchomieniu.

Source: https://ailoot.ai/blog/pl/claude-code-remote-control-phone/
Canonical: https://ailoot.ai/blog/pl/claude-code-remote-control-phone/
Language: pl
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-052
Revision: sha256-6e5b3187ec25c48df3815c440e77360bcda1d3e9d638f184c35107b565be9efe


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

Najważniejsze informacje

Uruchom `claude --rc` w terminalu, naciśnij Spację i zeskanuj kod QR aplikacją Claude na telefonie. Sesja działa na laptopie, a telefon jest tylko oknem do niej. To przydatne podczas zadań wykonywanych przez noc i pracy z kanapy, ale nie nadaje się do poważnej edycji kodu. Potrzebujesz wersji v2.1.51 lub nowszej oraz subskrypcji Pro albo Max.

</div>



Więcej instrukcji znajdziesz w [dokumentacji Ailoot](https://ailoot.ai/docs/).

## Czym jest Remote Control i po co programować z telefonu?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

Najważniejsze informacje

Remote Control to pomost między Claude Code na laptopie a aplikacją Claude na telefonie lub przeglądarką claude.ai/code. Sesja działa na twoim komputerze, a telefon jest jedynie interfejsem do niej. Wykonywanie poleceń i lokalne narzędzia pozostają na Twoim komputerze; treść wiadomości i wyników narzędzi nadal przechodzi przez Anthropic. Przydaje się, gdy zlecisz długie zadanie i chcesz nadal nim kierować bez siedzenia przy laptopie.

</div>

Anthropic udostępniło Remote Control 24 lutego 2026 roku. Anthropic opisuje tę funkcję jako sposób na kontynuowanie lokalnych sesji z dowolnego urządzenia.

Mówiąc prosto: jak zwykle uruchamiasz sesję w terminalu. Włączasz Remote Control. Otwierasz aplikację Claude na telefonie → kartę Code → i widzisz sesję z zieloną kropką. Dotknij jej, przeczytaj i odpowiedz. Możesz pisać z laptopa, telefonu i przeglądarki w dowolnej kombinacji — wszystko jest zsynchronizowane.

[Oficjalna dokumentacja Remote Control](https://code.claude.com/docs/en/remote-control#connection-and-security) rozróżnia lokalne wykonywanie od ruchu sieciowego: polecenia i operacje na plikach wykonują się na Twoim komputerze, a rozmowa jest synchronizowana przez Anthropic.

To kluczowa różnica w porównaniu z Claude Code w przeglądarce, gdzie sesja działa na maszynie wirtualnej Anthropic w chmurze. Tutaj Claude nadal działa na twoim sprzęcie, z dostępem do wszystkich twoich repozytoriów Git, zmiennych środowiskowych i kluczy do baz danych. Telefon to tylko ekran, za pomocą którego rozmawiasz z Claude.

### Dlaczego osoba programująca w stylu vibe coding może tego potrzebować

Oto trzy praktyczne sytuacje, w których autor korzystał z tej funkcji co tydzień:

1.  **Długie refaktoryzowanie przez noc.** Zleć Claude aktualizację 40 plików pod nowe API. Odejdź od laptopa. Rano połóż się na kanapie z telefonem, przejrzyj różnice i napisz: „Zaakceptuj pierwszych 12; resztę pokaż osobno”. Nie musisz otwierać laptopa.
2.  **Zatwierdzenie kroku w drodze do pracy.** Jesteś w metrze, gdy Claude wysyła powiadomienie push: „Potrzebuję decyzji w sprawie migracji schematu”. Otwórz je, przeczytaj dwie możliwości i napisz: „Wybierz pierwszą opcję; nie ruszaj testów”. Sesja postępuje, gdy jedziesz.
3.  **Podczas transmisji na żywo lub spotkania.** W trakcie spotkania na Zoomie możesz sprawdzić na telefonie, czy druga sesja Claude zbudowała kompilację testową. Nie musisz przełączać się z rozmowy wideo.

## Czego potrzebujesz, aby uruchomić Remote Control

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

Najważniejsze informacje

Claude Code w wersji 2.1.51 lub nowszej oraz subskrypcja Pro, Max, Team albo Enterprise. Klucze API nie działają. Potrzebujesz sieci z dostępem wychodzącym przez port 443, bez przechwytujących proxy. Zaloguj się raz w terminalu przez claude.ai, używając `/login`, i możesz zaczynać. W przypadku Team/Enterprise administrator musi też włączyć tę opcję w ustawieniach organizacji.

</div>

Pełna tabela wymagań:

| Element | Minimalna wersja / wymaganie |
|----|----|
| Claude Code CLI | v2.1.51 (wydano 24.02.2026) |
| Rozszerzenie VS Code | v2.1.79 |
| Powiadomienia push | v2.1.110 |
| Subskrypcja | Pro, Max, Team albo Enterprise |
| Klucz API | Nie działa — tylko OAuth przez `/login` |
| Sieć | Wychodzące połączenie HTTPS przez port 443 |
| System operacyjny | macOS, Linux, WSL |
| Zaufanie do obszaru roboczego | Uruchom `claude` co najmniej raz w folderze projektu |
| Team/Enterprise | Administrator włączył Remote Control w ustawieniach administracyjnych |

Sprawdź wersję poleceniem:

```bash
claude --version
```

Jeśli jest niższa niż 2.1.51, zaktualizuj ją:

```bash
npm install -g @anthropic-ai/claude-code@latest
```

Jeśli w środowisku ustawiono `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` lub `apiKeyHelper`, Remote Control się nie uruchomi. Od wersji v2.1.139 (11.05.2026) Anthropic jawnie blokuje tę funkcję, gdy te zmienne są obecne. Uruchom `unset ANTHROPIC_API_KEY` i zaloguj się ponownie przez `/login`.

## Jak uruchomić Remote Control: 3 sposoby w 2 minuty

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

Najważniejsze informacje

Remote Control można uruchomić na trzy sposoby: samo polecenie `claude remote-control` uruchamia serwer sesji zdalnych; flaga `claude --rc` rozpoczyna zwykłą sesję z włączonym Remote Control; a polecenie ukośnikowe `/rc` w aktywnej sesji zmienia ją w zdalną. W przypadku większości zadań wygodniejszy jest drugi sposób.

</div>

### Sposób 1. Tryb serwera — dedykowany serwer sesji zdalnych

1.  #### Otwórz terminal w folderze projektu

    Uruchom `cd`, aby przejść do katalogu, w którym będziesz pracować. Jeśli to nowy folder, uruchom `claude` jak zwykle, aby ukończyć okno dialogowe Workspace Trust.

2.  #### Uruchom serwer

    ```bash
    claude remote-control
    ```

    Terminal pozostaje uruchomiony. Na dole pojawi się adres URL sesji i komunikat „Press space to show QR”. Serwer czeka na połączenia.

3.  #### Połącz się z telefonu

    Naciśnij Spację — pojawi się kod QR. Zeskanuj go aplikacją Claude lub aparatem iPhone’a, aby otworzyć sesję.

Opcjonalnie ustaw nazwę sesji i parametry:

```bash
claude remote-control --name "Refactor API" --spawn worktree --capacity 4
```

- `--name` — nazwa wyświetlana na telefonie na liście sesji.
- `--spawn worktree` — każda nowa sesja otwiera się we własnym Git worktree, aby sesje równoległe sobie nie przeszkadzały.
- `--capacity 4` — maksymalnie 4 jednoczesne sesje zdalne na serwerze. Wartość domyślna to 32.

### Sposób 2. Tryb interaktywny — moja sesja z włączonym Remote Control

```bash
claude --remote-control
# lub krócej:
claude --rc
```

Rozpoczyna to zwykłą interaktywną sesję w terminalu z włączonym Remote Control. Możesz pisać do Claude’a z laptopa i telefonu — rozmowa jest jedną zsynchronizowaną sesją.

W przeciwieństwie do trybu serwera jest to jedna sesja. Przydaje się, gdy planujesz pracować głównie na komputerze, a telefon ma być rozwiązaniem zapasowym, gdy musisz odejść.

### Sposób 3. Z aktywnej sesji za pomocą `/rc`

Już pracujesz w Claude Code? Nie kończ sesji. Po prostu wpisz:

```
/remote-control
```

albo krócej:

```
/rc
```

Sesja przechodzi w tryb zdalny. Nie stracisz jej kontekstu. Przydatne, gdy w trakcie zadania zorientujesz się, że musisz odejść.

## Kod QR: połącz telefon w 10 sekund

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

Najważniejsze informacje

Po uruchomieniu Remote Control w terminalu naciśnij Spację, aby wyświetlić kod QR. Otwórz aplikację Claude na telefonie (iOS lub Android) albo użyj samego aparatu i zeskanuj kod. Sesja otworzy się w aplikacji lub przeglądarce pod adresem claude.ai/code. Na tym samym ekranie w aplikacji sesja pojawi się na liście z zieloną kropką oznaczającą, że jest „online”.

</div>

1.  ### Zainstaluj aplikację Claude

    Jeśli jeszcze jej nie masz, wpisz `/mobile` w Claude Code. Pojawi się kod QR umożliwiający pobranie aplikacji z App Store lub Google Play. To szybsze niż ręczne wyszukiwanie.

2.  ### Wyświetl kod QR sesji w terminalu

    Po uruchomieniu `claude --rc` lub `claude remote-control` naciśnij **Spację**. Kod QR pojawi się bezpośrednio w terminalu.

3.  ### Zeskanuj kod telefonem

    Otwórz aplikację Claude → aparat albo użyj standardowego aparatu iPhone’a (aparaty Androida również mogą go skanować). Jeśli to nie działa, poszerz okno terminala, przełącz się na iTerm2 lub Windows Terminal albo skopiuj adres URL nad kodem QR i wklej go ręcznie do przeglądarki.

4.  ### Włącz powiadomienia push

    Wpisz `/config` w sesji i włącz „Push when Claude decides”. Claude Code musi być w wersji 2.1.110 lub nowszej.

### Co zobaczysz na telefonie

Otworzy się karta Code w aplikacji Claude. Sesja pojawi się na liście z ikoną komputera i zieloną kropką (online). Dotknij jej, aby wejść.

Potem działa to podobnie jak claude.ai/code: możesz oglądać wiadomości Claude’a i różnice w plikach, akceptować je lub odrzucać, a także prosić o zmiany. Możesz napisać nowe polecenie. Wszystko trafia na twoją maszynę, gdzie lokalny Claude przetwarza je i zwraca odpowiedź.

<figure>
<blockquote>
<p>Pracuj jednocześnie z obu interfejsów: rozmowa synchronizuje się między wszystkimi połączonymi urządzeniami — pisz z terminala, przeglądarki lub telefonu, jak ci wygodnie.</p>
</blockquote>
<figcaption>— Anthropic Docs, https://code.claude.com/docs/en/remote-control</figcaption>
</figure>

### Co Claude może robić z powiadomieniami push

Claude wysyła powiadomienia push, gdy uzna, że są potrzebne. Domyślnie dzieje się tak w dwóch przypadkach: po zakończeniu długiego zadania albo gdy Claude potrzebuje twojej decyzji. Możesz też poprosić wprost: „Powiadom mnie, gdy testy przejdą”, a Claude wyśle powiadomienie.

Jeśli powiadomienia push nie przychodzą:

- W iOS sprawdź Ustawienia → Powiadomienia → Claude. Tryby skupienia mogą je wyciszać.
- W Androidzie wyłącz optymalizację baterii dla aplikacji Claude.
- Jeśli `/config` wyświetla „No mobile registered”, otwórz aplikację Claude przynajmniej raz, aby zaktualizowała token push.

## Praca z kanapy: 5 przydatnych scenariuszy

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

Najważniejsze informacje

Prawdziwą zaletą Remote Control jest to, że nie musisz wracać do laptopa, by kliknąć pojedyncze zatwierdzenie. Nikt nie planuje pełnoprawnego programowania na telefonie. Oto pięć sytuacji, w których autor korzystał z tej funkcji co tydzień: przeglądanie nocnego zadania, zatwierdzenie kroku w metrze, długie zadanie podczas lunchu, decyzja architektoniczna z kawiarni i równoległe sesje w worktree.

</div>

### Scenariusz 1. Przegląd na kanapie — sprawdzenie nocnego zadania

Przed snem zleć Claude’owi zadanie, na przykład: „Uruchom nowe reguły lintowania w całym repozytorium i napraw wszystkie niekrytyczne problemy; resztę oznacz jako TODO”. Uruchom `claude --rc` i zostaw otwarty terminal.

Rano połóż się na kanapie z telefonem. Otwórz aplikację Claude → zobacz sesję z zieloną kropką → znajdź 87 commitów przedstawionych jako różnice. Przewijaj je; przy wątpliwych fragmentach napisz „cofnij to, naprawię ręcznie”, a przy tych bez zastrzeżeń — „zaakceptuj wszystko”. Nie musisz „iść do laptopa” o 7 rano.

### Scenariusz 2. Zatwierdzenie w drodze — akceptacja kroku w metrze

Rano rozpocznij długą migrację schematu bazy danych. O 9:30 w metrze przychodzi powiadomienie push: „Znaleziono dwie możliwości migracji; potrzebna decyzja”. Dotknij go, przeczytaj opcje, wybierz jedną i dodaj: „Nie usuwaj starej tabeli, dopóki pełny zestaw testów się nie zakończy”. Claude kontynuuje pracę.

Bez Remote Control Claude zatrzymałby się w tym momencie i czekał w ciszy. Docierasz na miejsce i otwierasz laptop — tracisz 40 minut.

### Scenariusz 3. Wzorzec odejścia od komputera — długie zadanie podczas lunchu

Przed lunchem zleć Claude’owi: „Zaktualizuj dokumentację wszystkich endpointów”. Idź do kawiarni. Po 25 minutach przychodzi powiadomienie: „Gotowe, sprawdź”. Raz dotknij „zaakceptuj”, a potem wróć do zupy. Bez Remote Control albo siedzisz 25 minut przy laptopie jak strażnik, albo wracasz i widzisz, że Claude przez cały ten czas nic nie zrobił, bo trafił na punkt wymagający decyzji.

To ważna kwestia. Remote Control nie zwiększa autonomii Claude’a — zapewnia tylko dostęp z dowolnego miejsca. Im mniej punktów decyzyjnych napotka Claude, tym mniej powiadomień push otrzymasz. Dlatego instrukcje do zadania powinny być bardziej szczegółowe: „Zrób to w ten sposób; w takich sytuacjach zrób tamto; jeśli naprawdę nie będzie jasne, zatrzymaj się i wyślij powiadomienie push”.

### Scenariusz 4. Decyzja architektoniczna z kawiarni

Podczas refaktoryzacji Claude znajduje dwie ścieżki migracji i prosi o wybór. Jeśli nie ma cię przy komputerze, otwórz proponowane różnice na telefonie, wybierz opcję i dodaj komentarz: „Ale nie ruszaj tabeli user_settings — usunę ją w przyszłym tygodniu”. Sesja będzie kontynuowana.

Działa to szczególnie dobrze w trybie worktree (`--spawn worktree`): każde równoległe zadanie znajduje się w osobnej gałęzi, więc zadania sobie nie przeszkadzają. Na telefonie przełączasz się między nimi jak między czatami.

### Scenariusz 5. Kilka sesji worktree jednocześnie

Jednym z wydajnych podejść jest tryb serwera połączony z wieloma worktree. Uruchom to na laptopie:

```bash
claude remote-control --spawn worktree --capacity 4
```

Uruchom z telefonu sesje w różnych gałęziach: jedna buduje funkcję, druga naprawia błędy z listy, a trzecia wykonuje testy regresyjne. Wszystkie działają równolegle na laptopie i żadna nie blokuje pozostałych.

<div class="aside" data-semantic="callout" role="note" aria-label="Attention">

Uwaga

Tryb serwera zużywa zasoby laptopa proporcjonalnie do liczby jednoczesnych sesji. Przy 16 GB RAM cztery równoległe sesje Claude’a są już wyraźnie odczuwalne. Uruchamiaj tyle, ile może obsłużyć twoja maszyna.

</div>

## Bezpieczeństwo: co pozostaje na komputerze, a co jest wysyłane

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

Najważniejsze informacje

Wiadomości czatu i wyniki narzędzi przechodzą przez Anthropic i mogą zawierać kod źródłowy lub sekrety. Lokalne wykonywanie nie zapobiega takiemu ujawnieniu. Połączenie jest wychodzące, korzysta z portu 443, używa krótkotrwałych danych uwierzytelniających i jest szyfrowane za pomocą TLS. Laptop nie otwiera żadnych portów przychodzących, a zdalny telefon nie uzyskuje bezpośredniego dostępu do systemu plików.

</div>

Przed podłączeniem wrażliwego projektu ustal, co może znaleźć się w promptach i wynikach narzędzi. Sekrety produkcyjne przechowuj poza środowiskiem dostępnym agentowi; tabela przesyłania danych nie dowodzi, że konkretna sesja nie może ich ujawnić.

<figure>
<blockquote>
<p>Lokalna sesja Claude Code wykonuje wyłącznie wychodzące żądania HTTPS i nigdy nie otwiera na twojej maszynie portów przychodzących. Po uruchomieniu Remote Control sesja rejestruje się w Anthropic API i odpytuje je o zadania.</p>
</blockquote>
<figcaption>— Anthropic Docs, https://code.claude.com/docs/en/remote-control</figcaption>
</figure>

Mówiąc prosto: laptop pyta Anthropic: „Czy masz dla mnie jakieś wiadomości?”, odbiera odpowiedź i przetwarza ją lokalnie. Nikt z zewnątrz nie otwiera portu przychodzącego do twojej maszyny. Zapora firmowa pozwoli na to bez specjalnej konfiguracji.

### Co fizycznie trafia do Anthropic

| Rodzaj danych | Gdzie się znajdują |
|----|----|
| Pliki źródłowe | Przechowywane lokalnie; fragmenty i różnice włączone do rozmowy są przesyłane |
| `.env`, sekrety, klucze API | Mogą wyciec po odczytaniu do promptu lub wyniku narzędzia; lokalne przechowywanie nie ogranicza dostępu |
| Lokalne serwery MCP i konfiguracje | Działają lokalnie; zwracana treść może trafić do rozmowy |
| Bazy danych, z którymi łączy się Claude | Pozostają na skonfigurowanym hoście; wyniki zapytań mogą trafić do rozmowy |
| Treść twoich wiadomości do Claude’a | W Anthropic API, po czym wraca odpowiedź |
| Treść odpowiedzi Claude’a | W Anthropic API, a następnie na telefonie |
| Różnice w plikach pokazywane przez Claude’a | Przez Anthropic API (tak jak w zwykłej sesji Claude.ai) |
| Zaimportowane obrazy i pliki przez `@` | Przez Anthropic API |

Remote Control dodaje synchronizowany interfejs, a nie tryb pracy modelu offline. Anthropic przechowuje zapis podłączonej sesji, w tym wiadomości, odpowiedzi i aktywność narzędzi, zgodnie ze swoją polityką wykorzystania danych. Sprawdź zarówno dane wysyłane do modelu, jak i dostęp z podłączonych urządzeń.

### Uwaga dotycząca danych uwierzytelniających

<figure>
<blockquote>
<p>Połączenie korzysta z kilku krótkotrwałych danych uwierzytelniających; każda ma jeden cel i niezależny czas życia.</p>
</blockquote>
<figcaption>— Anthropic Docs, https://code.claude.com/docs/en/remote-control</figcaption>
</figure>

Innymi słowy, między laptopem, Anthropic i telefonem krąży pula krótkotrwałych tokenów zamiast jednego tokenu o długim czasie życia. Przejęcie jednego z nich nie daje dostępu do wszystkich.

Jest jeszcze jedno ważne ograniczenie: `--dangerously-skip-permissions` nie działa w Remote Control. Każde wywołanie narzędzia (Bash, Write, Edit) nadal wymaga twojej zgody. To celowe rozwiązanie — funkcja telefonu nie ma zmienić się w „laptop działający na autopilocie bez nadzoru”.

<div class="aside" data-semantic="callout" role="note" aria-label="Note">

Uwaga

Jeśli chcesz pełnej autonomii („Claude sam podejmuje decyzje i pracuje przez 14 godzin bez przerwy, bez zatwierdzania”), to inna funkcja: tryb `/goal`. Więcej informacji znajdziesz w [przewodniku po /goal w Claude Code](https://ailoot.ai/blog/pl/goal-mode-claude-code-codex/). Remote Control robi coś innego: umożliwia kierowanie pracą z dowolnego miejsca, bez zwiększania autonomii.

</div>

## Uruchomiono Remote Control? Skonfiguruj teraz Claude’a, by nie przerywał ci co 10 minut

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

Najważniejsze informacje

Samo Remote Control rozwiązuje połowę problemu: zapewnia podgląd sesji w telefonie. Druga połowa to konfiguracja, dzięki której Claude wie, kiedy się zatrzymać i zapytać, a kiedy kontynuować samodzielnie. Możesz to zrobić za pomocą CLAUDE.md, szczegółowego polecenia na początku zadania i trybu `/goal`. Wtedy powiadomienia push będą przychodzić wtedy, gdy są ważne, a nie co 10 minut.

</div>

`/rc` to wygodny sposób, by przenieść sesję na telefon. Ale jeśli Claude co 10 minut pisze „Nie rozumiem, co mam zrobić”, problemem nie jest telefon, lecz **inżynieria kontekstu**: jasność zasad ustalonych na początku.



## Sześć problemów przy pierwszym uruchomieniu i sposoby ich rozwiązania

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

Najważniejsze informacje

Najczęstsze problemy przy pierwszym połączeniu to: komunikat „Remote Control environments are not available”, bo ustawiono klucz API; kod QR nie daje się zeskanować, bo jest za mały w terminalu; zapora blokuje port 443; Claude Code jest nieaktualny; powiadomienia push są wyciszone; albo Remote Control nie działa z poziomu Claude Desktop. Każdy z tych problemów można rozwiązać w 1–2 minuty.

</div>

### Problem 1. „Remote Control environments are not available for your account”

To najczęstsza skarga w repozytorium `anthropics/claude-code` (issue \#29449 i ponad tuzin duplikatów). Odpowiedziałeś `y` na pytanie „enable Remote Control?”, CLI zwróciło błąd i nie proponuje już ponownej próby.

**Przyczyna jest niemal zawsze taka sama:** w środowisku ustawiono `ANTHROPIC_API_KEY` lub `CLAUDE_CODE_OAUTH_TOKEN`. Remote Control działa wyłącznie z pełnym logowaniem OAuth przez `/login`, a nie z kluczem.

**Rozwiązanie:**

```bash
unset ANTHROPIC_API_KEY
unset CLAUDE_CODE_OAUTH_TOKEN
unset apiKeyHelper

# sprawdź, czy środowisko jest czyste:
env | grep -i anthropic
env | grep -i claude

# zaloguj się ponownie:
claude
/logout
/login
```

Po zalogowaniu się przez przeglądarkę za pomocą `/login` Remote Control powinien się uruchomić.

### Problem 2. Telefon nie może zeskanować kodu QR

Aparat telefonu jest skierowany na kod, ale nie reaguje albo wyświetla komunikat „Nie można odczytać”.

**Przyczyna:** terminal wyświetla kod QR w zbyt małym rozmiarze lub z niewystarczającym kontrastem.

**Rozwiązanie:**

1.  Powiększ okno terminala do pełnego ekranu.
2.  Jeśli używasz Apple Terminal, przełącz się na iTerm2 (lub Warp). W systemie Windows użyj Windows Terminal zamiast CMD.
3.  Zmniejsz rozmiar czcionki w terminalu o 1–2 punkty, aby kod QR był większy.
4.  Jeśli to nie pomoże, skopiuj URL nad kodem QR i otwórz go w przeglądarce telefonu.

### Problem 3. Zapora blokuje port 443

Zwykle zdarza się to na komputerach firmowych z przechwytującym proxy (Zscaler lub firmowa sieć VPN z MITM).

<figure>
<blockquote>
<p>Problem z siecią lub proxy: zapora albo proxy może blokować wychodzące żądania HTTPS. Remote Control wymaga dostępu do Anthropic API przez port 443.</p>
</blockquote>
<figcaption>— Anthropic Docs, https://code.claude.com/docs/en/remote-control</figcaption>
</figure>

**Rozwiązanie:** zacznij od szczegółowych logów i zarejestruj konkretny błąd:

```bash
claude remote-control --verbose
```

Jeśli zobaczysz „certificate verification failed”, połączenie jest przechwytywane przez MITM i musisz skontaktować się z administratorem sieci. Jeśli pojawi się „connection refused” / „timeout”, poproś administratora o zezwolenie na dostęp wychodzący do `*.anthropic.com:443`.

### Problem 4. Claude Code jest nieaktualny

Sprawdź:

```bash
claude --version
```

Jeśli wersja jest niższa niż 2.1.51, zaktualizuj ją:

```bash
npm install -g @anthropic-ai/claude-code@latest
```

Rozszerzenie VS Code wymaga co najmniej v2.1.79. Powiadomienia push wymagają v2.1.110.

### Problem 5. Powiadomienia push nie przychodzą

Sytuacja: Remote Control działa, ale telefon milczy, gdy Claude kończy długie zadanie.

**Lista kontrolna:**

1.  Uruchom `/config` w sesji. Jeśli pojawi się „No mobile registered”, otwórz aplikację Claude na telefonie co najmniej raz, aby zaktualizowała token push.
2.  iOS: Ustawienia → Powiadomienia → Claude → sprawdź, czy powiadomienia są włączone i czy tryb skupienia ich nie wycisza.
3.  Android: otwórz ustawienia baterii i wyłącz optymalizację baterii dla Claude’a.
4.  Jeśli w iOS włączono podsumowanie powiadomień, powiadomienie push może przyjść, ale pojawić się w podsumowaniu godzinowym. Wyłącz podsumowanie dla Claude’a.

### Problem 6. Claude Desktop psuje `/remote-control`

Jeśli uruchomisz `/remote-control` w aplikacji Claude Desktop, pojawi się błąd „Remote Control requires a full-scope login token” (GitHub issue \#48378).

**Przyczyna:** Claude Desktop wstrzykuje token OAuth o ograniczonych uprawnieniach (wyłącznie do wnioskowania).

**Rozwiązanie:** uruchom Claude Code w zwykłym terminalu systemowym, a nie w terminalu wbudowanym w Claude Desktop. To znane ograniczenie; Anthropic pracuje nad poprawką.

### Dodatkowo. Automatyczne ponowne łączenie po cichu przestaje działać w długich sesjach

Objaw: sesja Remote Control działa przez 30–60 minut, a potem telefon rozłącza się bez żadnego wskaźnika (issue \#34255). Naprawa ręczna: `/remote-control` → Disconnect → uruchom ponownie. To nie jest idealne, ale funkcja nadal jest dostępna jako wersja poglądowa do celów badawczych.

W samym maju 2026 roku Anthropic opublikowało osiem poprawek dotyczących wyłącznie Remote Control — funkcja jest aktywnie rozwijana. Możesz zgłosić uwagi, ale rozsądnie jest oczekiwać, że większość tych problemów zniknie w ciągu kilku miesięcy.

## Remote Control a boty Telegram i SSH+tmux

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

Najważniejsze informacje

Remote Control to oficjalne, zsynchronizowane okno do lokalnej sesji Claude’a. Boty Telegram przez Anthropic Channels to kanał reagujący, w którym „zewnętrzne zdarzenie podpowiada Claude’owi działanie”. SSH+tmux w telefonie to uniwersalna powłoka, ale rozłącza się, gdy Mac przechodzi w stan uśpienia, a przeglądanie różnic na 6-calowym ekranie jest męczące. Wybierz zależnie od zadania: kieruj sesją przez Remote Control, reaguj na zdarzenie przez Channels albo użyj SSH+tmux, gdy potrzebujesz dowolnej powłoki.

</div>

### Tabela porównawcza

| Element | Remote Control | Channels (TG/Discord) | SSH + tmux |
|----|----|----|----|
| Kto inicjuje | Otwieram sesję | Zewnętrzne zdarzenie uruchamia Claude’a | Łączę się |
| Interfejs | Pełny interfejs claude.ai/code | Wiadomości czatu | Terminal w telefonie |
| Gdzie działa sesja | Na mojej maszynie | Na mojej maszynie | Na serwerze |
| Przeglądanie różnic | Wygodne (natywny interfejs) | Tekst na czacie | Mikroskopijna czcionka |
| Obsługa CLI | Tylko Claude Code | Dowolne polecenie przez bota | Dowolne polecenie |
| Cena | Wliczona w Pro/Max | Bezpłatnie (wtyczka Channels) | Bezpłatnie |
| Zachowanie po utracie sieci | Automatyczne ponowne połączenie | Reaktywne (push) | Rozłącza się przy przełączaniu |
| Kiedy sesja się kończy | Zamknięcie terminala / brak sieci przez \>10 min | Bot działa bez przerwy | tmux zachowuje sesję |

### Kiedy wybrać daną opcję

- **Remote Control** — domyślna konfiguracja, gdy chcesz „odejść od laptopa i nadal kierować pracą”. Pełny interfejs, synchronizacja urządzeń i brak usług zewnętrznych.
- **Channels (bot Telegram)** — gdy chcesz, by błąd CI, skarga nowego klienta lub wiadomość na czacie automatycznie skłoniły Claude’a do zbadania sprawy. To „zdarzenie → Claude reaguje”, zamiast „kieruję Claude’em z telefonu”. Więcej informacji znajdziesz w [przewodniku po Telegramie i Claude Code](https://ailoot.ai/blog/pl/claude-code-telegram-channels/).
- **SSH + tmux** — gdy potrzebujesz dowolnej powłoki na telefonie do własnych poleceń (wdrożenie wydania, sprawdzenie logu, ponowne uruchomienie usługi). Uniwersalna powłoka poza Claude Code. Do jednorazowych zadań można użyć Termux/Blink.
- **Inni agenci programistyczni** — Anthropic Remote Control obsługuje wyłącznie Claude Code. Porównanie Claude’a z alternatywami znajdziesz w artykule [Cursor a Claude Code](https://ailoot.ai/blog/pl/cursor-vs-claude-code/).

<figure>
<blockquote>
<p>Channels: zdarzenia push z aplikacji czatu, takiej jak Telegram lub Discord, albo z własnego serwera. Przydatne do reagowania na zdarzenia zewnętrzne, na przykład błędy CI lub wiadomości na czacie.</p>
</blockquote>
<figcaption>— Anthropic Docs, https://code.claude.com/docs/en/remote-control</figcaption>
</figure>

Oficjalna dokumentacja Anthropic rozróżnia te funkcje według zastosowania: Remote Control służy do sterowania, a Channels do reagowania.

## Co nowego w Remote Control od maja do czerwca 2026 roku

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

Najważniejsze informacje

W ciągu półtora miesiąca Anthropic opublikowało osiem ukierunkowanych poprawek i usprawnień dotyczących wyłącznie Remote Control: blokowanie funkcji, gdy w środowisku znajduje się klucz API; naprawę przekierowań konektora MCP podczas rotacji tokenu; zastąpienie komunikatu „Opening your options” właściwą ofertą po osiągnięciu limitu; stały element w stopce zamiast wiadomości przy uruchamianiu; poprawę powiadomień push w sesjach SDK; oraz właściwe komunikaty o błędach przy pierwszym połączeniu. Na dzień 03.06.2026 aktualna wersja to 2.1.162.

</div>

Pełna oś czasu poprawek:

| Wersja | Data | Co się zmieniło |
|----|----|----|
| v2.1.51 | 24.02.2026 | Pierwsze wydanie Remote Control |
| v2.1.79 | March 2026 | Obsługa w rozszerzeniu VS Code |
| v2.1.110 | April 2026 | Powiadomienia push stały się oficjalną funkcją |
| v2.1.126 | 01.05.2026 | Zastąpiono pusty komunikat „Opening your options...” właściwą ofertą po osiągnięciu limitu szybkości |
| v2.1.139 | 11.05.2026 | Remote jest blokowany, gdy obecny jest `ANTHROPIC_API_KEY` lub `apiKeyHelper` |
| v2.1.140 | 12.05.2026 | Zarządzane ustawienia ponawiają żądanie 401 z wymuszonym odświeżeniem tokenu |
| v2.1.141 | 13.05.2026 | Naprawiono błędy konektora MCP z kodem 401 podczas rotacji tokenu sesji workera |
| v2.1.149 | 22.05.2026 | Naprawiono błędny komunikat „Mobile push not sent” w sesjach SDK |
| v2.1.151 | 27.05.2026 | Remote Control jest teraz stałym elementem w stopce |
| v2.1.152 | 27.05.2026 | Naprawiono zawieszanie się `/remote-control` na „connecting...” |
| v2.1.154 | 28.05.2026 | Autouzupełnianie pokazuje „Disconnect”, gdy funkcja jest już aktywna |
| v2.1.162 | 03.06.2026 | Aktualna wersja; ogólne usprawnienia wskaźników, równoległej obsługi narzędzi i innych elementów |

Osiem poprawek dotyczących Remote Control w ciągu miesiąca to normalna sytuacja w przypadku funkcji w wersji poglądowej do celów badawczych. Anthropic wyraźnie reaguje na opinie i usuwa problemy brzegowe.

Jeśli funkcja działa dziwnie, najpierw sprawdź wersję i zaktualizuj ją. Jest spora szansa, że błąd został już naprawiony.

## Lista kontrolna: skonfiguruj i uruchom w 5 minut

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

Najważniejsze informacje

Aby Remote Control działał niezawodnie już za pierwszym razem, wykonaj siedem poniższych kroków. Rozwiązują one 90% problemów przy pierwszym uruchomieniu i pozwalają zatwierdzić pierwsze powiadomienie push z telefonu w ciągu pięciu minut od rozpoczęcia.

</div>

1.  ### Sprawdź wersję Claude Code

    `claude --version` — powinna wynosić 2.1.51 lub więcej. Jeśli jest starsza, uruchom `npm install -g @anthropic-ai/claude-code@latest`.

2.  ### Usuń klucze API ze środowiska

    Uruchom `unset ANTHROPIC_API_KEY` i `unset CLAUDE_CODE_OAUTH_TOKEN`. Następnie wykonaj `/logout` → `/login` przez przeglądarkę.

3.  ### Zainstaluj aplikację Claude na telefonie

    Uruchom `/mobile` w sesji Claude Code, aby wyświetlić kod QR do App Store / Google Play.

4.  ### Uruchom Remote Control

    Uruchom `claude --rc` albo wpisz `/rc` w sesji. Pojawi się adres URL i komunikat „Press space to show QR”.

5.  ### Zeskanuj kod QR telefonem

    Naciśnij Spację w terminalu → użyj aparatu lub aplikacji Claude. Jeśli nie można zeskanować kodu, powiększ okno terminala.

6.  ### Włącz powiadomienia push

    `/config` → „Push when Claude decides”. Jeśli pojawi się „No mobile registered”, otwórz aplikację Claude co najmniej raz.

7.  ### Rozpocznij długie zadanie i odejdź

    Sprecyzuj polecenie: „Zrób to w ten sposób; w takich przypadkach zrób tamto; jeśli pojawią się wątpliwości, wyślij powiadomienie push”. Następnie pracuj z telefonu, korzystając z powiadomień push.

W jednym praktycznym przykładzie, od rozpoczęcia od zera do pierwszej rozmowy z kanapy minęło 3–5 minut.

<div class="section" role="doc-bibliography" aria-label="Sources">

### Źródła

- [Kontynuuj lokalne sesje na dowolnym urządzeniu za pomocą Remote Control - Claude Code Docs](https://code.claude.com/docs/en/remote-control) — oficjalna dokumentacja Anthropic i główne źródło informacji o poleceniach, wymaganiach i ograniczeniach.
- [Claude Code Changelog](https://code.claude.com/docs/en/changelog) — historia wersji od 2.1.51 do 2.1.162, w tym wszystkie poprawki Remote Control.

</div>





Gdy będziesz gotowy, poznaj [Ailoot](https://ailoot.ai/).

## Pytania i odpowiedzi

### Czy Remote Control utrzymuje całą rozmowę poza chmurą?

Nie. Polecenia i dostęp do plików działają lokalnie, ale wiadomości, odpowiedzi, różnice w plikach i aktywność narzędzi są synchronizowane przez Anthropic. Fragmenty kodu lub sekrety zawarte w tej treści mogą więc opuścić komputer.

### Dlaczego komputer musi pozostać włączony podczas Remote Control?

Telefon jest interfejsem do procesu Claude Code na Twoim komputerze. Utrzymuj ten proces w działaniu i komputer dostępny; otwarcie aplikacji w telefonie nie przenosi lokalnego wykonywania na maszynę wirtualną w chmurze.


## Ailoot · Firma i jej portfel projektów

Ailoot opiera się na zgromadzonym doświadczeniu operacyjnym, szerokiej bazie klientów, stabilnej usłudze i stałej kontroli KPI.

Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach.

Ailoot wykorzystuje to doświadczenie operacyjne, zapewniając dostęp przez API do funkcji AI w produktach klientów, agentach, aplikacjach i automatyzacjach.
