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

auto mode در Claude Code؛ default جدید چیست؟

از Claude Code v2.1.283، auto mode در sessionهای تعاملی terminal و VS Code حالت آغازین است. تفاوت permission modeها و انتخاب امن برای serverهای بدون نظارت را ببینید.

تغییرات حالت auto در تاریخ 14 August 2026

حالت auto در Claude Code فراخوانی ابزارها را بدون درخواست مجوزهای معمول اجرا می‌کند و از یک مدل طبقه‌بندی‌کننده مجزا برای بازبینی اقدامات استفاده می‌نماید. خواندن فایل‌ها و ویرایش دایرکتوری کاری در خارج از مسیرهای محافظت‌شده، از بررسی توسط این طبقه‌بندی‌کننده عبور می‌کنند. از تاریخ 14 August 2026، این حالت به وضعیت پیش‌فرض شروع جلسات جدید در طرح‌های Pro، Max و Team تبدیل شد. طبق مستندات مورخ 27 October 2026، با استفاده از Claude Code نسخه v2.1.283 یا بالاتر، حالت auto به عنوان حالت پیش‌فرض برای شروع جلسات در ترمینال تعاملی و VS Code در تمامی طرح‌ها و ارائه‌دهندگان در نظر گرفته شده است. شما می‌توانید در هر زمان حالت را تغییر دهید و تنظیمات پیش‌فرضی که قبلاً برای خود تعیین کرده‌اید، بازنویسی نخواهد شد.

مستندات اکنون این تغییر را به شرح زیر بیان می‌کنند:

با استفاده از Claude Code نسخه v2.1.283 یا بالاتر، حالت auto به عنوان حالت مجوز پیش‌فرض برای شروع جلسات در ترمینال تعاملی و VS Code تعیین شده است. در نسخه‌های قدیمی‌تر، این حالت تنها در طرح‌های Pro، Max، Ultra و Team به عنوان حالت پیش‌فرض مجوز شناخته می‌شود.

دو قانون در همان صفحه اهمیت بیشتری نسبت به شماره نسخه دارند. یک defaultMode که در ~/.claude/settings.json شخصی خود تنظیم کرده‌اید، پس از این تغییر باقی می‌ماند: Claude Code ممکن است یک بار برای تغییر آن به حالت auto از شما سوال کند، اما اگر آن را رد کنید، تنظیمات شما حفظ خواهد شد. پیش‌فرضی که سازمان شما از طریق تنظیمات مدیریت‌شده اعمال کرده است نیز تغییر نمی‌کند. پست اطلاعیه اعلام کرد که حالت auto در ابتدا برای طرح‌های Enterprise و Claude API به صورت اختیاری باقی می‌ماند و در به‌روزرسانی مورخ 22 October 2026 ذکر شده است که مدیران Enterprise پیش از تبدیل شدن حالت auto به پیش‌فرض برای سازمانشان، ایمیلی دریافت خواهند کرد. از نسخه v2.1.283 به بعد، مستندات دیگر این استثنا را برای جلسات ترمینال و VS Code قائل نمی‌شوند، اگرچه با نسخه v2.1.285 یا بالاتر، سازمانی که پیکربندی HIPAA روی آن اعمال شده باشد، همچنان در حالت Manual شروع به کار می‌کند.

اگر Claude Code را روی یک VPS (سرور خصوصی مجازی) اجرا می‌کنید، این تغییر نسبت به لپ‌تاپ اهمیت بیشتری دارد. درخواست مجوز، یک نقطه بازرسی است که نیاز به حضور فرد پشت کیبورد دارد. در یک سیستم از راه دور، شما اغلب حضور ندارید، بنابراین حالتی که جلسه با آن شروع می‌شود، همان حالتی است که برای ساعت‌ها باقی می‌ماند. اجرای claude -p غیرتعاملی از قانون متفاوتی پیروی می‌کند: با نسخه v2.1.302 یا بالاتر، این اجراها در default شروع می‌شوند مگر اینکه حالتی را تعیین کنید، که این شامل استفاده از ارائه‌دهنده شخص ثالث یا غیرفعال بودن تله‌متری نیز می‌شود. تا تاریخ 31 October 2026، نسخه فعلی v2.1.316 است و صفحه حالت‌های مجوز این رفتار را مستند کرده است. پیش از نسخه v2.1.302، آن دو مورد ممکن بود در auto شروع شوند، بنابراین اگر احتمال می‌دهید سیستم روی نسخه قدیمی‌تری باشد، claude --version را روی آن اجرا کنید.

حالت‌های دسترسی Claude Code، از بیشترین نظارت تا کمترین

