Claude Code Remote Control: ovládání z telefonu přes QR kód

Další pokyny najdete v dokumentaci Ailoot.

Co je Claude Code Remote Control a proč ho používat z telefonu?#

Anthropic uvedl Remote Control 24. února 2026. Anthropic jej popisuje jako způsob, jak pokračovat v místních relacích z libovolného zařízení.

Jednoduše řečeno: jako obvykle spustíte relaci v terminálu. Zapnete Remote Control. Otevřete aplikaci Claude v telefonu → kartu Code → a uvidíte svou relaci se zelenou tečkou. Klepněte na ni, čtěte a odpovídejte. Můžete psát z notebooku, telefonu i prohlížeče v libovolné kombinaci — vše se synchronizuje.

Oficiální dokumentace Remote Control rozlišuje místní vykonávání a síťový provoz: příkazy a operace se soubory běží na vašem počítači, zatímco konverzace se synchronizuje přes Anthropic.

To je hlavní rozdíl oproti Claude Code na webu, kde relace běží ve virtuálním počítači Anthropic v cloudu. Zde Claude stále běží na vašem hardwaru se všemi vašimi repozitáři Git, proměnnými prostředí a databázovými klíči. Telefon je jen obrazovka, přes kterou s ním komunikujete.

Proč by to mohl potřebovat vibe coder

Tři praktické situace, které autor využíval každý týden:

1. Dlouhý refaktoring přes noc. Zadejte Claude úkol aktualizovat 40 souborů pro nové API. Odejděte od notebooku. Ráno si lehněte na gauč s telefonem, zkontrolujte diff a řekněte: „Přijmi prvních 12; zbytek mi ukaž zvlášť.“ Notebook nemusíte otevírat.
2. Schválení kroku cestou do práce. Jste v metru, když Claude pošle push oznámení: „Potřebuji rozhodnutí ohledně migrace schématu.“ Otevřete ho, přečtěte si dvě možnosti a napište: „Zvol první možnost; testů se nedotýkej.“ Relace pokračuje, zatímco jedete.
3. Při živém vysílání nebo schůzce. Během schůzky na Zoomu můžete na telefonu zkontrolovat, zda druhá relace Claude vytvořila testovací sestavení. Nemusíte přepínat z videohovoru.

Co potřebujete ke spuštění Claude Code Remote Control?#

Úplná tabulka požadavků:

Verzi zkontrolujte příkazem:

claude --version

Pokud je nižší než 2.1.51, aktualizujte:

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

Pokud máte nastavené ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN nebo apiKeyHelper, Remote Control se nespustí. Od verze 2.1.139 (11.05.2026) Anthropic tuto funkci výslovně blokuje, když jsou tyto proměnné přítomné. Spusťte unset ANTHROPIC_API_KEY a znovu se přihlaste pomocí /login.

Jak spustit Remote Control: 3 způsoby za 2 minuty#

Způsob 1. Režim serveru — vyhrazený server pro vzdálené relace

1. Otevřete terminál ve složce projektu

   Jednou spusťte cd a přejděte do adresáře, ve kterém budete pracovat. Pokud jde o novou složku, spusťte obvyklým způsobem claude a dokončete dialog Důvěryhodnost pracovního prostoru.

2. Spusťte server

   claude remote-control
   

   Terminál zůstane spuštěný. Dole se zobrazí URL relace a výzva „Stisknutím mezerníku zobrazíte QR kód“. Server čeká na připojení.

3. Připojte se z telefonu

   Stiskněte mezerník — zobrazí se QR kód. Naskenujte ho aplikací Claude nebo fotoaparátem iPhonu a otevřete relaci.

Volitelné: nastavte název a parametry relace:

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

• --name — název relace zobrazený v seznamu na telefonu.
• --spawn worktree — každá nová relace se otevře ve vlastním pracovním stromu Git, aby si paralelní relace nepřekážely.
• --capacity 4 — maximálně 4 současné vzdálené relace na serveru. Výchozí hodnota je 32.

Způsob 2. Interaktivní režim — moje relace s aktivním Remote Control

