آموزش Claude Code از صفر: از اولین جلسه تا اولین commit | آکادمی برنامه‌نویسی بدیعی

آموزش Claude Code از صفر: از اولین جلسه تا اولین commit

میخواهید با Claude Code کار کنید، ولی نمیدانید از کجا شروع کنید؟ این مقاله اولین جلسه را قدم به قدم و

بدون ریسک جلو میبرد .

Claude Code فقط یک چتبات نیست. این ابزار فایلهای پروژه را میخواند. کد را تغییر میدهد. فرمان اجرا

میکند .

آن مهمتر از یاد گرفتن دکمه هاست. دکمه ها با هر نسخه عوض میشوند. اصول » کنترل « برای همین، یاد گرفتن

این مقاله عوض نمیشوند .

فهرست مطالب

1. Claude Code چه کاری میکند؟

2. پیشنیازها

3. اولین جلسه، قدم به قدم

4. پوشه درست را باز کنید

5. آشنایی با محیط کار

6. حالت دسترسی: مهمترین تنظیم

7. اولین ویژگی تا commit

8. اشتباههای رایج مبتدیها

9. گام بعدی

Claude Code چه کاری میکند؟

در چت بات معمولی، شما کد را کپی میکنید. آن را در پروژه میگذارید. اگر خطا داد، دوباره برای مدل

میفرستید .

در Claude Code این کارها را خود ابزار انجام میدهد. داخل پوشه پروژه کار میکند. کد مینویسد، اجرا

میکند و نتیجه را میبیند. اگر خطا باشد، خودش اصلاح میکند .

Claude Code سه شکل دارد :

• برنامه دسکتاپ

• ابزار خط فرمان (CLI)

• افزونه ویرایشگر

موتور هر سه یکی است. فقط محیط کار فرق میکند. برای شروع، نسخه دسکتاپ راحتتر است. گفت وگو،

ترمینال و تغییرات را یکجا میبینید .

پیش نیازها

قبل از شروع، این سه چیز را آماده کنید :

• یک اشتراک فعال Claude که Claude Code را پوشش بدهد

• Git نصب شده روی سیستم

• یک پوشه پروژه آزمایشی

پروژه آزمایشی مهم است. اولین تمرینها را روی پروژه اصلی تان انجام ندهید. اگر چیزی خراب شد، ضرر

نمیکنید .

اولین جلسه، قدم به قدم

گام 1 : نصب و ورود

برنامه را نصب کنید. با حساب خود وارد شوید. جزئیات نصب در هر نسخه کمی فرق میکند. اگر چیزی نخواند،

مستندات رسمی را ببینید .

گام 2 : انتخاب پوشه

بخش کدنویسی برنامه را باز کنید. پوشه اصلی پروژه آزمایشی را انتخاب کنید .

گام 3 : اولین درخواست

اولین درخواست باید فقط خواندنی باشد. یعنی چیزی را تغییر ندهد. این جمله مثال خوبی است :

فایل README را بخوان. در پنج خط بگو این پروژه چیست و چه ساختاری دارد. هیچ فایلی را تغییر نده .

با این درخواست بدون خطر میفهمید Claude پروژه را چطور میبیند .

پوشه درست را باز کنید

Claude Code فقط در پوشهای کار میکند که شما انتخاب میکنید. اگر پوشهای خیلی بزرگ را باز کنید، به

فایلهای نامربوط هم دسترسی پیدا میکند. مثلاً اگر کل درایو را باز کنید .

قاعده ساده است: کوچکترین پوشهای را باز کنید که کارتان در آن جا میشود .

تمرین اول: یک پوشه خالی بسازید. آن را در Claude Code باز کنید. بخواهید فایلی به نام hello.txt بسازد.

دقت کنید که قبل از ساختن فایل از شما اجازه میگیرد .

پایه امنیت است » اجازه گرفتن « همین .

آشنایی با محیط کار

محیط Claude Code چند بخش اصلی دارد :

• فهرست جلسات: جلسه های قبلی را نشان میدهد .

• پنل گفت وگو: درخواست ها و تأییدها اینجاست .

• ترمینال: میتوانید dotnet build و dotnet test را اجرا کنید .

. ویرایشگر: فایلها را میبینید و ویرایش میکنید .

• نمای Diff: نشان میدهد » قبل و بعد « تغییر هر فایل را .

