SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor

آموزش ارسال پیام بین sessionهای Claude Code

نحوه استفاده از قابلیت cross-session messaging در Claude Code برای تبادل متن بین دو session روی یک VPS را بیاموزید. بررسی عملکرد ListAgents و SendMessage در نسخه 2.1.224.

مفهوم پیام‌رسانی بین sessionهای Claude Code

دو session از Claude Code زمانی می‌توانند برای یکدیگر پیام بفرستند که روی یک ماشین و تحت یک کاربر سیستم‌عامل یکسان اجرا شوند. پیام یک قطعه متن ساده است که یک Claude برای Claude دیگر می‌نویسد. پیام شامل سابقه مکالمه یا فایل نیست. Claude با ابزار ListAgents، session دیگر را پیدا می‌کند و متن را با SendMessage می‌فرستد؛ بنابراین شما هیچ‌وقت این دو ابزار را دستی فراخوانی نمی‌کنید. کافی است بگویید session دیگر باید چه چیزی را بداند؛ Claude خود پیام را می‌نویسد.

نام این قابلیت cross-session messaging است. در November 2026، استفاده از آن در macOS و Linux، ازجمله Linux داخل WSL 2، به Claude Code v2.1.224 یا جدیدتر نیاز دارد و در Windows بومی به v2.1.234 یا جدیدتر نیازمند است. پیام‌رسانی بین sessionهای یک ماشین در همه providerها کار می‌کند؛ ازجمله Amazon Bedrock، Claude Platform on AWS، Google Cloud's Agent Platform و Microsoft Foundry که در آن‌ها به v2.1.248 یا جدیدتر نیاز دارد. دسترسی به sessionهای روی ماشین‌های دیگر یا در cloud محدودتر است: این دسترسی از طریق Remote Control انجام می‌شود و به ورود به claude.ai نیاز دارد؛ بنابراین با API key یا در آن چهار provider کار نمی‌کند. وقتی یک session این شرایط را داشته باشد، messaging از قبل فعال است و نیازی به فعال‌سازی ندارد. رفتار توضیح‌داده‌شده در ادامه از مستندات Anthropic درباره cross-session messaging گرفته شده است.

VPS جایی است که این قابلیت اهمیت پیدا می‌کند، چون sessionها در VPS آن‌قدر باقی می‌مانند که ارزش آدرس‌دهی داشته باشند. روی laptop درِ دستگاه را می‌بندید. اما روی serverی که تحت tmux اجرا می‌شود، sessionی را که دوشنبه شروع کرده‌اید، پنج‌شنبه هم همچنان در حال اجراست و context یک repository را حفظ کرده است. وقتی دو session از این نوع داشته باشید، نحوه ارتباط آن‌ها دیگر موضوعی نظری نیست. اگر هنوز این محیط را راه‌اندازی نکرده‌اید، از اجرای Claude Code روی VPS تحت tmux شروع کنید؛ این بخش plumbing مربوط به session را که این راهنما فرض می‌کند پوشش می‌دهد.

چه زمانی استفاده از نشست دوم مقرون‌به‌صرفه است

ابتدا هزینه‌ها را در نظر بگیرید. هر نشست یک نمونه مستقل از Claude با پنجره متنی (context window) اختصاصی خود است؛ بنابراین هزینه دو نشست تقریباً دو برابر هزینه یک نشست در همان بازه زمانی است. هر پیامی که ارسال می‌شود، دقیقاً مانند پرامپتی که تایپ می‌کنید، در میزان مصرف لحاظ می‌شود. هماهنگی بین نشست‌ها رایگان نیست و کارهایی که در واقع یک توالی واحد از مراحل هستند، با تقسیم شدن بین نشست‌ها کندتر و پرهزینه‌تر می‌شوند.

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

  • یک نشست یک تغییر ناسازگار (breaking change) را شناسایی می‌کند، در حالی که نشست دیگر در حال توسعه بر اساس همان کدی است که تغییر کرده است. Claude تغییر را خلاصه کرده و ارسال می‌کند، به‌جای اینکه شما مجبور باشید آن را دوباره در ترمینال دیگر تایپ کنید.
  • دو نشست روی یک مخزن (repository) در git worktreeهای جداگانه کار می‌کنند و یکی از آن‌ها باید بداند چه چیزی نهایی شده است.
  • یک عملیات طولانی مهاجرت یا اجرای تست، نتیجه خود را به نشستی که در حال نظارت بر آن هستید گزارش می‌دهد.
  • یک نشست سازنده (builder) و یک نشست بازبین (reviewer)؛ جایی که بازبین آنچه سازنده تولید کرده را می‌خواند و یافته‌های خود را بازمی‌گرداند.

