رفتن به محتوا
Claude Code Docs غیر رسمی

ادامه‌ی نشست‌های محلی از هر دستگاهی با Remote Control

Remote Control، claude.ai/code یا اپلیکیشنِ Claude برای iOS و Android را به یک نشستِ Claude Code که روی ماشینت در حالِ اجراست وصل می‌کند. کاری را پشتِ میزت شروع کن، بعد از روی مبل با گوشی‌ات یا با یک مرورگر روی کامپیوترِ دیگری ادامه‌اش بده.

وقتی یک نشستِ Remote Control را روی ماشینت شروع می‌کنی، Claude در تمامِ مدت به‌صورتِ محلی به اجرا ادامه می‌دهد، پس هیچ‌چیز به ابر نمی‌رود. با Remote Control می‌توانی:

  • از کلِ محیطِ محلی‌ات از راهِ دور استفاده کنی: filesystem، سرورهای MCP، ابزارها، و پیکربندیِ پروژه‌ات همگی در دسترس می‌مانند، و تایپِ @ مسیرهای فایل را از پروژه‌ی محلی‌ات تکمیلِ خودکار می‌کند
  • هم‌زمان از هر دو سطح کار کنی: مکالمه در همه‌ی دستگاه‌های متصل هم‌گام می‌ماند، پس می‌توانی پیام‌ها را از ترمینال، مرورگر، و گوشی‌ات به‌تناوب بفرستی
  • از وقفه‌ها جان به در ببری: اگر لپ‌تاپت بخوابد یا شبکه‌ات قطع شود، نشست وقتی ماشینت دوباره آنلاین شود خودکار دوباره وصل می‌شود

برخلافِ Claude Code on the web، که روی زیرساختِ ابری اجرا می‌شود، نشست‌های Remote Control مستقیماً روی ماشینت اجرا می‌شوند و با filesystem محلی‌ات تعامل می‌کنند. رابط‌های وب و موبایل فقط پنجره‌ای به آن نشستِ محلی‌اند.

این صفحه راه‌اندازی، نحوه‌ی شروع و اتصال به نشست‌ها، و مقایسه‌ی Remote Control با Claude Code on the web را پوشش می‌دهد.

پیش‌نیازها

Section titled “پیش‌نیازها”

پیش از استفاده از Remote Control، تأیید کن که محیطت این شرایط را برآورده می‌کند:

  • اشتراک: روی پلن‌های Pro، Max، Team، و Enterprise در دسترس است. API keyها پشتیبانی نمی‌شوند. روی Team و Enterprise، یک admin باید ابتدا گزینه‌ی Remote Control را در تنظیماتِ admin برای Claude Code فعال کند.
  • احرازِ هویت: claude را اجرا کن و اگر هنوز وارد نشده‌ای، با /login از طریقِ claude.ai وارد شو.
  • اعتمادِ workspace: claude را دستِ‌کم یک‌بار در پوشه‌ی پروژه‌ات اجرا کن تا دیالوگِ اعتمادِ workspace را بپذیری.

شروعِ یک نشستِ Remote Control

Section titled “شروعِ یک نشستِ Remote Control”

می‌توانی یک نشستِ Remote Control را از CLI یا از افزونه‌ی VS Code شروع کنی. CLI سه حالتِ فراخوانی ارائه می‌دهد؛ VS Code از commandِ /remote-control استفاده می‌کند.

به پوشه‌ی پروژه‌ات برو و اجرا کن:

Terminal window
claude remote-control

پروسه در ترمینالت در حالتِ سرور به اجرا ادامه می‌دهد و منتظرِ اتصال‌های راهِ دور می‌ماند. یک URL نشست نمایش می‌دهد که می‌توانی برای اتصال از دستگاهی دیگر استفاده کنی، و می‌توانی spacebar را بزنی تا یک QR code برای دسترسیِ سریع از گوشی‌ات نمایش داده شود. تا وقتی یک نشستِ راهِ دور فعال است، ترمینال وضعیتِ اتصال و فعالیتِ ابزارها را نشان می‌دهد.

