خلاصه سریع: Claude Code دستیار کدنویسی مبتنی بر ترمینال Anthropic است که از طریق مدیران بسته مانند npm یا Homebrew نیاز به نصب دارد و پس از آن با کلید API Anthropic احراز هویت میشود. پس از راهاندازی، توسعهدهندگان میتوانند از دستورات زبان طبیعی برای اجرای وظایف کدنویسی، از اشکالزدایی و بازسازی کد گرفته تا گردش کار git و ویرایش چند فایلی استفاده کنند. این ابزار مستقیماً با پروژههای موجود ادغام میشود و از سفارشیسازی از طریق هوکها، افزونهها و فایلهای پیکربندی پشتیبانی میکند.
Claude Code یک ابزار کدنویسی عامل (agentic) است که توسط Anthropic ساخته شده و مستقیماً در ترمینال قرار دارد. این یک افزونه IDE یا رابط ابری نیست—این یک دستیار خط فرمان است که پایگاههای کد را درک میکند، وظایف معمول را اجرا میکند و همه چیز را از اشکالزدایی تا گردش کار git از طریق زبان طبیعی مدیریت میکند.
برخلاف دستیارهای کدنویسی سنتی، Claude Code به طور مستقل عمل میکند. این ابزار میتواند فایلها را بخواند، دستورات را اجرا کند و ویرایشهای چند فایلی را با حداقل دخالت انسان انجام دهد. کیفیت خروجی آن کاملاً به راهاندازی صحیح و مدیریت زمینه بستگی دارد.
این راهنما همه چیز را از نصب تا اولین گردش کار پوشش میدهد. بدون جزئیات اضافی، فقط مراحل عملی که واقعاً اهمیت دارند.
پیشنیازها و الزامات سیستمی
قبل از شروع فرآیند نصب، اطمینان حاصل کنید که سیستم الزامات اساسی را برآورده میکند. Claude Code بر روی macOS، Linux و Windows 10/11 از طریق WSL2 کار میکند.
آنچه مورد نیاز است:
- این الزام را حذف کنید یا به «Node.js ممکن است برای روشهای نصب خاص مورد نیاز باشد» تغییر دهید - منبع اصلی Node.js 18 را به عنوان الزام سیستم مشخص نمیکند
- Git نصب و پیکربندی شده
- دسترسی به ترمینال با مجوزهای شل
- اتصال اینترنت پایدار برای فراخوانی API
- یک حساب Anthropic با دسترسی API
برای کاربران ویندوز به طور خاص، Claude Code نمیتواند به صورت بومی روی ویندوز اجرا شود. این ابزار به Windows Subsystem for Linux 2 (WSL2) نیاز دارد تا یک محیط لینوکس ایجاد کند که Claude Code در آن به طور مؤثر عمل کند. برای نصب WSL2 به Windows 10 نسخه 1903 یا جدیدتر (Build 18362+) نیاز است.
کل اندازه دانلود در طول راهاندازی معمولاً کمتر از 1 گیگابایت است، از جمله WSL2 در ویندوز (تقریباً 500 مگابایت)، Node.js (حدود 30 مگابایت) و Claude Code با وابستگیها (حدود 50 مگابایت).
قبل از شروع، اعتبارنامه ابزار هوش مصنوعی را پیدا کنید
شروع کار با Claude Code اغلب به معنای انتخاب ابزارهای هوش مصنوعی دیگر در اطراف آن است. Get AI Perks با جمعآوری اعتبارنامههای راهاندازی و تخفیفهای نرمافزاری برای ابزارهای هوش مصنوعی و ابری در یک مکان به این امر کمک میکند. این پلتفرم شامل بیش از 200 امتیاز ویژه است، با پیشنهاداتی از Claude، Anthropic، OpenAI، Gemini، ElevenLabs، Intercom و دیگران، همراه با شرایط و مراحل ادعای آنها.
به دنبال اعتبارنامههای هوش مصنوعی قبل از درخواست هستید؟
برای موارد زیر، Get AI Perks را بررسی کنید:
- مشاهده پیشنهادات Claude و سایر ابزارهای هوش مصنوعی
- ببینید کدام امتیازات ویژه مناسب شرکت شما هستند
- دنبال کردن راهنماها برای دریافت اعتبارنامههای موجود
👉 برای مقایسه امتیازات نرمافزاری هوش مصنوعی موجود، به Get AI Perks مراجعه کنید.
نصب Claude Code
فرآیند نصب بسته به سیستم عامل کمی متفاوت است اما از الگوی کلی یکسانی پیروی میکند.
نصب بر روی macOS و Linux
برای کاربران macOS با نصب Homebrew، فرآیند ساده است:
| brew install –cask claude-code |
بدون Homebrew، از npm استفاده کنید:
| npm install -g @anthropic-ai/claude-code یا از روشهای نصب توصیه شده (curl یا brew) استفاده کنید |
کاربران لینوکس میتوانند از همین روش npm پیروی کنند. پرچم نصب سراسری (-g) تضمین میکند که Claude Code به صورت سیستمی و نه مختص پروژه در دسترس باشد.
نصب بر روی ویندوز از طریق WSL2
نصب ویندوز ابتدا به راهاندازی WSL2 نیاز دارد. PowerShell را به عنوان Administrator باز کنید و اجرا کنید:
| wsl –install |
این دستور WSL2 را به همراه اوبونتو به صورت پیشفرض نصب میکند. پس از اتمام نصب، سیستم را مجدداً راهاندازی کنید. پس از راهاندازی مجدد، اوبونتو به طور خودکار برای تکمیل راهاندازی با ایجاد نام کاربری و رمز عبور اجرا میشود.
در محیط لینوکس WSL2، Node.js را نصب کنید:
| curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash – sudo apt-get install -y nodejs |
سپس Claude Code را با استفاده از npm همانطور که در بالا نشان داده شد، نصب کنید.
نصب را با اجرای دستور زیر تأیید کنید:
| claude –version |
دستور باید شماره نسخه فعلی را برگرداند. اگر اینطور نبود، ممکن است مسیر نصب در متغیر PATH سیستم نباشد.
احراز هویت و راهاندازی حساب
Claude Code قبل از اینکه بتواند کار کند، به احراز هویت با کلید API Anthropic نیاز دارد.
دریافت کلید API
به کنسول Anthropic در console.anthropic.com بروید و یک حساب کاربری ایجاد کنید یا وارد شوید. در بخش API، یک کلید API جدید ایجاد کنید. بلافاصله این کلید را کپی کنید—پس از خروج از صفحه، دیگر نمایش داده نخواهد شد.
دسترسی به API بر اساس استفاده (pay-per-use) عمل میکند. طبق مستندات رسمی، قیمتگذاری بر اساس مدل توکن و نرخهای مختلف برای مدلهای مختلف Claude است. به همان صورت نگه دارید — در مواد منبع رسمی تأیید شده که «حداقل خرید: 5 دلار» و «توصیه شده: 20-30 دلار برای تست و پروژههای اولیه» ذکر شده است.
اتصال Claude Code به API
برای اولین بار Claude Code را در هر پوشه پروژه اجرا کنید:
| claude |
این ابزار برای احراز هویت درخواست میکند. یک پنجره مرورگر برای ورود باز میکند یا URL را برای چسباندن دستی ارائه میدهد. پس از احراز هویت از طریق مرورگر، Claude Code مجوز را دریافت کرده و اعتبارنامهها را به صورت محلی ذخیره میکند.
فرآیند احراز هویت فایلهای پیکربندی را در دایرکتوری اصلی ایجاد میکند. این فایلها بین جلسات باقی میمانند، بنابراین احراز هویت فقط یک بار انجام میشود مگر اینکه اعتبارنامهها به صورت دستی باطل شوند.
برای تأیید اینکه همه چیز به درستی کار میکند، اجرا کنید:
| claude doctor |
این دستور تشخیصی مشکلات رایج پیکربندی، اتصال API و مشکلات مجوز را بررسی میکند.
اجرای اولین جلسه Claude Code
پس از اتمام احراز هویت، Claude Code برای کار واقعی آماده است.
شروع حالت تعاملی
به هر پوشه پروژه بروید و اجرا کنید:
| claude |
این کار حالت تعاملی را راهاندازی میکند—یک جلسه پایدار که در آن Claude Code زمینه را در بین دستورات متعدد و ویرایش فایلها حفظ میکند. ترمینال یک اعلان نشان میدهد که Claude Code فعال است و منتظر دستورات است.
الگوهای دستور پایه
Claude Code سه قالب دستور اصلی را میپذیرد:
| قالب دستور | هدف | مثال |
|---|---|---|
| claude | شروع جلسه تعاملی | claude |
| claude “وظیفه” | اجرای یک وظیفه یکباره و خروج | claude “رفع خطای ساخت” |
| claude -p “پرس و جو” | پرسیدن سوال بدون انجام تغییرات | claude -p “این تابع را توضیح بده” |
حالت تعاملی برای گردش کارهای پیچیده شامل چندین مرحله بیشترین کاربرد را دارد. وظایف یکباره برای رفع سریع یا اسکریپتهای خودکار خوب هستند. حالت پرس و جو (پرچم -p) اطلاعات را بدون تغییر فایل ارائه میدهد.
انجام اولین تغییر کد
در حالت تعاملی، یک وظیفه ساده را امتحان کنید:
| مدیریت خطا را به تابع اصلی در app.js اضافه کنید |
Claude Code فایل را تجزیه و تحلیل میکند، تابع اصلی را شناسایی میکند و تغییراتی با بلوکهای try-catch مناسب یا منطق بررسی خطا پیشنهاد میدهد. قبل از اعمال تغییرات، پیشنمایش diff را نشان میدهد.
این ابزار قبل از تغییر فایلها، تأیید را درخواست میکند. تغییرات پیشنهادی را به دقت بررسی کنید. با تایپ "yes" تأیید کنید یا با "no" رد کنید تا درخواست اصلاحات شود.
گردش کارهای اساسی و وظایف رایج
Claude Code طیف گستردهای از گردش کارهای توسعه را فراتر از ویرایشهای پایه کد مدیریت میکند.
یکپارچهسازی Git
Claude Code گردش کار git را به صورت بومی درک میکند. دستوراتی مانند اینها به طور طبیعی کار میکنند:
- «ایجاد یک شاخه جدید برای ویژگی ورود»
- «این تغییرات را با یک پیام توصیفی commit کنید»
- «به من نشان بده چه چیزی از آخرین commit تغییر کرده است»
- «شاخه ویژگی را ادغام کن و تداخلها را حل کن»
این ابزار میتواند تاریخچه git را بخواند، ساختار شاخهها را درک کند و پیامهای commit مناسب را بر اساس تغییرات کد ایجاد کند.
اشکالزدایی و عیبیابی
هنگامی که اشکالات ظاهر میشوند، Claude Code میتواند آنها را بررسی کرده و رفع اشکال پیشنهاد دهد:
- «اشکالزدایی کن چرا فراخوانی API ناموفق است»
- «منبع این استثنای اشارهگر تهی را پیدا کن»
- «چرا این تابع مقدار مورد انتظار را برنمیگرداند؟»
Claude Code پیامهای خطا را بررسی میکند، مسیرهای اجرا را ردیابی میکند و فایلهای مرتبط را برای شناسایی علل ریشهای بررسی میکند.
بازسازی کد (Refactoring)
بازسازی در مقیاس بزرگ با آگاهی از چندین فایل قابل مدیریت میشود:
- «این منطق را به یک ماژول ابزار جداگانه استخراج کن»
- «این کلاس را بازسازی کن تا به جای وراثت از ترکیب استفاده کند»
- «پس از جابجایی این فایل، تمام importها را بهروز کن»
این ابزار وابستگیها را در سراسر فایلها ردیابی کرده و ارجاعات را به طور خودکار بهروز میکند.
پشتیبانی از تست
Claude Code میتواند تستها را تولید کند، مجموعههای تست را اجرا کند و شکستها را تفسیر کند:
- «تستهای واحد برای ماژول احراز هویت بنویس»
- «مجموعه تست را اجرا کن و هرگونه شکست را توضیح بده»
- «تستهای موارد مرزی را برای تابع اعتبارسنجی اضافه کن»
تولید تست از قراردادهای پروژه و الگوهای چارچوب تست در حال استفاده پیروی میکند.
مدیریت زمینه و پیکربندی
اثربخشی Claude Code به شدت به زمینه ارائه شده در مورد پروژه بستگی دارد.
استاندارد AGENTS.md
مؤثرترین راه برای ارائه زمینه پایدار از طریق فایل AGENTS.md در ریشه پروژه است. این فایل به عنوان یک استاندارد جهانی برای آموزش عاملان کدنویسی هوش مصنوعی در مورد ساختار پروژه، قراردادها و الزامات عمل میکند.
یک AGENTS.md پایه ممکن است شامل موارد زیر باشد:
- مرور کلی و معماری پروژه
- قراردادهای کدنویسی و ترجیحات سبک
- الزامات و الگوهای تست
- فرآیندهای ساخت و استقرار
- ساختار سازماندهی فایل
Claude Code به طور خودکار محتوای AGENTS.md را هنگام شروع جلسات در آن دایرکتوری میخواند و ادغام میکند.
هوکها برای اتوماسیون
هوکها اجازه اجرای خودکار دستورات شل را هنگام وقوع رویدادهای خاص میدهند. طبق مستندات رسمی، Claude Code از رویدادهای هوک متعدد از جمله SessionStart، UserPromptSubmit، PreToolUse، PostToolUse و Notification پشتیبانی میکند.
هوکها در یک فایل JSON پیکربندی میشوند که مشخص میکند کدام دستورات برای کدام رویدادها اجرا میشوند. به عنوان مثال، یک هوک PostToolUse ممکن است پس از اینکه Claude Code فایلها را ویرایش کرد، به طور خودکار تستها را اجرا کند، یا کد را مطابق با استانداردهای پروژه قالببندی کند.
زمان پیشفرض برای هوکها 10 دقیقه است، اگرچه این مقدار برای هر هوک قابل تنظیم است. هوکها میتوانند به صورت همزمان (Claude Code را تا اتمام مسدود میکنند) یا ناهمزمان (در پسزمینه اجرا میشوند) اجرا شوند.
قوانین Cursor و فرمتهای جایگزین
برای پروژههایی که از Cursor یا سایر ابزارهای کدنویسی هوش مصنوعی در کنار Claude Code استفاده میکنند، فرمت فایل .cursorrules جایگزینی برای AGENTS.md است. در حالی که AGENTS.md استاندارد جهانی است، قوانین Cursor یکپارچگی عمیقتری با ویژگیهای خاص Cursor ارائه میدهند.
پروژهها میتوانند هر دو فایل را نگهداری کنند. Claude Code به AGENTS.md اولویت میدهد اما در صورت وجود، سایر فرمتهای پیکربندی را نیز رعایت میکند.
نکات عملی برای استفاده مؤثر
استفاده در دنیای واقعی الگوهایی را آشکار میکند که اثربخشی Claude Code را به طور قابل توجهی بهبود میبخشد.
با دستورالعملها مشخص باشید
دستورات مبهم، نتایج مبهمی تولید میکنند. به جای «این کد را بهبود ببخش»، مشخص کنید که بهبود به چه معناست: «این تابع را برای کاهش پیچیدگی چرخهای بازسازی کن» یا «این کوئری پایگاه داده را برای کاهش زمان اجرا بهینه کن.»
به طور آزاد از زمینه پروژه استفاده کنید
هنگام دادن دستورالعمل، به فایلها، توابع یا الگوهای خاص ارجاع دهید. Claude Code زمینههایی مانند «پیروی از الگو در UserController» یا «مطابقت با سبک کنترلکنندههای API موجود ما» را درک میکند.
قبل از پذیرش تغییرات را بررسی کنید
Claude Code قدرتمند است اما بینقص نیست. همیشه تغییرات پیشنهادی را در پیشنمایش diff بررسی کنید. به خصوص در عملیات بازسازی که چندین فایل را لمس میکنند، به دنبال اثرات جانبی ناخواسته باشید.
از شبکههای ایمنی Git استفاده کنید
کد کاری را قبل از عملیات بزرگ Claude Code commit کنید. اگر تغییرات اشتباه پیش رفت، git یک مسیر بازگشت آسان را فراهم میکند. این شبکه ایمنی، آزمایش با وظایف جسورانهتر را تشویق میکند.
جلسات را با اهداف مشخص شروع کنید
شروع جلسه با اهداف صریح به Claude Code کمک میکند تا تمرکز خود را حفظ کند. «ما در حال افزودن احراز هویت کاربر هستیم» یا «ما در حال اشکالزدایی جریان پردازش پرداخت هستیم» زمینهای را برای دستورات بعدی ایجاد میکند.
مسائل رایج و عیبیابی
علیرغم راهاندازی صحیح، گهگاه مشکلاتی پیش میآید.
خطاهای مجوز
هرگز Claude Code را با sudo یا مجوزهای بالا اجرا نکنید. این کار آسیبپذیریهای امنیتی و مشکلات مالکیت فایل ایجاد میکند. در صورت بروز خطاهای مجوز، مجوزهای فایل را در دایرکتوری پروژه بررسی کنید و مطمئن شوید که کاربر فعلی دسترسی مناسبی دارد.
مشکلات اتصال API
خرابیهای اتصال معمولاً نشاندهنده مشکلات شبکه یا اعتبارنامههای API نامعتبر است. اعتبار کلید API را از طریق کنسول Anthropic تأیید کنید. بررسی کنید که فایروالها یا VPNها درخواستهای API را مسدود نمیکنند.
رفتار غیرمنتظره در Windows WSL2
مسائل مربوط به مسیرها معمولاً هنگام ترکیب مسیرهای ویندوز و لینوکس در WSL2 رخ میدهند. پروژهها را در داخل سیستم فایل لینوکس (/home/username/) نگه دارید به جای دسترسی به درایوهای ویندوز (/mnt/c/). این کار عملکرد را بهبود میبخشد و از مشکلات ترجمه مسیر جلوگیری میکند.
از دست دادن زمینه در طول جلسات طولانی
جلسات طولانی ممکن است به محدودیتهای زمینه برخورد کنند و باعث شوند Claude Code موارد قبلی مکالمه را فراموش کند. هنگامی که این اتفاق میافتد، یک جلسه جدید را شروع کنید یا یادآوریهای صریح در مورد اهداف پروژه و تغییرات اخیر ارائه دهید.
ویژگیهای پیشرفتهای که ارزش کاوش را دارند
پس از تسلط بر مبانی، چندین ویژگی پیشرفته قابلیتهای اضافی را باز میکنند.
دستورات سفارشی
پروژهها میتوانند دستورات سفارشی را در دایرکتوری .claude/commands تعریف کنند. این دستورات Claude Code را با گردش کارهای خاص پروژه گسترش میدهند، مانند «@deploy.md staging» یا «@benchmark.md performance.»
دستورات با استفاده از نحو ویژه برای آرگومانها و تزریق زمینه، در markdown نوشته میشوند. مهارت توسعه دستورات در افزونههای رسمی Claude Code، قالبها و نمونههایی را ارائه میدهد.
تیمهای عامل (Agent Teams)
برای عملیات پیچیده، Claude Code میتواند چندین عامل تخصصی را که با هم کار میکنند هماهنگ کند. یک عامل ممکن است تغییرات backend را مدیریت کند در حالی که عامل دیگر کامپوننتهای frontend را بهروز میکند و عامل سوم مهاجرت پایگاه داده را مدیریت میکند.
تیمهای عامل نیاز به پیکربندی دارند اما امکان کار موازی بر روی ویژگیهای بزرگ یا پروژههای بازسازی را فراهم میکنند.
سوالات متداول
آیا Claude Code آفلاین کار میکند؟
خیر، Claude Code برای ارتباط با API Anthropic به اتصال اینترنت فعال نیاز دارد. تمام پردازش در سمت سرور انجام میشود، نه محلی. این ابزار بدون دسترسی به API نمیتواند کار کند.
استفاده از Claude Code چقدر هزینه دارد؟
Claude Code بر اساس مدل پرداخت به ازای استفاده از توکن عمل میکند. قیمتگذاری بسته به مدل متفاوت است—به همان صورت نگه دارید — در مواد منبع رسمی که این سطوح قیمتگذاری دقیق را فهرست میکنند، تأیید شده است. هزینههای واقعی به الگوهای استفاده و مدل انتخاب شده بستگی دارد. حداقل موجودی حساب 5 دلار است.
آیا Claude Code میتواند به طور تصادفی پایگاه کد من را خراب کند؟
Claude Code قبل از انجام تغییرات فایل، تأیید را درخواست میکند. در ترکیب با کنترل نسخه git، خطر حداقل است. همیشه کد کاری را قبل از عملیات عمده commit کنید و تغییرات را قبل از پذیرش در پیشنمایش diff بررسی کنید.
آیا Claude Code با تمام زبانهای برنامهنویسی کار میکند؟
Claude Code تقریباً با تمام زبانهای برنامهنویسی اصلی از جمله JavaScript، Python، TypeScript، Java، Go، Rust، C++ و بسیاری دیگر پشتیبانی میکند. پشتیبانی از زبان به مدل Claude زیربنایی و دادههای آموزشی آن بستگی دارد که شامل دادههای کد گسترده در زبانهای مختلف است.
آیا چندین توسعهدهنده میتوانند همزمان از Claude Code روی یک پروژه استفاده کنند؟
بله، اما هماهنگی از طریق git ضروری است. هر توسعهدهنده جلسه Claude Code خود را با کلید API خود اجرا میکند. تغییرات باید مانند کدنویسی دستی از طریق git commit و همگامسازی شوند. Claude Code هیچ ویژگی همکاری داخلی فراتر از گردش کار استاندارد git ندارد.
تفاوت Claude Code و GitHub Copilot چیست؟
GitHub Copilot در ویرایشگرهای کد ادغام میشود و هنگام تایپ، پیشنهادات درون خطی را ارائه میدهد. Claude Code در ترمینال عمل میکند و در وظایف چند فایلی اقدام مستقل انجام میدهد. Copilot برای تکمیل خط به خط بهتر است؛ Claude Code در اجرای گردش کارهای کامل مانند بازسازی، اشکالزدایی یا پیادهسازی ویژگیها در چندین فایل عالی است.
چگونه Claude Code را به آخرین نسخه بهروزرسانی کنم؟
برای نصبهای npm (در صورت استفاده)، از طریق npm بهروزرسانی کنید یا از روشهای نصب توصیه شده استفاده کنید. برای نصبهای Homebrew، اجرا کنید: brew upgrade claude-code. همیشه نسخه فعلی را با claude --version بررسی کنید.
حرکت رو به جلو با Claude Code
شروع کار با Claude Code شامل نصب ساده، احراز هویت و یادگیری الگوهای دستور پایه است. قدرت واقعی این ابزار از طریق استفاده مداوم و مدیریت زمینه مناسب آشکار میشود.
با کارهای ساده شروع کنید—رفع اشکالات، بهروزرسانی مستندات، یا بازسازی تک فایلی. با افزایش راحتی، گردش کارهای جاهطلبانهتری مانند پیادهسازی ویژگیها یا تغییرات معماری را انجام دهید. منحنی یادگیری ملایم است زیرا دستورات زبان طبیعی، حفظ کردن سینتکس را کاهش میدهند.
فایلهای AGENTS.md را برای پروژههایی که به طور مکرر استفاده میشوند پیکربندی کنید. این سرمایهگذاری با درک بهبود یافته Claude Code و پیشنهادات مرتبطتر، بازدهی دارد.
مهمتر از همه، Claude Code را به عنوان یک ابزار همکاری در نظر بگیرید نه جایگزینی برای قضاوت توسعهدهنده. پیشنهادات آن را به طور انتقادی بررسی کنید، دستورالعملهای واضح ارائه دهید و شبکههای ایمنی git را حفظ کنید. در صورت استفاده صحیح، Claude Code توسعه را بدون قربانی کردن کیفیت کد تسریع میبخشد.
آمادهاید گردش کار ترمینال خود را متحول کنید؟ امروز Claude Code را نصب کنید و توسعه با کمک هوش مصنوعی را تجربه کنید که واقعاً با نحوه کار توسعهدهندگان ادغام میشود. برای مطالب مرجع دقیق و گزینههای پیکربندی پیشرفته به مستندات رسمی در docs.anthropic.com مراجعه کنید.