شش حالت وجود دارد. نامی که در ابتدای هر خط آمده، مقداری است که در تنظیمات می‌نویسید یا به --permission-mode پاس می‌دهید. هر شش حالت توسط خود Claude Code اعمال می‌شوند، نه توسط مدل؛ زیرا تصمیم‌گیری درباره اینکه یک فراخوانی ابزار مجاز به انجام چه کاری است، وظیفهٔ چارچوب پیرامون مدل است.

  • default: Claude پیش از اکثر اقداماتی که فایل‌ها را ویرایش می‌کنند، دستورات shell را اجرا می‌کنند یا به شبکه متصل می‌شوند، اجازه می‌گیرد. خواندن فایل‌ها در دایرکتوری کاری شما همچنان بدون پرسش انجام می‌شود. رابط خط فرمان (CLI) این حالت را Manual نام‌گذاری کرده و manual را به عنوان نام مستعار می‌پذیرد.
  • plan: Claude فایل‌ها را می‌خواند و دستورات را برای بررسی اجرا می‌کند، اما سورس‌کد شما را ویرایش نمی‌کند. ویرایش‌ها تا زمانی که طرح را تأیید نکنید مسدود می‌مانند، مگر در نشست‌های ترمینال تعاملی که مجوزهای bypass در دسترس باشند: در آنجا، نه طبقه‌بندی‌کننده و نه پرسش برای دستورات برنامه‌ریزی اعمال نمی‌شود.
  • acceptEdits: ویرایش‌های فایل بدون پرسش اجرا می‌شوند، به همراه دستورات سیستم‌فایل mkdir، touch، rm، rmdir، mv، cp و sed. این مورد فقط برای مسیرهای داخل دایرکتوری کاری یا additionalDirectories شما اعمال می‌شود. نوشتن در مسیرهای محافظت‌شده و حذف‌های حساسِ شناسایی‌شده همچنان نیاز به تأیید دارند و touch فقط با مسیرهای فایل ساده به‌طور خودکار تأیید می‌شود. سایر دستورات shell از قوانین مجوز عادی پیروی می‌کنند.
  • auto: پرسش‌های معمول مجوز با بررسی‌های طبقه‌بندی‌کننده جایگزین می‌شوند. قوانین صریح ask همچنان باعث ایجاد پرسش می‌شوند.
  • dontAsk: Claude Code هر چیزی را که نیاز به پرسش از شما داشته باشد، به‌طور خودکار رد می‌کند. به‌جز فراخوانی‌هایی که یک mod نصب‌شده توسط شما می‌تواند تأیید کند، خواندن فایل در دایرکتوری‌های کاری، قوانین allow شما، دستورات Bash داخلی فقط‌خواندنی، دریافت مستندات از پیش تأییدشده، و فراخوانی‌هایی که یک hook از نوع PreToolUse تأیید کند، اجرا خواهند شد. نشست هرگز منتظر ورودی نمی‌ماند.
  • bypassPermissions: پرسش‌ها و بررسی‌های ایمنی نادیده گرفته می‌شوند، از جمله نوشتن در مسیرهای محافظت‌شده مانند .git و .claude.

در طول یک نشست، Shift+Tab را فشار دهید تا بین default، acceptEdits و plan جابه‌جا شوید. از auto، اولین فشار شما را به default می‌برد. نوار وضعیت نشان می‌دهد که در کدام حالت قرار دارید، مانند ⏵⏵ auto mode on یا یک ⏸ manual mode on خاکستری. سایر حالت‌ها به‌طور پیش‌فرض در این چرخه نیستند. auto زمانی به آن می‌پیوندد که حساب شما شرایط لازم را داشته باشد. bypassPermissions تنها زمانی به آن می‌پیوندد که نشست با --permission-mode bypassPermissions، --dangerously-skip-permissions یا --allow-dangerously-skip-permissions، یا با defaultMode: "bypassPermissions" در تنظیمات کاربر، --settings یا تنظیمات مدیریت‌شده شروع شده باشد. dontAsk هرگز در آنجا ظاهر نمی‌شود، بنابراین آن را با claude --permission-mode dontAsk تنظیم کنید.

