مرورِ کلی Claude Code

Claude Code یک ابزار کدنویسی ایجنتیک است که کدبیس تو را می‌خواند، فایل‌ها را ویرایش می‌کند، دستورها را اجرا می‌کند و با ابزارهای توسعه‌ات یکپارچه می‌شود. در ترمینال، IDE، اپلیکیشن دسکتاپ و مرورگرت در دسترس است.

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

شروع کنیم

محیط خودت را برای شروع انتخاب کن. بیشتر سطح‌ها به یک اشتراک Claude یا حساب Anthropic Console نیاز دارند. ترمینالِ CLI و VS Code از ارائه‌دهنده‌های شخص‌ثالث هم پشتیبانی می‌کنند.

CLIِ کامل و پرامکانات برای کار با 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 به‌عنوان ابزار شل استفاده می‌کند. راه‌اندازی‌های WSL به Git for Windows نیاز ندارند.

brew install --cask claude-code

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

winget install Anthropic.ClaudeCode

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

سپس Claude Code را در هر پروژه‌ای اجرا کن:

cd your-project
claude

در اولین اجرا از تو خواسته می‌شود وارد شوی. همین! با شروعِ سریع ادامه بده ←

افزونه‌ی VS Code به‌صورت مستقیم در ویرایشگرت، diffهای درون‌خطی، @-mention، بازبینی پلن و تاریخچه‌ی گفت‌وگو را فراهم می‌کند.

یا در نمای Extensions عبارت “Claude Code” را جست‌وجو کن (Cmd+Shift+X در مک، Ctrl+Shift+X در ویندوز/لینوکس). بعد از نصب، Command Palette را باز کن (Cmd+Shift+P / Ctrl+Shift+P)، عبارت “Claude Code” را تایپ کن و Open in New Tab را انتخاب کن.

با VS Code شروع کن ←

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

اینجا چند نمونه از روش‌هایی که می‌توانی از Claude Code استفاده کنی آورده شده:

کارهایی که مدام عقب می‌اندازی را خودکار کن

Claude Code از پسِ کارهای کسل‌کننده‌ای که وقتت را می‌خورند برمی‌آید: نوشتن تست برای کدِ بدون تست، رفع خطاهای lint در سراسر یک پروژه، حل تعارض‌های merge، به‌روزرسانی وابستگی‌ها و نوشتن یادداشت‌های انتشار.

claude "write tests for the auth module, run them, and fix any failures"

قابلیت بساز و باگ رفع کن

چیزی که می‌خواهی را به زبان ساده توصیف کن. Claude Code رویکرد را برنامه‌ریزی می‌کند، کد را در چند فایل می‌نویسد و درست کار کردنش را تأیید می‌کند.

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

کامیت و pull request بساز

Claude Code مستقیماً با git کار می‌کند. تغییرات را stage می‌کند، پیام کامیت می‌نویسد، شاخه می‌سازد و pull request باز می‌کند.

claude "commit my changes with a descriptive message"

در CI می‌توانی بازبینی کد و triage مسائل را با GitHub Actions یا GitLab CI/CD خودکار کنی.

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

Model Context Protocol (MCP) یک استاندارد باز برای وصل کردن ابزارهای هوش مصنوعی به منابع داده‌ی بیرونی است. با MCP، Claude Code می‌تواند سندهای طراحی‌ات را در Google Drive بخواند، تیکت‌ها را در Jira به‌روزرسانی کند، داده را از Slack بکشد، یا از ابزارِ سفارشیِ خودت استفاده کند. شروعِ سریعِ MCP اولین سرور تو را سرتاسر وصل می‌کند.

با دستورالعمل‌ها، skills و hooks سفارشی‌سازی کن

CLAUDE.md یک فایل markdown است که به ریشه‌ی پروژه‌ات اضافه می‌کنی و Claude Code در ابتدای هر نشست آن را می‌خواند. از آن برای تعیین استانداردهای کدنویسی، تصمیم‌های معماری، کتابخانه‌های ترجیحی و چک‌لیست‌های بازبینی استفاده کن. Claude همچنین حین کار حافظه‌ی خودکار می‌سازد و آموخته‌هایی مثل دستورهای build و بینش‌های عیب‌یابی را در طول نشست‌ها ذخیره می‌کند، بی‌آنکه چیزی بنویسی.

برای بسته‌بندیِ ورک‌فلوهای تکرارشونده که تیمت می‌تواند به‌اشتراک بگذارد، skills بساز، مثل /review-pr یا /deploy-staging.

Hooks به تو اجازه می‌دهند دستورهای شل را پیش یا پس از اکشن‌های Claude Code اجرا کنی، مثل قالب‌بندیِ خودکار بعد از هر ویرایش فایل یا اجرای lint پیش از یک کامیت.

تیم‌های ایجنت را اجرا کن و ایجنت سفارشی بساز

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

برای اجرای چند نشستِ کامل به‌صورت موازی و تماشای آن‌ها از یک صفحه، از ایجنت‌های پس‌زمینه استفاده کن. برای ورک‌فلوهای کاملاً سفارشی، Agent SDK به تو اجازه می‌دهد ایجنت‌های خودت را با تکیه بر ابزارها و قابلیت‌های Claude Code بسازی، با کنترل کامل بر ارکستراسیون، دسترسی به ابزار و مجوزها.

