دستیار کدنویسی داخل ویرایشگر شما خط بعدی را حدس میزند و بیشتر وقتها هم خوب حدس میزند. اما کار واقعی معمولاً یک خط نیست: باید یک باگ را در سه فایل دنبال کنید، علتش را پیدا کنید، اصلاحش کنید، تست بنویسید و مطمئن شوید جای دیگری نشکسته است. در این حالت تکمیل خودکار فقط سرعت تایپ شما را بالا میبرد — نه سرعت تمامشدن کار را.
ایجنت کدنویسی دقیقاً برای پر کردن همین فاصله ساخته شده است. در این راهنما میبینید ایجنت کدنویسی چیست، چه فرقی با دستیار کدنویسی دارد، در عمل چه کارهایی را برمیدارد، کجا شکست میخورد و برای شروع از داخل ایران چه گزینههایی روی میز دارید.
ایجنت کدنویسی چیست؟
پاسخ کوتاه: ایجنت کدنویسی یک مدل زبانی است که علاوه بر تولید متن، به ابزار هم دسترسی دارد — میتواند فایلهای پروژه را بخواند، آنها را تغییر دهد، دستور اجرا کند، خروجی دستور را ببیند و بر پایهٔ همان خروجی قدم بعدی را انتخاب کند. تفاوت بنیادی در همین حلقه است: دستیار یکبار پیشنهاد میدهد و کنار میرود؛ ایجنت تا رسیدن به نتیجه چند دور میچرخد.
سه چیز یک ایجنت را از یک مدل زبانی ساده جدا میکند:
- هدف بهجای دستور: ورودی شما «این خط را کامل کن» نیست؛ «این تست را سبز کن» یا «این تابع را به سه تابع کوچکتر بشکن» است.
- ابزار: دسترسی به فایلهای پروژه، ترمینال، جستوجو در مخزن و گاهی اتصال به سرویسهای بیرونی.
- حلقهٔ بازخورد: نتیجهٔ هر قدم — خطای کامپایلر، تست قرمز، خروجی لاگ — ورودی قدم بعدی میشود.
اگر این تفکیک برایتان تازه است، تفاوت مدل زبانی و ایجنت پایهٔ همین بحث را مفصلتر باز کرده و ایجنت هوش مصنوعی چیست تعریف کلیتر را به دست میدهد.
فرق ایجنت کدنویسی با دستیار کدنویسی در چیست؟
سادهترین راه تشخیص، پرسیدن یک سؤال است: «واحد کار چیست؟» دستیار روی یک خط یا یک تابع کار میکند و شما لحظهبهلحظه بالای سرش هستید. ایجنت روی یک تغییر کامل کار میکند و شما در پایان، مجموع تغییرات را بازبینی میکنید.
| معیار | دستیار کدنویسی | ایجنت کدنویسی |
|---|---|---|
| واحد کار | یک خط یا یک تابع | یک تغییر کامل روی چند فایل |
| ورودی شما | شروع کد یا توضیحی کوتاه | شرح نتیجهای که میخواهید |
| دسترسی | فایل باز در ویرایشگر | چند فایل، ترمینال و تستها |
| تعداد رفتوبرگشت | یکبار پیشنهاد | چند دور تا رسیدن به معیار |
| زمان بازبینی | همزمان و خطبهخط | در پایان و روی مجموع تغییرات |
| ریسک اصلی | پیشنهاد بیربط | تغییری گستردهتر از خواستهٔ شما |
| مناسب برای | سرعت نوشتن روزمره | کارهای چندمرحلهای و تکراری |
هیچکدام جای دیگری را نمیگیرد. بیشتر تیمهایی که هر دو را دارند، دستیار را برای نوشتن روزمره روشن نگه میدارند و ایجنت را برای کارهای بسته و مشخص صدا میزنند.

