Claude Code Remote Control: QR код арқылы 2026 жылы телефоннан код жазу

Қосымша нұсқаулар Ailoot құжаттамасында берілген.

Remote Control деген не және телефоннан кодты не үшін жазу керек?#

Anthropic Remote Control мүмкіндігін 2026 жылғы 24 ақпанда шығарды. Anthropic оны жергілікті сеанстарды кез келген құрылғыдан жалғастыру тәсілі деп сипаттайды.

Қарапайым тілмен айтқанда: әдеттегідей терминалда сеанс бастайсыз. Remote Control-ды қосыңыз. Телефоныңызда Claude қолданбасын ашыңыз → Code қойындысына өтіңіз → сонда жасыл нүктесі бар сеансыңызды көресіз. Оны түртіп, оқып, жауап беріңіз. Ноутбуктен, телефоннан және браузерден кез келген ретпен жаза аласыз — бәрі синхрондалады.

Ресми Remote Control құжаттамасы жергілікті орындауды желілік трафиктен ажыратады: пәрмендер мен файлдық әрекеттер машинаңызда орындалады, ал әңгіме Anthropic арқылы синхрондалады.

Бұл сеанс Anthropic-тің бұлттағы виртуалды машинасында орындалатын вебтегі Claude Code-тан басты айырмашылығы. Мұнда Claude Git репозиторийлеріңіз, орта айнымалыларыңыз және дерекқор кілттеріңіз бар өз жабдығыңызда жұмыс істей береді. Телефон — онымен сөйлесуге арналған экран ғана.

Vibe coder-ге бұл не үшін керек болуы мүмкін?

Автор апта сайын пайдаланған үш практикалық жағдай:

1. Түнге қалдырылатын ұзақ рефакторинг. Claude-қа жаңа API үшін 40 файлды жаңарту тапсырмасын беріңіз. Ноутбуктен алыстаңыз. Таңертең диванда жатып телефоннан diff-ті қарап, «Алғашқы 12-сін қабылда; қалғанын бөлек көрсет» деңіз. Ноутбукты ашудың қажеті жоқ.
2. Жұмысқа бара жатқанда бір қадамды мақұлдау. Метромен келе жатқанда Claude-тан push-хабарлама келеді: «Схеманы көшіру жөнінде шешім керек». Ашып, екі нұсқаны оқып, «Бірінші нұсқаны таңда; тесттерге тиме» деп жазыңыз. Жолда келе жатсаңыз да сеанс жалғасады.
3. Тікелей эфирді немесе жиналысты қатар бақылау. Zoom жиналысында отырғанда телефоныңыздан Claude-тың екінші сеансы тест құрастыруын жасап болғанын тексере аласыз. Бейнеқоңыраудан басқа терезеге ауысудың қажеті жоқ.

Remote Control іске қосу үшін не қажет?#

Талаптардың толық кестесі:

Нұсқаны мына пәрменмен тексеріңіз:

claude --version

Егер нұсқаңыз 2.1.51-ден ескі болса, жаңартыңыз:

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

Ортаңызда ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN немесе apiKeyHelper орнатылған болса, Remote Control іске қосылмайды. v2.1.139 нұсқасынан бастап (11.05.2026) Anthropic осы айнымалылар болғанда функцияны тікелей бұғаттайды. unset ANTHROPIC_API_KEY пәрменін орындап, /login арқылы қайта кіріңіз.

Remote Control-ды қалай бастауға болады: 2 минутта 3 тәсіл#

1-тәсіл. Сервер режимі — қашықтағы сеанстарға арналған жеке сервер

1. Жоба қалтасында терминал ашыңыз

   Жұмыс істейтін каталогқа өту үшін cd пәрменін бір рет орындаңыз. Бұл жаңа қалта болса, Workspace Trust диалогын аяқтау үшін әдеттегідей claude пәрменін орындаңыз.

2. Серверді іске қосыңыз

   claude remote-control
   

   Терминал ашық тұрады. Төменгі жағында сеанс URL-і және «QR көрсету үшін бос орын пернесін басыңыз» деген сұрау пайда болады. Сервер қосылымдарды күтіп тұрады.