زمانی که کارها متوالی هستند یا هر دو نشست قرار است فایل‌های یکسانی را ویرایش کنند، از یک نشست استفاده کنید. اگر به دنبال گروهی هماهنگ هستید که Claude آن‌ها را در یک وظیفه واحد ایجاد و مدیریت کند، از قابلیت «تیم‌های عامل» (agent teams) استفاده کنید که یک ویژگی مجزا و همچنان آزمایشی است. اگر فقط می‌خواهید همان گفتگو را در ترمینال دیگری داشته باشید، نشست قبلی را از سر بگیرید (resume). پیام‌رسانی بین‌نشستی برای نشست‌های مستقلی است که خودتان شروع و هدایت می‌کنید.

پیش از آن‌که طراحی خود را به این قابلیت وابسته کنید، وجود آن را بررسی کنید

ابتدا نسخه را بررسی کنید:

claude --version

شماره نسخه را با 2.1.224 مقایسه کنید. سپس درون یک session، /list-agents را وارد کنید؛ این دستور به /peers نیز پاسخ می‌دهد. این دستور همه agentهایی را نمایش می‌دهد که این session می‌تواند به آن‌ها دسترسی داشته باشد، همراه با نامی که هرکدام با آن پاسخ می‌دهند. اگر command اصلاً شناسایی نشد، این session قابلیت پیام‌رسانی بین sessionها را ندارد و هیچ مقدار crossSessionInbound این وضعیت را تغییر نمی‌دهد. /status را وارد کنید و به‌دنبال یک ردیف Peer address بگردید؛ این ردیف نشانی inbox خود این session را نگه می‌دارد که با uds: آغاز می‌شود.

کاربران VPS در buildهای قدیمی با یک دام رایج مواجه می‌شوند. پیش از v2.1.248، پیام‌رسانی روی همان ماشین به دریافت feature flagها وابسته بود و چند متغیر حریم خصوصی این دریافت را غیرفعال می‌کردند؛ در نتیجه، قابلیت در وضعیت پیش‌فرض خاموش باقی می‌ماند. DO_NOT_TRACK، DISABLE_TELEMETRY، CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC و DISABLE_GROWTHBOOK همگی این کار را انجام می‌دهند. کاربران برای harden کردن یک سرور تازه این مقادیر را در ~/.bashrc قرار می‌دهند و بعد تعجب می‌کنند که چرا /list-agents وجود ندارد. از v2.1.248، پیام‌رسانی بین sessionهای روی یک ماشین، حتی با غیرفعال بودن دریافت feature flagها، کار می‌کند؛ بنابراین به‌روزرسانی راه‌حل مناسب‌تری است. این متغیرها همچنان برای sessionهای خارج از این ماشین اهمیت دارند: وقتی دریافت feature flagها خاموش باشد، Claude فقط زمانی به آن sessionها دسترسی دارد که Remote Control در دسترس باشد، و CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC و DISABLE_GROWTHBOOK باعث می‌شوند Remote Control در دسترس نباشد. همین مقادیر ممکن است از map مربوط به env در یک فایل settings یا از managed settings دریافت شوند؛ بنابراین ابتدا shell را بررسی کنید.

env | grep -E 'DO_NOT_TRACK|DISABLE_TELEMETRY|DISABLE_GROWTHBOOK|NONESSENTIAL'

در یک build قدیمی، هر متغیری را که خروجی می‌دهد unset کنید. برای DISABLE_TELEMETRY و CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC، هر مقدار غیرخالی این رفتار را فعال می‌کند، ازجمله رشته 0؛ بنابراین DISABLE_TELEMETRY=0 برخلاف ظاهرش کاری را که انتظار دارید انجام نمی‌دهد. برای خاموش کردن آن، متغیر را unset کنید یا مقدار آن را به یک رشته خالی تغییر دهید.

نام‌گذاری sessionها برای تشخیص آن‌ها از یکدیگر

Claude پیام را با نام به یک session ارسال می‌کند، اما تعیین نام الزامی نیست. اگر نامی تعیین نکنید، Claude Code خودش برای session نام انتخاب می‌کند و Claude همچنان می‌تواند آن session را با ListAgents پیدا کند و با SendMessage برای آن پیام بفرستد. در یک session تعاملی، نام خودکار از نام working directory و یک پسوند دوحرفی تشکیل می‌شود؛ برای مثال myapp-3f. این نام برای یک session مناسب است، اما برای چهار session گیج‌کننده می‌شود و ممکن است دو session نام یکسانی داشته باشند. برای انتخاب نام، هنگام شروع session آن را تعیین کنید:

claude --name builder-api

همچنین می‌توانید هنگام اجرای session، نام آن را با /rename تعیین کنید. مگر آن‌که session به Remote Control متصل باشد، خروجی /list-agents working directory هر session محلی را نشان می‌دهد. به این ترتیب می‌توان sessionهایی را که نام یکسان دارند از هم تشخیص داد. فهرست خود Claude نیز هنگام تکراری‌بودن نام‌ها، یک شناسه کوتاه به آدرس اضافه می‌کند. وقتی session به Remote Control متصل است، /list-agents working directoryها و هر نام sessionی را که نتواند به یک شخص نسبت دهد نمایش نمی‌دهد؛ بنابراین چنین ردیفی به‌شکل (unnamed session) دیده می‌شود. آنچه Claude هنگام جست‌وجوی یک مقصد می‌بیند، تغییر نمی‌کند. انتخاب نام توسط خودتان از خواندن شناسه‌ها ساده‌تر است. نامی که خودتان انتخاب می‌کنید، قابلیت تکمیل پیش‌بینانه @ را نیز کاربردی می‌کند: از v2.1.232 به بعد، با واردکردن @builder در prompt و انتخاب session، دقیقاً به Claude می‌گویید کدام session را منظور دارید.

طرح‌بندی دو-جلسه‌ای tmux که می‌توانید بازتولید کنید

این یک جلسه برای builder و یک جلسه برای reviewer روی یک repository است. reviewer در یک git worktree جداگانه کار می‌کند؛ بنابراین این دو جلسه هرگز روی یک فایل واحد نمی‌نویسند. git worktree add همراه با HEAD یک checkout جداشده ایجاد می‌کند؛ این همان چیزی است که برای جلسه‌ای می‌خواهید که فقط فایل‌ها را می‌خواند و commit نمی‌کند. چون این دو جلسه وظایف متفاوتی دارند، بهتر است برای reviewer سبک خروجی مستقلی تعیین کنید. این کار system prompt همان جلسه را تغییر می‌دهد و در تمام turnها باقی می‌ماند، نه این‌که مانند دستوری که فقط یک بار تایپ کرده‌اید به‌تدریج اثر خود را از دست بدهد.

cd ~/src/api
git worktree add ../api-review HEAD
tmux new-session -d -s agents -n builder -c ~/src/api
tmux new-window -t agents -n reviewer -c ~/src/api-review
tmux send-keys -t agents:builder 'claude --name builder-api' C-m
tmux send-keys -t agents:reviewer 'claude --name reviewer-api' C-m
tmux attach -t agents

سپس Ctrl+b و w پنجره‌ها را بر اساس نام فهرست می‌کنند تا بتوانید یکی را انتخاب کنید. در پنجره builder، /list-agents را اجرا کنید. باید reviewer-api را با دایرکتوری کاری ~/src/api-review ببینید. اگر وجود ندارد، جلسه reviewer هنوز راه‌اندازی خود را کامل نکرده است یا یکی از دو مشکل بخش بعدی وجود دارد. سپس موضوعی را با زبان ساده تحویل دهید:

Tell reviewer-api which files I changed for the rate limiter and what to look at first.

Claude خلاصه را می‌نویسد و ارسال می‌کند. شما متن پیام را نمی‌نویسید و محتوای ارسالی Claude ثابت نیست. در پنجره reviewer، پیام به‌صورت یک پیش‌نمایش یک‌خطی کم‌رنگ نمایش داده می‌شود که نام فرستنده و خط اول متن را نشان می‌دهد؛ برای مثال › Message from @builder-api: …. اگر آن جلسه idle باشد، Claude بلافاصله turn جدیدی را در آن آغاز می‌کند. اگر جلسه در میانه یک turn باشد، پیام تا فاصله بین فراخوانی‌های ابزار منتظر می‌ماند؛ بنابراین یک command در حال اجرا هرگز قطع نمی‌شود. Ctrl+O نمایشگر transcript را با متن کامل باز می‌کند و Claude کل پیام را می‌خواند، چه آن را باز کنید و چه نکنید. این دو جلسه زمانی بهتر با یکدیگر کار می‌کنند که builder تغییرات را کوچک نگه دارد، زیرا diff محدود hand-off کوتاه‌تری ایجاد می‌کند و باعث می‌شود reviewer بتواند بررسی را در یک turn به پایان برساند؛ این همان عادتی است که مهارت lazy senior dev برای تقویت آن ایجاد شده است.