claude --remote-control
# or shorter:
claude --rc

Tím se v terminálu spustí běžná interaktivní relace se zapnutým Remote Control. Claudeovi můžete psát z notebooku i telefonu — konverzace je jedna synchronizovaná relace.

Na rozdíl od režimu serveru jde o jednu relaci. Hodí se, když plánujete pracovat hlavně na počítači a chcete mít telefon jako záložní možnost, až budete potřebovat odejít.

Způsob 3. Z aktivní relace pomocí /rc

Už pracujete v Claude Code? Relaci neukončujte. Stačí zadat:

/remote-control

nebo stručněji:

/rc

Relace se přepne na vzdálenou. O její kontext nepřijdete. Hodí se, když si uprostřed úkolu uvědomíte, že potřebujete odejít.

QR kód: připojte telefon za 10 sekund#

1. Nainstalujte aplikaci Claude

   Pokud ji ještě nemáte, zadejte v Claude Code /mobile. Zobrazí se QR kód pro stažení aplikace z App Storu nebo Google Play. Je to rychlejší než ruční hledání.

2. Zobrazte QR kód relace v terminálu

   Po příkazu claude --rc nebo claude remote-control stiskněte mezerník. QR kód se objeví přímo v terminálu.

3. Naskenujte ho telefonem

   Otevřete aplikaci Claude → fotoaparát, nebo použijte běžný fotoaparát iPhonu (umí ho naskenovat i fotoaparáty Androidu). Pokud to nefunguje, zvětšete okno terminálu, přepněte na iTerm2 nebo Windows Terminal, případně zkopírujte URL nad QR kódem a ručně ji vložte do prohlížeče.

4. Zapněte push oznámení

   V relaci zadejte /config a zapněte „Upozornit, když Claude rozhodne“. Claude Code musí mít verzi 2.1.110 nebo novější.

Co uvidíte v telefonu

V aplikaci Claude se otevře karta Code. Vaše relace se objeví v seznamu s ikonou počítače a zelenou tečkou (online). Klepnutím do ní vstoupíte.

Pak je to jako v claude.ai/code: můžete vidět Claudeovy zprávy a rozdíly v souborech, schvalovat je nebo odmítat, případně požadovat změny. Můžete zadat nový požadavek. Vše se odešle do vašeho počítače, kde místní Claude zpracuje požadavek a vrátí odpověď.

Co může Claude dělat s push oznámeními

Claude posílá push oznámení, když usoudí, že jsou potřeba. Ve výchozím nastavení se to stává ve dvou případech: dokončí se dlouhý úkol, nebo Claude potřebuje vaše rozhodnutí. Můžete o ně také výslovně požádat: „Dej mi vědět, až testy projdou,“ a jedno oznámení pošle.

Pokud push oznámení nepřicházejí:

• Na iOS zkontrolujte Nastavení → Oznámení → Claude. Režimy soustředění je mohou ztišit.
• Na Androidu vypněte optimalizaci baterie pro aplikaci Claude.
• Pokud /config hlásí „Není registrováno žádné mobilní zařízení“, alespoň jednou otevřete aplikaci Claude, aby mohla aktualizovat push token.

Práce z gauče: 5 užitečných scénářů#

Scénář 1. Kontrola na gauči — kontrola nočního běhu

Před spaním zadejte Claude úkol, například: „Spusť celé úložiště podle nových pravidel lintování a oprav vše, co není kritické; zbytek označ jako TODO.“ Spusťte claude --rc a nechte terminál otevřený.

Ráno si lehněte na gauč s telefonem. Otevřete aplikaci Claude → najděte relaci se zelenou tečkou → uvnitř uvidíte 87 commitů jako diffy. Projděte je; u pochybných míst napište „vrať tuto změnu; opravím ji ručně“ a u čistých „přijmi vše“. V 7 ráno nemusíte „jít k notebooku“.

Scénář 2. Schválení během cesty — schválení kroku v metru