حالت Auto همچنین به یک مدل جدید نیاز دارد که دلیل معمول ظاهر نشدن آن است. تا تاریخ 27 اکتبر 2026، مستندات Claude Opus 4.6 یا جدیدتر، Sonnet 4.6 یا جدیدتر، Haiku 5.5، یا یک مدل Fable در Anthropic API، لیست کوتاه‌تری در Amazon Bedrock، Google Cloud و Microsoft Foundry را ذکر کرده و می‌گوید مدل‌های قدیمی‌تر مانند Sonnet 4.5 در هیچ ارائه‌دهنده‌ای پشتیبانی نمی‌شوند. اگر Claude Code گزارش داد که حالت auto در دسترس نیست، ابتدا آن الزامات و هر تنظیم disableAutoMode را بررسی کنید. Anthropic همچنین می‌تواند حالت auto را از سمت سرور غیرفعال کند و نشستی که آن پاسخ را دریافت کرده، حالت auto را تا پایان نشست غیرفعال نگه می‌دارد؛ بنابراین به‌جای انتظار در نشست قدیمی، یک نشست جدید شروع کنید.

دو کنترل در هر حالتی برقرار هستند، از جمله bypassPermissions: قوانین deny و قوانین صریح ask. هیچ‌کدام برای EndConversation اعمال نمی‌شوند در حالی که ابزار دیگری در دسترس باقی مانده باشد. این‌ها اهرم‌هایی هستند که فارغ از حالتی که نشست با آن شروع می‌شود، در اختیار شما باقی می‌مانند.

موارد مسدودشده توسط طبقه‌بندی‌کننده حالت خودکار

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

یک مدل طبقه‌بندی‌کننده مجزا، اقدامات را پیش از اجرا بازبینی می‌کند و هر موردی را که فراتر از درخواست شما باشد، زیرساخت‌های ناشناس را هدف قرار دهد، یا به نظر برسد ناشی از محتوای مخربی است که Claude خوانده، مسدود می‌کند.

موارد مسدودشده به‌صورت پیش‌فرض، در دسته‌بندی‌هایی که مدیر سرور بیش از همه با آن‌ها مواجه می‌شود:

  • دانلود و اجرای کد، مانند curl | bash
  • استقرار (deploy) و مهاجرت‌های محیط عملیاتی (production)
  • اجرای force push
  • تغییر در زیرساخت‌های اشتراکی
  • باز کردن تونل یا reverse shell که یک سرویس محلی را از طریق اینترنت عمومی در دسترس قرار می‌دهد
  • چاپ اعتبارنامه (credential) یا توکن فعال در متن گفتگو یا یک فایل

موارد مجاز به‌صورت پیش‌فرض:

  • عملیات فایل محلی در دایرکتوری کاری شما
  • نصب وابستگی‌های تعریف‌شده در فایل‌های lock یا manifest
  • درخواست‌های HTTP فقط‌خواندنی (read-only)
  • Push کردن به شاخه‌های مخزنی که در آن کار می‌کنید، شامل شاخه پیش‌فرض، به‌جز شاخه‌های غیر پیش‌فرضی که نام آن‌ها نشان‌دهنده هدف استقرار یا انتشار است. محتوای push همچنان از سایر قوانین طبقه‌بندی‌کننده عبور می‌کند.

هرگز تنها به خلاصه‌ای مانند موارد بالا اکتفا نکنید. دستور claude auto-mode defaults را اجرا کنید تا لیست کامل قوانین را به‌صورت JSON چاپ کنید و مجموعه‌ای را که همراه با نسخه نصب‌شده شما ارائه شده است، مطالعه نمایید. /auto-mode-setup یک دستور مجزا است: این دستور ورودی‌های autoMode.environment را از پروژه و نشست‌های اخیر شما در آن استخراج کرده و در صورت تأیید شما، آن‌ها را در ~/.claude/settings.json می‌نویسد. این دستور، و نه claude auto-mode defaults، الزامات نسخه را به همراه دارد. در طرح‌های Pro، Max، Ultra و Team، دستور /auto-mode-setup به نسخه v2.1.228 یا بالاتر، و در ویندوز بومی به نسخه v2.1.233 یا بالاتر نیاز دارد. در طرح Enterprise یا هنگام استفاده از کلید API کنسول Claude، به نسخه v2.1.283 یا بالاتر نیاز است. پیش از نسخه v2.1.304، دستور /auto-mode-setup در نشست‌هایی که feature flagها را دریافت نمی‌کنند (مانند محیطی که telemetry در آن غیرفعال است یا روی ارائه‌دهنده شخص ثالث قرار دارد) وجود ندارد؛ بنابراین اگر سرور شما این‌گونه است، ابتدا آن را به‌روزرسانی کنید.