پرچم‌های در دسترس:

پرچمتوضیح
--name "My Project"یک عنوانِ سفارشیِ نشست تنظیم می‌کند که در فهرستِ نشست‌ها در claude.ai/code دیده می‌شود.
--remote-control-session-name-prefix <prefix>پیشوند برای نام‌های نشستِ خودکارساخته‌شده وقتی نامی صریح تنظیم نشده. به‌صورتِ پیش‌فرض hostname ماشینت است، که نام‌هایی مثلِ myhost-graceful-unicorn تولید می‌کند. برای همین اثر CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX را تنظیم کن.
--spawn <mode>اینکه سرور چطور نشست‌ها را می‌سازد.
• same-dir (پیش‌فرض): همه‌ی نشست‌ها پوشه‌ی کاریِ فعلی را به اشتراک می‌گذارند، پس اگر همان فایل‌ها را ویرایش کنند می‌توانند تداخل کنند.
• worktree: هر نشستِ on-demand یک git worktree مخصوصِ خودش می‌گیرد. به یک مخزنِ git نیاز دارد.
• session: حالتِ تک‌نشست. دقیقاً یک نشست سرویس می‌دهد و اتصال‌های اضافی را رد می‌کند. فقط در شروع تنظیم می‌شود.
در زمانِ اجرا w را بزن تا بینِ same-dir و worktree جابه‌جا شوی.
--capacity <N>حداکثر تعدادِ نشست‌های هم‌زمان. پیش‌فرض ۳۲ است. با --spawn=session قابلِ استفاده نیست.
--verboseلاگ‌های دقیقِ اتصال و نشست را نشان می‌دهد.
--sandbox / --no-sandboxsandboxing را برای ایزولاسیونِ filesystem و شبکه فعال یا غیرفعال می‌کند. به‌صورتِ پیش‌فرض خاموش است.

اتصال از دستگاهی دیگر

Section titled “اتصال از دستگاهی دیگر”

وقتی یک نشستِ Remote Control فعال شد، چند راه برای اتصال از دستگاهی دیگر داری:

  • URL نشست را باز کن در هر مرورگری تا مستقیم به نشست روی claude.ai/code بروی.
  • QR code را اسکن کن که در کنارِ URL نشست نشان داده می‌شود تا آن را مستقیماً در اپلیکیشنِ Claude باز کنی. با claude remote-control، spacebar را بزن تا نمایشِ QR code را روشن یا خاموش کنی.
  • claude.ai/code یا اپلیکیشنِ Claude را باز کن و نشست را با نام در فهرستِ نشست‌ها پیدا کن. در اپلیکیشنِ موبایلِ Claude، در نوارِ ناوبری روی Code بزن تا به فهرستِ نشست‌ها برسی. نشست‌های Remote Control یک آیکنِ کامپیوتر با یک نقطه‌ی وضعیتِ سبز نشان می‌دهند وقتی آنلاین‌اند.

عنوانِ نشستِ راهِ دور به این ترتیب انتخاب می‌شود:

  1. نامی که به --name، --remote-control، یا /remote-control پاس داده‌ای
  2. عنوانی که با /rename تنظیم کرده‌ای
  3. آخرین پیامِ معنادار در تاریخچه‌ی مکالمه‌ی موجود
  4. یک نامِ خودکارساخته‌شده مثلِ myhost-graceful-unicorn، که در آن myhost همان hostname ماشینت یا پیشوندی است که با --remote-control-session-name-prefix تنظیم کرده‌ای

اگر نامی صریح تنظیم نکرده باشی، عنوان وقتی یک prompt بفرستی به‌روز می‌شود تا promptت را بازتاب دهد. تغییرِ نامِ یک نشست از claude.ai یا اپلیکیشنِ Claude، عنوانِ محلیِ نمایش‌داده‌شده در claude --resume را هم به‌روز می‌کند.

