Przejdź do głównej zawartości

Sterowanie agentami z telefonu: Remote Control, Happy, CloudCLI i Orca Mobile

Klienci zdalni i mobilni pozwalają sterować agentem kodującym z telefonu lub przeglądarki, podczas gdy sam agent dalej działa na komputerze programisty. Claude Code ma Remote Control, Codex ma eksperymentalne codex remote-control, a Happy, CloudCLI, Orca i Nimbalyst dodają powiadomienia push, zdalne zatwierdzanie uprawnień i widok wielu agentów.

Ta strona jest dla programisty, który o 16:00 uruchamia dwugodzinny refaktor i nie chce przy nim siedzieć, oraz dla tech leada, który decyduje, którzy klienci mogą dotykać kodu firmy. Agent staje na pytaniu o uprawnienie, gdy tylko wyjdziesz z pokoju, albo pracuje dalej, a rano w diffie czeka niespodzianka. Potrzebujesz agenta, który pyta, dociera do ciebie tam, gdzie jesteś, i oddaje dowody zamiast opowieści.

  • Tabelę decyzyjną, która dopasowuje agenta, plan i sieć do właściwego klienta.
  • Przykład krok po kroku: prośba o uprawnienie z happy claude zatwierdzona na telefonie.
  • Przepływ pracy dla całego procesu: plan przy biurku, nadzór z telefonu, review przy biurku.
  • Trzy prompty do skopiowania: przekazanie zadania, sprawdzenie statusu i przegląd po powrocie.
  • Obraz bezpieczeństwa: przez co każdy klient przesyła ruch, co przechowuje i jak go wyłączyć.

Szczegóły działania Remote Control i kanałów w Claude Code opisuje strona kanały i Remote Control. Uruchamianie wielu agentów naraz z aplikacji desktopowej opisuje strona powłoki agentów.

Który klient zdalny pasuje do twojego agenta i konfiguracji?

Dział zatytułowany „Który klient zdalny pasuje do twojego agenta i konfiguracji?”

Zacznij od agenta, którego używasz, i od sposobu uwierzytelniania. Domyślny wybór to ścieżka dostawcy; klient zewnętrzny ma sens przy kilku agentach, bramce albo potrzebie pełnego interfejsu na telefonie.

Twoja sytuacjaWybórDlaczego
Claude Code z logowaniem Pro, Max, Team lub Enterprise, połączony z api.anthropic.comRemote Control (claude --remote-control)Wbudowane; aplikacja Claude i claude.ai/code łączą się z lokalną sesją; push przy prośbach o uprawnienia
Codex CLI na twoim komputerzecodex remote-controlWbudowane w codex-cli; w wersji 0.157.1 oznaczone jako eksperymentalne
Używasz Claude Desktop i chcesz z telefonu zlecić nowe zadanie, a nie sterować trwającymDispatch w aplikacji ClaudeTylko Pro i Max; parujesz aplikację mobilną z Claude Desktop; zadanie działa na twojej maszynie
Claude Code i Codex z jednej aplikacjiHappyJedna nakładka na oba agenty, szyfrowanie end-to-end, push, gdy agent potrzebuje zgody
Claude Code z kluczem API, za bramką, na Bedrock, Agent Platform w Google Cloud (dawniej Vertex AI) lub FoundryHappy (najpierw przetestuj)Remote Control nie działa w żadnym z tych przypadków; Happy opakowuje lokalne CLI i przesyła ruch przez własny serwer
Pełny interfejs webowy na telefonie lub tablecie: pliki, git, powłoka, wszystkie wcześniejsze sesje; również Cursor CLICloudCLISamodzielnie hostowany interfejs na twojej maszynie; wykrywa istniejące sesje; wszystkie narzędzia Claude Code domyślnie wyłączone
Już uruchamiasz agentów w równoległych worktree w aplikacji desktopowejAplikacja mobilna Orca lub Nimbalyst na iOSTelefon paruje się z aplikacją desktopową, której już używasz
Stary poradnik każe użyć Omnary jako pilota na telefonŻadne z powyższych: Omnara zmieniła profilTo teraz platforma zarządzanych agentów; pip install omnara to przestarzałe przekierowanie

Popularność (gwiazdki na GitHubie odczytane 26 września 2026): Orca 78 410; Happy 23 913; CloudCLI 13 811; Omnara 2870; Nimbalyst 1777. Remote Control i codex remote-control są częścią CLI dostawców, więc nie mają liczby gwiazdek. Gwiazdki mierzą zainteresowanie, a nie to, czy przekaźnik jest bezpieczny dla twojego kodu.

