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

شروع با اپِ دسکتاپ

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

دانلود برای macOS

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

دانلود برای Windows

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

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

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

اپِ دسکتاپ سه تب دارد:

  • Chat: گفت‌وگوی عمومی بدونِ دسترسی به فایل، شبیه به claude.ai.
  • Cowork: یک ایجنتِ پس‌زمینه‌ی خودمختار که روی کارها در یک VMِ ابری با محیطِ خودش کار می‌کند. می‌تواند مستقل اجرا شود در حالی که تو کارِ دیگری می‌کنی.
  • Code: یک دستیارِ کدنویسیِ تعاملی با دسترسیِ مستقیم به فایل‌های محلی‌ات. هر تغییر را در لحظه مرور و تأیید می‌کنی.

Chat و Cowork در مقاله‌های پشتیبانیِ Claude Desktop پوشش داده شده‌اند. این صفحه روی تبِ Code تمرکز دارد.

نصب

Section titled “نصب”

نصب و ورود

نصب‌کننده‌ی پلتفرمت را از لینک‌های بالا دانلود و اجرا کن. Claude را از پوشه‌ی Applications روی macOS یا منوی Start روی Windows راه‌اندازی کن، سپس با حسابِ Anthropicت وارد شو.

بازکردنِ تبِ Code

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

اپِ دسکتاپ شاملِ Claude Code است. لازم نیست Node.js یا CLI را جداگانه نصب کنی. برای استفاده از claude از ترمینال، CLI را جداگانه نصب کن. شروع با CLI را ببین.

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

Section titled “اولین نشستت را شروع کن”

با تبِ Codeِ باز، یک پروژه انتخاب کن و کاری به Claude بسپار.

انتخابِ یک محیط و پوشه

Local را انتخاب کن تا Claude روی دستگاهت با فایل‌هایت به‌صورتِ مستقیم اجرا شود. روی Select folder کلیک کن و دایرکتوریِ پروژه‌ات را انتخاب کن.

همچنین می‌توانی این‌ها را انتخاب کنی:

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

انتخابِ یک مدل

یک مدل را از منوی کشویی کنارِ دکمه‌ی ارسال انتخاب کن. برای مقایسه‌ی مدل‌های در دسترس، مدل‌ها را ببین. می‌توانی بعداً از همان منوی کشویی مدل را عوض کنی.

به Claude بگو چه کند

آنچه می‌خواهی Claude انجام دهد را تایپ کن:

  • Find a TODO comment and fix it
  • Add tests for the main function
  • Create a CLAUDE.md with instructions for this codebase

یک نشست گفت‌وگویی با Claude درباره‌ی کدِ توست. هر نشست کانتکست و تغییراتِ خودش را ردیابی می‌کند، پس می‌توانی روی چند کار کار کنی بدونِ اینکه با هم تداخل کنند.

مرور و پذیرشِ تغییرات

به‌صورتِ پیش‌فرض، تبِ Code در حالتِ Ask permissions شروع می‌شود، جایی که Claude تغییرات را پیشنهاد می‌دهد و پیش از اعمالشان منتظرِ تأییدِ تو می‌ماند. این‌ها را خواهی دید:

  1. یک نمای diff که دقیقاً نشان می‌دهد در هر فایل چه چیزی تغییر خواهد کرد
  2. دکمه‌های Accept/Reject برای تأیید یا ردِ هر تغییر
  3. به‌روزرسانی‌های لحظه‌ای همین‌طور که Claude روی درخواستت کار می‌کند

اگر تغییری را رد کنی، Claude می‌پرسد دوست داری چطور به‌گونه‌ای متفاوت پیش برود. فایل‌هایت تا وقتی نپذیری تغییر نمی‌کنند.

حالا چه؟

Section titled “حالا چه؟”

اولین ویرایشت را انجام دادی. برای مرجعِ کاملِ هر کاری که Desktop می‌تواند انجام دهد، استفاده از Claude Code Desktop را ببین. این‌جا چند چیز برای امتحانِ بعدی هست.

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

به Claude کانتکستِ بیشتری بده. @filename را در جعبه‌ی پرامپت تایپ کن تا یک فایلِ مشخص را به گفت‌وگو بکشی، با دکمه‌ی پیوست تصاویر و PDFها را پیوست کن، یا فایل‌ها را مستقیماً در پرامپت بکش‌ورها کن. هرچه Claude کانتکستِ بیشتری داشته باشد، نتیجه بهتر است. افزودنِ فایل‌ها و کانتکست را ببین.

