اپِ دسکتاپ

اپِ Claude Desktop سه تب دارد: Chat برای گفت‌وگوها، Cowork برای Dispatch و کارهای ایجنتیکِ طولانی‌تر، و Code برای توسعه‌ی نرم‌افزار. این صفحه مرجعِ تبِ Code است.

دانلود برای macOS

بیلدِ یونیورسال برای Intel و Apple Silicon

دانلود برای Windows

برای پردازنده‌های x64

برای Windows ARM64، نصب‌کننده‌ی ARM64 را دانلود کن. اپِ دسکتاپ روی Linux در دسترس نیست؛ به‌جایش از CLI استفاده کن.

بعد از نصب، Claude را راه‌اندازی کن، وارد شو، و روی تبِ Code کلیک کن. اولین باری که آن را روی Windows باز می‌کنی، به Git for Windowsِ نصب‌شده نیاز داری؛ بعد از نصبش اپ را ری‌استارت کن. برای مرورِ قدم‌به‌قدمِ اولین نشستت، راهنمای شروع را ببین.

در تبِ Code، هر گفت‌وگو یک نشست است: تاریخچه‌ی چت، پوشه‌ی پروژه، و تغییراتِ کدِ خودش را دارد، مستقل از هر نشستِ دیگری. نوارِ کناری نشست‌هایت را فهرست می‌کند و به تو اجازه می‌دهد چندتا را به‌صورتِ موازی اجرا کنی. درونِ یک نشست می‌توانی:

diffها را مرور و روی آن‌ها نظر بگذاری، سپس PRِ حاصل را از طریقِ CI تماشا کنی
اپِ در حالِ اجرایت را پیش‌نمایش کنی در یک مرورگرِ توکار، در حالی که Claude تغییراتِ خودش را راستی‌آزمایی می‌کند
پنل‌ها را بچینی برای چت، diff، پیش‌نمایش، ترمینال، و ویرایشگرِ فایل در کنارِ هم
یک سؤالِ جانبی بپرسی که از کانتکستِ نشست استفاده می‌کند بدونِ اینکه منحرفش کند
ابزارهای بیرونی مثلِ GitHub، Slack و Linear را وصل کنی
بگذاری Claude اپ‌ها را باز کند و صفحه‌نمایشت را کنترل کند
روی دستگاهت، در ابر، یا روی SSH اجرا کنی

برای کارهای تکرارشونده‌ی زمان‌بندی‌شده، میان‌برهای صفحه‌کلید، یا فرستادنِ کارها از تلفنت، صفحه‌ها و بخش‌های لینک‌شده را ببین. اگر از قبل از CLIِ مبتنی‌بر-ترمینال استفاده می‌کنی، برای آنچه منتقل می‌شود مقایسه با CLI را ببین.

یک نشست شروع کن

پیش از فرستادنِ اولین پیامت، چهار چیز را در ناحیه‌ی پرامپت پیکربندی کن:

Environment: انتخاب کن Claude کجا اجرا شود. برای دستگاهت Local، برای نشست‌های ابریِ میزبانیِ‌Anthropic Remote، یا یک SSH connection برای دستگاهِ راه‌دوری که خودت مدیریت می‌کنی را انتخاب کن. پیکربندیِ محیط را ببین.
Project folder: پوشه یا مخزنی که Claude در آن کار می‌کند را انتخاب کن. برای نشست‌های ابری، می‌توانی چند مخزن اضافه کنی.
Model: یک مدل را از منوی کشویی کنارِ دکمه‌ی ارسال انتخاب کن. می‌توانی این را در طولِ نشست عوض کنی.
Permission mode: از انتخاب‌گرِ حالت انتخاب کن Claude چقدر خودمختاری داشته باشد. می‌توانی این را در طولِ نشست عوض کنی.

کارت را تایپ کن و Enter را بزن تا شروع شود. هر نشست کانتکست و تغییراتِ خودش را به‌صورتِ مستقل ردیابی می‌کند.

کار با کد

به Claude کانتکستِ درست بده، کنترل کن چقدر به‌تنهایی انجام دهد، و آنچه را تغییر داده مرور کن.

از جعبه‌ی پرامپت استفاده کن

آنچه می‌خواهی Claude انجام دهد را تایپ کن و Enter را بزن تا ارسال شود. Claude فایل‌های پروژه‌ات را می‌خواند، تغییر اعمال می‌کند، و بر اساسِ حالتِ دسترسی‌ات دستورها را اجرا می‌کند. می‌توانی Claude را در هر لحظه‌ای منحرف کنی: روی دکمه‌ی توقف کلیک کن تا فوراً قطع شود، یا یک اصلاح تایپ کن و Enter را بزن تا بدونِ متوقف‌کردنِ اکشنِ در حالِ اجرا ارسال شود. Claude به‌محضِ اینکه اکشنِ فعلی کامل شود اصلاح را می‌خواند و پیش از قدمِ بعدی‌اش تنظیم می‌شود.

دکمه‌ی + کنارِ جعبه‌ی پرامپت به تو دسترسی به پیوست‌های فایل، skillها، connectorها، و پلاگین‌ها می‌دهد.

فایل و کانتکست به پرامپت‌ها اضافه کن

جعبه‌ی پرامپت از دو راه برای آوردنِ کانتکستِ بیرونی پشتیبانی می‌کند:

@mentionِ فایل‌ها: @ را و سپس نامِ یک فایل را تایپ کن تا فایلی به کانتکستِ گفت‌وگو اضافه شود. Claude سپس می‌تواند آن فایل را بخواند و به آن ارجاع دهد. @mention در نشست‌های ابری در دسترس نیست.
پیوستِ فایل‌ها: تصاویر، PDFها، و دیگر فایل‌ها را با دکمه‌ی پیوست به پرامپتت پیوست کن، یا فایل‌ها را مستقیماً در پرامپت بکش‌ورها کن. این برای به اشتراک‌گذاریِ اسکرین‌شات‌های باگ‌ها، ماکاپ‌های طراحی، یا اسنادِ مرجع مفید است.

یک حالتِ دسترسی انتخاب کن

حالت‌های دسترسی کنترل می‌کنند Claude در طولِ یک نشست چقدر خودمختاری دارد: اینکه آیا پیش از ویرایشِ فایل‌ها، اجرای دستورها، یا هر دو بپرسد. می‌توانی در هر لحظه‌ای با انتخاب‌گرِ حالت کنارِ دکمه‌ی ارسال حالت‌ها را عوض کنی. با Ask permissions شروع کن تا دقیقاً ببینی Claude چه می‌کند، سپس با راحت‌ترشدن به Auto accept edits یا Plan mode برو.

حالت	کلیدِ تنظیمات	رفتار
Ask permissions	`default`	Claude پیش از ویرایشِ فایل‌ها یا اجرای دستورها می‌پرسد. یک diff می‌بینی و می‌توانی هر تغییر را بپذیری یا رد کنی. برای کاربرانِ تازه توصیه می‌شود.
Auto accept edits	`acceptEdits`	Claude ویرایش‌های فایل و دستورهای رایجِ فایل‌سیستمی مثلِ `mkdir`، `touch` و `mv` را به‌صورتِ خودکار می‌پذیرد، اما همچنان پیش از اجرای دیگر دستورهای ترمینال می‌پرسد. وقتی به تغییراتِ فایل اعتماد داری و تکرارِ سریع‌تر می‌خواهی از این استفاده کن.
Plan mode	`plan`	Claude فایل‌ها را می‌خواند و دستورها را برای کاوش اجرا می‌کند، سپس یک پلن پیشنهاد می‌دهد بدونِ ویرایشِ کدِ منبعت. برای کارهای پیچیده که می‌خواهی اول رویکرد را مرور کنی خوب است.
Auto	`auto`	Claude همه‌ی اکشن‌ها را با بررسی‌های ایمنیِ پس‌زمینه که هم‌راستایی با درخواستت را تأیید می‌کنند اجرا می‌کند. پرامپت‌های دسترسی را کم می‌کند در حالی که نظارت را حفظ می‌کند. در Settings → Claude Code فعالش کن. الزاماتِ در دسترس‌بودن را در زیر ببین.
Bypass permissions	`bypassPermissions`	Claude بدونِ پرامپت‌های دسترسی اجرا می‌شود، به‌جز آن‌هایی که با قواعدِ askِ صریح اجباری شده‌اند؛ معادلِ `--dangerously-skip-permissions` در CLI. در Settings → Claude Code زیرِ «Allow bypass permissions mode» فعالش کن. فقط در کانتینرها یا VMهای sandboxed از این استفاده کن. ادمین‌های سازمانی می‌توانند این گزینه را غیرفعال کنند.

حالتِ دسترسیِ dontAsk فقط در CLI در دسترس است.

حالتِ Auto یک research preview است که برای همه‌ی کاربران روی Anthropic API در دسترس است و به Claude Opus 4.6 یا بالاتر، یا Sonnet 4.6 نیاز دارد. در استقرارهای Enterprise که Desktop را به Google Cloud Vertex AI مسیریابی می‌کنند، حالتِ auto خاموش است تا وقتی CLAUDE_CODE_ENABLE_AUTO_MODE را تنظیم کنی، و آن‌جا فقط Claude Opus 4.7 و Opus 4.8 پشتیبانی می‌شوند.

نشست‌های ابری از Accept edits، Plan mode و Auto mode پشتیبانی می‌کنند. Accept edits متناظرِ حالتِ default است: نشست‌های ابری ویرایش‌های فایل را از پیش تأیید می‌کنند، پس انتخاب‌گر به‌جای Ask permissions، Accept edits را نشان می‌دهد. Bypass permissions در دسترس نیست چون محیطِ ابری از قبل sandboxed است.

ادمین‌های سازمانی می‌توانند محدود کنند کدام حالت‌های دسترسی در دسترس باشند. برای جزئیات، پیکربندیِ سازمانی را ببین.

اپت را پیش‌نمایش کن