اگر محیط از قبل یک نشستِ فعال داشته باشد، از تو پرسیده می‌شود که ادامه‌اش بدهی یا یکی تازه شروع کنی.

اگر هنوز اپلیکیشنِ Claude را نداری، از commandِ /mobile درونِ Claude Code استفاده کن تا یک QR code دانلود برای iOS یا Android نمایش داده شود.

فعال‌کردنِ Remote Control برای همه‌ی نشست‌ها

Section titled “فعال‌کردنِ Remote Control برای همه‌ی نشست‌ها”

به‌صورتِ پیش‌فرض، Remote Control فقط وقتی فعال می‌شود که صراحتاً claude remote-control، claude --remote-control، یا /remote-control را اجرا کنی. برای فعال‌کردنِ خودکارِ آن برای هر نشستِ تعاملی، درونِ Claude Code /config را اجرا کن و Enable Remote Control for all sessions را روی true بگذار. برای غیرفعال‌کردن، آن را به false برگردان. در اپلیکیشنِ Desktop، می‌توانی این را از Settings → Claude Code → Enable remote control by default هم تغییر دهی.

با روشن‌بودنِ این تنظیم، هر پروسه‌ی تعاملیِ Claude Code یک نشستِ راهِ دور ثبت می‌کند. اگر چند نمونه اجرا کنی، هرکدام محیط و نشستِ خودش را می‌گیرد. برای اجرای چند نشستِ هم‌زمان از یک پروسه‌ی واحد، به‌جایش از حالتِ سرور استفاده کن.

اتصال و امنیت

Section titled “اتصال و امنیت”

نشستِ محلیِ Claude Code تو فقط درخواست‌های HTTPS خروجی می‌فرستد و هرگز پورت‌های ورودی روی ماشینت باز نمی‌کند. وقتی Remote Control را شروع می‌کنی، با Claude API ثبت‌نام می‌کند و برای کار polling می‌کند. وقتی از دستگاهی دیگر وصل می‌شوی، سرور پیام‌ها را بینِ کلاینتِ وب یا موبایل و نشستِ محلی‌ات روی یک اتصالِ جریانی مسیریابی می‌کند.

همه‌ی ترافیک از طریقِ Claude API روی TLS عبور می‌کند، همان امنیتِ انتقالِ هر نشستِ Claude Code. اتصال از چند اعتبارِ کوتاه‌عمر استفاده می‌کند، که هرکدام به یک هدفِ واحد محدود شده و مستقل منقضی می‌شود.

Remote Control در برابرِ Claude Code on the web

Section titled “Remote Control در برابرِ Claude Code on the web”

Remote Control و Claude Code on the web هر دو از رابطِ claude.ai/code استفاده می‌کنند. تفاوتِ کلیدی اینجاست که نشست کجا اجرا می‌شود: Remote Control روی ماشینت اجرا می‌شود، پس سرورهای MCP محلی، ابزارها، و پیکربندیِ پروژه‌ات در دسترس می‌مانند. Claude Code on the web در زیرساختِ ابریِ مدیریت‌شده‌ی Anthropic اجرا می‌شود.

وقتی در میانه‌ی کارِ محلی هستی و می‌خواهی از دستگاهی دیگر ادامه دهی، از Remote Control استفاده کن. وقتی می‌خواهی کاری را بدون هیچ راه‌اندازیِ محلی کلید بزنی، روی مخزنی کار کنی که cloneاش نکرده‌ای، یا چند کار را به‌صورتِ موازی اجرا کنی، از Claude Code on the web استفاده کن.

نوتیفیکیشن‌های push موبایل

Section titled “نوتیفیکیشن‌های push موبایل”

وقتی Remote Control فعال است، Claude می‌تواند نوتیفیکیشن‌های push به گوشی‌ات بفرستد.

Claude تصمیم می‌گیرد کِی push کند. معمولاً وقتی یک کارِ طولانی تمام می‌شود یا وقتی برای ادامه به تصمیمی از تو نیاز دارد یکی می‌فرستد. می‌توانی در promptت هم درخواستِ push بدهی، برای مثال notify me when the tests finish. فراتر از گزینه‌ی روشن/خاموشِ زیر، پیکربندیِ per-event وجود ندارد.

