منطق ایجنت‌ها › M0 — شروع
۰.۸ فرّار تدریسی ~۴۰ دقیقه

Terminal و نصب

قبل از این فصل: فصل ۰.۷

در یک نگاه

این فصل فرّار است

دستورهای نصب و پیش‌نیازها از مستندات رسمی برداشته شده‌اند و در تاریخ زیر بررسی شده‌اند. این‌ها هر چند ماه عوض می‌شوند. اگر دستوری کار نکرد، اول صفحه‌ی رسمی نصب را ببین (لینکش پایین همین فصل است) — احتمالاً این متن عقب افتاده، نه تو.

آخرین به‌روزرسانی: ۱۴۰۵/۰۵/۰۴

۰.۸.۱

terminal چیست و چرا از آن نمی‌ترسیم

terminal — که فارسی‌زبان‌ها «ترمینال» تلفظش می‌کنند — یک پنجره است که در آن به‌جای کلیک‌کردن روی آیکون‌ها، اسمِ کاری را که می‌خواهی تایپ می‌کنی و Enter می‌زنی. همین.

در کل این دوره شکل نوشتاری‌اش terminal می‌ماند، چون همان چیزی است که روی سیستم خودت و در هر راهنمایی می‌بینی.

چیزی که ترسناکش می‌کند این نیست که سخت است — این است که خالی است. هیچ دکمه‌ای نشانت نمی‌دهد چه کارهایی ممکن است. ولی همان خالی‌بودن قدرتش هم هست: کاری که در پنجره‌ها ده کلیک است، اینجا یک خط است.

و یک خبر خوب: اگر اصلاً نمی‌خواهی با terminal کار کنی، لازم نیست. یک اپ دسکتاپ هم هست که همان کار را با پنجره‌ی معمولی انجام می‌دهد. اگر آن را انتخاب کردی، این فصل را بخوان ولی نصبِ terminal را رد کن و به بخش ۰.۸.۶ برو.

کجا پیدایش کنی: در Mac اسمش Terminal است و در جستجوی Spotlight پیدا می‌شود. در Windows PowerShell یا Windows Terminal است و در منوی Start.

۰.۸.۲

مسیر فایل و پوشه‌ی جاری

این تنها مفهومی است که واقعاً باید بفهمی، و بدون آن بقیه گیج‌کننده می‌شود.

terminal همیشه داخل یک پوشه ایستاده. هر دستوری که می‌زنی، روی همان پوشه اثر می‌گذارد. اگر بگویی «فایل‌ها را نشان بده»، فایل‌های همان پوشه را نشان می‌دهد، نه همه‌ی کامپیوتر.

پس قبل از هر کاری، سؤال اول همیشه این است: الان کجا ایستاده‌ام؟

مسیر پوشه‌ها با / از هم جدا می‌شود (در ویندوز \). مثلاً /Users/ali/Documents یعنی: پوشه‌ی Users، داخلش ali، داخلش Documents.

۰.۸.۳

پنج دستور که کافی است

برای کل این دوره، این پنج تا بس است:

دو ترفند که وقتت را نصف می‌کنند: کلید 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 راحت نیستی: اپ دسکتاپ همان کار را با پنجره‌ی معمولی انجام می‌دهد. لینکش در صفحه‌ی رسمی پایین هست.

برای عمق بیشتر

ذخیره شد