3. Телефоннан қосылыңыз

   Space пернесін басыңыз — QR код пайда болады. Сеансты ашу үшін оны Claude қолданбасымен немесе iPhone камерасымен сканерлеңіз.

Қосымша: сеанс атауы мен параметрлерін орнатыңыз:

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

• --name — телефондағы тізімде сеансқа көрсетілетін атау.
• --spawn worktree — әр жаңа сеанс өз Git worktree ішінде ашылады, сондықтан қатар орындалған сеанстар бір-біріне кедергі жасамайды.
• --capacity 4 — сервердегі бір мезгілдегі қашықтағы сеанстардың ең көбі 4 болатынын білдіреді. Әдепкі мәні — 32.

2-тәсіл. Интерактивті режим — Remote Control қосылған өз сеансым

claude --remote-control
# немесе қысқаша:
claude --rc

Бұл терминалда Remote Control қосылған кәдімгі интерактивті сеансты бастайды. Claude-қа ноутбуктен де, телефоннан да жаза аласыз — әңгіме бір синхрондалған сеанста жүреді.

Сервер режимінен айырмашылығы — бұл бір ғана сеанс. Компьютерден көбірек жұмыс істеп, орныңыздан кету қажет болғанда телефонды қосалқы құрал ретінде пайдаланғыңыз келсе, осы режим ыңғайлы.

3-тәсіл. Белсенді сеанстан /rc арқылы

Claude Code-та жұмыс істеп жатырсыз ба? Сеансты жаппаңыз. Жай ғана мынаны теріңіз:

/remote-control

немесе қысқаша:

/rc

Сеанс қашықтан басқарылатын болады. Оның контексті жоғалмайды. Тапсырманың ортасында орныңыздан кету керегін түсінгенде пайдалы.

QR код: телефонды 10 секундта қосу#

1. Claude қолданбасын орнатыңыз

   Әлі орнатпаған болсаңыз, Claude Code-та /mobile деп теріңіз. App Store немесе Google Play дүкенінен қолданбаны жүктеуге арналған QR код пайда болады. Бұл қолданбаны қолмен іздегеннен жылдамырақ.

2. Сеанстың QR кодын терминалда көрсетіңіз

   claude --rc немесе claude remote-control пәрменінен кейін Space пернесін басыңыз. QR код терминалда бірден көрінеді.

3. Телефонмен сканерлеңіз

   Claude қолданбасын ашыңыз → камераны таңдаңыз немесе iPhone камерасын пайдаланыңыз (Android камералары да сканерлей алады). Істемесе, терминал терезесін кеңейтіңіз, iTerm2 не Windows Terminal қолданып көріңіз немесе QR кодтың үстіндегі URL-ді көшіріп, браузерге қолмен қойыңыз.

4. Push-хабарландыруларды қосыңыз

   Сеанста /config деп теріп, «Claude шешім қабылдағанда push-хабарлама жіберу» параметрін қосыңыз. Claude Code 2.1.110 немесе одан кейінгі нұсқада болуы керек.

Телефоныңызда не көрінеді?

Claude қолданбасында Code қойындысы ашылады. Сеансыңыз компьютер белгішесі және жасыл нүктесі бар тізімде көрінеді (онлайн). Оған кіру үшін түртіңіз.

Одан кейін claude.ai/code сияқты Claude хабарламалары мен файл diff-терін көріп, оларды мақұлдай не кері қайтара аласыз немесе өзгеріс сұрай аласыз. Жаңа сұрау да жаза аласыз. Барлығы компьютеріңізге жіберіледі; жергілікті Claude оны өңдеп, жауап қайтарады.

Claude push-хабарландыруларымен не істей алады?

Claude қажет деп шешкен кезде push-хабарландыру жібереді. Әдепкіде бұл екі жағдайда болады: ұзақ тапсырма аяқталғанда немесе Claude сіздің шешіміңізді қажет еткенде. «Тесттер өткенде маған хабарла» деп тікелей сұрай аласыз — сонда да хабарлама жібереді.