چه کسی چه کسی را روی یک VPS می‌بیند

ارسال پیام در یک ماشین واحد هرگز از سرورهای Anthropic عبور نمی‌کند. هر نشست (session) سوکت صندوق ورودی اختصاصی خود را متصل می‌کند؛ یک Unix domain socket با مسیری در سیستم فایل همان ماشین. یک نشست تنها زمانی در لیست نشست‌های دیگر شما ظاهر می‌شود که یکی از این سوکت‌ها را متصل کرده باشد. دو نتیجه از این موضوع حاصل می‌شود که هر دو در محیط سرور تأثیرگذار هستند.

این سوکت به کاربر سیستم‌عامل شما محدود شده است. نشستی که با کاربر root شروع کرده‌اید و نشستی که با کاربر deploy آغاز شده است، نمی‌توانند یکدیگر را ببینند؛ حتی اگر در یک tmux server کنار هم باشند، زیرا نشست‌های یک کاربر نمی‌توانند به سوکت کاربر دیگر دسترسی داشته باشند. هر دو نشست را با یک کاربر واحد اجرا کنید.

هر کانتینر سیستم فایل مخصوص به خود را دارد. یک نشست داخل Docker و یک نشست روی میزبان (host) نمی‌توانند به یکدیگر دسترسی داشته باشند. دو نشست داخل یک کانتینر می‌توانند به‌طور عادی با هم پیام رد و بدل کنند. اگر برای ایزوله‌سازی، عامل‌ها (agents) را در کانتینرها نگه می‌دارید، همان‌طور که در اجرای عامل‌های برنامه‌نویسی در یک VM یک‌بارمصرف توضیح داده شده است، انتظار داشته باشید که پیام‌رسانی فقط در داخل کانتینر کار کند و نه از مرز کانتینر عبور کند.

نشست‌های شما در ماشین‌های دیگر و نشست‌های ابری شما، تنها زمانی در لیست ظاهر می‌شوند که این نشست به Remote Control متصل باشد و نشست‌های روی ماشین‌های دیگر با برچسب Remote Control مشخص می‌شوند. از نسخه v2.1.225 به بعد، Claude می‌تواند مکالمه‌ای را با نشستی روی یکی دیگر از ماشین‌های شما آغاز کند، نه اینکه فقط به یک نشست پاسخ دهد. آن پیام‌ها از طریق سرورهای Anthropic منتقل می‌شوند، همان‌طور که پیام‌ها به یک نشست ابری نیز از این مسیر عبور می‌کنند. یک نشست ابری نمی‌تواند با SendMessage پاسخ دهد، حتی اگر پیام حاوی آدرس پاسخ باشد: پیام همچنان می‌رسد و شما پاسخ نشست ابری را در رونوشت آن در claude.ai/code می‌خوانید. اگر این نشست هنگام ارسال پیام Claude به خارج از ماشین به Remote Control متصل نباشد، پیام همچنان ارسال می‌شود اما بدون آدرس پاسخ، بنابراین طرف مقابل نمی‌تواند به آن پاسخ دهد.

چرا پیام شما هرگز نرسید

دلیل معمول، شبکه نیست. نشست گیرنده تصمیم می‌گیرد با پیام چه کند و ممکن است تصمیم بگیرد آن را تحویل ندهد. هر پیام ورودی در یکی از 3 وضعیت قرار می‌گیرد: تحویل‌شده، نگه‌داشته‌شده (تا زمان تأیید شما بدون تحویل کنار گذاشته می‌شود)، یا ردشده (بدون تحویل حذف می‌شود).

وقتی هیچ مقدار crossSessionInbound اعمال نشود، Claude Code برای هر پیام و با مقایسهٔ حالت‌های مجوز دو نشست تصمیم می‌گیرد. نشست‌هایی را که اعلان‌های مجوز را دور می‌زنند در یک گروه قرار می‌دهد و همهٔ نشست‌های دیگر را در گروه مقابل. auto، acceptEdits و dontAsk به‌عنوان حالت‌های دارای اعلان مجوز محسوب می‌شوند. در یک نشست تعاملی ترمینال که مجوزهای bypass در دسترس است، حالت Plan به‌عنوان حالت bypass در نظر گرفته می‌شود. اگر مطمئن نیستید یک نشست در کدام گروه قرار می‌گیرد، عملکرد واقعی هر حالت مجوز را ابتدا بخوانید؛ زیرا بیشتر نشست‌ها اکنون با حالت auto شروع می‌شوند و این حالت در سمت دارای اعلان مجوز قرار دارد. سپس قاعده به‌صورت متقارن اعمال می‌شود:

  • نشست گیرنده‌ای که برای مجوزها اعلان نمایش می‌دهد، هر پیام را تحویل می‌گیرد. فقط زمانی پیام را نگه می‌دارد که نشست فرستنده خود را به‌عنوان نشستی معرفی کند که اعلان‌های مجوز را bypass می‌کند.
  • نشست گیرنده‌ای که اعلان‌های مجوز را bypass می‌کند، همهٔ پیام‌ها را برای تأیید شما نگه می‌دارد. فقط زمانی پیام را تحویل می‌دهد که فرستنده نیز همین وضعیت را داشته باشد.