• انتخاب مدل: مدل سبک برای کار روزمره، مدل قویتر برای کار سخت .

نکته مهم : Claude Code تغییرات را خودش در Git ثبت (commit) نمیکند. بازبینی و commit با شماست .

حالت دسترسی: مهمترین تنظیم

حالت دسترسی تعیین میکند Claude قبل از هر کار از شما بپرسد یا نه. سه حالت دارد :

• پرسیدن )پیش فرض(: قبل از هر تغییر یا فرمان تأیید میگیرد. برای شروع همین را بگذارید .

• خودکار: بیشتر کارها را خودش انجام میدهد. فقط در کارهای پرخطر میپرسد. وقتی کاملاً آشنا شدید .

• بدون پرسش: هیچ تأییدی نمیگیرد. فقط در محیط جدا مثل ماشین مجازی .

هنگام تأیید چه کنیم؟

قبل از تأیید، دو چیز را بدانید :

1. چه فرمانی اجرا میشود؟

2. چه فایلی تغییر میکند؟

فرمانی که تأیید میکنید با دسترسیهای خود شما اجرا میشود. اگر شما میتوانید پوشهای را پاک کنید، آن

فرمان هم میتواند .

را زود نزنید. اول الگو را بفهمید » همیشه قبول کن « گزینه .

اولین ویژگی تا commit

بهترین راه یادگیری این است که یک ویژگی کوچک را کامل بسازید. این شش گام را بروید :

1. شاخه (branch) جدا بسازید. مثلاً feature/booking-phone. اگر نتیجه بد شد، کل شاخه را دور

میریزید .

2. اول طرح، بعد کد. از Claude بخواهید قبل از نوشتن کد، طرح بدهد. کدام فایلها تغییر میکنند؟ چه

تستهایی لازم است؟

3. طرح را بخوانید و اصلاح کنید. ارزانترین زمان اصلاح همینجاست.

4. تأیید کنید. حالت پرسیدن را نگه دارید .

5. build و test را اجرا کنید. اگر خطا بود، خروجی را به Claude بدهید .

6. Diff را بخوانید و commit کنید. پیام commit باید معنادار باشد .

نمونه کامل این مسیر در مقاله ساخت یک ویژگی کامل با Claude Code آمده است .

اشتباههای رایج مبتدی ها

• باز کردن پوشهای خیلی بزرگ

• تأیید فرمان ها بدون خواندن

• قبول تغییرات فقط چون پیام Claude مطمئن بود

• کار مستقیم روی شاخه main

• ادامه دادن در گفت وگوی خیلی طولانی

برای کار تازه، جلسه تازه باز کنید. فهرست کاملتر در مقاله 7 اشتباه رایج در کار با Claude Code است .

گام بعدی

بعد از اولین جلسه، این سه موضوع را یاد بگیرید :

• فایل CLAUDE.md برای ثبت قاعدههای پروژه

• قاعده های allow و deny برای کنترل قطعی

• کار امن با Git

را میسازند » کار حرفهای با ابزار « و » استفاده از ابزار « این سه مورد فرق .

میخواهید این مهارت را پروژه محور و با مدرس یاد بگیرید؟ دوره هوش مصنوعی در برنامه نویسی آکادمی

برنامه نویسی بدیعی برای همین طراحی شده است. برای انتخاب مسیر هم میتوانید از مشاوره رایگان استفاده

کنید .

سوالات متداول

Claude Code با ChatGPT چه فرقی دارد؟

چت بات فقط متن میدهد. اجرای کار با شماست . Claude Code خودش فایل میخواند، کد را تغییر میدهد و

فرمان اجرا میکند. پس قدرت بیشتری دارد. به همین دلیل کنترل بیشتری هم لازم دارد .

برای شروع باید برنامه نویس حرفه ای باشم؟

نه. ولی باید مفاهیم پایه و Git را بدانید. چون باید تغییرات را بازبینی کنید. اگر مبتدی هستید، اول مفاهیم

را یاد بگیرید. بعد از عامل کمک بگیرید .

آیا Claude Code خودش commit میکند؟

نه. تغییرات خودکار ثبت نمیشوند . Claude میتواند پیام commit پیشنهاد بدهد. ثبت نهایی با شماست .

امنترین حالت برای شروع کدام است؟

حالت پرسیدن. این حالت پیش فرض است. قبل از هر تغییر یا فرمان از شما تأیید میگیرد .