Claude می‌تواند یک dev server راه بیندازد و یک مرورگرِ توکار باز کند تا تغییراتش را راستی‌آزمایی کند. این برای اپ‌های وبِ frontend و همچنین سرورهای backend کار می‌کند: Claude می‌تواند endpointهای API را تست کند، لاگ‌های سرور را ببیند، و روی مشکلاتی که پیدا می‌کند تکرار کند. در بیشترِ موارد، Claude بعد از ویرایشِ فایل‌های پروژه به‌صورتِ خودکار سرور را راه می‌اندازد. می‌توانی از Claude بخواهی در هر لحظه‌ای پیش‌نمایش کند. به‌صورتِ پیش‌فرض، Claude بعد از هر ویرایش تغییرات را خودکار راستی‌آزمایی می‌کند.

پنلِ پیش‌نمایش همچنین می‌تواند فایل‌های HTMLِ ایستا، PDFها، تصاویر و ویدیوها را از پروژه‌ات باز کند. روی مسیرِ یک HTML، PDF، تصویر، یا ویدیو در چت کلیک کن تا در پیش‌نمایش باز شود.

از پنلِ پیش‌نمایش می‌توانی:

مستقیماً در مرورگرِ توکار با اپِ در حالِ اجرایت تعامل کنی
تماشا کنی Claude خودش تغییراتش را به‌صورتِ خودکار راستی‌آزمایی می‌کند: اسکرین‌شات می‌گیرد، DOM را بررسی می‌کند، روی عناصر کلیک می‌کند، فرم‌ها را پر می‌کند، و مشکلاتی را که پیدا می‌کند برطرف می‌کند
سرورها را از منوی کشویی Preview در نوارِ ابزارِ نشست راه بیندازی یا متوقف کنی
با انتخابِ Persist sessions در منوی کشویی، کوکی‌ها و local storage را در سراسرِ ری‌استارت‌های سرور پایدار نگه داری، تا مجبور نباشی در طولِ توسعه دوباره لاگین کنی
پیکربندیِ سرور را ویرایش کنی یا همه‌ی سرورها را یک‌جا متوقف کنی

Claude پیکربندیِ اولیه‌ی سرور را بر اساسِ پروژه‌ات می‌سازد. اگر اپت از یک دستورِ devِ سفارشی استفاده می‌کند، .claude/launch.json را ویرایش کن تا با راه‌اندازی‌ات بخواند. برای مرجعِ کامل، پیکربندیِ سرورهای پیش‌نمایش را ببین.

برای پاک‌کردنِ داده‌ی نشستِ ذخیره‌شده، Persist preview sessions را در Settings → Claude Code خاموش کن. برای غیرفعال‌کردنِ کاملِ پیش‌نمایش، Preview را در Settings → Claude Code خاموش کن.

مرورِ تغییرات با نمای diff

بعد از اینکه Claude تغییراتی در کدت ایجاد می‌کند، نمای diff به تو اجازه می‌دهد پیش از ساختِ یک pull request اصلاحات را فایل‌به‌فایل مرور کنی.

وقتی Claude فایل‌ها را تغییر می‌دهد، یک نشانگرِ آمارِ diff ظاهر می‌شود که تعدادِ خطوطِ افزوده و حذف‌شده را نشان می‌دهد، مثلِ +12 -1. روی این نشانگر کلیک کن تا نمایشگرِ diff باز شود، که فهرستِ فایل‌ها را در سمتِ چپ و تغییراتِ هر فایل را در سمتِ راست نمایش می‌دهد.

برای نظردادن روی خطوطِ مشخص، روی هر خطی در diff کلیک کن تا یک جعبه‌ی نظر باز شود. بازخوردت را تایپ کن و Enter را بزن تا نظر اضافه شود. بعد از افزودنِ نظر به چند خط، همه‌ی نظرها را یک‌جا ارسال کن:

macOS: Cmd+Enter را بزن
Windows: Ctrl+Enter را بزن

Claude نظرهایت را می‌خواند و تغییراتِ درخواست‌شده را اعمال می‌کند، که به‌صورتِ یک diffِ تازه که می‌توانی مرور کنی ظاهر می‌شوند.

کدت را مرور کن

در نمای diff، روی Review code در نوارِ ابزارِ بالا-راست کلیک کن تا از Claude بخواهی پیش از کامیت تغییرات را ارزیابی کند. Claude diffهای فعلی را بررسی می‌کند و مستقیماً در نمای diff نظر می‌گذارد. می‌توانی به هر نظری پاسخ دهی یا از Claude بخواهی بازنگری کند.

این مرور روی مسائلِ پرسیگنال تمرکز می‌کند: خطاهای کامپایل، خطاهای منطقیِ قطعی، آسیب‌پذیری‌های امنیتی، و باگ‌های آشکار. روی سبک، فرمت، مسائلِ از پیش‌موجود، یا چیزی که یک linter بگیرد علامت نمی‌گذارد.

مانیتورِ وضعیتِ pull request

بعد از اینکه یک pull request باز می‌کنی، یک نوارِ وضعیتِ CI در نشست ظاهر می‌شود. Claude Code از GitHub CLI برای پولِ نتایجِ check و آشکارکردنِ شکست‌ها استفاده می‌کند.

Auto-fix: وقتی فعال است، Claude به‌صورتِ خودکار با خواندنِ خروجیِ شکست و تکرار، تلاش می‌کند checkهای شکست‌خورده‌ی CI را برطرف کند.
Auto-merge: وقتی فعال است، Claude به‌محضِ پاس‌شدنِ همه‌ی checkها، PR را ادغام می‌کند. روشِ ادغام squash است. برای کارکردنِ این، Auto-merge باید در تنظیماتِ مخزنِ GitHubت فعال شده باشد.

از تاگل‌های Auto-fix و Auto-merge در نوارِ وضعیتِ CI برای فعال‌کردنِ هرکدام استفاده کن. Claude Code همچنین وقتی CI تمام می‌شود یک اعلانِ دسکتاپ می‌فرستد. برای اینکه نشست به‌محضِ ادغام یا بسته‌شدنِ PR به‌صورتِ خودکار آرشیو شود، auto-archive را در Settings → Claude Code روشن کن.

فضای کارت را بچین

تبِ Code حولِ پنل‌هایی ساخته شده که می‌توانی در هر چیدمانی بچینی: چت، diff، پیش‌نمایش، ترمینال، فایل، plan، tasks، و subagent. یک پنل را با هدرش بکش تا جابه‌جا شود، یا لبه‌ی یک پنل را بکش تا اندازه‌اش را عوض کنی. روی macOS Cmd+\ یا روی Windows Ctrl+\ را بزن تا پنلِ فوکوس‌شده بسته شود. پنل‌های بیشتر را از منوی Views در نوارِ ابزارِ نشست باز کن.

دستورها را در ترمینال اجرا کن