بنابراین نخستین workflowای که بیشتر افراد می‌سازند، دقیقاً همان workflowای است که کار نمی‌کند. شما یک builder را با --permission-mode bypassPermissions شروع می‌کنید چون می‌خواهید بدون نظارت اجرا شود، reviewer را با تنظیمات پیش‌فرض رها می‌کنید و هر پیامی که builder می‌فرستد در یک دیالوگ تأیید منتظر می‌ماند که کسی آن را نمی‌بیند. این دیالوگ پس از مهلت dialogExpiry بسته می‌شود؛ این مهلت به‌طور پیش‌فرض 5m است و پیام حذف می‌شود. پیش از آن‌که socket را مقصر بدانید، صفحهٔ نشست گیرنده را برای وجود دیالوگ تأیید در انتظار بررسی کنید.

برای آن‌که یک نشست پیام‌ها را بدون نظارت دریافت کند، crossSessionInbound را روی accept تنظیم کنید. محل تنظیم این مقدار تعیین می‌کند که تنظیم روی چه چیزی اعمال شود. Claude Code ابتدا تنظیمات مدیریت‌شده، سپس flag مربوط به --settings و بعد تنظیمات کاربر را می‌خواند و نخستین مقداری را که پیدا کند اعمال می‌کند. مقدار موجود در تنظیمات project یا local فقط زمانی اعمال می‌شود که در نردبان accept < hold < refuse سخت‌گیرانه‌تر باشد. مقدار accept در .claude/settings.json از هر مقداری سهل‌گیرانه‌تر است؛ بنابراین هر زمان که یک منبع مورداعتماد مقداری تنظیم کرده باشد، نادیده گرفته می‌شود. آن را در ~/.claude/settings.json قرار دهید یا برای یک نشست به‌صورت مستقیم ارسال کنید. از v2.1.232، ردیف /config پیام‌های نشست‌های دیگر شما همین تنظیم کاربر را برای شما می‌نویسد.

claude --name runner --settings '{"crossSessionInbound":"accept"}'

یک worker بدون رابط گرافیکی claude -p مانند یک نشست تعاملی به یک inbox socket متصل می‌شود و در فهرست نمایش داده می‌شود، اما نمی‌تواند دیالوگ تأیید نشان دهد. Claude Code پیام را برای همان مهلت dialogExpiry در آنجا نگه می‌دارد؛ این مهلت به‌طور پیش‌فرض 5 دقیقه است. اگر در این بازه تغییر حالت یا تنظیمات اجازهٔ تحویل پیام را بدهد، پیام تحویل می‌شود؛ در غیر این صورت حذف می‌شود و برای فرستنده‌ای که Claude Code بتواند به آن دسترسی داشته باشد، به‌صورت منقضی‌شده گزارش می‌شود. خط --settings در بالا روشی است که با آن به چنین workerای اجازه می‌دهید پیام‌ها را دریافت کند. نشستی که در حالت bare شروع شود، هیچ socketای ایجاد نمی‌کند؛ بنابراین نه می‌تواند پیام دریافت کند و نه در فهرست نمایش داده می‌شود.

وقتی hand-offها به بن‌بست می‌رسند

حلقه‌های پیام برای شما مدیریت می‌شوند. Claude Code پیام‌های تکراری هر فرستنده را rate-limit می‌کند، تکرارهای یکسانی را که در فاصله‌ای کوتاه دریافت شوند حذف می‌کند و تعداد پیام‌های پذیرفته‌شده‌ای را که در انتظار خوانده‌شدن هستند، در هر session به 50 مورد محدود می‌کند؛ بنابراین یک حلقه بین دو session خودبه‌خود متوقف می‌شود. تعداد پیام‌های نگه‌داشته‌شده نیز به 100 مورد محدود است و پس از آن، قدیمی‌ترین پیام‌ها حذف می‌شوند. از v2.1.238، اگر inbox یک session به‌دلیل rate limit یا پر بودن صف، پیام‌های شما را حذف کند، session شما را مطلع می‌کند.