برای راه‌اندازیِ نوتیفیکیشن‌های push موبایل:

اپلیکیشنِ موبایلِ Claude را نصب کن

اپلیکیشنِ Claude را برای iOS یا Android دانلود کن.

با حسابِ Claude Code‌ات وارد شو

همان حساب و سازمانی را استفاده کن که برای Claude Code در ترمینال استفاده می‌کنی.

نوتیفیکیشن‌ها را مجاز کن

درخواستِ مجوزِ نوتیفیکیشنِ سیستم‌عامل را بپذیر.

push را در Claude Code فعال کن

در ترمینالت، /config را اجرا کن و Push when Claude decides را فعال کن.

اگر نوتیفیکیشن‌ها نمی‌رسند:

  • اگر /config پیغامِ No mobile registered را نشان می‌دهد، اپلیکیشنِ Claude را روی گوشی‌ات باز کن تا توکنِ push خود را تازه کند. هشدار دفعه‌ی بعد که Remote Control وصل شود پاک می‌شود.
  • روی iOS، حالت‌های Focus و خلاصه‌های نوتیفیکیشن می‌توانند pushها را سرکوب یا به تأخیر بیندازند. Settings → Notifications → Claude را بررسی کن.
  • روی Android، بهینه‌سازیِ تهاجمیِ باتری می‌تواند تحویل را به تأخیر بیندازد. اپلیکیشنِ Claude را در تنظیماتِ سیستم از بهینه‌سازیِ باتری مستثنا کن.

محدودیت‌ها

Section titled “محدودیت‌ها”
  • یک نشستِ راهِ دور به‌ازای هر پروسه‌ی تعاملی: بیرون از حالتِ سرور، هر نمونه‌ی Claude Code در هر زمان یک نشستِ راهِ دور پشتیبانی می‌کند. برای اجرای چند نشستِ هم‌زمان از یک پروسه‌ی واحد، از حالتِ سرور استفاده کن.
  • پروسه‌ی محلی باید در حالِ اجرا بماند: Remote Control به‌صورتِ یک پروسه‌ی محلی اجرا می‌شود. اگر ترمینال را ببندی، از VS Code خارج شوی، یا به‌نحوی پروسه‌ی claude را متوقف کنی، نشست تمام می‌شود.
  • قطعیِ طولانیِ شبکه: اگر ماشینت بیدار است اما بیش از حدودِ ۱۰ دقیقه نتواند به شبکه برسد، نشست time out می‌شود و پروسه خارج می‌شود. claude remote-control را دوباره اجرا کن تا یک نشستِ جدید شروع کنی.
  • ultraplan اتصالِ Remote Control را قطع می‌کند: شروعِ یک نشستِ ultraplan هر نشستِ فعالِ Remote Control را قطع می‌کند، چون هر دو قابلیت رابطِ claude.ai/code را اشغال می‌کنند و در هر زمان فقط یکی می‌تواند متصل باشد.
  • بعضی commandها فقط محلی‌اند: commandهایی که یک picker تعاملی در ترمینال باز می‌کنند، مثلِ /plugin یا /resume، فقط از CLI محلی کار می‌کنند. commandهایی که خروجیِ متنی تولید می‌کنند، از جمله /compact، /clear، /context، /usage، /exit، /usage-credits، /recap، و /reload-plugins، از موبایل و وب کار می‌کنند. {/* min-version: 2.1.166 */}از نسخه‌ی v2.1.166، /mcp هم از موبایل و وب کار می‌کند: به‌جای بازکردنِ picker یک خلاصه‌ی متنی از وضعیتِ سرور برمی‌گرداند، و همان زیرفرمان‌های reconnect، enable، و disable را مثلِ CLI محلی می‌پذیرد، با یک تفاوت: از موبایل و وب، /mcp reconnect بدونِ نامِ سرور هر سروری را که از کار افتاده یا به احرازِ هویت نیاز دارد دوباره وصل می‌کند، در حالی که CLI محلی برای reconnect به نامِ سرور نیاز دارد.