Push-хабарландырулар келмесе:

• iOS-та Settings → Notifications → Claude тармағын тексеріңіз. Focus режимдері хабарландыруларды үнсіз етуі мүмкін.
• Android-та Claude қолданбасы үшін батареяны оңтайландыруды өшіріңіз.
• /config ішінде «No mobile registered» деп көрсетілсе, push токенін жаңарту үшін Claude қолданбасын кемінде бір рет ашыңыз.

Диванда отырып жұмыс істеу: пайдалы 5 жағдай#

1-жағдай. Диванда тексеру — түнгі жұмыстың нәтижесін қарау

Ұйықтар алдында Claude-қа «Бүкіл репозиторийді жаңа lint ережелерімен тексеріп, маңызды емес қателердің бәрін түзет; қалғанын TODO деп белгіле» сияқты тапсырма беріңіз. claude --rc пәрменін іске қосып, терминалды ашық қалдырыңыз.

Таңертең телефонды алып, диванға жатыңыз. Claude қолданбасын ашыңыз → жасыл нүктесі бар сеансты көресіз → оның ішінде 87 коммиттің diff-тері бар. Оларды қарап шығып, күмәнді тұстарда «мынаны кері қайтар; өзім қолмен түзетемін», ал дұрыс жерлерде «бәрін қабылда» деп жазыңыз. Таңғы 7-де ноутбукке барудың қажеті жоқ.

2-жағдай. Жолда мақұлдау — метродағы қадамды мақұлдау

Таңертең дерекқор схемасын көшіруге арналған ұзақ жұмысты бастаңыз. 9:30-да метрода келе жатқанда push-хабарлама келеді: «Көшірудің екі нұсқасын таптым; шешім керек». Түртіп, оқып, біреуін таңдаңыз да, «Ескі кестені толық тестілеу аяқталғанша жойма» деп қосыңыз. Claude жұмысын жалғастырады.

Remote Control болмаса, Claude осы жерде тоқтап, үнсіз күтер еді. Жетіп, ноутбукты ашқанша 40 минут жоғалады.

3-жағдай. Орныңыздан кету — түскі ас кезінде ұзақ тапсырма

Түскі асқа дейін Claude-қа «Барлық endpoint құжаттамасын жаңарт» деп тапсырма беріңіз. Дәмханаға барыңыз. 25 минуттан кейін «Дайын, қарап шық» деген push келеді. «Қабылдау» түймесін бір рет түртіп, сорпаңызды жалғастырыңыз. Remote Control болмаса, не 25 минут күзетші сияқты ноутбук алдында отырасыз, не Claude шешім қажет ететін жерге тіреліп, бүкіл уақыт бойы ештеңе жасамағанын көресіз.

Маңыздысы — Remote Control Claude-ты дербестірмейді, тек оған кез келген жерден қол жеткізуге мүмкіндік береді. Claude неғұрлым аз шешім қабылдау нүктесіне тап болса, сізге келетін push-хабарландыру да соғұрлым аз болады. Сондықтан тапсырма нұсқауларын нақтырақ жазыңыз: «Мұны осылай істе; мына жағдайларда былай жаса; шынымен түсініксіз болса, тоқтап, push-хабарлама жібер».

4-жағдай. Дәмханадан архитектуралық шешім қабылдау

Рефакторингтің ортасында Claude көшірудің екі жолын тауып, бірін таңдауды сұрайды. Компьютеріңізден алыс болсаңыз, ұсынылған diff-терді телефоннан ашып, бір нұсқаны таңдап, «Бірақ user_settings кестесіне тиме — оны келесі аптада өшіремін» деп қосыңыз. Сеанс жалғаса береді.

Бұл әсіресе worktree режимінде (--spawn worktree) жақсы жұмыс істейді: қатар орындалатын әр тапсырма өз тармағында болады, сондықтан бір-біріне кедергі жасамайды. Телефонда олардың арасында чаттар сияқты ауыса аласыз.

5-жағдай. Бірнеше worktree сеансын қатар жүргізу