Ráno spusťte dlouhou migraci databázového schématu. V 9:30 dorazí v metru push oznámení: „Našel jsem dvě varianty migrace; potřebuji rozhodnutí.“ Klepněte na něj, přečtěte si je, jednu vyberte a přidejte: „Nemaž starou tabulku, dokud nebude dokončeno celé testování.“ Claude pokračuje.

Bez Remote Control by se Claude v tom okamžiku zastavil a čekal v tichosti. Dorazíte a otevřete notebook — ztratili jste 40 minut.

Scénář 3. Odchod na chvíli — dlouhý úkol během oběda

Před obědem zadejte Claude úkol „Aktualizuj dokumentaci všech koncových bodů“. Vyrazte do kavárny. Po 25 minutách přijde push oznámení: „Hotovo, podívej se.“ Jednou klepněte na „přijmout“ a vraťte se k polévce. Bez Remote Control byste buď 25 minut seděli u notebooku jako hlídač, nebo byste se vrátili a zjistili, že Claude celou dobu nic nedělal, protože narazil na místo vyžadující rozhodnutí.

To je důležitý bod. Remote Control nedělá Claude autonomnějším — pouze vám umožňuje přístup odkudkoli. Čím méně rozhodovacích bodů Claude potká, tím méně push oznámení dostanete. Proto zadání úkolu specifikujte přesněji: „Udělej to takto; v těchto případech postupuj takhle; pokud je to opravdu nejasné, zastav se a pošli push oznámení.“

Scénář 4. Architektonické rozhodnutí z kavárny

Uprostřed refaktoringu Claude najde dvě cesty migrace a požádá vás o výběr. Pokud nejste u počítače, otevřete navržené diffy v telefonu, vyberte možnost a přidejte komentář: „Ale nedotýkej se tabulky user_settings — příští týden ji odstraním.“ Relace pokračuje.

To funguje obzvlášť dobře v režimu pracovního stromu (--spawn worktree): každý paralelní úkol je ve vlastní větvi, takže si navzájem nepřekážejí. V telefonu mezi nimi přepínáte jako mezi chaty.

Scénář 5. Několik relací v pracovních stromech současně

Jedním z výkonných přístupů je režim serveru s několika pracovními stromy. Spusťte to na notebooku:

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

Z telefonu spusťte relace v různých větvích: jedna vytvoří funkci, druhá opraví chyby ze seznamu a třetí spustí regresní testy. Všechny běží souběžně na notebooku; žádná neblokuje jinou.

Zabezpečení: co zůstává v počítači a co se odesílá#

Před připojením citlivého projektu určete, který obsah smí vstoupit do zadání a výstupu nástrojů. Produkční tajné údaje ponechte mimo prostředí dostupné agentovi; tabulka přenosů nedokazuje, že je konkrétní relace nemůže zpřístupnit.

V běžné řeči: váš notebook se zeptá Anthropic: „Máte pro mě nějaké zprávy?“, dostane odpověď a zpracuje ji místně. Nikdo zvenčí neotevírá příchozí port do vašeho počítače. Firemní firewall to povolí bez zvláštní konfigurace.

Jaká data se fyzicky odesílají Anthropic

Remote Control přidává synchronizované rozhraní, nikoli režim místní inference bez sítě. Anthropic uchovává přepis připojené relace včetně zpráv, odpovědí a aktivity nástrojů podle svých zásad používání dat. Prověřte data odesílaná modelu i přístup připojených zařízení.

Poznámka k přihlašovacím údajům

Jinými slovy, mezi vaším notebookem, Anthropic a telefonem koluje sada krátkodobých tokenů namísto jednoho dlouhodobě platného tokenu. Kompromitování jednoho vám neposkytne přístup ke všem.

Je tu ještě jedno důležité omezení: --dangerously-skip-permissions v Remote Control nefunguje. Každé volání nástroje (Bash, Write, Edit) stále čeká na vaše schválení. Je to záměr — aby se funkce pro telefon nezměnila v „notebook na autopilota bez dozoru“.

Spustili jste Remote Control? Teď vše nastavte tak, aby vás Claude nerušil každých 10 minut#