عیب‌یابی

Section titled “عیب‌یابی”

«Remote Control requires a claude.ai subscription»

Section titled “«Remote Control requires a claude.ai subscription»”

با یک حسابِ claude.ai احرازِ هویت نشده‌ای. claude auth login را اجرا کن و گزینه‌ی claude.ai را انتخاب کن. اگر ANTHROPIC_API_KEY در محیطت تنظیم شده، ابتدا آن را unset کن.

«Remote Control requires a full-scope login token»

Section titled “«Remote Control requires a full-scope login token»”

با یک توکنِ بلندعمر از claude setup-token یا متغیرِ محیطیِ CLAUDE_CODE_OAUTH_TOKEN احرازِ هویت شده‌ای. این توکن‌ها محدود به inference-only هستند و نمی‌توانند نشست‌های Remote Control برقرار کنند. به‌جایش claude auth login را اجرا کن تا با یک توکنِ نشستِ full-scope احرازِ هویت شوی.

«Unable to determine your organization for Remote Control eligibility»

Section titled “«Unable to determine your organization for Remote Control eligibility»”

اطلاعاتِ کش‌شده‌ی حسابت کهنه یا ناقص است. claude auth login را اجرا کن تا تازه‌اش کنی.

«Remote Control is not yet enabled for your account»

Section titled “«Remote Control is not yet enabled for your account»”

بررسیِ واجدِ‌شرایط‌بودن می‌تواند با حضورِ بعضی متغیرهای محیطی شکست بخورد:

  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC یا DISABLE_TELEMETRY: آن‌ها را unset کن و دوباره امتحان کن.
  • CLAUDE_CODE_USE_BEDROCK، CLAUDE_CODE_USE_VERTEX، یا CLAUDE_CODE_USE_FOUNDRY: Remote Control به احرازِ هویتِ claude.ai نیاز دارد و با ارائه‌دهنده‌های شخصِ ثالث کار نمی‌کند.

اگر هیچ‌یک از این‌ها تنظیم نشده، /logout و بعد /login را اجرا کن تا تازه شود.

«Remote Control is disabled by your organization’s policy»

Section titled “«Remote Control is disabled by your organization’s policy»”

این خطا چهار علتِ مجزا دارد. ابتدا /status را اجرا کن تا ببینی از کدام روشِ ورود و کدام اشتراک استفاده می‌کنی.

  • با یک API key یا حسابِ Console احرازِ هویت شده‌ای: Remote Control به claude.ai OAuth نیاز دارد. /login را اجرا کن و گزینه‌ی claude.ai را انتخاب کن. اگر ANTHROPIC_API_KEY در محیطت تنظیم شده، آن را unset کن.
  • admin Team یا Enterprise تو آن را فعال نکرده: Remote Control روی این پلن‌ها به‌صورتِ پیش‌فرض خاموش است. یک admin می‌تواند آن را در claude.ai/admin-settings/claude-code با روشن‌کردنِ گزینه‌ی Remote Control فعال کند. این گزینه یک تنظیمِ سازمانیِ سمتِ سرور است.
  • گزینه‌ی admin خاکستری (غیرفعال) است: سازمانت یک پیکربندیِ نگه‌داریِ داده یا انطباق دارد که با Remote Control ناسازگار است. این از پنلِ admin قابلِ تغییر نیست. برای بررسیِ گزینه‌ها با پشتیبانیِ Anthropic تماس بگیر.
  • خطا به disableRemoteControl اشاره می‌کند: مدیرِ ITت Remote Control را روی این دستگاه از طریقِ managed settings غیرفعال کرده، مستقل از گزینه‌ی سراسریِ سازمان.

«Remote credentials fetch failed»

Section titled “«Remote credentials fetch failed»”