W każdej opcji wykonanie zostaje na twojej maszynie. Różnią się tym, co przechodzi przez sieć i kto obsługuje przekaźnik, a o to dział bezpieczeństwa zapyta najpierw.

KlientPrzekaźnikCo opuszcza twoją maszynęLicencjaAgenci
Remote ControlAPI Anthropic, tylko wychodzące HTTPS, bez portów przychodzącychTranskrypt sesji (wiadomości, odpowiedzi, aktywność narzędzi), przechowywany na serwerach Anthropic zgodnie z polityką wykorzystania danychCzęść Claude CodeClaude Code
codex remote-controlZdalne sterowanie app-serverem OpenAIPomoc codex-cli 0.157.1 tego nie podaje; dokumentacja Codex Remote od OpenAI opisuje uruchamianie, prowadzenie i przeglądanie zadań z telefonuCzęść codex-cliCodex
HappySerwer synchronizacji Happy (domyślnie https://api.cluster-fluster.com), wymienny przez HAPPY_SERVER_URLDane sesji zaszyfrowane end-to-end; klucze zostają na twoich urządzeniachMITClaude Code, Codex i inni przez ACP
CloudCLI (self-hosted)Brak: telefon otwiera port twojej maszynyNie widzi ich żadna firma trzecia, ale serwer to zdalna powłoka, która nasłuchuje na wszystkich interfejsach sieciowych po zwykłym HTTP (CloudCLI 1.37.3), więc każdy w tej sieci dociera do jej strony logowania i może podejrzeć ruchAGPL-3.0-or-laterClaude Code, Cursor CLI, Codex
Orca mobilePrzekaźnik parowania Orca (kod w katalogu cloud/ repozytorium)Status agentów i wysyłane przez ciebie poleceniaMITWszystko, co działa w Orca
Nimbalyst iOSREADME tego nie opisujeStatus sesji, pytania i diffy, które pokazuje aplikacjaMITCodex, Claude Code, OpenCode i inni

Żaden z tych klientów nie jest serwerem MCP ani pluginem, więc żaden nie dokłada schematów narzędzi do okna kontekstu agenta.

Ten przykład korzysta z Happy, bo działa tak samo dla Claude Code i Codex. Polecenia pochodzą z README Happy i README CLI happy (npm happy 1.2.5, sprawdzone 2026-09-26).

  1. Zainstaluj aplikację na telefonie (App Store lub Google Play, oba linki są w github.com/slopus/happy) albo otwórz aplikację webową pod https://app.happy.engineering.

  2. Zainstaluj CLI na maszynie, na której działa agent. Wymaga Node.js 20 lub nowszego oraz zainstalowanego i zalogowanego CLI samego agenta:

    Okno terminala
    npm install -g happy # nie happy-coder, który jest przestarzały
    claude --version # Claude Code musi już działać w tym terminalu
  3. Uruchom agenta przez nakładkę, w repozytorium, na gałęzi funkcji:

    Okno terminala
    git switch -c fix/flaky-invoice-tests
    happy claude --permission-mode default # albo: happy codex

    --permission-mode default jawnie ustawia Claude Code w trybie Manual, więc zmiana trybu startowego Claude Code (auto od wersji 2.1.283 w kanale latest) nie wyłączy po cichu zatwierdzania z telefonu. Happy 1.2.5 przyjmuje wartość konfiguracyjną default, a nie manual (kod źródłowy Happy 1.2.5, sprawdzone 26 września 2026). Sesja pokazuje kod QR. Zeskanuj go aplikacją Happy, żeby podłączyć telefon. Happy uwierzytelnia się parą kluczy, których klucz prywatny zostaje na laptopie; logowaniem zarządzają happy auth login i happy auth logout.

  4. Daj agentowi zadanie, które będzie wymagało zgody, na przykład prompt przekazania z dalszej części strony, i odejdź od komputera.

  5. Gdy agent poprosi o zgodę (tryb Manual w Claude Code, polityka zatwierdzania w Codex), Happy wyśle powiadomienie push. Otwórz je, przeczytaj dokładne polecenie i zatwierdź je albo odrzuć. Zatwierdzaj ograniczone polecenia, takie jak npm test -- invoices; odrzucaj wszystko, co robi push, wdraża, usuwa albo dotyka plików poza repozytorium.

  6. Po powrocie do laptopa naciśnij dowolny klawisz w terminalu. Kontrola wraca do lokalnej sesji.

Agent powinien ruszyć kilka sekund po twojej zgodzie, a telefon pokazywać tę samą rozmowę co terminal. Jeśli na telefon nic nie dociera, następnym razem przed wyjściem uruchom happy doctor na laptopie.

Jeśli twoja konfiguracja na to pozwala, wbudowana ścieżka oznacza o jeden przekaźnik mniej do oceny.

Remote Control wymaga logowania przez claude.ai w planie Pro, Max, Team lub Enterprise; w Team i Enterprise najpierw musi je włączyć Owner w ustawieniach administracyjnych Claude Code. Nie działa z kluczami API, Amazon Bedrock, Agent Platform w Google Cloud, Microsoft Foundry, firmową bramką Claude apps ani z ANTHROPIC_BASE_URL wskazującym inny host niż api.anthropic.com. Najpierw uruchom raz claude w projekcie, żeby zaakceptować okno zaufania do katalogu projektu.

Okno terminala
# Sesja interaktywna, którą możesz też prowadzić z telefonu
claude --remote-control "invoice tests" # alias: --rc
# Albo tryb serwera: kilka sesji z telefonu, każda we własnym worktree
claude remote-control --spawn worktree --name "invoice tests"

W działającej sesji /remote-control (albo /rc) podłącza bieżącą rozmowę. Z telefonu połączysz się, skanując kod QR (w trybie serwera pokazuje go spacja) albo otwierając sesję w aplikacji Claude w sekcji Code. /mobile pokazuje kod QR prowadzący do sklepu z aplikacjami.

Żeby zatwierdzać z telefonu, uruchom /config i włącz Push when actions required. Prośby o uprawnienia i pytania czekają otwarte, aż na nie odpowiesz. Inne przekazywane okna dialogowe domyślnie zamykają się po pięciu minutach (zmienia to dialogExpiry).

claude --help w wersji 2.1.283 nie wymienia podpolecenia remote-control, a claude remote-control --help kończy się błędem, dopóki nie zalogujesz się na uprawnione konto. Pełną listę flag znajdziesz na stronie kanały i Remote Control.

Jeśli już uruchamiasz agentów w Orca lub Nimbalyst, sparuj ich aplikacje mobilne zamiast dokładać kolejne narzędzie; konfigurację i porównanie znajdziesz na stronie powłoki agentów.

Start przy biurku, nadzór z telefonu, review przy biurku

Dział zatytułowany „Start przy biurku, nadzór z telefonu, review przy biurku”

Telefon dobrze nadaje się do odpowiedzi na pytanie, zatwierdzenia ograniczonej akcji i zawrócenia agenta, który zboczył z kursu. Słabo nadaje się do czytania diffa, więc planowanie i review zostają przy biurku.

  1. Zaplanuj przy biurku. Opisz zadanie z definicją ukończenia, którą da się udowodnić jedną linijką statusu: dokładne polecenie testów, pliki w zakresie i to, co nie może się zmienić. Kryteria akceptacji wpisz do promptu, a nie trzymaj w głowie.

  2. Odizoluj przebieg. Utwórz dla zadania gałąź albo worktree. W trybie serwera Remote Control --spawn worktree daje każdej sesji z telefonu osobny worktree; w Codex zobacz worktree.

  3. Ustal granicę uprawnień przed wyjściem. Uruchom sesję w trybie Manual (claude --remote-control --permission-mode manual albo happy claude --permission-mode default), żeby każde polecenie spoza listy dozwolonych stało się pytaniem na telefonie. Od wersji 2.1.283 (kanał latest) tryb auto jest trybem startowym, a jego klasyfikator zatwierdza akcje bez pytania. Nie uruchamiaj przebiegu bez nadzoru z --dangerously-skip-permissions ani w trybie pełnego dostępu; to wolno tylko w jednorazowym sandboksie z ograniczoną siecią.

  4. Przekaż zadanie promptem poniżej, sprawdź, że jedno powiadomienie push dociera na telefon, i dopiero wtedy wyjdź. Zamknij pokrywę tylko wtedy, gdy sesja działa w tmux lub screen na maszynie, która nie zasypia.

  5. Nadzoruj z telefonu. Odpowiadaj na pytania, zatwierdzaj ograniczone polecenia, a po powiadomieniu wysyłaj prompt statusu. Odrzucaj push, merge, wdrożenia i wszystko poza repozytorium, podając powód, żeby agent mógł się dostosować.

  6. Zrób review przy biurku. Uruchom prompt przeglądu po powrocie, wypchnij gałąź i pozwól ocenić ją CI oraz code review PR-ów agenta. Pull request zatwierdza człowiek, jak każdą pracę zrobioną przy biurku.

Jak udowodnić, że praca sterowana z telefonu jest poprawna?

Dział zatytułowany „Jak udowodnić, że praca sterowana z telefonu jest poprawna?”

Sesja musi wytworzyć dowody, które zmieszczą się w linijce statusu, a przy biurku sprawdzasz je, zanim cokolwiek trafi na produkcję.

SprawdzenieGdzieWarunek zaliczenia
Ukończenie jest zdefiniowanePrompt przekazaniaNazwane polecenie testów i zakres plików, zapisane przed wyjściem
Zakres utrzymanyPanel diffa na telefonie (Remote Control) lub przewijane diffy (Nimbalyst), potem git diff --stat przy biurkuZmieniły się tylko pliki z zakresu; żadnego lockfile’a, konfiguracji CI ani niezwiązanego modułu
Testy przechodząOdpowiedź ze statusem, potem ponowne uruchomienie przy biurkuTo samo polecenie, kod wyjścia 0, uruchomione przez ciebie, a nie tylko zgłoszone przez agenta
Zgody z telefonu są rozliczonePrompt przeglądu po powrocieKażde polecenie zatwierdzone z telefonu jest wymienione razem z wynikiem
Bramki przechodząCI na wypchniętej gałęziTypy, lint, testy i automatyczne code review na zielono; zobacz pakiet dowodów
Człowiek zatwierdzaPull requestRecenzent akceptuje dowody, a nie podsumowanie agenta

Nieudany przebieg kosztuje jeden git reset na gałęzi albo jeden usunięty worktree, bo nic nie zostało wypchnięte ani scalone bez review.

Prompty do skopiowania dla agentów nadzorowanych z telefonu

Dział zatytułowany „Prompty do skopiowania dla agentów nadzorowanych z telefonu”
  • „Remote Control requires claude.ai subscription auth”. ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN lub apiKeyHelper ma pierwszeństwo przed logowaniem. Naprawa: usuń zmienną z powłoki i z bloku env w ustawieniach, potem claude auth login. Jeśli klucz musi zostać, użyj Happy.
  • „Remote Control is only available when using Claude via api.anthropic.com”. Sesję kieruje LiteLLM, OpenRouter, Claude Code Router, firmowa bramka, Bedrock, Agent Platform w Google Cloud albo Foundry. Naprawa: na czas tej sesji usuń zmienną wskazaną w komunikacie albo użyj Happy; kompromisy bramek opisuje strona bramki i modele lokalne.
  • „Remote Control requires feature-flag evaluation”. Ustawione jest CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC lub DISABLE_GROWTHBOOK. Naprawa: usuń zmienną. claude doctor wskazuje, która kontrola uprawnień nie przeszła. Jeśli komunikat wymienia DISABLE_TELEMETRY lub DO_NOT_TRACK, zaktualizuj do v2.1.283 (kanał latest); na kanale stable 2.1.274 usuń te zmienne.
  • Sesja przeszła w tryb offline po zamknięciu pokrywy. Naprawa: uruchamiaj agenta w tmux lub screen na maszynie, która nie zasypia. Żeby odzyskać rozmowę, postąp zgodnie z tym, jak ją uruchomiłeś. Sesję interaktywną (--remote-control lub /remote-control) wznów przez claude --continue (albo claude --resume), co ponownie łączy Remote Control. W trybie serwera uruchom claude remote-control --continue w ciągu około czterech godzin od zatrzymania serwera; tej flagi nie da się łączyć z --spawn ani --capacity.
  • Tryb serwera zakończył się w czasie jazdy pociągiem. Poddaje się po mniej więcej 10 minutach bez sieci, a interaktywna sesja --remote-control ponawia próby. Naprawa: przy niestabilnej sieci wybieraj formę interaktywną.
  • Nie przychodzi żadne powiadomienie push. W Remote Control /config pokazuje No mobile registered, dopóki aplikacja Claude nie odświeży tokenu; tryby skupienia w iOS i optymalizacja baterii w Androidzie opóźniają powiadomienia. Naprawa: otwórz raz aplikację, wyłącz dla niej optymalizację baterii i zrób test promptem w rodzaju „notify me when the tests finish”. W Happy uruchom happy doctor.
  • Demon Happy po restarcie macOS zwraca „API Error: 401”. Agent launchd nie ma dostępu do pęku kluczy. Naprawa: uruchamiaj demona z profilu powłoki, jak pokazuje README CLI Happy, a nie z LaunchAgenta.
  • Agent czeka na okno, którego telefon nigdy nie pokazuje, albo tura kończy się sama. Prośba o zgodę na kredyty użycia modelu Fable pojawia się tylko tam, gdzie działa sesja; inne przekazane okna (poza prośbami o uprawnienia i pytaniami) zamykają się po pięciu minutach; /plugin i /resume działają wyłącznie lokalnie. Naprawa: wybierz model i zainstaluj pluginy przy biurku, ustaw dialogExpiry i przed wyjściem wyślij jeden próbny prompt.
  • Dwie sesje z telefonu edytowały ten sam plik. Tryb serwera Remote Control domyślnie używa --spawn same-dir. Naprawa: uruchom ponownie z --spawn worktree albo naciśnij w w terminalu serwera.
  • Zatwierdziłeś coś, czego nie powinieneś. Naprawa: zatrzymaj sesję, zrób git reset --hard do ostatniego dobrego commita na gałęzi (albo usuń worktree) i zawęź zakres w prompcie przekazania.

Co tech lead powinien ustawić, zanim zespół zacznie używać klientów mobilnych

Dział zatytułowany „Co tech lead powinien ustawić, zanim zespół zacznie używać klientów mobilnych”

Klient mobilny to nowy sposób zatwierdzania poleceń powłoki na firmowych maszynach; podejmij tę decyzję raz dla całego zespołu.

KontrolaJakEfekt
Wyłączenie Remote Control na urządzeniu lub we flocieUstawienie disableRemoteControl (dla floty w ustawieniach zarządzanych)Żadnej sesji nie da się prowadzić zdalnie
Dopuszczenie Remote Control w Team lub EnterprisePrzełącznik Ownera w ustawieniach administracyjnych Claude CodeWyłączone, dopóki Owner go nie włączy
Wymóg zweryfikowanego urządzeniaRequire trusted devices (beta) w Organization settings, Capabilities, Remote sessionsSterowanie wymaga zarejestrowanego urządzenia i logowania biometrią lub passkeyem nie starszego niż 18 godzin
Blokada automatycznego łączenia w repozytoriumremoteControlAtStartup: false w projektowym .claude/settings.jsonRespektowane; projektowe true jest ignorowane, więc plik w repozytorium nie włączy Remote Control wszystkim
Ograniczenie zdalnego sterowania w Codexallow_remote_control w zarządzanym requirements.tomlLimit na poziomie administratora dla Codex
Zgoda z telefonu na każde poleceniepermissions.disableAutoMode: "disable" w ustawieniach zarządzanychSesje startują w trybie Manual, więc polecenia spoza listy dozwolonych trafiają na telefon jako pytania
Organizacje z Zero Data RetentionNic do ustawieniaRemote Control nie da się włączyć, bo transkrypt jest przechowywany na serwerach Anthropic
Klienci zewnętrzniLista dozwolonych narzędzi w polityce inżynieryjnejNajpierw oceń przekaźnik, licencję (CloudCLI to AGPL) i domyślne uprawnienia

Najczęstsze pytania

Czy Remote Control w Claude Code działa z kluczem API albo przez bramkę LLM?

Nie. Remote Control wymaga logowania przez claude.ai w planie Pro, Max, Team lub Enterprise i sesji połączonej z api.anthropic.com. Z kluczem API, u dostawcy chmurowego albo za bramką użyj Happy.

Jak zatwierdzić prośbę agenta o uprawnienie z telefonu?

W Happy uruchom agenta jako happy claude lub happy codex, sparuj aplikację i odpowiedz na prośbę, gdy przyjdzie powiadomienie push. W Remote Control włącz w /config opcję Push when actions required; prośby o uprawnienia czekają otwarte, aż na nie odpowiesz.

Czy Omnara to nadal pilot do Claude Code na telefonie?

Nie. Omnara zmieniła profil na platformę zarządzanych agentów. Pakiet omnara na PyPI to przestarzałe przekierowanie, a obecne narzędzie obsługuje się poleceniami npx omnara.

Czy mogę scalać zmiany z telefonu?

Nie. Telefon służy do kierowania agentem i zatwierdzania ograniczonych akcji. Push, merge i wdrożenie rób przy biurku, gdy testy, CI i code review dadzą dowody.