/rc je pohodlný způsob, jak dostat relaci do telefonu. Pokud ale Claude každých 10 minut napíše „Nevím, co mám dělat“, problém není v telefonu, ale v inženýrství kontextu: v tom, jak jasně na začátku stanovíte pravidla.

Šest problémů při prvním spuštění a jak je vyřešit#

Problém 1. „Pro váš účet nejsou dostupná prostředí Remote Control“

Nejčastější stížnost v repozitáři anthropics/claude-code (issue #29449 a více než tucet duplicitních hlášení). Odpověděli jste y na otázku „zapnout Remote Control?“ — CLI vrátilo chybu a už nenabízí další pokus.

Příčina je téměř vždy stejná: v prostředí je nastaveno ANTHROPIC_API_KEY nebo CLAUDE_CODE_OAUTH_TOKEN. Remote Control funguje pouze přes plné OAuth přihlášení pomocí /login, nikoli s klíčem.

Oprava:

unset ANTHROPIC_API_KEY
unset CLAUDE_CODE_OAUTH_TOKEN
unset apiKeyHelper

# check that the environment is clean:
env | grep -i anthropic
env | grep -i claude

# sign in again:
claude
/logout
/login

Po přihlášení přes prohlížeč pomocí /login by se Remote Control mělo spustit.

Problém 2. Telefonem nelze naskenovat QR kód

Fotoaparát telefonu míří na kód, ale nereaguje nebo hlásí: „Nelze přečíst“.

Příčina: terminál zobrazuje QR kód příliš malý nebo s příliš nízkým kontrastem.

Oprava:

1. Rozšiřte okno terminálu na celou obrazovku.
2. Pokud používáte Apple Terminal, přejděte na iTerm2 (nebo Warp). Ve Windows použijte Windows Terminal místo CMD.
3. Zmenšete velikost písma terminálu o 1–2 body, aby se QR kód zobrazil větší.
4. Pokud to nepomůže, zkopírujte URL nad QR kódem a otevřete ji v prohlížeči telefonu.

Problém 3. Firewall blokuje port 443

Obvykle k tomu dochází na firemních počítačích se zachytávající proxy (Zscaler nebo firemní VPN s MITM).

Oprava: začněte s podrobnými protokoly a zachyťte konkrétní chybu:

claude remote-control --verbose

Pokud uvidíte „ověření certifikátu selhalo“, dochází k odposlechu MITM a musíte se obrátit na správce sítě. Pokud uvidíte „připojení odmítnuto“ / „vypršel časový limit“, požádejte správce o povolení odchozího přístupu na *.anthropic.com:443.

Problém 4. Claude Code je příliš zastaralý

Zkontrolujte:

claude --version

Pokud je nižší než 2.1.51, aktualizujte:

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

Rozšíření VS Code vyžaduje alespoň v2.1.79. Push oznámení vyžadují v2.1.110.

Problém 5. Push oznámení nepřicházejí

Situace: Remote Control funguje, ale telefon zůstane tichý, když Claude dokončí dlouhý úkol.

Kontrolní seznam:

1. V relaci spusťte /config. Pokud hlásí „Není registrováno žádné mobilní zařízení“, alespoň jednou otevřete aplikaci Claude v telefonu, aby mohla aktualizovat push token.
2. iOS: Nastavení → Oznámení → Claude → zkontrolujte, že jsou oznámení zapnutá a režim Soustředění je netlumí.
3. Android: otevřete nastavení baterie a vyjměte Claude z optimalizace baterie.
4. Pokud je zapnutý souhrn oznámení iOS, push může dorazit, ale zobrazit se v hodinovém souhrnu. Vypněte souhrn pro Claude.

Problém 6. Claude Desktop narušuje /remote-control

Pokud v aplikaci Claude Desktop spustíte /remote-control, zobrazí se chyba „Remote Control vyžaduje přihlašovací token s plným rozsahem“ (GitHub issue #48378).

Příčina: Claude Desktop vkládá OAuth token s omezenými oprávněními (pouze inference).

Oprava: spusťte Claude Code v běžném systémovém terminálu, nikoli v terminálu vestavěném do Claude Desktop. Jde o známé omezení; Anthropic pracuje na opravě.

Bonus. Automatické opětovné připojení v dlouhých relacích tiše selže

Příznak: relace Remote Control běží 30–60 minut, pak se telefon bez upozornění tiše odpojí (issue #34255). Opravte to ručně: /remote-control → Odpojit → znovu spustit. Není to ideální, ale funkce je stále ve fázi výzkumného náhledu.

Jen v květnu 2026 Anthropic dodal osm oprav zaměřených konkrétně na Remote Control — funkce se aktivně vylepšuje. Můžete si stěžovat, ale je rozumné očekávat, že většina těchto problémů během několika měsíců zmizí.

Remote Control vs. Telegram boti a SSH+tmux#

Srovnávací tabulka

Kdy zvolit jednotlivé možnosti

• Remote Control — výchozí nastavení pro „odejít od notebooku a dál řídit práci“. Úplné rozhraní, synchronizace zařízení a žádné služby třetích stran.
• Channels (bot Telegramu) — když chcete, aby selhání CI, nová stížnost zákazníka nebo zpráva v chatu automaticky vyzvala Claude k vyšetření. Jde o „událost → Claude reaguje“ místo „řídím Claude z telefonu“. Více se dočtete v návodu k Telegramu a Claude Code.
• SSH + tmux — když potřebujete v telefonu libovolný shell pro vlastní příkazy (nasadit vydání, zkontrolovat protokol, restartovat službu). Univerzální shell mimo Claude Code. Pro jednorázové úkoly funguje přes Termux/Blink.
• Další agenti pro programování — Anthropic Remote Control je pouze pro Claude Code. Srovnání Claude a alternativ najdete v Cursor vs Claude Code.

Vlastní dokumentace Anthropic tedy tyto dvě funkce rozlišuje podle případu použití: Remote Control slouží k ovládání; Channels k reakci.

Co je v Remote Control nového od května 2026 do června 2026#

Úplná časová osa oprav:

Osm oprav specifických pro Remote Control za jeden měsíc je u funkce ve fázi výzkumného náhledu běžné. Anthropic zjevně reaguje na zpětnou vazbu a řeší okrajové případy.

Pokud se funkce chová podivně, nejprve zkontrolujte verzi a aktualizujte ji. Je dost možné, že chyba už byla opravena.

Kontrolní seznam: nastavte ho a zprovozněte za 5 minut#

1. Zkontrolujte verzi Claude Code

   claude --version — měla by být 2.1.51 nebo novější. Pokud není, spusťte npm install -g @anthropic-ai/claude-code@latest.

2. Odeberte klíče API z prostředí

   Spusťte unset ANTHROPIC_API_KEY a unset CLAUDE_CODE_OAUTH_TOKEN. Poté v prohlížeči spusťte /logout → /login.

3. Nainstalujte aplikaci Claude do telefonu

   V relaci Claude Code spusťte /mobile, aby se zobrazil QR kód pro App Store / Google Play.

4. Spusťte Remote Control

   Spusťte claude --rc nebo v relaci zadejte /rc. Zobrazí se URL a výzva „Stisknutím mezerníku zobrazíte QR kód“.

5. Naskenujte QR kód telefonem

   Stiskněte v terminálu mezerník → použijte fotoaparát nebo aplikaci Claude. Pokud se kód nenačte, zvětšete okno terminálu.

6. Zapněte push oznámení

   /config → „Upozornit, když Claude rozhodne“. Pokud se zobrazí „Není registrováno žádné mobilní zařízení“, alespoň jednou otevřete aplikaci Claude.

7. Spusťte dlouhý úkol a odejděte

   Upřesněte zadání: „Udělej to takto; v těchto případech postupuj takhle; v nejasných případech pošli push oznámení.“ Pak pracujte z telefonu s využitím push oznámení.

V praktickém příkladu to od začátku až po první konverzaci z gauče trvalo 3–5 minut.

Až budete připraveni, seznamte se s Ailoot.