Сервер режимін бірнеше worktree-мен бірге пайдалану — тиімді тәсілдердің бірі. Мұны ноутбукте іске қосыңыз:

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

Телефоннан әртүрлі тармақтарда сеанстар бастаңыз: біреуі функция жасайды, екіншісі тізімдегі қателерді жөндейді, үшіншісі регрессиялық тесттерді орындайды. Барлығы ноутбукте қатар жұмыс істейді; бірде-бірі екіншісіне бөгет болмайды.

Қауіпсіздік: компьютеріңізде не қалады, не жіберіледі?#

Құпия жоба қоспас бұрын промпттар мен құрал шығысына қандай мазмұн кіре алатынын шешіңіз. Өндірістік құпияларды агент қолы жететін ортадан тыс сақтаңыз; тасымалдау кестесі нақты сеанс оларды жариялай алмайтынын дәлелдемейді.

Қарапайым тілмен айтқанда, ноутбугіңіз Anthropic-тен «Маған хабарламалар бар ма?» деп сұрап, жауап алады да, оны жергілікті өңдейді. Сырттан ешкім компьютеріңізге кіретін порт ашпайды. Корпоративтік брандмауэр мұны арнайы баптаусыз өткізуге мүмкіндік береді.

Anthropic-ке нақты қандай дерек жіберіледі?

Remote Control офлайн модель есептеуін емес, синхрондалған интерфейсті қосады. Anthropic қосылған сеанстың хабарламалар, жауаптар және құрал әрекеттері бар мәтінін өз дерек пайдалану саясаты бойынша сақтайды. Модельге жіберілетін деректі де, қосылған құрылғылардан қолжетімділікті де қараңыз.

Тіркелгі деректері туралы ескерту

Басқаша айтқанда, бір ұзақ мерзімді токеннің орнына ноутбук, Anthropic және телефон арасында қысқа мерзімді токендер жиыны айналып жүреді. Біреуі бұзылса да, қалғанының бәріне қол жеткізу мүмкін болмайды.

Тағы бір маңызды шектеу: Remote Control режимінде --dangerously-skip-permissions жұмыс істемейді. Әр құрал шақыруы (Bash, Write, Edit) сіздің мақұлдауыңызды күте береді. Бұл әдейі жасалған — телефоннан басқару мүмкіндігі «бақылаусыз автопилоттағы ноутбукке» айналмауы үшін.

Remote Control-ды іске қостыңыз ба? Енді Claude сізді әр 10 минут сайын бөлмес үшін баптаңыз#

/rc — сеансты телефоннан ашудың ыңғайлы тәсілі. Бірақ Claude әр 10 минут сайын «Не істеу керегін түсінбедім» деп жазса, мәселе телефонда емес; ол контексті жобалауда: бастапқыда ережелерді қаншалықты анық қойғаныңызда.

Алғаш іске қосқандағы 6 мәселе және оларды шешу жолдары#

1-мәселе. «Remote Control environments are not available for your account»