پیش از تکیه بر این قابلیت، دو محدودیت مستندشده اهمیت دارند. نخست، در درخواست‌های طبقه‌بندی‌کننده‌ای که Claude Code به خود می‌فرستد، طبقه‌بندی‌کننده پیام‌های شما، فراخوانی ابزارها به‌جز جستجوهای فقط‌خواندنی (مانند خواندن فایل و جستجوها) و محتوای CLAUDE.md شما را می‌بیند، اما نتایج ابزارها حذف می‌شوند؛ بنابراین متن داخل یک فایل یا صفحه وب که Claude خوانده است، نمی‌تواند مستقیماً طبقه‌بندی‌کننده را تحت تأثیر قرار دهد. دوم، زمانی که طبقه‌بندی‌کننده یک اقدام را 3 بار متوالی یا 20 بار در یک نشست مسدود کند، حالت خودکار متوقف شده و Claude Code به مرحله پرسش از شما بازمی‌گردد. تأیید اقدام پرسش‌شده، حالت خودکار را از سر می‌گیرد. این آستانه‌ها قابل تنظیم نیستند. اجرای غیرتعاملی با فلگ -p و بدون --permission-prompt-tool، کسی را برای پرسش ندارد و مستندات صراحتاً بیان می‌کنند که Claude Code اجرای کار را متوقف نمی‌کند: اقدام مسدودشده اجرا نمی‌شود و Claude به کار خود ادامه می‌دهد.

رفتار دوم همان موردی است که در یک سرور راه دور به دو شکل مشکل‌ساز می‌شود. یک نشست تعاملی که در حال اجرا رها شده و به محدودیت می‌رسد، در مرحله پرسش متوقف شده و منتظر شخصی می‌ماند که به ترمینال نگاه نمی‌کند. اجرای -p هرگز منتظر نمی‌ماند، بنابراین ممکن است یک کار با مراحل مسدودشده و انجام‌نشده به پایان برسد. نشست دوم Claude Code روی همان سرور جایگزین آن شخص نیست، زیرا متن ارسالی از یک نشست به نشست دیگر هرگز به عنوان رضایت شما محسوب نمی‌شود و نمی‌تواند به پرسش مجوز در انتظار پاسخ دهد؛ بنابراین نشستی که در آن مرحله متوقف شده، همچنان به پاسخ انسانی نیاز دارد. محدود کردن آنچه عامل (agent) قصد انجام آن را دارد، نیمه دیگر راه‌حل است و مهارتی که عامل را به سمت کوچک‌ترین تغییر ممکن سوق می‌دهد، مانع از آن می‌شود که نشست به سمت اقدامات گسترده‌ای برود که طبقه‌بندی‌کننده آن‌ها را متوقف می‌کند. در حالی که یک مهارت، یک وظیفه را هدایت می‌کند، یک سبک خروجی، خودِ system prompt را ویرایش می‌کند؛ بنابراین سبکی که درخواست تغییرات کوچک و جراحی‌گونه دارد، در تمام مراحل نشست و نه فقط برای وظیفه‌ای که آن را فراخوانده‌اید، اعمال می‌شود.

محل قرارگیری حالت‌ها در settings.json

تمام موارد فوق، یک شیء واحد در فایل تنظیمات هستند.

{
  "permissions": {
    "defaultMode": "auto",
    "allow": [
      "Bash(npm run test *)",
      "Bash(git status)"
    ],
    "ask": [
      "Bash(git push *)",
      "Bash(docker compose up *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./secrets/**)",
      "Bash(curl *)"
    ]
  }
}

قوانین به ترتیب ارزیابی می‌شوند: ابتدا deny، سپس ask و در نهایت allow. اولین تطابق در این ترتیب، نتیجه را تعیین می‌کند و یک قانون محدودتر، بر قانون گسترده‌تری که پیش از آن آمده است، اولویت ندارد. یک قانون deny برای Bash(aws *)، دستور aws s3 ls را مسدود می‌کند، حتی اگر همان دستور را به‌طور مشخص allow کرده باشید؛ بنابراین یک قانون allow نمی‌تواند استثنایی برای یک قانون deny ایجاد کند. قوانین Read و Edit در حالت‌های deny یا ask از negation در gitignore پشتیبانی می‌کنند: در لیست deny یک فایل تنظیمات، اگر Read(*.env) با Read(!sample.env) دنبال شود، فایل‌هایی با نام sample.env از قانون قبلی مستثنی می‌شوند. این استثنا فقط شامل قوانین مسیر نسبی (relative-path) قبلی از همان منبع تنظیمات می‌شود؛ این استثنا نمی‌تواند قانون deny از منبع دیگری را لغو کند یا فایلی را که در یک دایرکتوری کاملاً مسدود شده قرار دارد، باز کند.