شکستی که واقعاً رخ می‌دهد، بی‌سروصداتر است و به‌جای loop، یک hand-off است. Session A از session B سؤالی می‌پرسد که پیش از ادامه‌دادن به پاسخ آن نیاز دارد و سپس idle می‌شود. B پیام را نگه می‌دارد، یا در میانه یک turn طولانی است، یا به سؤالی پاسخ می‌دهد که A واقعاً نپرسیده است. A منتظر می‌ماند. یک ساعت بعد برمی‌گردید و دو session idle می‌بینید، بدون آن‌که کاری انجام شده باشد.

hand-offها را طوری بنویسید که به پاسخ نیاز نداشته باشند. یک پیام خوب حاوی یک واقعیت یا تصمیم است: چه چیزی تغییر کرده و نتیجه چه بوده است. پیام بد از session دیگر اجازه می‌خواهد یا پاسخی را درخواست می‌کند که فرستنده برای ادامه به آن وابسته است. Claude از قبل طوری دستور داده شده است که هرگز از session دیگری انجام کاری را نخواهد که تنظیمات permission خود آن session مانعش می‌شود و چنین کاری را دوباره به شما ارجاع دهد. این قاعده را خودتان نیز گسترش دهید. اگر یک session بدون دریافت پاسخ نمی‌تواند پیشرفت کند، شما باید به آن پاسخ دهید. اگر یک session فقط لازم دارد بداند session دیگر چه زمانی یک کار طولانی را تمام می‌کند، به‌جای پاسخ، درخواست notice کنید: از v2.1.236 در هر دو session، Claude می‌تواند از یکی از sessionهای شما روی این machine بخواهد وقتی در ادامه idle شد یا خارج شد، یک notice واحد ارسال کند؛ اگر چیزی دریافت نشود، Claude Code این درخواست را پس از 12 ساعت حذف می‌کند. رعایت نظم context نیز در اینجا کمک می‌کند، زیرا sessionی که رشته کار را گم کرده باشد پیام‌های مبهم می‌نویسد؛ مدیریت context در Claude Code این جنبه را پوشش می‌دهد.

پیام ورودی را به‌عنوان ورودی غیرقابل‌اعتماد در نظر بگیرید

Claude Code به Claude دریافت‌کننده اعلام می‌کند که پیام از یک session دیگر آمده است، نه از شما؛ همچنین دامنه اقداماتی را که آن پیام می‌تواند انجام دهد محدود می‌کند. این اعمال محدودیت در برنامه‌ای انجام می‌شود که مدل را دربر گرفته است، نه در میزان تمایل مدل به اطاعت؛ تفاوت عملی یک agent harness نیز همین است. یک پیام نمی‌تواند از طرف شما به یک درخواست مجوز در انتظار پاسخ دهد، زیرا رضایت یک session دیگر، رضایت شما نیست. پیام نمی‌تواند چون session دیگری درخواست کرده است، تنظیمات مجوز، CLAUDE.md یا پیکربندی دیگری را تغییر دهد. یک slash command درون متن، مانند /compact، به‌صورت متن ساده دریافت می‌شود و هرگز اجرا نمی‌شود. اگر اقدام بر اساس پیام به مجوزی نیاز داشته باشد که session دریافت‌کننده در اختیار ندارد، همان درخواستی را می‌بینید که برای هر کار دیگری نمایش داده می‌شود. وقتی session فرستنده در حالت خودکار اجرا می‌شود، classifier آن نیز هر پیام را پیش از تحویل Claude Code بررسی می‌کند و پیامی که مسدود کند هرگز به گیرنده نمی‌رسد. این محدودیت‌ها در حالت‌های دارای مجوز گسترده نیز باقی می‌مانند؛ به همین دلیل session دورزننده، پیام‌های ورودی را به‌طور پیش‌فرض نگه می‌دارد و به آن‌ها اعتماد نمی‌کند.

این موضوع مجوزها را پوشش می‌دهد، اما محتوا را نه. session فرستنده ممکن است توضیح یک pull request، یک صفحه وب، README یک dependency یا دیدگاه یک فرد ناشناس در یک issue را خوانده باشد و هر چیزی که خوانده است بتواند بر متنی که برای session دیگر شما می‌نویسد اثر بگذارد. پیام، داده است. باید با همان بدبینی‌ای با آن برخورد کنید که نسبت به هر متن دیگری دارید که از خارج وارد یک session شده است. این همان انضباطی است که در دور نگه‌داشتن اسرار از agentهای هوش مصنوعی شما توضیح داده می‌شود: فرض کنید هر چیزی که از یک مرز اعتماد عبور کرده است ممکن است نادرست باشد و هرگز اجازه ندهید خودش به خودش مجوز بدهد.