anthropics/claude-code репозиторийіндегі ең жиі шағым (#29449 мәселесі және ондағаннан астам қайталанған есеп). «enable Remote Control?» деген сұраққа y деп жауап бердіңіз — CLI қате қайтарып, қайта көруді ұсынбайды.

Себебі әрдайым дерлік біреу: ортада ANTHROPIC_API_KEY немесе CLAUDE_CODE_OAUTH_TOKEN орнатылған. Remote Control тек /login арқылы толық OAuth-пен жұмыс істейді, кілтпен жұмыс істемейді.

Шешімі:

unset ANTHROPIC_API_KEY
unset CLAUDE_CODE_OAUTH_TOKEN
unset apiKeyHelper

# ортаның таза екенін тексеру:
env | grep -i anthropic
env | grep -i claude

# қайта кіру:
claude
/logout
/login

Браузер арқылы /login жасағаннан кейін Remote Control іске қосылуы керек.

2-мәселе. Телефоныңыз QR кодты сканерлемейді

Телефон камерасын кодқа бағыттайсыз, бірақ ештеңе болмайды немесе «Мұны оқу мүмкін емес» дейді.

Себебі: терминал QR кодты тым кішкентай немесе контрасты аз етіп көрсетеді.

Шешімі:

1. Терминал терезесін толық экранға үлкейтіңіз.
2. Apple Terminal қолдансаңыз, iTerm2-ге (немесе Warp-қа) ауысыңыз. Windows қолдансаңыз, CMD орнына Windows Terminal пайдаланыңыз.
3. QR код үлкенірек көрінуі үшін терминал қарпінің өлшемін 1–2 пунктке кішірейтіңіз.
4. Бұл көмектеспесе, QR кодтың үстіндегі URL-ді көшіріп, телефон браузерінде ашыңыз.

3-мәселе. Брандмауэр 443-портты бұғаттайды

Бұл әдетте трафикті ұстап қалатын проксиі бар корпоративтік компьютерлерде болады (Zscaler немесе MITM қолданатын корпоративтік VPN).

Шешімі: алдымен толық журналдарды қосып, нақты қатені тіркеңіз:

claude remote-control --verbose

«certificate verification failed» көрсеңіз, MITM трафикті ұстап тұр; желі әкімшісіне хабарласуыңыз керек. «connection refused» / «timeout» көрсеңіз, әкімшіден *.anthropic.com:443 мекенжайына сырттан қосылуға рұқсат беруді сұраңыз.

4-мәселе. Claude Code нұсқасы тым ескі

Тексеріңіз:

claude --version

Егер нұсқаңыз 2.1.51-ден ескі болса, жаңартыңыз:

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

VS Code кеңейтіміне кемінде v2.1.79 қажет. Push-хабарландырулар үшін v2.1.110 керек.

5-мәселе. Push-хабарландырулар келмейді

Жағдай: Remote Control жұмыс істейді, бірақ Claude ұзақ тапсырманы аяқтағанда телефон үнсіз қалады.

Тексеру тізімі:

1. Сеанста /config пәрменін орындаңыз. «No mobile registered» десе, push токенін жаңарту үшін телефондағы Claude қолданбасын кемінде бір рет ашыңыз.
2. iOS: Settings → Notifications → Claude → хабарландырулардың қосулы екенін және Focus режимі оларды үнсіз етпегенін тексеріңіз.
3. Android: батарея баптауларын ашып, Claude қолданбасын батареяны оңтайландырудан алып тастаңыз.
4. iOS Notification Summary қосулы болса, push хабарламасы келсе де, сағат сайынғы қорытындыда көрінуі мүмкін. Claude үшін Summary-ді өшіріңіз.

6-мәселе. Claude Desktop /remote-control пәрменін бұзады

Claude Desktop қолданбасында /remote-control пәрменін орындасаңыз, «Remote Control requires a full-scope login token» қатесін аласыз (GitHub-тағы #48378 мәселесі).

Себебі: Claude Desktop шектеулі рұқсаттары бар OAuth токенін енгізеді (тек inference).

Шешімі: Claude Code-ты Claude Desktop ішіндегі терминалда емес, кәдімгі жүйелік терминалда іске қосыңыз. Бұл — белгілі шектеу; Anthropic оны түзетіп жатыр.

Қосымша. Ұзақ сеанстарда автоматты қайта қосылу үнсіз тоқтайды

Белгісі: Remote Control сеансы 30–60 минут жұмыс істеген соң, ешқандай белгі берместен телефоннан ажырайды (#34255 мәселесі). Қолмен түзетіңіз: /remote-control → Disconnect → қайта іске қосыңыз. Бұл қолайлы емес, бірақ мүмкіндік әлі де зерттеу алдындағы алдын ала нұсқада.

Тек 2026 жылғы мамырда Anthropic Remote Control-ға арнайы сегіз түзету шығарды — функция белсенді түрде жетілдіріліп жатыр. Шағымдануға болады, бірақ бұл мәселелердің көбі бір-екі айда жойылады деп күту орынды.

Remote Control мен Telegram боттары және SSH+tmux салыстыруы#

Салыстыру кестесі

Әр нұсқаны қашан таңдау керек?

• Remote Control — «ноутбуктен алыстап, жұмысты бағыттауды жалғастыруға» арналған әдепкі таңдау. Толық интерфейс, құрылғыларды синхрондау және үшінші тарап қызметтері жоқ.
• Channels (Telegram боты) — CI қатесі, жаңа тұтынушы шағымы немесе чат хабарламасы Claude-ты автоматты түрде тексеруге итермелесін десеңіз. Бұл «мен Claude-ты телефоннан басқарамын» дегеннен гөрі «оқиға → Claude жауап береді» үлгісі. Telegram мен Claude Code туралы нұсқаулықтан көбірек оқыңыз.
• SSH + tmux — өз пәрмендеріңізді орындау үшін телефонда кез келген shell керек болғанда (релиз шығару, журнал тексеру, қызметті қайта іске қосу). Claude Code-тан тыс әмбебап shell. Бір реттік тапсырмалар үшін Termux/Blink арқылы істейді.
• Басқа кодтау агенттері — Anthropic Remote Control тек Claude Code-қа арналған. Claude пен баламаларын салыстыру үшін Cursor мен Claude Code салыстыруын қараңыз.

Сондықтан Anthropic-тің ресми құжаттамасы бұл екі мүмкіндікті қолданылу мақсаты бойынша ажыратады: Remote Control — басқаруға, Channels — оқиғаларға жауап беруге арналған.

Remote Control-дағы 2026 жылғы мамыр мен маусым арасындағы жаңалықтар#

Түзетулердің толық реті:

Бір айда Remote Control-ға арналған сегіз түзету зерттеу алдындағы алдын ала нұсқа үшін қалыпты жағдай. Anthropic кері байланысқа жауап беріп, шеткі жағдайларды түзетіп жатқаны анық.

Функция сізде оғаш жұмыс істесе, алдымен нұсқасын тексеріп, жаңартыңыз. Қате әлдеқашан түзетілген болуы мүмкін.

Тексеру тізімі: 5 минутта орнатып, іске қосу#

1. Claude Code нұсқасын тексеріңіз

   claude --version — нұсқа 2.1.51 немесе одан кейінгі болуы керек. Ескі болса, npm install -g @anthropic-ai/claude-code@latest пәрменін орындаңыз.

2. Ортадан API кілттерін алып тастаңыз

   unset ANTHROPIC_API_KEY және unset CLAUDE_CODE_OAUTH_TOKEN пәрмендерін орындаңыз. Содан кейін браузер арқылы /logout → /login пәрмендерін орындаңыз.

3. Claude қолданбасын телефонға орнатыңыз

   App Store / Google Play дүкенінен жүктеу QR кодын көрсету үшін Claude Code сеансында /mobile пәрменін орындаңыз.

4. Remote Control-ды бастаңыз

   claude --rc пәрменін орындаңыз немесе белсенді сеанста /rc деп жазыңыз. URL және «QR көрсету үшін бос орын пернесін басыңыз» деген сұрау шығады.

5. QR кодты телефонмен сканерлеңіз

   Терминалда Space пернесін басыңыз → камераны немесе Claude қолданбасын пайдаланыңыз. Сканерленбесе, терминал терезесін кеңейтіңіз.

6. Push-хабарландыруларды қосыңыз

   /config → «Claude шешім қабылдағанда push-хабарлама жіберу». «No mobile registered» десе, Claude қолданбасын кемінде бір рет ашыңыз.

7. Ұзақ тапсырма бастап, орныңыздан кетіңіз

   Сұрау мәтінін нақтылаңыз: «Мұны осылай істе; мына жағдайларда былай жаса; күмәнді болса, push-хабарлама жібер». Содан кейін push-хабарландырулар арқылы телефоннан жұмысты жалғастырыңыз.

Бір практикалық мысалда бәрін жаңадан орнатып, диванда отырып алғашқы сөйлесуге дейін 3–5 минут кетті.

Дайын болғанда, Ailoot-пен танысыңыз.