ask نوع قانونی است که در حالت auto کاربرد دارد. حالت auto اعلان‌های معمول را حذف می‌کند و یک قانون ask برای دستوری خاص که می‌خواهید کاربر روی آن تأییدیه دهد، دوباره اعلان ایجاد می‌کند. دستور deploy شما در این دسته قرار می‌گیرد. همچنین اگر می‌خواهید پیش از خروج کد از محیط، یک checkpoint داشته باشید، Bash(git push *) نیز در همین دسته جای می‌گیرد. نگهداری فایل‌های حاوی اعتبارنامه‌ها در deny نیمه دیگر این موضوع است و با دور نگه داشتن اعتبارنامه‌ها از دسترس agent جفت می‌شود.

فایل‌های تنظیمات به ترتیب اولویت (از کمترین به بیشترین):

  • ~/.claude/settings.json: تنظیمات کاربری شما که در تمام پروژه‌ها اعمال می‌شود.
  • .claude/settings.json: تنظیمات پروژه که در مخزن (repository) commit می‌شود.
  • .claude/settings.local.json: تنظیمات شخصی شما برای یک مخزن خاص؛ زمانی که Claude Code آن را ایجاد می‌کند، در gitignore قرار می‌گیرد. اگر آن را دستی ایجاد کردید، به .gitignore اضافه کنید.
  • تنظیمات مدیریت‌شده (Managed settings) که توسط مدیر سیستم اعمال می‌شود. در لینوکس، این فایل /etc/claude-code/managed-settings.json است. هیچ‌چیز، حتی flagهای خط فرمان، نمی‌تواند قانون مجوز مدیریت‌شده را لغو کند.

یک دام در اینجا وجود دارد که علت آن مستند شده است. defaultMode: "auto" زمانی که از .claude/settings.json یا .claude/settings.local.json فراخوانی شود، اعمال نمی‌شود؛ بنابراین یک مخزن نمی‌تواند با ارسال یک فایل تنظیمات، به خود حالت auto اعطا کند. bypassPermissions نیز از این دو فایل نادیده گرفته می‌شود. اگر auto را در آنجا تنظیم کنید، Claude Code به پیش‌فرض داخلی خود بازمی‌گردد و از هرگونه defaultMode در ~/.claude/settings.json صرف‌نظر می‌کند، بدون اینکه خطایی چاپ شود. در نسخه یا طرحی که پیش‌فرض داخلی آن Manual است، نشست به‌آرامی در حالت default شروع می‌شود. این خط را به ~/.claude/settings.json منتقل کنید. دستور /permissions را اجرا کنید تا تمام قوانین فعال را در کنار فایلی که از آن آمده‌اند، مشاهده کنید.

دو سوییچی که یک حالت را غیرفعال می‌کنند

مدیران سیستم دو سوییچ برای غیرفعال‌سازی (kill switch) در اختیار دارند و هر دو به جای مقدار بولی، رشته "disable" را می‌پذیرند.

{
  "permissions": {
    "disableAutoMode": "disable",
    "disableBypassPermissionsMode": "disable"
  }
}

مستندات مشخص می‌کند که هر دو تنظیم، رشته "disable" را در هر فایل تنظیماتی می‌پذیرند. این موارد در محیط‌های مدیریت‌شده که امکان بازنویسی تنظیمات وجود ندارد، بسیار کاربردی هستند.

disableAutoMode باعث حذف auto از چرخه Shift+Tab می‌شود و نشست‌هایی که با --permission-mode auto آغاز می‌شوند، به‌جای آن در حالت Manual شروع خواهند شد. disableBypassPermissionsMode همین وظیفه را برای حالت bypass انجام می‌دهد و از هر scopeای عمل می‌کند؛ بنابراین می‌توانید آن را در ~/.claude/settings.json خود قرار دهید تا دسترسی خود را به حالتی که ترجیح می‌دهید ساعت 2 بامداد روی یک سرور زنده با آن مواجه نشوید، مسدود کنید. در سیستمی که سایر کاربران نیز از آن استفاده می‌کنند، هر دو را در /etc/claude-code/managed-settings.json قرار دهید، زیرا فایل تنظیمات کاربر متعلق به خود اوست و فایل مدیریت‌شده چنین نیست.

چرا auto mode روی یک VPS به مرز ایزوله‌سازی نیاز دارد

classifier هر بار یک action را بررسی می‌کند. این ابزار مشخص نمی‌کند action تأییدشده بعداً چه کاری انجام می‌دهد. مستندات این مرز را به‌روشنی بیان می‌کنند:

classifier یک کنترل per-action است، نه یک مرز ایزوله‌سازی؛ بنابراین یک مرز ایزوله‌سازی همچنان برای اجرای unattended، دفاع در عمق بیشتری فراهم می‌کند و برخلاف --dangerously-skip-permissions الزامی نیست.

بنابراین ترکیب مناسب برای یک remote box، استفاده از auto mode به‌همراه محیطی است که حاضر باشید آن را از دست بدهید، نه bypassPermissions به‌علاوه امیدواری. مستندات، Bypass mode را فقط برای محیط‌های ایزوله توصیه می‌کنند: containerها، virtual machineها یا dev containerهایی که به اینترنت دسترسی ندارند و Claude Code نمی‌تواند به سیستم host شما آسیب بزند. VPSای که database و reverse proxy شما روی آن اجرا می‌شوند، هیچ‌کدام از این موارد نیست.

در یک server، سه اقدام بیشترین اهمیت را دارند. Claude Code را به‌عنوان یک کاربر عادی اجرا کنید و هرگز از root استفاده نکنید. برای آن کاربر یک working directory فراهم کنید و هیچ فایل یا منبع ارزشمند دیگری را در دسترسش نگذارید. به‌جای تعمیر box، آن را از نو بسازید؛ این همان استدلالی است که استفاده از یک VM موقت و حذف آن پس از هر job را توجیه می‌کند. جزئیات hardening این موارد، از ایجاد user تا تنظیم firewall ruleها، در راهنمای کامل ایمن‌سازی اجرای Claude Code روی VPS آمده است؛ بنابراین اینجا تکرار نمی‌شود.

Claude Code خودش قانون مربوط به root را اعمال می‌کند. در Linux و macOS، اجرای آن در Bypass mode با sudo یا به‌عنوان root رد می‌شود:

--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons

این بررسی در یک sandbox شناسایی‌شده انجام نمی‌شود؛ به همین دلیل، پاسخ مستند برای اجرای autonomous در container، استفاده از dev containerای است که Claude Code را با یک کاربر غیرroot اجرا کند. اگر agent را از طریق SSH و با استفاده از phone یا laptop هدایت می‌کنید، همین منطق درباره یک Claude Code session طولانی‌مدت که در tmux باز نگه داشته شده است نیز صدق می‌کند: هنگام اجرای session، کسی prompt را زیر نظر ندارد. هیچ‌یک از این مراحل تا زمانی که خود login کار نکند آغاز نمی‌شود؛ بنابراین اگر box با Permission denied (publickey) شما را رد می‌کند، خروجی verbose مربوط به SSH مشخص می‌کند واقعاً با کدام‌یک از پنج خطا مواجه هستید.

راه‌اندازی محیط ایزوله (Sandbox) برای Bash روی Ubuntu VPS

محیط ایزوله داخلی، دسترسی به فایل‌سیستم و شبکه را برای دستورات Bash که Claude اجرا می‌کند محدود می‌سازد و سیستم‌عامل این محدودیت را بر پردازش‌های فرزند نیز اعمال می‌کند. دستورات مستثنی‌شده و تلاش‌های مجدد تأییدشده که خارج از محیط ایزوله اجرا می‌شوند، تحت این محدودیت نیستند. در لینوکس، این قابلیت به دو بسته نرم‌افزاری نیاز دارد.

sudo apt-get install bubblewrap socat

برنامه Claude Code را اجرا کرده و /sandbox را وارد کنید. پنل با زبانه‌های Mode، Overrides و Config باز می‌شود. اگر بسته موردنیازی نصب نباشد، تنها زبانه Dependencies نمایش داده می‌شود که لیست موارد لازم برای نصب را نشان می‌دهد. بررسی وابستگی‌ها در زمان شروع برنامه انجام می‌شود، بنابراین پس از نصب بسته‌ها، Claude Code را مجدداً راه‌اندازی کنید، در غیر این صورت پنل همچنان وضعیت آن‌ها را «مفقود» گزارش می‌دهد.

در Ubuntu 24.04 و نسخه‌های جدیدتر، سیاست پیش‌فرض AppArmor مانع از ایجاد فضای نام کاربری (user namespace) توسط bubblewrap می‌شود، بنابراین محیط ایزوله اجرا نمی‌شود. بررسی کنید که آیا این مورد برای سرور شما صدق می‌کند یا خیر:

sysctl kernel.apparmor_restrict_unprivileged_userns

خروجی 0، یا خطایی مبنی بر عدم وجود کلید، به این معنی است که نیازی به انجام کاری نیست. خروجی 1 به این معنی است که bwrap به پروفایل اختصاصی خود نیاز دارد:

sudo tee /etc/apparmor.d/bwrap > /dev/null <<'EOF'
abi <abi/4.0>,
include <tunables/global>

profile bwrap /usr/bin/bwrap flags=(unconfined) {
  userns,
  include if exists <local/bwrap>
}
EOF
sudo systemctl reload apparmor

این پروفایل روی خود bwrap اعمال می‌شود، نه روی دستوراتی که در داخل محیط ایزوله اجرا می‌کند. سپس محدوده را در تنظیمات محدودتر کنید:

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "denyRead": ["~/"],
      "allowRead": ["."]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

این بلوک باید در فایل .claude/settings.json پروژه قرار گیرد، زیرا . فقط در تنظیمات پروژه به ریشه پروژه اشاره می‌کند. اگر همین خطوط را در ~/.claude/settings.json قرار دهید، . به ~/.claude اشاره خواهد کرد و در نتیجه قانون denyRead باعث می‌شود فایل‌های پروژه شما مسدود بمانند و هر دستوری در خواندن کدی که قرار است ویرایش کند، با شکست مواجه شود.

توجه داشته باشید که این موارد چه چیزی را پوشش نمی‌دهند. محیط ایزوله، Bash و پردازش‌های فرزند آن را محدود می‌کند. ابزارهای داخلی فایل در داخل پردازش Claude Code اجرا می‌شوند و سرورهای MCP (پروتکل زمینه مدل) و هوک‌ها، پردازش‌های مجزایی هستند که بدون محدودیت روی میزبان اجرا می‌شوند. برای قرار دادن همه آن‌ها پشت یک مرز امنیتی، کل پردازش Claude Code را داخل یک کانتینر، ماشین مجازی یا بسته @anthropic-ai/sandbox-runtime اجرا کنید که در زمان نگارش این متن، یک نسخه پیش‌نمایش تحقیقاتی (beta) است.

هر تنظیم به کدام حالت نیاز دارد؟

یک مخزن مستقل روی لپ‌تاپ شخصی

از auto استفاده کنید و برای اقداماتی که می‌خواهید نیازمند تأیید باشند، قوانین ask را تنظیم کنید. شما پشت صفحه‌کلید هستید، fallback طبقه‌بندی‌کننده واقعاً می‌تواند به شما برسد و دامنهٔ آسیب به یک دستگاه تحت کنترل شما محدود است. پیش‌فرض 14 August برای همین وضعیت نوشته شده است.

یک VPS اشتراکی

برای هر کاربر، auto را در فایل ~/.claude/settings.json همان کاربر تنظیم کنید؛ این کار را روی سیستمی انجام دهید که حسابی که Claude Code را اجرا می‌کند root نباشد و نتواند کارهای سایر کاربران را بخواند. disableBypassPermissionsMode را به‌صورت "disable" در /etc/claude-code/managed-settings.json مستقر کنید و آن را با قوانین deny همراه سازید تا از مسیرهای اشتراکی محافظت شود. یک سیستم اشتراکی روشن‌ترین نمونه‌ای است که در آن bypassPermissions گزینهٔ نادرستی است، زیرا مرز جداسازی‌ای که این حالت فرض می‌کند وجود ندارد: tenantهای دیگر داخل همان مرز هستند.

CI و نشست‌های بدون نظارت

از dontAsk همراه با فهرست صریح allow از فرمان‌های موردنیاز job استفاده کنید. وقتی هیچ فردی قرار نیست prompt را ببیند، auto-deny حالت صحیح هنگام خطاست. حالت Auto به‌صورت غیرتعاملی نیز اجرا می‌شود، اما یک اجرای -p که با مسدودسازی‌های تکراری classifier مواجه شود متوقف نمی‌شود: اقدام‌های مسدودشده رد می‌شوند و Claude به کار خود ادامه می‌دهد؛ بنابراین ممکن است job با انجام‌نشدن بخشی از مراحلش پایان یابد. bypassPermissions را فقط برای container یا ماشین مجازی‌ای نگه دارید که از یک image بازسازی می‌کنید و آن را روی هیچ hostی که سرویس مهم دیگری اجرا می‌کند به کار نبرید.

FAQ

چه زمانی حالت auto به حالت پیش‌فرض در Claude Code تبدیل شد؟