ایجنت کدنویسی در عمل چه کارهایی را برمیدارد؟
فهرست زیر عمداً محافظهکارانه است؛ اینها کارهاییاند که نتیجهشان قابل سنجش است:
- نوشتن تست برای کدی که از قبل نوشته شده و تست ندارد.
- یکدستسازی کدهای تکراری در چند فایل، وقتی الگوی تغییر روشن است.
- ارتقای نسخهٔ یک کتابخانه و اصلاح شکستگیهایی که کامپایلر یا تست نشان میدهد.
- تبدیل یک اسکریپت آزمایشی به کدی که قابل نگهداری باشد.
- خواندن یک مخزن ناآشنا و توضیح مسیر اجرای یک قابلیت، از ورودی تا خروجی.
- اصلاح باگهایی که مسیر بازتولیدشان مشخص است.
نکتهٔ مشترک همهٔ اینها یک چیز است: درست بودن جواب را میشود با یک دستور سنجید — تست سبز میشود یا نمیشود، پروژه ساخته میشود یا نمیشود. هر جا این معیار وجود نداشته باشد، ایجنت هم راهی ندارد که بفهمد کارش تمام شده است.
چطور کار را درست به ایجنت کدنویسی بسپاریم؟
بیشتر نتیجههای بد از پرامپت بد نمیآید؛ از صورتمسئلهٔ بد میآید. چهار قدم زیر بخش عمدهٔ مشکل را حل میکند:
- نتیجه را تعریف کنید، نه مسیر را. بهجای «این حلقه را جور دیگری بنویس»، بگویید «خروجی این تابع برای ورودی خالی باید آرایهٔ خالی باشد و تستهای فعلی هم نشکند».
- مرز تغییر را مشخص کنید. صریح بگویید کدام پوشهها اجازهٔ تغییر دارند. بدون مرز، ایجنت برای «بهتر کردن» سراغ فایلهایی میرود که اصلاً موضوع کار نبودهاند.
- راه سنجش بدهید. نام دستور تست یا بیلد را در خود درخواست بنویسید تا ایجنت بتواند کار خودش را بسنجد.
- خروجی را مثل کد یک همکار تازهوارد بازبینی کنید. نه با بیاعتمادی کامل، نه با اعتماد کامل.
یک نمونه از شکل درست صورتمسئله: «در پوشهٔ سرویسها، همهٔ فراخوانیهای مستقیم به لایهٔ پایگاه داده را به ریپازیتوری موجود منتقل کن. فقط همین پوشه تغییر کند. در پایان دستور تست را اجرا کن و تا سبز شدن ادامه بده.» این درخواست هم هدف دارد، هم مرز، هم معیار پایان.
اگر میخواهید درخواستهایتان را دقیقتر بنویسید، پرامپتنویسی فارسی برای ایجنتها همین الگو را برای کارهای غیرکدی هم باز کرده است.
قاعدهٔ طلایی: هر کاری که نتیجهاش را نمیتوانید با یک دستور بسنجید، هنوز آمادهٔ سپردن به ایجنت نیست.
ایجنت کدنویسی کجا شکست میخورد؟
پنهان کردن محدودیتها فقط انتظار را بالا میبرد و بعد اعتماد را خراب میکند. اینها جاهایی است که ایجنت — مستقل از اینکه کدام مدل پشتش باشد — ضعیف عمل میکند:
- تصمیمهای معماری: انتخاب بین دو طراحی به چیزهایی وابسته است که در کد نوشته نشدهاند؛ برنامهٔ محصول، اندازهٔ تیم و بدهی فنی موجود.
- قراردادهای نانوشته: وقتی یک فیلد به دلیلی تاریخی نباید تغییر کند و هیچجا مستند نشده، ایجنت راهی برای دانستنش ندارد.
- پروژههای بدون تست: بدون معیار، حلقهٔ بازخورد بسته نمیشود و ایجنت عملاً به یک دستیار پرحرف تبدیل میشود.
- کارهای با اثر برگشتناپذیر: مهاجرت دیتابیس روی دادهٔ واقعی و استقرار نسخهٔ نهایی باید پشت تأیید انسانی بماند.
- دادهٔ حساس: پیش از وصل کردن ایجنت به مخزن داخلی، روشن کنید چه چیزی از سازمان بیرون میرود؛ امنیت داده در هوش مصنوعی سازمانی همین مرزها را فهرست کرده است.