Claude Code نتوانست یک اعتبارِ کوتاه‌عمر از Claude API برای برقراریِ اتصال بگیرد. با --verbose دوباره اجرا کن تا خطای کامل را ببینی:

Terminal window
claude remote-control --verbose

علت‌های متداول:

  • وارد نشده‌ای: claude را اجرا کن و با /login با حسابِ claude.ai‌ات احرازِ هویت شو. احرازِ هویت با API key برای Remote Control پشتیبانی نمی‌شود.
  • مشکلِ شبکه یا proxy: ممکن است یک firewall یا proxy درخواستِ HTTPS خروجی را مسدود کند. Remote Control به دسترسی به Claude API روی پورتِ ۴۴۳ نیاز دارد.
  • ساختِ نشست شکست خورد: اگر Session creation failed — see debug log را هم می‌بینی، شکست زودتر در راه‌اندازی رخ داده. بررسی کن که اشتراکت فعال باشد.

انتخابِ رویکردِ درست

Section titled “انتخابِ رویکردِ درست”

Claude Code چند راه ارائه می‌دهد تا وقتی پشتِ ترمینالت نیستی کار کنی. آن‌ها در اینکه چه چیزی کار را راه‌اندازی می‌کند، Claude کجا اجرا می‌شود، و چه‌قدر باید راه‌اندازی کنی فرق دارند.

محرکClaude اجرا می‌شود رویراه‌اندازیبهترین برای
Dispatchپیام‌دادنِ یک کار از اپلیکیشنِ موبایلِ Claudeماشینت (Desktop)اپلیکیشنِ موبایل را با Desktop جفت کنواگذاریِ کار وقتی دور هستی، با کمترین راه‌اندازی
Remote Controlراندنِ یک نشستِ در حالِ اجرا از claude.ai/code یا اپلیکیشنِ موبایلِ Claudeماشینت (CLI یا VS Code)اجرای claude remote-controlهدایتِ کارِ در حالِ پیشرفت از دستگاهی دیگر
Channelspush‌کردنِ رویدادها از یک اپلیکیشنِ چت مثلِ Telegram یا Discord، یا سرورِ خودتماشینت (CLI)نصبِ یک پلاگینِ channel یا ساختِ خودتواکنش به رویدادهای بیرونی مثلِ شکستِ CI یا پیام‌های چت
Slackمنشن‌کردنِ @Claude در یک channel تیمیابرِ Anthropicنصبِ اپلیکیشنِ Slack با Claude Code on the web فعالPRها و بازبینی‌ها از چتِ تیمی
Scheduled tasksتنظیمِ یک زمان‌بندیCLI، Desktop، یا ابرانتخابِ یک تناوباتوماسیونِ تکراری مثلِ بازبینی‌های روزانه

منابعِ مرتبط

Section titled “منابعِ مرتبط”
  • Claude Code on the web: اجرای نشست‌ها در محیط‌های ابریِ مدیریت‌شده‌ی Anthropic به‌جای روی ماشینت
  • Ultraplan: یک نشستِ برنامه‌ریزیِ ابری را از ترمینالت کلید بزن و برنامه را در مرورگرت بازبینی کن
  • Channels: Telegram، Discord، یا iMessage را به یک نشست فوروارد کن تا Claude وقتی دور هستی به پیام‌ها واکنش دهد
  • Dispatch: یک کار را از گوشی‌ات پیام بده و می‌تواند یک نشستِ Desktop برای رسیدگی به آن بسازد
  • احرازِ هویت: /login را راه‌اندازی کن و اعتبارها را برای claude.ai مدیریت کن
  • مرجعِ CLI: فهرستِ کاملِ پرچم‌ها و commandها از جمله claude remote-control
  • امنیت: اینکه نشست‌های Remote Control چطور در مدلِ امنیتیِ Claude Code جا می‌گیرند
  • Data usage: اینکه چه داده‌ای در طولِ نشست‌های محلی و راهِ دور از Claude API عبور می‌کند