این حالت از تاریخ 14 اوت 2026 برای نشست‌های جدید در طرح‌های Pro، Max و Team به حالت پیش‌فرض تبدیل شد. طبق مستندات مورخ 27 اکتبر 2026، در Claude Code نسخه v2.1.283 یا بالاتر، این حالت برای نشست‌های تعاملی ترمینال و VS Code در تمامی طرح‌ها و ارائه‌دهندگان به صورت پیش‌فرض فعال است؛ به استثنای سازمان‌هایی که پیکربندی HIPAA روی آن‌ها اعمال شده است که در نسخه‌های v2.1.285 و بالاتر، در حالت Manual شروع می‌شوند. اجراهای غیرتعاملی claude -p در حالت default آغاز می‌شوند، مگر اینکه حالتی را تعیین کنید. پیش از نسخه v2.1.302، اجراها روی ارائه‌دهندگان شخص ثالث یا در صورت غیرفعال بودن telemetry ممکن بود در حالت auto شروع شوند؛ از نسخه v2.1.302 به بعد، این اجراها نیز در حالت default آغاز می‌شوند. پیش‌فرضی که خودتان تعیین می‌کنید ثابت می‌ماند مگر اینکه درخواست تغییر یک‌باره (one-time switch) را بپذیرید، و پیش‌فرضی که سازمان شما مدیریت می‌کند بدون تغییر باقی می‌ماند. برای بررسی وضعیت فعلی نشست، به نوار وضعیت نگاه کنید که در حالت auto عبارت ⏵⏵ auto mode on را نمایش می‌دهد.

آیا باید از حالت auto یا bypassPermissions روی یک VPS استفاده کنم؟

از حالت auto به همراه یک مرز ایزولاسیون (isolation boundary) استفاده کنید. طبقه‌بندی‌کننده (classifier) اقدامات را پیش از اجرا بررسی می‌کند؛ عملیات خواندن و ویرایش دایرکتوری کاری در خارج از مسیرهای محافظت‌شده از بررسی عبور می‌کنند، اما مستندات به‌صراحت بیان می‌کنند که این یک کنترل برای هر اقدام است و نه یک مرز ایزولاسیون؛ بنابراین برای اجرای بدون نظارت، همچنان به یک container، ماشین مجازی یا محیطی که آمادگی بازسازی آن را دارید نیاز است. گزینه bypassPermissions بررسی‌ها را به‌طور کامل نادیده می‌گیرد و مستندات آن را فقط برای محیط‌های ایزوله توصیه کرده‌اند. Claude Code در صورت اجرا به عنوان root در لینوکس، از شروع در این حالت خودداری کرده و پیام --dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons را چاپ می‌کند.

چگونه می‌توانم از استفاده هر کاربری در سرورم از حالت auto یا bypass جلوگیری کنم؟

مقادیر permissions.disableAutoMode و permissions.disableBypassPermissionsMode را در فایل /etc/claude-code/managed-settings.json برابر با رشته "disable" قرار دهید. تنظیمات مدیریت‌شده (Managed settings) بر هر محدوده (scope) دیگری اولویت دارند، بنابراین هیچ فایل تنظیمات کاربری و هیچ پرچم (flag) خط فرمانی نمی‌تواند آن‌ها را نادیده بگیرد. گزینه disableAutoMode باعث حذف auto از چرخه Shift+Tab می‌شود و نشستی که با --permission-mode auto شروع شود، به‌جای آن در حالت Manual آغاز می‌گردد. گزینه disableBypassPermissionsMode نیز از هر محدوده‌ای کار می‌کند، بنابراین یک کاربر می‌تواند آن را در فایل ~/.claude/settings.json شخصی خود تنظیم کند.

چرا تنظیمات defaultMode: "auto" من نادیده گرفته می‌شود؟

زیرا در فایل اشتباهی قرار دارد. تنظیم defaultMode: "auto" زمانی که از .claude/settings.json یا .claude/settings.local.json اعمال شود، تأثیری ندارد تا یک مخزن (repository) نتواند با ارسال یک فایل تنظیمات، به خود مجوز حالت auto بدهد. Claude Code در این شرایط به پیش‌فرض داخلی خود بازمی‌گردد، هرگونه defaultMode در تنظیمات کاربری شما را نادیده می‌گیرد و هیچ خطایی چاپ نمی‌کند؛ در مواردی که پیش‌فرض داخلی Manual باشد، نشست در حالت default شروع می‌شود. تنظیمات را به ~/.claude/settings.json منتقل کنید و سپس دستور /permissions را اجرا کنید تا تأیید کنید هر قانون فعال از کدام فایل آمده است. اگر حالت auto همچنان در دسترس نیست، پیش‌نیاز مدل را بررسی کنید: مدل‌های قدیمی‌تر مانند Sonnet 4.5 در هیچ ارائه‌دهنده‌ای پشتیبانی نمی‌شوند.

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