برای شروع از ایران چه گزینههایی دارید؟
دو مانع عملی پیش پای توسعهدهندهٔ ایرانی هست: دسترسی و پرداخت. سرویسهای خارجی معمولاً هر دو را سخت میکنند.
وکر برای همین حالت، Wokr Code را بهصورت اکستنشن VSCode عرضه میکند؛ با همان حساب کاربری و همان موجودی اعتباری که در وباپ، اپ ویندوز و افزونهٔ کروم استفاده میکنید — یعنی خرید جداگانهای لازم نیست. برای امتحان کردن هم کارت بانکی لازم نیست: پلن رایگان ۱٬۰۰۰ توکن در ساعت میدهد و پرداخت بهصورت ریالی و از طریق درگاه داخلی انجام میشود. اعتباری که میخرید تاریخ انقضا ندارد و اشتراک ماهانهٔ اجباری هم در کار نیست.
اگر میخواهید ایجنت به ابزارها و سرویسهای خودتان وصل شود، راهنمای MCP پروتکلی را توضیح میدهد که این اتصال را استاندارد میکند. برای نگاه کلیتر به نقش هوش مصنوعی در کار توسعه هم هوش مصنوعی برای برنامهنویسی نقطهٔ شروع بهتری است.
نسخههای دسکتاپ و افزونهها را میتوانید از صفحهٔ دانلود وکر بردارید.
پرسشهای پرتکرار
آیا ایجنت کدنویسی جای برنامهنویس را میگیرد؟
نه. چیزی که تغییر میکند نسبت زمان است: وقت کمتری صرف کارهای مکانیکی و وقت بیشتری صرف تعریف مسئله و بازبینی میشود. مسئولیت کدی که ادغام میشود همچنان با شماست و ایجنت این مسئولیت را برنمیدارد.
آیا ایجنت به کل پروژه دسترسی پیدا میکند؟
به همان اندازه که شما اجازه بدهید. در عمل بهتر است دامنهٔ کار را به پوشههای مرتبط محدود کنید؛ هم ریسک کمتر میشود و هم نتیجه دقیقتر، چون ایجنت در فایلهای بیربط گم نمیشود.
برای شروع چقدر باید هزینه کنم؟
برای امتحان کردن، هیچ. پلن رایگان ۱٬۰۰۰ توکن در ساعت میدهد و کارت بانکی نمیخواهد. اگر بعد به حجم بیشتری نیاز داشتید، اعتبار را ریالی میخرید و همان اعتبار بدون تاریخ انقضا باقی میماند. جزئیات بستهها در صفحهٔ قیمتها آمده است.
فرق ایجنت کدنویسی با چتباتهای عمومی چیست؟
چتبات عمومی کد را در پنجرهٔ گفتوگو مینویسد و شما باید آن را کپی کنید، در جای درست بگذارید و خودتان اجرا کنید. ایجنت کدنویسی داخل پروژه کار میکند: فایل را پیدا میکند، تغییر را اعمال میکند و نتیجهٔ اجرا را میبیند. همین «دیدن نتیجه» است که به او اجازه میدهد خودش را اصلاح کند.
جمعبندی
ایجنت کدنویسی جادو نیست؛ یک تغییر در واحد کار است. تا وقتی واحد کار شما «یک خط» باشد، دستیار کافی است. از لحظهای که واحد کار به «یک تغییر کامل با معیار مشخص» تبدیل میشود، ایجنت معنا پیدا میکند — و دقیقاً همانجا هم بیشترین ساعت را برمیگرداند.
از یک کار کوچک و برگشتپذیر شروع کنید: یک تابع بدون تست را انتخاب کنید و نوشتن تستش را بسپارید. اگر خروجی قابل اتکا بود، دامنه را بزرگتر کنید. برای امتحان کردن، اکستنشن VSCode وکر را از صفحهٔ دانلود نصب کنید و اولین کار را با همان پلن رایگان بسپارید.