اگر می‌خواهید این وضعیت کمتر رخ دهد، 2 کنترل وجود دارد. تنظیم crossSessionInbound روی refuse، پیام‌های peer ورودی را بدون تحویل‌دادن حذف می‌کند. این مقدار در تنظیمات project یا local بر هر منبع دیگری اولویت دارد، زیرا سخت‌گیرانه‌ترین مقدار در این زنجیره است. برای جلوگیری از ارسال یا فهرست‌کردن پیام‌ها توسط این session، قواعد deny مجوز را با نام‌های SendMessage و ListAgents اضافه کنید؛ هر دو باید به‌صورت نام ابزار ساده و بدون specifier نوشته شوند. تنظیم isolatePeerMachines روی true باعث می‌شود پیش از رسیدن هر پیام به session خارج از این ماشین، تأیید صریح شما لازم باشد. این تأیید حتی در حالت bypassPermissions نیز لازم است.

{
  "crossSessionInbound": "refuse",
  "isolatePeerMachines": true
}

رد کردن SendMessage، ارسال پیام به subagentها را نیز حذف می‌کند، زیرا هر دو قابلیت از یک ابزار استفاده می‌کنند. session ردکننده هیچ تغییر قابل مشاهده‌ای در /status خود یا در فهرست sessionهای دیگر روی همان ماشین نشان نمی‌دهد. بنابراین تنظیمات را از پیکربندی session تأیید کنید، نه از روی صفحه.

پل‌ها و سرورهای MCP با حافظه اشتراکی

چندین پروژه شخص‌ثالث در همان بازه زمانی کارهای مشابهی انجام دادند: پل‌های محلی agent-to-agent که متن را بین ایجنت‌های در حال اجرا منتقل می‌کنند، و سرورهای MCP (پروتکل زمینه مدل) که به چندین ایجنت یک فضای ذخیره‌سازی مشترک برای خواندن و نوشتن می‌دهند. آن‌ها را به عنوان یک ساختار متفاوت در نظر بگیرید، نه به عنوان رقیب؛ و پیش از اجرای هر دستور نصب، آن را با فایل README همان پروژه مطابقت دهید. پیام‌رسانی از نوع push است، زیرا فرستنده متن را در نوبت گیرنده قرار می‌دهد. فضای ذخیره‌سازی مشترک از نوع pull است، زیرا هیچ‌کس وقفه دریافت نمی‌کند و یک نشست، یادداشت را در زمان بررسی بعدی مشاهده می‌کند. مدل pull برای وضعیت‌هایی که به‌کندی تغییر می‌کنند آرام‌تر است و تنها زمانی کار می‌کند که نشست واقعاً آن را بررسی کند.

اگر این مسیر را انتخاب می‌کنید، پرسش‌های ارزشمند درباره فرآیند هستند، نه لیست قابلیت‌ها. سرور با چه کاربری اجرا می‌شود و چه چیزی را روی سیستم می‌تواند بخواند؟ اجرای سرورهای MCP روی یک VPS این پیکربندی را پوشش می‌دهد. اشتراک‌گذاری مهارت‌های ایجنت بین مخازن حالت ساده‌تری را پوشش می‌دهد که در آن آنچه می‌خواهید بین نشست‌ها به اشتراک بگذارید، دستورالعمل‌ها هستند نه وضعیت زنده؛ این کار بسیاری از پیام‌هایی را که در غیر این صورت باید ارسال می‌کردید، حذف می‌کند. برای دید کلی‌تر، اجرای یک ایجنت کدنویسی روی یک VPS نقطه شروع مناسبی است.

FAQ

چرا دستور /list-agents در نشست من شناسایی نمی‌شود؟

نشست (session) از قابلیت پیام‌رسانی بین‌نشستی پشتیبانی نمی‌کند. ابتدا claude --version را بررسی کنید: این قابلیت به نسخه 2.1.224 یا جدیدتر در macOS و Linux، نسخه 2.1.234 یا جدیدتر در ویندوز بومی، و نسخه 2.1.248 یا جدیدتر در Amazon Bedrock، پلتفرم Claude در AWS، پلتفرم Agent در Google Cloud و Microsoft Foundry نیاز دارد. در نسخه‌های قدیمی‌تر از 2.1.248، پوسته (shell) خود را برای وجود DO_NOT_TRACK، DISABLE_TELEMETRY، CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC یا DISABLE_GROWTHBOOK بررسی کنید، زیرا هر یک از این موارد باعث غیرفعال شدن دریافت feature-flag می‌شود که نسخه‌های قدیمی برای پیام‌رسانی به آن نیاز داشتند. به‌روزرسانی به نسخه 2.1.248 یا بالاتر، این وابستگی را برای نشست‌های روی یک ماشین واحد حذف می‌کند.