ترمینالِ یکپارچه به تو اجازه می‌دهد دستورها را در کنارِ نشستت اجرا کنی بدونِ اینکه به اپِ دیگری بروی. از منوی Views بازش کن یا روی macOS یا Windows Ctrl+` را بزن. ترمینال در دایرکتوریِ کاریِ نشستت باز می‌شود و همان محیطِ Claude را به اشتراک می‌گذارد، پس دستورهایی مثلِ npm test یا git status همان فایل‌هایی را می‌بینند که Claude ویرایش می‌کند. برای بازکردنِ یک تبِ ترمینالِ دوم، روی + در هدرِ پنلِ ترمینال کلیک کن یا روی یک پوشه در چت راست‌کلیک کن تا Open in terminal را انتخاب کنی. ترمینال فقط در نشست‌های محلی در دسترس است.

فایل‌ها را باز و ویرایش کن

روی مسیرِ یک فایل در چت یا نمایشگرِ diff کلیک کن تا در پنلِ فایل باز شود. مسیرهای HTML، PDF، تصویر و ویدیو به‌جایش در پنلِ پیش‌نمایش باز می‌شوند. ویرایش‌های موضعی انجام بده و روی Save کلیک کن تا برگردانده شوند. اگر فایل از وقتی بازش کرده‌ای روی دیسک تغییر کرده باشد، پنل به تو هشدار می‌دهد و اجازه می‌دهد override یا discard کنی. روی Discard کلیک کن تا ویرایش‌هایت برگردانده شوند، یا روی مسیر در هدرِ پنل کلیک کن تا مسیرِ مطلق را کپی کنی.

پنلِ فایل در نشست‌های محلی و SSH در دسترس است. برای نشست‌های ابری، از Claude بخواه تغییر را اعمال کند.

فایل‌ها را در اپ‌های دیگر باز کن

روی مسیرِ هر فایلی در چت، نمایشگرِ diff، یا پنلِ فایل راست‌کلیک کن تا یک منوی کانتکست باز شود:

Attach as context: فایل را به پرامپتِ بعدی‌ات اضافه کن
Open in: فایل را در یک ویرایشگرِ نصب‌شده مثلِ VS Code، Cursor، یا Zed باز کن
Show in Finder روی macOS، Show in Explorer روی Windows: پوشه‌ی دربرگیرنده را باز کن
Copy path: مسیرِ مطلق را در کلیپ‌بوردت کپی کن

حالت‌های نما را عوض کن

حالت‌های نما کنترل می‌کنند چقدر جزئیات در رونوشتِ چت ظاهر شود. حالت‌ها را از منوی کشویی Transcript view کنارِ دکمه‌ی ارسال عوض کن، یا روی macOS یا Windows Ctrl+O را بزن تا بینشان بچرخی.

حالت	چه چیزی نشان می‌دهد
Normal	فراخوانی‌های ابزار جمع‌شده در خلاصه‌ها، با پاسخ‌های متنیِ کامل
Verbose	هر فراخوانیِ ابزار، خواندنِ فایل، و قدمِ میانی که Claude برمی‌دارد
Summary	فقط پاسخ‌های نهاییِ Claude و تغییراتی که ایجاد کرد

از Verbose هنگامِ دیباگِ اینکه چرا Claude اکشنِ خاصی را انجام داد استفاده کن. از Summary وقتی استفاده کن که چند نشست را اجرا می‌کنی و می‌خواهی نتایج را سریع مرور کنی.

میان‌برهای صفحه‌کلید

روی macOS Cmd+/ یا روی Windows Ctrl+/ را بزن تا همه‌ی میان‌برهای در دسترسِ تبِ Code را ببینی. روی Windows، برای میان‌برهای زیر از Ctrl به‌جای Cmd استفاده کن. چرخشِ نشست، تاگلِ ترمینال، و تاگلِ حالتِ نما روی هر پلتفرمی از Ctrl استفاده می‌کنند.

میان‌بر	اکشن
`Cmd` `/`	نمایشِ میان‌برهای صفحه‌کلید
`Cmd` `N`	نشستِ تازه
`Cmd` `W`	بستنِ نشست
`Ctrl` `Tab` / `Ctrl` `Shift` `Tab`	نشستِ بعدی یا قبلی
`Cmd` `Shift` `]` / `Cmd` `Shift` `[`	نشستِ بعدی یا قبلی
`Esc`	توقفِ پاسخِ Claude
`Cmd` `Shift` `D`	تاگلِ پنلِ diff
`Cmd` `Shift` `P`	تاگلِ پنلِ پیش‌نمایش
`Cmd` `Shift` `S`	انتخابِ یک عنصر در پیش‌نمایش
`Ctrl` `	تاگلِ پنلِ ترمینال
`Cmd` `\`	بستنِ پنلِ فوکوس‌شده
`Cmd` `;`	بازکردنِ چتِ جانبی
`Ctrl` `O`	چرخش بینِ حالت‌های نما
`Cmd` `Shift` `M`	بازکردنِ منوی حالتِ دسترسی
`Cmd` `Shift` `I`	بازکردنِ منوی مدل
`Cmd` `Shift` `E`	بازکردنِ منوی effort
`1`–`9`	انتخابِ آیتم در یک منوی باز

این میان‌برها فقط برای تبِ Code اعمال می‌شوند. میان‌برهای حالتِ تعاملیِ مبتنی‌بر-ترمینال، مثلِ Shift+Tab برای چرخشِ حالت‌ها، در Desktop اعمال نمی‌شوند.

بررسیِ مصرف

روی حلقه‌ی مصرف کنارِ انتخاب‌گرِ مدل کلیک کن تا مصرفِ فعلیِ پنجره‌ی کانتکست و مصرفِ پلنت برای آن دوره را ببینی. مصرفِ کانتکست به‌ازای هر نشست است؛ مصرفِ پلن در سراسرِ همه‌ی سطوحِ Claude Codeات به اشتراک گذاشته می‌شود.

بگذار Claude از کامپیوترت استفاده کند

computer use به Claude اجازه می‌دهد اپ‌هایت را باز کند، صفحه‌نمایشت را کنترل کند، و مستقیماً روی دستگاهت آن‌گونه که خودت کار می‌کنی کار کند. از Claude بخواه یک اپِ نیتیو را در یک شبیه‌سازِ موبایل تست کند، با یک ابزارِ دسکتاپ که CLI ندارد تعامل کند، یا چیزی را که فقط از طریقِ یک GUI کار می‌کند خودکار کند.

computer use به‌صورتِ پیش‌فرض خاموش است. پیش از اینکه Claude بتواند صفحه‌نمایشت را کنترل کند، در Settings فعالش کن. روی macOS، باید دسترسی‌های Accessibility و Screen Recording را هم بدهی.

چه وقت computer use اعمال می‌شود

Claude چند راه برای تعامل با یک اپ یا سرویس دارد، و computer use گسترده‌ترین و کندترین است. اول دقیق‌ترین ابزار را امتحان می‌کند:

اگر برای یک سرویس connector داری، Claude از connector استفاده می‌کند.
اگر کار یک دستورِ شل است، Claude از Bash استفاده می‌کند.
اگر کار کارِ مرورگری است و Claude in Chrome را راه‌اندازی کرده‌ای، Claude از آن استفاده می‌کند.
اگر هیچ‌کدام اعمال نشوند، Claude از computer use استفاده می‌کند.

سطوحِ دسترسیِ به‌ازای هر اپ این را تقویت می‌کنند: مرورگرها به view-only و ترمینال‌ها و IDEها به click-only محدود شده‌اند، که Claude را حتی وقتی computer use فعال است به سمتِ ابزارِ اختصاصی هدایت می‌کند. کنترلِ صفحه‌نمایش برای چیزهایی نگه داشته شده که هیچ‌چیزِ دیگری به آن نمی‌رسد، مثلِ اپ‌های نیتیو، پنل‌های کنترلِ سخت‌افزار، شبیه‌سازهای موبایل، یا ابزارهای اختصاصیِ بدونِ API.

computer use را فعال کن

computer use به‌صورتِ پیش‌فرض خاموش است. اگر از Claude بخواهی کاری انجام دهد که به آن نیاز دارد در حالی که خاموش است، Claude به تو می‌گوید می‌توانست کار را انجام دهد اگر computer use را در Settings فعال کنی.

اپِ دسکتاپ را به‌روزرسانی کن

مطمئن شو آخرین نسخه‌ی Claude Desktop را داری. در claude.com/download دانلود یا به‌روزرسانی کن، سپس اپ را ری‌استارت کن.

تاگل را روشن کن

در اپِ دسکتاپ، به Settings > General (زیرِ Desktop app) برو. تاگلِ Computer use را پیدا کن و روشنش کن. روی Windows، تاگل فوراً اثر می‌کند و راه‌اندازی کامل است. روی macOS، به قدمِ بعدی برو.

اگر تاگل را نمی‌بینی، تأیید کن که روی macOS یا Windows با یک پلنِ Pro یا Max هستی، سپس اپ را به‌روزرسانی و ری‌استارت کن.

دسترسی‌های macOS را بده

روی macOS، پیش از اینکه تاگل اثر کند دو دسترسیِ سیستمی بده:

Accessibility: به Claude اجازه می‌دهد کلیک کند، تایپ کند، و اسکرول کند
Screen Recording: به Claude اجازه می‌دهد ببیند روی صفحه‌نمایشت چیست

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

دسترسی‌های اپ

اولین باری که Claude نیاز دارد از یک اپ استفاده کند، یک پرامپت در نشستت ظاهر می‌شود. روی Allow for this session یا Deny کلیک کن. تأییدها برای نشستِ فعلی، یا در نشست‌های spawnشده با Dispatch ۳۰ دقیقه دوام می‌آورند.

پرامپت همچنین نشان می‌دهد Claude چه سطحی از کنترل برای آن اپ می‌گیرد. این سطوح بر اساسِ دسته‌ی اپ ثابت‌اند و قابلِ تغییر نیستند:

سطح	Claude چه می‌تواند بکند	اعمال می‌شود به
View only	اپ را در اسکرین‌شات‌ها ببیند	مرورگرها، پلتفرم‌های ترید
Click only	کلیک و اسکرول کند، اما تایپ یا استفاده از میان‌برهای صفحه‌کلید نه	ترمینال‌ها، IDEها
Full control	کلیک، تایپ، کشیدن، و استفاده از میان‌برهای صفحه‌کلید	هر چیزِ دیگری

اپ‌هایی با دامنه‌ی گسترده، مثلِ ترمینال‌ها، Finder یا File Explorer، و System Settings یا Settings، یک هشدارِ اضافی در پرامپت نشان می‌دهند تا بدانی تأییدشان چه چیزی اعطا می‌کند.

می‌توانی دو تنظیم را در Settings > General (زیرِ Desktop app) پیکربندی کنی:

Denied apps: اپ‌ها را این‌جا اضافه کن تا بدونِ پرامپت ردشان کنی. Claude ممکن است همچنان یک اپِ ردشده را به‌صورتِ غیرمستقیم از طریقِ اکشن‌ها در یک اپِ مجاز تحتِ تأثیر قرار دهد، اما نمی‌تواند مستقیماً با اپِ ردشده تعامل کند.
Unhide apps when Claude finishes: در حالی که Claude کار می‌کند، پنجره‌های دیگرت پنهان می‌شوند تا فقط با اپِ تأییدشده تعامل کند. وقتی Claude تمام می‌کند، پنجره‌های پنهان بازگردانده می‌شوند مگر اینکه این تنظیم را خاموش کنی.

مدیریتِ نشست‌ها

هر نشست یک گفت‌وگوی مستقل با کانتکست و تغییراتِ خودش است. می‌توانی چند نشست را به‌صورتِ موازی اجرا کنی، چت‌های جانبی منشعب کنی، کار را به ابر بفرستی، یا بگذاری Dispatch از تلفنت برایت نشست شروع کند.

به‌صورتِ موازی با نشست‌ها کار کن

روی + New session در نوارِ کناری کلیک کن، یا روی macOS Cmd+N یا روی Windows Ctrl+N را بزن، تا روی چند کار به‌صورتِ موازی کار کنی. Ctrl+Tab و Ctrl+Shift+Tab را بزن تا بینِ نشست‌ها در نوارِ کناری بچرخی. برای مخازنِ Git، هر نشست با استفاده از worktreeهای Git کپیِ ایزوله‌ی خودش از پروژه‌ات را می‌گیرد، پس تغییرات در یک نشست تا وقتی کامیت نکنی روی نشست‌های دیگر اثر نمی‌گذارند.

برای دیدنِ دو نشست هم‌زمان، روی macOS Cmd یا روی Windows Ctrl را نگه دار و روی یک نشست در نوارِ کناری کلیک کن. نشست در یک پنلِ دوم کنارِ آنی که از قبل باز داری باز می‌شود. در حالی که تقسیم فعال است، کلیک روی نشستِ دیگری در نوارِ کناری هر پنلی را که فوکوس دارد جایگزین می‌کند. روی macOS Cmd+\ یا روی Windows Ctrl+\ را بزن تا پنلِ فوکوس‌شده بسته شود و به یک نشستِ تکی برگردی.

worktreeها به‌صورتِ پیش‌فرض در <project-root>/.claude/worktrees/ ذخیره می‌شوند. می‌توانی این را در Settings → Claude Code زیرِ «Worktree location» به یک دایرکتوریِ سفارشی تغییر دهی. همچنین می‌توانی یک پیشوندِ شاخه تنظیم کنی که به نامِ هر شاخه‌ی worktree افزوده می‌شود، که برای مرتب‌نگه‌داشتنِ شاخه‌های ساخته‌شده‌ی Claude مفید است. برای حذفِ یک worktree وقتی کارت تمام شد، روی نشست در نوارِ کناری هاور کن و روی آیکونِ آرشیو کلیک کن. برای اینکه نشست‌ها وقتی pull requestشان ادغام یا بسته می‌شود خودشان را آرشیو کنند، Auto-archive after PR merge or close را در Settings → Claude Code روشن کن. auto-archive فقط روی نشست‌های محلی‌ای که اجرایشان تمام شده اعمال می‌شود.

برای گنجاندنِ فایل‌های gitignore‌شده مثلِ .env در worktreeهای تازه، یک فایلِ .worktreeinclude در ریشه‌ی پروژه‌ات بساز.

از کنترل‌های بالای نوارِ کناری برای فیلترکردنِ نشست‌ها بر اساسِ وضعیت، پروژه، یا محیط، و برای گروه‌بندیِ نشست‌ها بر اساسِ پروژه استفاده کن. برای تغییرِ نامِ یک نشست، روی عنوانِ نشست در نوارِ ابزارِ بالای نشستِ فعال کلیک کن. برای بررسیِ مصرفِ کانتکست، بررسیِ مصرف را ببین. وقتی کانتکست پر می‌شود، Claude به‌صورتِ خودکار گفت‌وگو را خلاصه می‌کند و به کار ادامه می‌دهد. می‌توانی /compact را هم تایپ کنی تا خلاصه‌سازی را زودتر trigger کنی و فضای کانتکست را آزاد کنی. برای جزئیاتِ نحوه‌ی کارکردِ compaction، پنجره‌ی کانتکست را ببین.

اپِ دسکتاپ وقتی یک نشستِ Code کاری را تمام می‌کند و تو در آن لحظه آن نشست را نگاه نمی‌کنی، یک اعلانِ OS می‌فرستد.

یک سؤالِ جانبی بپرس بدونِ منحرف‌کردنِ نشست

یک چتِ جانبی به تو اجازه می‌دهد سؤالی از Claude بپرسی که از کانتکستِ نشستت استفاده می‌کند اما چیزی به گفت‌وگوی اصلی برنمی‌گرداند. از آن وقتی استفاده کن که می‌خواهی قطعه‌ای از کد را بفهمی، یک فرض را بررسی کنی، یا ایده‌ای را کاوش کنی بدونِ اینکه نشست را از مسیر خارج کنی.

روی macOS Cmd+; یا روی Windows Ctrl+; را بزن تا یک چتِ جانبی باز شود، یا /btw را در جعبه‌ی پرامپت تایپ کن. چتِ جانبی می‌تواند هر چیزی را که تا آن نقطه در رشته‌ی اصلی است بخواند. وقتی کارت تمام شد، چتِ جانبی را ببند و نشستِ اصلی را از جایی که رهایش کردی ادامه بده. چت‌های جانبی در نشست‌های محلی و SSH در دسترس‌اند.

کارهای پس‌زمینه را تماشا کن

پنلِ tasks کارِ پس‌زمینه‌ی در حالِ اجرا درونِ نشستِ فعلی را نشان می‌دهد: ساب‌ایجنت‌ها، دستورهای شلِ پس‌زمینه، و ورک‌فلوهای پویا. از منوی Views بازش کن یا به چیدمانت بکشش.

روی هر ورودی کلیک کن تا خروجی‌اش را در پنلِ subagent ببینی یا متوقفش کنی. برای دیدنِ اینکه نشست‌های دیگر چه می‌کنند، از نوارِ کناری استفاده کن.

کارهای طولانی را به‌صورتِ راه‌دور اجرا کن

برای refactorهای بزرگ، test suiteها، migrationها، یا دیگر کارهای طولانی، هنگامِ شروعِ یک نشست به‌جای Local، Remote را انتخاب کن. نشست‌های ابری روی زیرساختِ ابریِ Anthropic اجرا می‌شوند و حتی اگر اپ را ببندی یا کامپیوترت را خاموش کنی ادامه می‌یابند. هر وقت خواستی برگرد تا پیشرفت را ببینی یا Claude را به جهتِ دیگری هدایت کنی. می‌توانی نشست‌های ابری را از claude.ai/code یا اپِ Claude iOS هم مانیتور کنی.

نشست‌های ابری از چند مخزن هم پشتیبانی می‌کنند. بعد از انتخابِ یک محیطِ ابری، روی دکمه‌ی + کنارِ pillِ مخزن کلیک کن تا مخازنِ بیشتری به نشست اضافه کنی. هر مخزن انتخاب‌گرِ شاخه‌ی خودش را می‌گیرد. این برای کارهایی که چند کدبیس را پوشش می‌دهند مفید است، مثلِ به‌روزرسانیِ یک کتابخانه‌ی مشترک و مصرف‌کننده‌هایش.

برای بیشتر درباره‌ی نحوه‌ی کارکردِ نشست‌های ابری، Claude Code روی وب را ببین.

در سطحِ دیگری ادامه بده

منوی Continue in، که از آیکونِ VS Code در پایین‌-راستِ نوارِ ابزارِ نشست در دسترس است، به تو اجازه می‌دهد نشستت را به سطحِ دیگری منتقل کنی:

Claude Code on the Web: نشستِ محلی‌ات را می‌فرستد تا به‌صورتِ راه‌دور ادامه یابد. Desktop شاخه‌ات را push می‌کند، خلاصه‌ای از گفت‌وگو تولید می‌کند، و یک نشستِ ابریِ تازه با کانتکستِ کامل می‌سازد. سپس می‌توانی انتخاب کنی نشستِ محلی را آرشیو کنی یا نگهش داری. این به یک working tree تمیز نیاز دارد، و برای نشست‌های SSH در دسترس نیست.
Your IDE: پروژه‌ات را در یک IDEِ پشتیبانی‌شده در دایرکتوریِ کاریِ فعلی باز می‌کند.

نشست‌ها از Dispatch

Dispatch یک گفت‌وگوی پایدار با Claude است که در تبِ Cowork زندگی می‌کند. کاری را به Dispatch پیام می‌دهی، و آن تصمیم می‌گیرد چطور با آن برخورد کند.

یک کار به دو راه می‌تواند به یک نشستِ Code تبدیل شود: مستقیماً یکی بخواهی، مثلِ «open a Claude Code session and fix the login bug»، یا Dispatch تصمیم بگیرد کار، کارِ توسعه است و خودش یکی spawn کند. کارهایی که معمولاً به Code مسیریابی می‌شوند شاملِ رفعِ باگ‌ها، به‌روزرسانیِ وابستگی‌ها، اجرای تست‌ها، یا بازکردنِ pull requestها هستند. تحقیق، ویرایشِ سند، و کارِ صفحه‌گسترده در Cowork می‌مانند.

در هر صورت، نشستِ Code با یک نشانِ Dispatch در نوارِ کناریِ تبِ Code ظاهر می‌شود. وقتی تمام می‌شود یا به تأییدت نیاز دارد، یک push notification روی تلفنت می‌گیری.

اگر computer use را فعال داری، نشست‌های Codeِ spawnشده با Dispatch هم می‌توانند از آن استفاده کنند. تأییدهای اپ در آن نشست‌ها بعد از ۳۰ دقیقه منقضی می‌شوند و دوباره پرامپت می‌دهند، به‌جای اینکه مثلِ نشست‌های Codeِ معمولی کلِ نشست دوام بیاورند.

برای راه‌اندازی، pairing، و تنظیماتِ Dispatch، مقاله‌ی راهنمای Dispatch را ببین. Dispatch به یک پلنِ Pro یا Max نیاز دارد و روی پلن‌های Team یا Enterprise در دسترس نیست.

Dispatch یکی از چند راهِ کارکردن با Claude وقتی از ترمینالت دور هستی است. برای مقایسه‌اش با Remote Control، Channels، Slack، و کارهای زمان‌بندی‌شده، پلتفرم‌ها و یکپارچه‌سازی‌ها را ببین.

Claude Code را گسترش بده

سرویس‌های بیرونی را وصل کن، ورک‌فلوهای قابلِ‌استفاده‌ی مجدد اضافه کن، رفتارِ Claude را سفارشی کن، و سرورهای پیش‌نمایش را پیکربندی کن. برای مدیریتِ connectorها، skillها، و پلاگین‌ها در یک‌جا، روی Customize در نوارِ کناری کلیک کن.

ابزارهای بیرونی را وصل کن

برای نشست‌های محلی و SSH، روی دکمه‌ی + کنارِ جعبه‌ی پرامپت کلیک کن و Connectors را انتخاب کن تا یکپارچه‌سازی‌هایی مثلِ Google Calendar، Slack، GitHub، Linear، Notion و بیشتر اضافه کنی. می‌توانی connectorها را پیش از یا در طولِ یک نشست اضافه کنی. دکمه‌ی + در نشست‌های ابری در دسترس نیست، اما routineها connectorها را در زمانِ ساختِ routine پیکربندی می‌کنند.

برای مدیریت یا قطعِ connectorها، در اپِ دسکتاپ به Settings → Connectors برو، یا Manage connectors را از منوی Connectors در جعبه‌ی پرامپت انتخاب کن.

وقتی وصل شد، Claude می‌تواند تقویمت را بخواند، پیام بفرستد، issue بسازد، و مستقیماً با ابزارهایت تعامل کند. می‌توانی از Claude بپرسی چه connectorهایی در نشستت پیکربندی شده‌اند.

connectorها MCP serverهایی با یک جریانِ راه‌اندازیِ گرافیکی هستند. از آن‌ها برای یکپارچه‌سازیِ سریع با سرویس‌های پشتیبانی‌شده استفاده کن. برای یکپارچه‌سازی‌هایی که در Connectors فهرست نشده‌اند، MCP serverها را به‌صورتِ دستی از طریقِ فایل‌های تنظیمات اضافه کن. همچنین می‌توانی connectorهای سفارشی بسازی.

از skillها استفاده کن

Skillها آنچه را Claude می‌تواند انجام دهد گسترش می‌دهند. Claude وقتی مرتبط باشند به‌صورتِ خودکار بارشان می‌کند، یا می‌توانی یکی را مستقیماً فراخوانی کنی: / را در جعبه‌ی پرامپت تایپ کن یا روی دکمه‌ی + کلیک کن و Slash commands را انتخاب کن تا آنچه در دسترس است را مرور کنی. این شاملِ دستورهای داخلی، skillهای سفارشی‌ات، skillهای پروژه از کدبیست، و skillها از هر پلاگینِ نصب‌شده می‌شود. یکی را انتخاب کن و در فیلدِ ورودی هایلایت‌شده ظاهر می‌شود. کارت را بعد از آن تایپ کن و طبقِ معمول ارسال کن.

پلاگین نصب کن

پلاگین‌ها بسته‌های قابلِ‌استفاده‌ی مجددی هستند که skill، ایجنت، hook، MCP server، و پیکربندیِ LSP به Claude Code اضافه می‌کنند. می‌توانی پلاگین‌ها را از اپِ دسکتاپ بدونِ استفاده از ترمینال نصب کنی.

برای نشست‌های محلی و SSH، روی دکمه‌ی + کنارِ جعبه‌ی پرامپت کلیک کن و Plugins را انتخاب کن تا پلاگین‌های نصب‌شده‌ات و skillهایشان را ببینی. برای افزودنِ یک پلاگین، Add plugin را از زیرمنو انتخاب کن تا مرورگرِ پلاگین باز شود، که پلاگین‌های در دسترس از مارکت‌پلیس‌های پیکربندی‌شده‌ات شاملِ مارکت‌پلیسِ رسمیِ Anthropic را نشان می‌دهد. Manage plugins را انتخاب کن تا پلاگین‌ها را فعال، غیرفعال، یا حذف کنی.

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

سرورهای پیش‌نمایش را پیکربندی کن

Claude به‌صورتِ خودکار راه‌اندازیِ dev serverت را تشخیص می‌دهد و پیکربندی را در .claude/launch.json در ریشه‌ی پوشه‌ای که هنگامِ شروعِ نشست انتخاب کردی ذخیره می‌کند. پیش‌نمایش از این پوشه به‌عنوانِ دایرکتوریِ کاری‌اش استفاده می‌کند، پس اگر یک پوشه‌ی والد را انتخاب کردی، زیرپوشه‌هایی با dev serverهای خودشان به‌صورتِ خودکار تشخیص داده نمی‌شوند. برای کارکردن با سرورِ یک زیرپوشه، یا مستقیماً یک نشست در آن پوشه شروع کن یا یک پیکربندی را به‌صورتِ دستی اضافه کن.

برای سفارشی‌کردنِ نحوه‌ی راه‌اندازیِ سرورت، مثلاً برای استفاده از yarn dev به‌جای npm run dev یا تغییرِ پورت، فایل را به‌صورتِ دستی ویرایش کن یا روی Edit configuration در منوی کشویی Preview کلیک کن تا در ویرایشگرِ کدت باز شود. فایل از JSON با کامنت پشتیبانی می‌کند.

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

می‌توانی چند پیکربندی تعریف کنی تا سرورهای مختلف را از همان پروژه اجرا کنی، مثلِ یک frontend و یک API. نمونه‌ها را در زیر ببین.

راستی‌آزماییِ خودکارِ تغییرات

وقتی autoVerify فعال است، Claude بعد از ویرایشِ فایل‌ها به‌صورتِ خودکار تغییراتِ کد را راستی‌آزمایی می‌کند. اسکرین‌شات می‌گیرد، خطاها را بررسی می‌کند، و پیش از کامل‌کردنِ پاسخش تأیید می‌کند که تغییرات کار می‌کنند.

راستی‌آزماییِ خودکار به‌صورتِ پیش‌فرض روشن است. آن را به‌ازای هر پروژه با افزودنِ "autoVerify": false به .claude/launch.json غیرفعال کن، یا از منوی کشویی Preview تاگلش کن.

{
  "version": "0.0.1",
  "autoVerify": false,
  "configurations": [...]
}

وقتی غیرفعال است، ابزارهای پیش‌نمایش همچنان در دسترس‌اند و می‌توانی در هر لحظه از Claude بخواهی راستی‌آزمایی کند. راستی‌آزماییِ خودکار آن را بعد از هر ویرایش خودکار می‌کند.

فیلدهای پیکربندی

هر ورودی در آرایه‌ی configurations این فیلدها را می‌پذیرد:

فیلد	نوع	توضیح
`name`	string	یک شناسه‌ی یکتا برای این سرور
`runtimeExecutable`	string	دستوری که اجرا شود، مثلِ `npm`، `yarn`، یا `node`
`runtimeArgs`	string[]	آرگومان‌هایی که به `runtimeExecutable` پاس می‌شوند، مثلِ `["run", "dev"]`
`port`	number	پورتی که سرورت روی آن گوش می‌دهد. پیش‌فرض 3000 است
`cwd`	string	دایرکتوریِ کاری نسبت به ریشه‌ی پروژه‌ات. پیش‌فرض ریشه‌ی پروژه است. برای ارجاعِ صریح به ریشه‌ی پروژه از `${workspaceFolder}` استفاده کن
`env`	object	متغیرهای محیطیِ اضافی به‌صورتِ جفت‌های کلید-مقدار، مثلِ `{ "NODE_ENV": "development" }`. اسرار را این‌جا نگذار چون این فایل در مخزنت کامیت می‌شود. برای پاس‌دادنِ اسرار به dev serverت، به‌جایش آن‌ها را در ویرایشگرِ محیطِ محلی تنظیم کن.
`autoPort`	boolean	نحوه‌ی مدیریتِ تعارض‌های پورت. در زیر ببین
`program`	string	یک اسکریپت که با `node` اجرا شود. چه وقت `program` در برابرِ `runtimeExecutable` را ببین
`args`	string[]	آرگومان‌هایی که به `program` پاس می‌شوند. فقط وقتی `program` تنظیم شده باشد استفاده می‌شوند

چه وقت `program` در برابرِ `runtimeExecutable`

از runtimeExecutable با runtimeArgs برای راه‌اندازیِ یک dev server از طریقِ یک package manager استفاده کن. برای مثال، "runtimeExecutable": "npm" با "runtimeArgs": ["run", "dev"]، npm run dev را اجرا می‌کند.

از program وقتی استفاده کن که یک اسکریپتِ مستقل داری که می‌خواهی مستقیماً با node اجرایش کنی. برای مثال، "program": "server.js"، node server.js را اجرا می‌کند. پرچم‌های اضافی را با args پاس بده.

تعارض‌های پورت

فیلدِ autoPort کنترل می‌کند وقتی پورتِ موردِ علاقه‌ات از قبل در حالِ استفاده است چه اتفاقی بیفتد:

true: Claude به‌صورتِ خودکار یک پورتِ آزاد پیدا و استفاده می‌کند. برای بیشترِ dev serverها مناسب است.
false: Claude با یک خطا شکست می‌خورد. وقتی سرورت باید از یک پورتِ مشخص استفاده کند، مثلِ callbackهای OAuth یا allowlistهای CORS، از این استفاده کن.
تنظیم‌نشده (پیش‌فرض): Claude می‌پرسد آیا سرور به دقیقاً همان پورت نیاز دارد، سپس پاسخت را ذخیره می‌کند.

وقتی Claude یک پورتِ متفاوت انتخاب می‌کند، پورتِ اختصاص‌داده‌شده را از طریقِ متغیرِ محیطیِ PORT به سرورت پاس می‌دهد.

نمونه‌ها

این پیکربندی‌ها راه‌اندازی‌های رایج برای انواعِ مختلفِ پروژه را نشان می‌دهند:

این پیکربندی یک اپِ Next.js را با Yarn روی پورتِ 3000 اجرا می‌کند:

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "web",
      "runtimeExecutable": "yarn",
      "runtimeArgs": ["dev"],
      "port": 3000
    }
  ]
}

برای یک monorepo با یک frontend و یک API server، چند پیکربندی تعریف کن. frontend از autoPort: true استفاده می‌کند تا اگر 3000 گرفته شده باشد یک پورتِ آزاد انتخاب کند، در حالی که API server دقیقاً به پورتِ 8080 نیاز دارد:

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "frontend",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "cwd": "apps/web",
      "port": 3000,
      "autoPort": true
    },
    {
      "name": "api",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "start"],
      "cwd": "server",
      "port": 8080,
      "env": { "NODE_ENV": "development" },
      "autoPort": false
    }
  ]
}

برای اجرای مستقیمِ یک اسکریپتِ Node.js به‌جای استفاده از یک دستورِ package manager، از فیلدِ program استفاده کن:

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "server",
      "program": "server.js",
      "args": ["--verbose"],
      "port": 4000
    }
  ]
}

پیکربندیِ محیط

محیطی که هنگامِ شروعِ یک نشست انتخاب می‌کنی تعیین می‌کند Claude کجا اجرا شود و چطور وصل شوی:

Local: روی دستگاهت با دسترسیِ مستقیم به فایل‌هایت اجرا می‌شود
Remote: روی زیرساختِ ابریِ Anthropic اجرا می‌شود. نشست‌ها حتی اگر اپ را ببندی ادامه می‌یابند.
SSH: روی یک دستگاهِ راه‌دور که از طریقِ SSH به آن وصل می‌شوی اجرا می‌شود، مثلِ سرورهای خودت، VMهای ابری، یا dev containerها

نشست‌های محلی

اپِ دسکتاپ همیشه کلِ محیطِ شلت را به ارث نمی‌برد. روی macOS، وقتی اپ را از Dock یا Finder راه‌اندازی می‌کنی، پروفایلِ شلت، مثلِ ~/.zshrc یا ~/.bashrc، را می‌خواند تا PATH و یک مجموعه‌ی ثابت از متغیرهای Claude Code را استخراج کند، اما دیگر متغیرهایی که آن‌جا export می‌کنی برداشته نمی‌شوند. روی Windows، اپ متغیرهای محیطیِ کاربر و سیستم را به ارث می‌برد اما پروفایل‌های PowerShell را نمی‌خواند.

برای تنظیمِ متغیرهای محیطی برای نشست‌های محلی و dev serverها روی هر پلتفرمی، منوی کشویی محیط را در جعبه‌ی پرامپت باز کن، روی Local هاور کن، و روی آیکونِ چرخ‌دنده کلیک کن تا ویرایشگرِ محیطِ محلی باز شود. متغیرهایی که این‌جا ذخیره می‌کنی روی دستگاهت رمزگذاری‌شده ذخیره می‌شوند و روی هر نشستِ محلی و سرورِ پیش‌نمایشی که راه می‌اندازی اعمال می‌شوند. همچنین می‌توانی متغیرها را به کلیدِ env در فایلِ ~/.claude/settings.jsonات اضافه کنی، اگرچه این‌ها فقط به نشست‌های Claude می‌رسند و نه به dev serverها. برای فهرستِ کاملِ متغیرهای پشتیبانی‌شده، متغیرهای محیطی را ببین.

تفکرِ گسترده به‌صورتِ پیش‌فرض فعال است، که عملکرد را روی کارهای استدلالیِ پیچیده بهبود می‌دهد اما توکنِ اضافی مصرف می‌کند. برای غیرفعال‌کردنِ تفکر، MAX_THINKING_TOKENS را در ویرایشگرِ محیطِ محلی روی 0 تنظیم کن؛ این روی Fable 5 که همیشه از تفکرِ گسترده استفاده می‌کند اثری ندارد. روی ارائه‌دهنده‌های شخصِ‌ثالث، 0 به‌جایش پارامترِ thinking را حذف می‌کند، و مدل‌های با استدلالِ تطبیقی ممکن است همچنان فکر کنند. روی مدل‌های با استدلالِ تطبیقی، هر مقدارِ دیگرِ MAX_THINKING_TOKENS نادیده گرفته می‌شود چون استدلالِ تطبیقی به‌جایش عمقِ تفکر را کنترل می‌کند. روی Opus 4.6 و Sonnet 4.6، CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING را روی 1 تنظیم کن تا از یک بودجه‌ی ثابتِ تفکر استفاده کنی؛ Opus 4.7 و بالاتر همیشه از استدلالِ تطبیقی استفاده می‌کنند و حالتِ بودجه‌ی-ثابت ندارند.

نشست‌های ابری

نشست‌های ابری حتی اگر اپ را ببندی در پس‌زمینه ادامه می‌یابند. مصرف به‌سمتِ محدودیت‌های پلنِ اشتراکت حساب می‌شود بدونِ هزینه‌های جداگانه‌ی محاسبه.

می‌توانی محیط‌های ابریِ سفارشی با سطوحِ متفاوتِ دسترسیِ شبکه و متغیرهای محیطی بسازی. هنگامِ شروعِ یک نشستِ ابری منوی کشوییِ محیط را انتخاب کن و Add environment را انتخاب کن. برای جزئیاتِ پیکربندیِ دسترسیِ شبکه و متغیرهای محیطی، محیطِ ابری را ببین.

نشست‌های SSH

نشست‌های SSH به تو اجازه می‌دهند Claude Code را روی یک دستگاهِ راه‌دور اجرا کنی در حالی که از اپِ دسکتاپ به‌عنوانِ رابطت استفاده می‌کنی. این برای کارکردن با کدبیس‌هایی که روی VMهای ابری، dev containerها، یا سرورهایی با سخت‌افزار یا وابستگی‌های خاص زندگی می‌کنند مفید است.

برای افزودنِ یک اتصالِ SSH، پیش از شروعِ یک نشست روی منوی کشوییِ محیط کلیک کن و + Add SSH connection را انتخاب کن. دیالوگ این‌ها را می‌پرسد:

Name: یک برچسبِ دوستانه برای این اتصال
SSH Host: user@hostname یا یک هاستِ تعریف‌شده در ~/.ssh/config
SSH Port: اگر خالی بماند پیش‌فرض 22 است، یا از پورتِ تنظیماتِ SSHات استفاده می‌کند
Identity File: مسیرِ کلیدِ خصوصی‌ات، مثلِ ~/.ssh/id_rsa. خالی بگذار تا از کلیدِ پیش‌فرض یا تنظیماتِ SSHات استفاده شود.

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

دستگاهِ راه‌دور باید Linux یا macOS اجرا کند. Desktop اولین باری که وصل می‌شوی Claude Code را به‌صورتِ خودکار روی دستگاهِ راه‌دور نصب می‌کند. وقتی وصل شد، نشست‌های SSH از حالت‌های دسترسی، connectorها، پلاگین‌ها، و MCP serverها پشتیبانی می‌کنند.

اتصال‌های SSH را برای تیمت از پیش پیکربندی کن

ادمین‌ها می‌توانند اتصال‌های SSH را با افزودنِ sshConfigs به یک فایلِ تنظیماتِ مدیریت‌شده بینِ اعضای تیم توزیع کنند. اتصال‌هایی که این‌گونه تعریف می‌شوند به‌صورتِ خودکار در منوی کشوییِ محیطِ هر کاربر ظاهر می‌شوند و به‌صورتِ مدیریت‌شده نشان داده می‌شوند، پس کاربران می‌توانند انتخابشان کنند اما نمی‌توانند در اپ ویرایش یا حذفشان کنند.

نمونه‌ی زیر یک اتصالِ تکی را از پیش پیکربندی می‌کند که در ~/projects روی هاستِ راه‌دور باز می‌شود:

{
  "sshConfigs": [
    {
      "id": "shared-dev-vm",
      "name": "Shared Dev VM",
      "sshHost": "user@dev.example.com",
      "sshPort": 22,
      "sshIdentityFile": "~/.ssh/id_ed25519",
      "startDirectory": "~/projects"
    }
  ]
}

هر ورودی به id، name، و sshHost نیاز دارد. فیلدهای sshPort، sshIdentityFile، و startDirectory اختیاری‌اند. کاربران همچنین می‌توانند sshConfigs را به ~/.claude/settings.jsonِ خودشان اضافه کنند، جایی که اتصال‌های افزوده‌شده از طریقِ دیالوگ ذخیره می‌شوند.

محدود کن کاربران به کدام هاست‌های SSH می‌توانند وصل شوند

ادمین‌ها می‌توانند نشست‌های SSHِ Desktop را با افزودنِ sshHostAllowlist به یک فایلِ تنظیماتِ مدیریت‌شده به یک مجموعه‌ی تأییدشده از هاست‌ها محدود کنند. وقتی تنظیم شود، کاربران فقط می‌توانند به هاست‌هایی وصل شوند که hostnameِ resolveشده‌شان با یکی از الگوها بخواند. آن را روی یک آرایه‌ی خالی تنظیم کن تا نشست‌های SSH به‌کلی غیرفعال شوند.

نمونه‌ی زیر اتصال به هر هاستی زیرِ devboxes.example.com و به یک هاستِ bastionِ نام‌بُرده‌ی تکی را مجاز می‌کند:

{
  "sshHostAllowlist": ["*.devboxes.example.com", "bastion.example.com"]
}

الگوها به حروفِ کوچک و بزرگ حساس نیستند. * با هر هاستی می‌خواند، و *.example.com با example.com و هر زیردامنه‌ای می‌خواند. هر چیزِ دیگری یک تطبیقِ دقیق است. بررسی در برابرِ hostnameِ بعد از resolveِ ~/.ssh/config از طریقِ ssh -G اجرا می‌شود، پس aliasهای Host و ورودی‌های ProxyCommand/ProxyJump مجازند تا وقتی HostNameِ resolveشده بخواند.

sshHostAllowlist فقط از تنظیماتِ مدیریت‌شده خوانده می‌شود؛ مقادیر در تنظیماتِ کاربر یا پروژه نادیده گرفته می‌شوند. فقط اپِ Claude Desktop به این تنظیم احترام می‌گذارد؛ CLIِ Claude Code و افزونه‌های IDE آن را نمی‌خوانند، و دستورهای sshِ اجراشده از طریقِ ابزارِ Bash را محدود نمی‌کند. این تنظیم حاکم بر این است که اپِ Desktop به کدام هاست‌ها وصل می‌شود، نه خروجیِ شبکه، پس اگر به یک مرزِ سخت نیاز داری، آن را با کنترل‌های شبکه یا zero-trustِ سازمانت جفت کن.

پیکربندیِ سازمانی

سازمان‌های روی پلن‌های Team یا Enterprise می‌توانند رفتارِ اپِ دسکتاپ را از طریقِ کنترل‌های کنسولِ ادمین، فایل‌های تنظیماتِ مدیریت‌شده، و سیاست‌های مدیریتِ دستگاه مدیریت کنند.

کنترل‌های کنسولِ ادمین

این تنظیمات از طریقِ کنسولِ تنظیماتِ ادمین پیکربندی می‌شوند:

Code in the desktop: کنترل کن آیا کاربرانِ سازمانت می‌توانند به Claude Code در اپِ دسکتاپ دسترسی داشته باشند
Code in the web: نشست‌های وب را برای سازمانت فعال یا غیرفعال کن
Remote Control: Remote Control را برای سازمانت فعال یا غیرفعال کن
Disable Bypass permissions mode: از فعال‌کردنِ حالتِ bypass permissions توسطِ کاربرانِ سازمانت جلوگیری کن

تنظیماتِ مدیریت‌شده

تنظیماتِ مدیریت‌شده تنظیماتِ پروژه و کاربر را override می‌کنند و وقتی Desktop نشست‌های CLI را spawn می‌کند اعمال می‌شوند. می‌توانی این کلیدها را در فایلِ تنظیماتِ مدیریت‌شدهِ سازمانت تنظیم کنی یا از طریقِ کنسولِ ادمین به‌صورتِ راه‌دور پوششان دهی.

کلید	توضیح
`permissions.disableBypassPermissionsMode`	روی `"disable"` تنظیم کن تا از فعال‌کردنِ حالتِ Bypass permissions توسطِ کاربران جلوگیری شود.
`disableAutoMode`	روی `"disable"` تنظیم کن تا از فعال‌کردنِ حالتِ Auto توسطِ کاربران جلوگیری شود. Auto را از انتخاب‌گرِ حالت حذف می‌کند. زیرِ `permissions` هم پذیرفته می‌شود.
`autoMode`	سفارشی کن classifierِ حالتِ auto در سراسرِ سازمانت به چه چیزی اعتماد و چه چیزی را مسدود کند. پیکربندیِ حالتِ auto را ببین.
`sshConfigs`	اتصال‌های SSH را که در منوی کشوییِ محیط ظاهر می‌شوند از پیش پیکربندی کن. کاربران نمی‌توانند اتصال‌های مدیریت‌شده را ویرایش یا حذف کنند.
`sshHostAllowlist`	نشست‌های SSH را به هاست‌هایی محدود کن که hostnameِ resolveشده‌شان با یکی از این الگوها می‌خواند. یک آرایه‌ی خالی نشست‌های SSH را غیرفعال می‌کند. فقط از تنظیماتِ مدیریت‌شده خوانده می‌شود.
`managedMcpServers`	پیکربندی‌های MCP server را به همه‌ی کاربران در یک استقرارِ شخصِ‌ثالث پوش کن. هر ورودی یک transport از `"http"`، `"sse"`، یا `"stdio"`، جزئیاتِ اتصال، و اختیاراً یک نقشه‌ی `toolPolicy` مشخص می‌کند که محدود می‌کند کاربران کدام ابزارها در آن سرور را می‌توانند فراخوانی کنند. فقط در استقرارهای شخصِ‌ثالثِ (3P) Desktop در دسترس است.

یک فایلِ تنظیماتِ مدیریت‌شده که روی دیسکِ هر دستگاه مستقر شود روی نشست‌های Desktop اعمال می‌شود. تنظیماتِ مدیریت‌شده‌ای که از طریقِ کنسولِ ادمین به‌صورتِ راه‌دور پوش می‌شوند در حالِ حاضر فقط به نشست‌های CLI و IDE می‌رسند، پس برای استقرارهای Desktop یا فایل را از طریقِ MDM توزیع کن یا از کنترل‌های کنسولِ ادمینِ بالا استفاده کن.

permissions.disableBypassPermissionsMode و disableAutoMode در تنظیماتِ کاربر و پروژه هم کار می‌کنند، اما قراردادنشان در تنظیماتِ مدیریت‌شده از override‌کردنشان توسطِ کاربران جلوگیری می‌کند. autoMode از تنظیماتِ کاربر، .claude/settings.local.json، و تنظیماتِ مدیریت‌شده خوانده می‌شود، اما نه از .claude/settings.jsonِ کامیت‌شده: یک مخزنِ کلون‌شده نمی‌تواند قواعدِ classifierِ خودش را تزریق کند. برای فهرستِ کاملِ تنظیماتِ فقط-مدیریت‌شده شاملِ allowManagedPermissionRulesOnly و allowManagedHooksOnly، تنظیماتِ فقط-مدیریت‌شده را ببین.

سیاست‌های مدیریتِ دستگاه

تیم‌های IT می‌توانند اپِ دسکتاپ را از طریقِ MDM روی macOS یا group policy روی Windows مدیریت کنند. سیاست‌های در دسترس شاملِ فعال یا غیرفعال‌کردنِ قابلیتِ Claude Code، کنترلِ به‌روزرسانی‌های خودکار، و تنظیمِ یک URLِ استقرارِ سفارشی هستند.

macOS: از طریقِ دامنه‌ی preferenceِ com.anthropic.claudefordesktop با ابزارهایی مثلِ Jamf یا Kandji پیکربندی کن
Windows: از طریقِ registry در SOFTWARE\Policies\Claude پیکربندی کن

احراز هویت و SSO

سازمان‌های Enterprise می‌توانند SSO را برای همه‌ی کاربران الزامی کنند. برای جزئیاتِ سطحِ پلن احراز هویت و برای پیکربندیِ SAML و OIDC راه‌اندازیِ SSO را ببین.

مدیریتِ داده

Claude Code کدت را در نشست‌های محلی به‌صورتِ محلی یا در نشست‌های ابری روی زیرساختِ ابریِ Anthropic پردازش می‌کند. گفت‌وگوها و کانتکستِ کد برای پردازش به API‌ِ Anthropic فرستاده می‌شوند. برای جزئیاتِ نگه‌داریِ داده، حریمِ خصوصی، و انطباق، مدیریتِ داده را ببین.

استقرار

Desktop می‌تواند از طریقِ ابزارهای استقرارِ سازمانی توزیع شود:

macOS: از طریقِ MDM مثلِ Jamf یا Kandji با استفاده از نصب‌کننده‌ی .dmg توزیع کن
Windows: از طریقِ بسته‌ی MSIX یا نصب‌کننده‌ی .exe مستقر کن. برای گزینه‌های استقرارِ سازمانی شاملِ نصبِ خاموش، استقرارِ Claude Desktop برای Windows را ببین

برای پیکربندیِ شبکه مثلِ تنظیماتِ proxy، allowlistِ فایروال، و gatewayهای LLM، پیکربندیِ شبکه را ببین.

برای مرجعِ کاملِ پیکربندیِ سازمانی، راهنمای پیکربندیِ سازمانی را ببین.

از CLI می‌آیی؟

اگر از قبل از Claude Code CLI استفاده می‌کنی، Desktop همان موتورِ زیرین را با یک رابطِ گرافیکی اجرا می‌کند. می‌توانی هر دو را هم‌زمان روی یک دستگاه، حتی روی یک پروژه اجرا کنی. هرکدام تاریخچه‌ی نشستِ جداگانه نگه می‌دارند، اما پیکربندی و حافظه‌ی پروژه را از طریقِ فایل‌های CLAUDE.md به اشتراک می‌گذارند.

برای انتقالِ یک نشستِ CLI به Desktop، /desktop را در ترمینال اجرا کن. Claude نشستت را ذخیره می‌کند و در اپِ دسکتاپ بازش می‌کند، سپس از CLI خارج می‌شود. این دستور روی macOS و Windows وقتی با یک اشتراکِ Claude وارد شده‌ای در دسترس است. با احراز هویتِ API key یا روی Bedrock، Vertex، یا Foundry در دسترس نیست.

معادل‌های پرچم‌های CLI

این جدول معادلِ اپِ دسکتاپ را برای پرچم‌های رایجِ CLI نشان می‌دهد. پرچم‌هایی که فهرست نشده‌اند معادلِ دسکتاپ ندارند چون برای اسکریپت‌نویسی یا اتوماسیون طراحی شده‌اند.

CLI	معادلِ دسکتاپ
`--model sonnet`	منوی کشوییِ Model کنارِ دکمه‌ی ارسال
`--resume`, `--continue`	روی یک نشست در نوارِ کناری کلیک کن
`--permission-mode`	انتخاب‌گرِ حالت کنارِ دکمه‌ی ارسال
`--dangerously-skip-permissions`	حالتِ Bypass permissions. در Settings → Claude Code → «Allow bypass permissions mode» فعالش کن. ادمین‌های سازمانی می‌توانند این تنظیم را غیرفعال کنند.
`--add-dir`	با دکمه‌ی + در نشست‌های ابری چند مخزن اضافه کن
`--allowedTools`, `--disallowedTools`	معادلِ به‌ازای هر نشست ندارد. قواعدِ دسترسی در فایل‌های تنظیمات همچنان اعمال می‌شوند.
`--verbose`	حالتِ نمای Verbose در منوی کشوییِ Transcript view
`--print`, `--output-format`	در دسترس نیست. Desktop فقط تعاملی است.
متغیرِ محیطیِ `ANTHROPIC_MODEL`	منوی کشوییِ Model کنارِ دکمه‌ی ارسال
متغیرِ محیطیِ `MAX_THINKING_TOKENS`	در ویرایشگرِ محیطِ محلی تنظیم کن. پیکربندیِ محیط را ببین.

پیکربندیِ مشترک

Desktop و CLI همان فایل‌های پیکربندی را می‌خوانند، پس راه‌اندازی‌ات منتقل می‌شود:

فایل‌های CLAUDE.md و CLAUDE.local.md در پروژه‌ات توسطِ هر دو استفاده می‌شوند
**MCP serverها**ی پیکربندی‌شده در ~/.claude.json یا .mcp.json در هر دو کار می‌کنند
Hookها و **skillها**ی تعریف‌شده در تنظیمات روی هر دو اعمال می‌شوند
تنظیمات در ~/.claude.json و ~/.claude/settings.json به اشتراک گذاشته می‌شوند. قواعدِ دسترسی، ابزارهای مجاز، و دیگر تنظیمات در settings.json روی نشست‌های Desktop اعمال می‌شوند.
مدل‌ها: همان مدل‌ها در هر دو در دسترس‌اند. در Desktop، مدل را از منوی کشویی کنارِ دکمه‌ی ارسال انتخاب کن. می‌توانی مدل را در میانه‌ی نشست از همان منوی کشویی عوض کنی.

مقایسه‌ی قابلیت‌ها

این جدول قابلیت‌های اصلی را بینِ CLI و Desktop مقایسه می‌کند. برای فهرستِ کاملِ پرچم‌های CLI، مرجعِ CLI را ببین.

قابلیت	CLI	Desktop
حالت‌های دسترسی	همه‌ی حالت‌ها شاملِ `dontAsk`	Ask permissions، Auto accept edits، Plan mode، Auto، و Bypass permissions از طریقِ Settings
`--dangerously-skip-permissions`	پرچمِ CLI	حالتِ Bypass permissions. در Settings → Claude Code → «Allow bypass permissions mode» فعالش کن
ارائه‌دهنده‌های شخصِ‌ثالث	Bedrock، Vertex AI، Foundry	به‌صورتِ پیش‌فرض API‌ِ Anthropic. استقرارهای Enterprise می‌توانند Vertex AI و ارائه‌دهنده‌های gateway را پیکربندی کنند. راهنمای پیکربندیِ سازمانی را ببین. برای اجرای تبِ Code روی Bedrock، Vertex AI، Foundry، یا یک LLM gatewayِ self-hosted، Cowork روی 3P research preview را ببین.
MCP serverها	در فایل‌های تنظیمات پیکربندی کن	رابطِ کاربریِ Connectors برای نشست‌های محلی و SSH، یا فایل‌های تنظیمات
پلاگین‌ها	دستورِ `/plugin`	رابطِ کاربریِ مدیرِ پلاگین
@mentionِ فایل‌ها	متن‌محور	با تکمیلِ خودکار؛ فقط نشست‌های محلی و SSH
پیوست‌های فایل	در دسترس نیست	تصاویر، PDFها
ایزولاسیونِ نشست	پرچمِ `--worktree`	worktreeهای خودکار
چند نشست	ترمینال‌های جداگانه	تب‌های نوارِ کناری
کارهای تکرارشونده	jobهای cron، pipelineهای CI	کارهای زمان‌بندی‌شده
computer use	فعال‌سازی از طریقِ `/mcp` روی macOS	کنترلِ اپ و صفحه‌نمایش روی macOS و Windows
یکپارچه‌سازیِ Dispatch	در دسترس نیست	نشست‌های Dispatch در نوارِ کناری
اسکریپت‌نویسی و اتوماسیون	`--print`، Agent SDK	در دسترس نیست

چه چیزی در Desktop در دسترس نیست

قابلیت‌های زیر فقط در CLI یا افزونه‌ی VS Code در دسترس‌اند، مگر جایی که اشاره شده باشد:

ارائه‌دهنده‌های شخصِ‌ثالث: Desktop به‌صورتِ پیش‌فرض به API‌ِ Anthropic وصل می‌شود. استقرارهای Enterprise می‌توانند Vertex AI و ارائه‌دهنده‌های gateway را از طریقِ تنظیماتِ مدیریت‌شده پیکربندی کنند. برای Bedrock یا Foundry در CLI، شروعِ سریع را ببین. به‌عنوانِ استثنایی بر بخشِ بالا، Cowork روی 3P research preview تبِ Code را روی Bedrock، Vertex AI، Foundry، یا یک LLM gatewayِ self-hosted اجرا می‌کند.
Linux: اپِ دسکتاپ فقط روی macOS و Windows در دسترس است. روی Linux، از CLI استفاده کن.
پیشنهادهای کدِ درون‌خطی: Desktop پیشنهادهای سبکِ تکمیلِ خودکار ارائه نمی‌دهد. از طریقِ پرامپت‌های گفت‌وگویی و تغییراتِ کدِ صریح کار می‌کند.
تیم‌های ایجنت: نشست‌های موازیِ Claude Code که به هم پیام می‌دهند در CLI در دسترس‌اند، نه در Desktop. برای کارِ چند-ایجنتی درونِ یک نشست، از ورک‌فلوهای پویا استفاده کن، که در Desktop اجرا می‌شوند.
دستورهای دیالوگِ-ترمینال: دستورهای داخلی‌ای که یک پنلِ تعاملی در ترمینال باز می‌کنند، مثلِ /permissions، /config، /agents و /doctor، در تبِ Code در دسترس نیستند و با isn't available in this environment پاسخ می‌دهند. برای مدیریتِ قواعدِ دسترسی و پیکربندی، فایل‌های تنظیمات را مستقیماً ویرایش کن، یا دستور را از CLIِ مستقل اجرا کن.

عیب‌یابی

بخش‌های زیر مسائلِ خاصِ اپِ دسکتاپ را پوشش می‌دهند. برای خطاهای رانتایمِ API که در چت ظاهر می‌شوند مثلِ API Error: 500، 529 Overloaded، 429، یا Prompt is too long، مرجعِ خطا را ببین. آن خطاها و رفعشان در سراسرِ CLI، دسکتاپ، و وب یکسان‌اند.

نسخه‌ات را بررسی کن

برای دیدنِ اینکه کدام نسخه‌ی اپِ دسکتاپ را اجرا می‌کنی:

macOS: روی Claude در نوارِ منو کلیک کن، سپس About Claude
Windows: روی Help کلیک کن، سپس About

روی شماره‌ی نسخه کلیک کن تا در کلیپ‌بوردت کپی شود.

خطاهای 403 یا احراز هویت در تبِ Code

اگر هنگامِ استفاده از تبِ Code، Error 403: Forbidden یا دیگر شکست‌های احراز هویت دیدی:

از منوی اپ خارج شو و دوباره وارد شو. این رایج‌ترین رفع است.
تأیید کن که یک اشتراکِ پولیِ فعال داری: Pro، Max، Team، یا Enterprise.
اگر CLI کار می‌کند اما Desktop نه، اپِ دسکتاپ را به‌کلی ببند، نه فقط پنجره را، سپس دوباره بازش کن و دوباره وارد شو.
اتصالِ اینترنت و تنظیماتِ proxy‌ات را بررسی کن.

صفحه‌ی خالی یا گیرکرده هنگامِ راه‌اندازی

اگر اپ باز می‌شود اما یک صفحه‌ی خالی یا غیرپاسخگو نشان می‌دهد:

اپ را ری‌استارت کن.
به‌روزرسانی‌های در انتظار را بررسی کن. اپ هنگامِ راه‌اندازی خودکار به‌روز می‌شود.
روی Windows، Event Viewer را برای لاگ‌های crash زیرِ Windows Logs → Application بررسی کن.

«Failed to load session»

اگر Failed to load session دیدی، ممکن است پوشه‌ی انتخاب‌شده دیگر وجود نداشته باشد، ممکن است یک مخزنِ Git به Git LFSِ نصب‌نشده نیاز داشته باشد، یا ممکن است دسترسی‌های فایل مانعِ دسترسی شوند. سعی کن پوشه‌ی دیگری انتخاب کنی یا اپ را ری‌استارت کنی.

نشست ابزارهای نصب‌شده را پیدا نمی‌کند

اگر Claude نمی‌تواند ابزارهایی مثلِ npm، node، یا دیگر دستورهای CLI را پیدا کند، تأیید کن که ابزارها در ترمینالِ عادی‌ات کار می‌کنند، بررسی کن که پروفایلِ شلت PATH را درست راه‌اندازی می‌کند، و اپِ دسکتاپ را ری‌استارت کن تا متغیرهای محیطی دوباره بار شوند.

خطاهای Git و Git LFS

روی Windows، Git برای شروعِ نشست‌های محلیِ تبِ Code لازم است. اگر «Git is required» دیدی، Git for Windows را نصب کن و اپ را ری‌استارت کن.

اگر «Git LFS is required by this repository but is not installed» دیدی، Git LFS را از git-lfs.com نصب کن، git lfs install را اجرا کن، و اپ را ری‌استارت کن.

MCP serverها روی Windows کار نمی‌کنند

اگر تاگل‌های MCP server پاسخ نمی‌دهند یا سرورها روی Windows در اتصال شکست می‌خورند، بررسی کن که سرور در تنظیماتت درست پیکربندی شده، اپ را ری‌استارت کن، تأیید کن که فرایندِ سرور در Task Manager در حالِ اجراست، و لاگ‌های سرور را برای خطاهای اتصال مرور کن.

اپ بسته نمی‌شود

macOS: Cmd+Q را بزن. اگر اپ پاسخ نمی‌دهد، از Force Quit با Cmd+Option+Esc استفاده کن، Claude را انتخاب کن، و روی Force Quit کلیک کن.
Windows: از Task Manager با Ctrl+Shift+Esc استفاده کن تا فرایندِ Claude را پایان دهی.

مسائلِ خاصِ Windows

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

«Branch doesn’t exist yet» هنگامِ بازکردن در CLI

نشست‌های ابری می‌توانند شاخه‌هایی بسازند که روی دستگاهِ محلی‌ات وجود ندارند. روی نامِ شاخه در نوارِ ابزارِ نشست کلیک کن تا کپی شود، سپس آن را به‌صورتِ محلی fetch کن:

git fetch origin <branch-name>
git checkout <branch-name>

هنوز گیر کرده‌ای؟

روی GitHub Issues باگ را جست‌وجو کن یا ثبت کن
به مرکزِ پشتیبانیِ Claude برو

هنگامِ ثبتِ یک باگ، نسخه‌ی اپِ دسکتاپت، سیستم‌عاملت، پیامِ خطای دقیق، و لاگ‌های مرتبط را بگنجان. روی macOS، Console.app را بررسی کن. روی Windows، Event Viewer → Windows Logs → Application را بررسی کن.