دستورهای نصب و پیشنیازها از مستندات رسمی برداشته شدهاند و در تاریخ زیر بررسی شدهاند. اینها هر چند ماه عوض میشوند. اگر دستوری کار نکرد، اول صفحهی رسمی نصب را ببین (لینکش پایین همین فصل است) — احتمالاً این متن عقب افتاده، نه تو.
آخرین بهروزرسانی: ۱۴۰۵/۰۵/۰۴
terminal چیست و چرا از آن نمیترسیم
terminal — که فارسیزبانها «ترمینال» تلفظش میکنند — یک پنجره است که در آن بهجای کلیککردن روی آیکونها، اسمِ کاری را که میخواهی تایپ میکنی و Enter میزنی. همین.
در کل این دوره شکل نوشتاریاش terminal میماند، چون همان چیزی است که روی سیستم خودت و در هر راهنمایی میبینی.
چیزی که ترسناکش میکند این نیست که سخت است — این است که خالی است. هیچ دکمهای نشانت نمیدهد چه کارهایی ممکن است. ولی همان خالیبودن قدرتش هم هست: کاری که در پنجرهها ده کلیک است، اینجا یک خط است.
و یک خبر خوب: اگر اصلاً نمیخواهی با terminal کار کنی، لازم نیست. یک اپ دسکتاپ هم هست که همان کار را با پنجرهی معمولی انجام میدهد. اگر آن را انتخاب کردی، این فصل را بخوان ولی نصبِ terminal را رد کن و به بخش ۰.۸.۶ برو.
کجا پیدایش کنی: در Mac اسمش Terminal است و در جستجوی Spotlight پیدا میشود. در Windows PowerShell یا Windows Terminal است و در منوی Start.
مسیر فایل و پوشهی جاری
این تنها مفهومی است که واقعاً باید بفهمی، و بدون آن بقیه گیجکننده میشود.
terminal همیشه داخل یک پوشه ایستاده. هر دستوری که میزنی، روی همان پوشه اثر میگذارد. اگر بگویی «فایلها را نشان بده»، فایلهای همان پوشه را نشان میدهد، نه همهی کامپیوتر.
پس قبل از هر کاری، سؤال اول همیشه این است: الان کجا ایستادهام؟
مسیر پوشهها با / از هم جدا میشود (در ویندوز
\). مثلاً /Users/ali/Documents
یعنی: پوشهی Users، داخلش ali، داخلش Documents.
پنج دستور که کافی است
برای کل این دوره، این پنج تا بس است:
pwd— «الان کجا ایستادهام؟» مسیر پوشهی جاری را میگوید. (در PowerShell هم کار میکند.)ls— «داخل این پوشه چه هست؟» فهرست فایلها را میدهد. (در PowerShell:dirهم کار میکند.)cd نام-پوشه— «برو داخل این پوشه.»cd ..— «یک پوشه برو بالا.» آن دو نقطه یعنی «پوشهی والد».mkdir نام— «یک پوشهی تازه بساز.»
دو ترفند که وقتت را نصف میکنند: کلید Tab اسم فایل یا پوشه را خودش کامل میکند (چند حرف اول را بزن و Tab) · کلید فلش بالا دستور قبلی را برمیگرداند.
نصب روی Mac
پیشنیاز: macOS 13.0 یا بالاتر و حداقل ۴ گیگابایت رم.
Terminal را باز کن و این یک خط را بزن:
curl -fsSL https://claude.ai/install.sh | bash
اگر Homebrew داری، این هم کار میکند:
brew install --cask claude-code
یک تفاوت که بعداً به دردت میخورد: نصبِ خط اول خودش بهروز میشود؛ نصب با Homebrew نه و باید دستی بهروزش کنی.
نصب روی Windows
پیشنیاز: Windows 10 نسخهی 1809 یا بالاتر و حداقل ۴ گیگابایت رم.
بهخاطر بسپار ویندوز به WSL نیاز ندارد. مستقیم روی خود ویندوز نصب میشود. اگر جایی خواندی که باید اول WSL نصب کنی، آن متن قدیمی است.
در PowerShell:
irm https://claude.ai/install.ps1 | iex
اگر از WinGet استفاده میکنی:
winget install Anthropic.ClaudeCode
یک نکته که وقتِ خیلیها را میگیرد: PowerShell و CMD دو چیز
متفاوتاند و دستورهایشان فرق دارد. از روی خطِ فرمان تشخیصشان بده — اگر
اولش PS دارد، در PowerShell هستی. اگر دستور
irm را نشناخت، یعنی در CMD هستی.
اولین اجرا و اطمینان از کارکرد
سه قدم، به همین ترتیب. هیچکدام را رد نکن.
۱. ثابت کن نصب شده:
claude --version
باید یک شمارهی نسخه چاپ کند. اگر گفت command not found،
یعنی نصب کامل نشده — نه اینکه تو کاری را اشتباه کردهای.
۲. سلامتِ نصب را چک کن:
claude doctor
این دستور بدون اینکه چیزی را اجرا کند، وضعیت نصب و تنظیمات را گزارش میدهد و اگر مشکلی هست میگوید. کارِ ایمنی است، خراب نمیکند.
۳. اجرا کن:
claude
بار اول از تو میخواهد وارد حسابت شوی و مرورگر را باز میکند. اینجاست که حسابِ فصل ۰.۷ به کار میآید — و اگر آنجا کارت را درست تمام کرده باشی، این قدم چند ثانیه است.
claude doctor را یادت بماند. هر وقت بعداً چیزی عجیب
شد، اول این را بزن. بیشترِ مشکلاتی که آدمها ساعتها دنبالشان میگردند، همین
دستور در دو ثانیه میگویدشان.
تمرین (ساختنی)
نصب کن، و مسیر پوشهی خودت را با یک دستور نشان بده.
بعد از نصب، terminal را باز کن و pwd بزن. مسیری که
چاپ میشود را یادداشت کن — همان جایی است که terminal ایستاده، و در فصل بعد
لازمش داری.
بعد یک پوشهی تازه بساز و برو داخلش:
mkdir test و بعد cd test.
دوباره pwd بزن و ببین مسیر عوض شد.
پاسخنامه — اگر جایی گیر کردی
command not found بعد از نصب:
معمولاً یعنی نصب تمام نشده یا terminal را باید ببندی و دوباره باز کنی.
اول terminal تازه امتحان کن.
دستور نصب خطا داد: مطمئن شو در PowerShell هستی نه CMD
(یا برعکس). خطِ فرمان اگر با PS شروع شود،
PowerShell است.
نصب شد ولی وارد حساب نمیشوی: این مشکل نصب نیست، مشکل حساب است — به فصل ۰.۷ برگرد، بخش ۰.۷.۵. حساب رایگان برای این کار کافی نیست.
اصلاً با terminal راحت نیستی: اپ دسکتاپ همان کار را با پنجرهی معمولی انجام میدهد. لینکش در صفحهی رسمی پایین هست.
برای عمق بیشتر
- Advanced setup — مستندات رسمی نصب (انگلیسی). خلاصهی فارسی: همهی دستورهای این فصل از همین صفحه برداشته شدهاند. پیشنیازها را هم همینجا میگوید (macOS 13+، ویندوز ۱۰ نسخهی 1809+، ۴ گیگ رم)، و اینکه حساب رایگان Claude.ai کافی نیست و پلن Pro یا بالاتر لازم است. اگر دستوری در این فصل کار نکرد، نسخهی بهروزش اینجاست. لینک دانلود اپ دسکتاپ — که terminal نمیخواهد — هم در همین صفحه است.