برای کارهای تکرارشونده از skillها استفاده کن. / را تایپ کن یا روی + ← Slash commands کلیک کن تا دستورهای داخلی، skillهای سفارشی و skillهای پلاگین را مرور کنی. Skillها پرامپت‌های قابلِ‌استفاده‌ی مجددی هستند که هر وقت لازم داری فراخوانیشان می‌کنی، مثلِ چک‌لیست‌های code review یا مراحلِ استقرار.

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

تنظیم کن چقدر کنترل داشته باشی. حالتِ دسترسیِ تو این تعادل را کنترل می‌کند. Ask permissions (پیش‌فرض) پیش از هر ویرایش تأیید می‌خواهد. Auto accept edits ویرایش‌های فایل را برای تکرارِ سریع‌تر به‌صورتِ خودکار می‌پذیرد. Plan mode به Claude اجازه می‌دهد یک رویکرد را بدونِ دست‌زدن به هیچ فایلی ترسیم کند، که پیش از یک refactorِ بزرگ مفید است.

برای قابلیت‌های بیشتر پلاگین اضافه کن. روی دکمه‌ی + کنارِ جعبه‌ی پرامپت کلیک کن و Plugins را انتخاب کن تا پلاگین‌هایی را که skill، ایجنت، MCP server و بیشتر اضافه می‌کنند مرور و نصب کنی.

فضای کارت را بچین. پنل‌های چت، diff، ترمینال، فایل و پیش‌نمایش را به هر چیدمانی که می‌خواهی بکش. ترمینال را با Ctrl+` باز کن تا دستورها را در کنارِ نشستت اجرا کنی، یا روی مسیرِ یک فایل کلیک کن تا در پنلِ فایل باز شود. فضای کارت را بچین را ببین.

اپت را پیش‌نمایش کن. روی منوی کشویی Preview کلیک کن تا dev serverت را مستقیماً در دسکتاپ اجرا کنی. Claude می‌تواند اپِ در حالِ اجرا را ببیند، endpointها را تست کند، لاگ‌ها را بررسی کند، و روی چیزی که می‌بیند تکرار کند. اپت را پیش‌نمایش کن را ببین.

pull requestت را ردیابی کن. بعد از بازکردنِ یک PR، Claude Code نتایجِ checkهای CI را مانیتور می‌کند و می‌تواند به‌صورتِ خودکار شکست‌ها را برطرف کند یا وقتی همه‌ی checkها پاس شدند PR را ادغام کند. مانیتورِ وضعیتِ pull request را ببین.

Claude را روی یک زمان‌بندی بگذار. کارهای زمان‌بندی‌شده راه بینداز تا Claude به‌صورتِ خودکار و تکرارشونده اجرا شود: یک code reviewِ روزانه هر صبح، یک ممیزیِ هفتگیِ وابستگی‌ها، یا یک بریفینگ که از ابزارهای متصلت داده می‌کشد.

هر وقت آماده بودی مقیاسش بده. نشست‌های موازی را از نوارِ کناری باز کن تا روی چند کار هم‌زمان کار کنی، هرکدام در worktree گیتِ خودش، و پنلِ tasks را باز کن تا ساب‌ایجنت‌ها و دستورهای پس‌زمینه‌ای را که یک نشست در حالِ اجرا دارد ببینی. یک چتِ جانبی باز کن تا سؤالی بپرسی بدونِ اینکه رشته‌ی اصلی را منحرف کنی. کارهای طولانی را به ابر بفرست تا حتی اگر اپ را ببندی ادامه یابند، یا اگر کاری بیشتر از انتظار طول کشید نشست را روی وب یا در IDEات ادامه بده. ابزارهای بیرونی مثلِ GitHub، Slack و Linear را وصل کن تا ورک‌فلوت را کنارِ هم بیاوری.

از CLI می‌آیی؟

Section titled “از CLI می‌آیی؟”

Desktop همان موتورِ CLI را با یک رابطِ گرافیکی اجرا می‌کند. می‌توانی هر دو را هم‌زمان روی یک پروژه اجرا کنی، و آن‌ها پیکربندی را به اشتراک می‌گذارند (فایل‌های CLAUDE.md، MCP serverها، hookها، skillها و تنظیمات). برای مقایسه‌ی کاملِ قابلیت‌ها، معادلِ پرچم‌ها، و آنچه در Desktop در دسترس نیست، مقایسه با CLI را ببین.

بعد چه؟

Section titled “بعد چه؟”