با CLI پایپ کن، اسکریپت بنویس و خودکار کن

Claude Code ترکیب‌پذیر است و از فلسفه‌ی Unix پیروی می‌کند. لاگ‌ها را به آن پایپ کن، آن را در CI اجرا کن، یا با ابزارهای دیگر زنجیره‌اش کن:

# Analyze recent log output
tail -200 app.log | claude -p "Slack me if you see any anomalies"

# Automate translations in CI
claude -p "translate new strings into French and raise a PR for review"

# Bulk operations across files
git diff main --name-only | claude -p "review these changed files for security issues"

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

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

Claude را روی یک زمان‌بندی اجرا کن تا کارهای تکراری را خودکار کنی: بازبینی PR صبحگاهی، تحلیلِ شبانه‌ی خطاهای CI، حسابرسیِ هفتگیِ وابستگی‌ها، یا همگام‌سازیِ سندها بعد از merge شدنِ PRها.

Routines روی زیرساختِ مدیریت‌شده‌ی Anthropic اجرا می‌شوند، پس حتی وقتی کامپیوترت خاموش است به کار ادامه می‌دهند. همچنین می‌توانند با فراخوانیِ API یا رویدادهای GitHub فعال شوند. آن‌ها را از وب، اپلیکیشن دسکتاپ، یا با اجرای /schedule در CLI بساز.
کارهای زمان‌بندی‌شده‌ی دسکتاپ روی دستگاه خودت اجرا می‌شوند، با دسترسی مستقیم به فایل‌ها و ابزارهای محلی‌ات
/loop یک پرامپت را درون یک نشستِ CLI تکرار می‌کند، برای pollingِ سریع

از هر جایی کار کن

نشست‌ها به یک سطح واحد گره نخورده‌اند. همان‌طور که کانتکستت عوض می‌شود، کار را بین محیط‌ها جابه‌جا کن:

از پشت میزت دور شو و با Remote Control از گوشی یا هر مرورگری به کار ادامه بده
یک کار را از گوشی‌ات به Dispatch پیام بده و نشستِ دسکتاپی که می‌سازد را باز کن
یک کار طولانی را در وب یا اپلیکیشن iOS راه بینداز، سپس با claude --teleport آن را به ترمینالت بکش. Teleport به اشتراک claude.ai نیاز دارد.
یک نشستِ ترمینال را با /desktop به اپلیکیشن دسکتاپ تحویل بده تا diff را به‌صورت بصری بازبینی کنی
کارها را از چتِ تیمی مسیریابی کن: در Slack با یک گزارش باگ به @Claude mention بزن و یک pull request پس بگیر

از Claude Code همه‌جا استفاده کن

هر سطح به همان موتورِ زیرینِ Claude Code وصل می‌شود، پس فایل‌های CLAUDE.md، تنظیمات و سرورهای MCP تو در همه‌ی آن‌ها کار می‌کنند.

فراتر از محیط‌های ترمینال، VS Code، JetBrains، دسکتاپ و وب که بالاتر آمد، Claude Code با ورک‌فلوهای CI/CD، چت و مرورگر هم یکپارچه می‌شود:

می‌خواهم…	بهترین گزینه
یک نشست محلی را از گوشی یا دستگاه دیگرم ادامه دهم	Remote Control
رویدادها را از Telegram، Discord، iMessage یا webhookهای خودم به یک نشست بفرستم	Channels
یک کار را به‌صورت محلی شروع کنم و روی موبایل ادامه دهم	Web یا اپلیکیشن Claude iOS
Claude را روی یک زمان‌بندی دوره‌ای اجرا کنم	Routines یا کارهای زمان‌بندی‌شده‌ی دسکتاپ
بازبینی PR و triage مسائل را خودکار کنم	GitHub Actions یا GitLab CI/CD
روی هر PR بازبینی کدِ خودکار بگیرم	GitHub Code Review
گزارش‌های باگ را از Slack به pull request مسیریابی کنم	Slack
اپلیکیشن‌های وبِ زنده را دیباگ کنم	Chrome
برای ورک‌فلوهای خودم ایجنت سفارشی بسازم	Agent SDK

گام‌های بعدی

وقتی Claude Code را نصب کردی، این راهنماها کمکت می‌کنند عمیق‌تر شوی.

شروعِ سریع: اولین کار واقعی‌ات را قدم‌به‌قدم پیش ببر، از کاوش در یک کدبیس تا کامیت یک راه‌حل
ذخیره‌ی دستورالعمل‌ها و حافظه‌ها: با فایل‌های CLAUDE.md و حافظه‌ی خودکار به Claude دستورالعمل‌های ماندگار بده
ورک‌فلوهای رایج و بهترین شیوه‌ها: الگوهایی برای گرفتن بیشترین بهره از Claude Code
تنظیمات: Claude Code را برای ورک‌فلوی خودت سفارشی کن
عیب‌یابی: راه‌حل‌هایی برای مشکلات رایج
code.claude.com: دموها، هزینه و جزئیات محصول