یاد بگیرید. بسازید.

شروع برنامه‌نویسی با Claude Code؛ اولین تغییر در یک پروژه

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

تصویر مفهومی شروع برنامه‌نویسی با Claude Code؛ اولین تغییر در یک پروژه

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

برای اولین تجربه، پوشه‌ای کوچک با یک صفحه HTML و یک CSS کافی است. فایل محرمانه یا نسخه تنها و مهم کارتان را برای تمرین انتخاب نکنید. ابتدا خودتان پوشه و هدف صفحه را بشناسید؛ این شناخت کمک می‌کند تغییر ابزار را ارزیابی کنید.

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

نصب و ورود از راهنمای رسمی

راهنمای جاری Claude Code مسیر نصب بومی، Homebrew و WinGet را برای محیط‌های مختلف توضیح می‌دهد. دستور مناسب سیستم‌عامل خود را از همان صفحه بردارید. پس از نصب، با claude --version دسترسی فرمان را بررسی کنید و در پوشه پروژه، claude را اجرا کنید. ورود حساب در اولین جلسه انجام می‌شود.

اگر فرمان پیدا نشد، ممکن است مسیر نصب در PATH نباشد یا ترمینال نیاز به بازشدن دوباره داشته باشد. قبل از نصب چند نسخه مختلف، راهنمای رفع خطای همان نصب را بخوانید. اشتراک Claude و مصرف API روش صورتحساب یکسانی ندارند.

اول بخواند، بعد تغییر بدهد

درخواست اول را این‌طور محدود کنید: «ساختار پوشه را توضیح بده، فایل ورودی و روش اجرای پروژه را پیدا کن و فعلاً چیزی تغییر نده.» پس از بررسی پاسخ، یک کار کوچک مانند اضافه‌کردن label به فرم را بخواهید.

درخواست تغییر باید نتیجه قابل مشاهده داشته باشد. بگویید فرم با صفحه‌کلید قابل استفاده شود و ورودی نامعتبر پیام قابل فهم بگیرد. سپس تفاوت فایل‌ها و نتیجه آزمون را بخوانید. اگر ابزار کار دیگری پیشنهاد کرد، درباره ضرورت آن تصمیم بگیرید؛ هر پیشنهاد به معنی نیاز پروژه نیست.

brief.txttext
هدف: یک صفحه فارسی برای معرفی سه خدمت بساز.
مخاطب: صاحب کسب‌وکاری که با موبایل وارد سایت می‌شود.
محدوده: یک HTML و یک CSS، بدون وابستگی بیرونی.
پیش از تغییر: ساختار فایل‌ها و فرض‌ها را توضیح بده.
آزمون پذیرش:
- در عرض ۳۶۰ پیکسل اسکرول افقی نداشته باشد.
- فرم، برچسب قابل دسترسی داشته باشد.
- هر صفحه یک h1 روشن داشته باشد.
- خطاهای باقی‌مانده را صریح گزارش کن.
روش یادگیری: برای هر تصمیم، دلیل کوتاه و یک سؤال از من بپرس.

بازبینی، بخشی از یادگیری است

  • از ابزار بخواهید دلیل هر تغییر مهم را کوتاه توضیح دهد.
  • خودتان یک مسیر خطا و یک مسیر موفق را امتحان کنید.
  • تغییرهای نامرتبط را از کار اصلی جدا نگه دارید.
  • فرمان‌های نصب، حذف یا ارسال داده را قبل از اجرا بفهمید.

بعد از یک تغییر کوچک، خودتان همان کار را در یک فایل تازه تکرار کنید. اگر هنوز نمی‌دانید کدام خط رفتار را عوض کرده، از ابزار توضیح محدودتر بخواهید. هدف، وابستگی به جواب بعدی نیست؛ باید بتوانید بخشی از کار را مستقل انجام دهید.

انتخاب ابزار را با کار واقعی بسنجید

یک فرم یا تابع ثابت را با دو ابزار بررسی کنید و زمان رسیدن به نتیجه درست، میزان اصلاح و فهم توضیح را ثبت کنید. ممکن است انتخاب شما برای متن فارسی با انتخابتان برای اصلاح یک مخزن متفاوت باشد.