شروع سریع

به Claude Code خوش آمدی!

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

پیش از شروع

مطمئن شو که این‌ها را داری:

یک ترمینال یا command prompt باز
- اگر تا حالا هرگز با ترمینال کار نکرده‌ای، راهنمای ترمینال را ببین
یک پروژه‌ی کد برای کار کردن
یک اشتراک Claude (Pro، Max، Team یا Enterprise)، یک حساب Claude Console، یا دسترسی از طریق یک ارائه‌دهنده‌ی ابریِ پشتیبانی‌شده

گام ۱: نصب Claude Code

برای نصب Claude Code، یکی از روش‌های زیر را به کار ببر:

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

اگر پیام The token '&&' is not a valid statement separator را دیدی، یعنی در PowerShell هستی نه CMD. اگر پیام 'irm' is not recognized as an internal or external command را دیدی، یعنی در CMD هستی نه PowerShell. وقتی در PowerShell باشی پرامپت PS C:\ را نشان می‌دهد و وقتی در CMD باشی C:\ را بدون PS.

Git for Windows روی ویندوزِ نِیتیو توصیه می‌شود تا Claude Code بتواند از ابزار Bash استفاده کند. اگر Git for Windows نصب نباشد، Claude Code به‌جایش از PowerShell به‌عنوان ابزار shell استفاده می‌کند. راه‌اندازی‌های WSL به Git for Windows نیاز ندارند.

brew install --cask claude-code

Homebrew دو cask ارائه می‌دهد. claude-code کانال انتشار پایدار را دنبال می‌کند که معمولاً حدود یک هفته عقب‌تر است و انتشارهای دارای regressionهای مهم را رد می‌کند. claude-code@latest کانال آخرین نسخه را دنبال می‌کند و به‌محض عرضه، نسخه‌های جدید را دریافت می‌کند.

winget install Anthropic.ClaudeCode

روی Debian، Fedora، RHEL و Alpine می‌توانی با apt، dnf یا apk هم نصب کنی.

گام ۲: ورود به حسابت

استفاده از Claude Code نیازمند یک حساب است. با دستور claude یک نشست تعاملی شروع کن؛ در اولین استفاده از تو خواسته می‌شود وارد شوی:

claude

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

/login

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

Claude Pro، Max، Team یا Enterprise (توصیه‌شده)
Claude Console (دسترسی API با اعتبارِ پیش‌پرداخت). در اولین ورود، یک workspace با نام «Claude Code» به‌صورت خودکار در Console ساخته می‌شود تا هزینه‌ها متمرکز پیگیری شوند.
Amazon Bedrock، Google Vertex AI یا Microsoft Foundry (ارائه‌دهندگان ابریِ سازمانی)

پس از ورود، اعتبارنامه‌هایت ذخیره می‌شوند و دیگر لازم نیست دوباره وارد شوی.

گام ۳: نخستین نشستت را شروع کن

ترمینالت را در هر پوشه‌ی پروژه‌ای باز کن و Claude Code را راه بینداز:

cd /path/to/your/project
claude

پرامپت Claude Code را می‌بینی که نسخه، مدلِ فعلی و پوشه‌ی کاری بالای آن نشان داده شده‌اند. برای دیدن دستورهای موجود /help و برای ادامه‌ی یک گفت‌وگوی قبلی /resume را تایپ کن.

گام ۴: نخستین سوالت را بپرس

بیا با شناختِ کدبیست شروع کنیم. یکی از این دستورها را امتحان کن:

what does this project do?

Claude فایل‌هایت را تحلیل می‌کند و یک خلاصه ارائه می‌دهد. می‌توانی سوال‌های مشخص‌تری هم بپرسی:

what technologies does this project use?

where is the main entry point?

explain the folder structure

می‌توانی درباره‌ی توانایی‌های خودِ Claude هم از او بپرسی:

what can Claude Code do?

how do I create custom skills in Claude Code?

can Claude Code work with Docker?

گام ۵: نخستین تغییرِ کدت را اعمال کن

حالا بیا کاری کنیم Claude Code کمی کدنویسیِ واقعی انجام دهد. یک کار ساده را امتحان کن:

add a hello world function to the main file

Claude Code این کارها را می‌کند:

فایل مناسب را پیدا می‌کند
تغییرات پیشنهادی را به تو نشان می‌دهد
تأیید تو را می‌خواهد
ویرایش را اعمال می‌کند

گام ۶: استفاده از Git با Claude Code

Claude Code عملیات Git را گفت‌وگومحور می‌کند:

what files have I changed?

commit my changes with a descriptive message

برای عملیات پیچیده‌ترِ Git هم می‌توانی پرامپت بدهی:

create a new branch called feature/quickstart

show me the last 5 commits

help me resolve merge conflicts

گام ۷: رفع یک باگ یا افزودن یک قابلیت

Claude در عیب‌یابی و پیاده‌سازی قابلیت‌ها چیره‌دست است.

آنچه می‌خواهی را به زبان طبیعی توصیف کن:

add input validation to the user registration form

یا ایرادهای موجود را رفع کن:

there's a bug where users can submit empty forms - fix it

Claude Code این کارها را می‌کند:

کدِ مرتبط را پیدا می‌کند
کانتکست را می‌فهمد
یک راه‌حل پیاده می‌کند
در صورت وجود، تست‌ها را اجرا می‌کند

گام ۸: ورک‌فلوهای رایجِ دیگر را امتحان کن

راه‌های زیادی برای کار کردن با Claude هست:

بازنویسیِ کد (Refactor)

refactor the authentication module to use async/await instead of callbacks

نوشتن تست

write unit tests for the calculator functions

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

update the README with installation instructions

بازبینیِ کد

review my changes and suggest improvements

دستورهای ضروری

این‌ها مهم‌ترین دستورها برای استفاده‌ی روزمره‌اند. دستورهای shell از ترمینالت اجرا می‌شوند تا Claude Code را شروع یا از سر بگیری. دستورهای نشست داخل Claude Code پس از شروعِ آن اجرا می‌شوند.

دستورهای shell

دستور	چه می‌کند	نمونه
`claude`	شروع حالت تعاملی	`claude`
`claude "task"`	اجرای یک کارِ یک‌باره	`claude "fix the build error"`
`claude -p "query"`	اجرای یک پرسشِ یک‌باره، سپس خروج	`claude -p "explain this function"`
`claude -c`	ادامه‌ی آخرین گفت‌وگو در پوشه‌ی فعلی	`claude -c`
`claude -r`	از سر گرفتنِ یک گفت‌وگوی قبلی	`claude -r`

دستورهای نشست

دستور	چه می‌کند	نمونه
`/clear`	پاک‌کردنِ تاریخچه‌ی گفت‌وگو	`/clear`
`/help`	نمایش دستورهای موجود	`/help`
`/exit` یا Ctrl+D	خروج از Claude Code	`/exit`

برای فهرست کاملِ دستورهای shell به مرجع CLI و برای فهرست کاملِ دستورهای نشست به مرجع دستورها مراجعه کن.

نکته‌های حرفه‌ای برای تازه‌کارها

برای بیشتر، بهترین شیوه‌ها و ورک‌فلوهای رایج را ببین.

در درخواست‌هایت دقیق باش

به‌جای: «باگ را درست کن»

این را امتحان کن: «باگِ ورود را درست کن که در آن کاربران پس از وارد کردن اطلاعات نادرست یک صفحه‌ی خالی می‌بینند»

از دستورالعمل‌های گام‌به‌گام استفاده کن

کارهای پیچیده را به گام‌ها بشکن:

1. create a new database table for user profiles
2. create an API endpoint to get and update user profiles
3. build a webpage that allows users to see and edit their information

بگذار Claude اول کاوش کند

پیش از اعمال تغییرات، بگذار Claude کدت را بفهمد:

analyze the database schema

build a dashboard showing products that are most frequently returned by our UK customers

با میان‌برها در زمان صرفه‌جویی کن

برای دیدن همه‌ی دستورها و skillها / را تایپ کن
برای تکمیلِ دستور از Tab استفاده کن
برای تاریخچه‌ی دستورها ↑ را بزن
برای چرخیدن میان حالت‌های دسترسی Shift+Tab را بزن

گامِ بعدی چیست؟

حالا که پایه‌ها را یاد گرفتی، قابلیت‌های پیشرفته‌تر را کاوش کن:

Claude Code چطور کار می‌کند

حلقه‌ی ایجنتیک، ابزارهای داخلی، و نحوه‌ی تعامل Claude Code با پروژه‌ات را بفهم

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

با پرامپت‌نویسیِ مؤثر و راه‌اندازیِ درستِ پروژه نتیجه‌ی بهتری بگیر

ورک‌فلوهای رایج

راهنماهای گام‌به‌گام برای کارهای رایج

گسترشِ Claude Code

با CLAUDE.md، skillها، hookها، MCP و موارد دیگر سفارشی‌سازی کن

گرفتنِ کمک

در Claude Code: /help را تایپ کن یا بپرس «چطور می‌توانم…»
مستندات: همین‌جایی! راهنماهای دیگر را مرور کن
انجمن: به Discord ما بپیوند برای نکته‌ها و پشتیبانی