چرا پیام من به نشست دیگر هرگز نرسید؟

اگر /list-agents کار می‌کند، یعنی پیام‌رسانی فعال است و عامل محدودکننده‌تری مانع رسیدن پیام شده است. دلیل رایج، سطوح دسترسی (permission modes) است. نشستی که درخواست‌های مجوز را دور می‌زند (bypass)، تمام پیام‌های ورودی را تا زمان تأیید شما نگه می‌دارد، مگر اینکه فرستنده نیز دسترسی bypass داشته باشد؛ همچنین آن پنجره تأیید پس از مهلت dialogExpiry (به‌طور پیش‌فرض 5 دقیقه) حذف می‌شود. نشست گیرنده را برای یافتن پنجره تأیید معلق بررسی کنید. برای رفع این مشکل، crossSessionInbound را در ~/.claude/settings.json روی accept تنظیم کنید یا آن را با --settings ارسال کنید، زیرا یک accept در تنظیمات پروژه یا محلی به دلیل داشتن مقدار آزادتر، نادیده گرفته می‌شود.

آیا یک نشست Claude Code در Docker می‌تواند به نشستی روی میزبان (host) پیام دهد؟

خیر. صندوق ورودی هر نشست یک سوکت در سیستم فایل همان ماشین است و کانتینر سیستم فایل مجزای خود را دارد؛ بنابراین نشست داخل کانتینر و نشست روی میزبان نمی‌توانند به یکدیگر دسترسی داشته باشند. دو نشست داخل یک کانتینر واحد می‌توانند به‌طور عادی به یکدیگر پیام دهند. قانون مشابهی توضیح می‌دهد که چرا نشستی که با کاربر root اجرا می‌شود و نشستی که با کاربر عادی شما اجرا می‌شود نمی‌توانند به هم متصل شوند: سوکت به کاربر سیستم‌عاملی که مالک آن است محدود شده است.

آیا اقدام بر اساس پیام دریافتی از یک نشست دیگر Claude Code امن است؟

با متن دریافتی مانند ورودی غیرقابل‌اعتماد برخورد کنید، زیرا نشست فرستنده ممکن است یک صفحه وب، یک فایل README یا کامنت یک issue را که توسط شخص دیگری نوشته شده، خوانده باشد. Claude Code از قبل مانع از اجرای خودکار پیام می‌شود: این ابزار نمی‌تواند یک پنجره مجوز معلق را تأیید کند، نمی‌تواند تنظیمات مجوز یا CLAUDE.md را بنا به درخواست تغییر دهد، و یک slash command در متن، صرفاً به عنوان متن ساده دریافت می‌شود و هرگز اجرا نمی‌شود. این محافظت‌ها فقط مجوزها را پوشش می‌دهند و نه قضاوت شما را؛ بنابراین پیش از آنکه به نشست گیرنده دستور اقدام دهید، محتوای دریافتی را مطالعه کنید.

آیا پیام‌رسانی بین‌نشستی، کد من را برای Anthropic ارسال می‌کند؟

بین دو نشست روی یک ماشین واحد، خیر. پیام از طریق یک سوکت مختص هر نشست روی همان ماشین منتقل می‌شود و هرگز از سرورهای Anthropic عبور نمی‌کند؛ همچنین فقط متنی که Claude نوشته ارسال می‌شود و هرگز تاریخچه گفتگو یا فایل‌ها ارسال نمی‌شوند. پیام‌ها به نشستی روی ماشین دیگر شما یا به یک نشست ابری، از طریق سرورهای Anthropic عبور می‌کنند. از نسخه 2.1.225 به بعد، Claude می‌تواند گفتگو را با نشستی روی ماشین دیگر شما آغاز کند، نه اینکه فقط به آن پاسخ دهد. یک نشست ابری پیام را دریافت می‌کند اما نمی‌تواند با SendMessage به آن پاسخ دهد، بنابراین شما پاسخ آن را در رونوشت (transcript) خود در claude.ai/code می‌خوانید. برای اینکه پیش از خروج هر داده‌ای از ماشین، تأیید شما لازم باشد، isolatePeerMachines را روی true تنظیم کنید.

آیا این مقاله مفید بود؟