پشتیبانی Claude Code 2.1.277 از فایل AGENTS.md چگونه کار میکند؟
در آپدیت Claude Code 2.1.277، ابزار میتواند دستورهای پروژه را مستقیماً از فایل AGENTS.md بخواند. این قابلیت به تیمها اجازه میدهد قواعد مشترک کار با عاملهای هوش مصنوعی را بدون ایجاد فایل اختصاصی جدید حفظ کنند.
- اگر
CLAUDE.mdوجود نداشته باشد، Claude Code به سراغAGENTS.mdمیرود. - در صورت وجود
CLAUDE.md، همان فایل همچنان مبنای دستورهای پروژه است. - پشتیبانی مذکور در زمان نگارش برای Bedrock، Vertex و Foundry فعال نشده است.
کارکرد این ویژگی ساده است: هنگام بازکردن پروژه، ابزار کدنویسی Claude ابتدا وجود CLAUDE.md را بررسی میکند. اگر آن را پیدا نکند، محتوای AGENTS.md بهعنوان راهنمای پروژه بارگذاری میشود؛ بنابراین مهاجرت تیمهایی که قبلاً از استاندارد AGENTS.md استفاده میکردند، آسانتر خواهد بود.
برای مثال، میتوانید در این فایل سبک نامگذاری متغیرها، فرمان اجرای تست، ساختار پوشهها و محدودیت ویرایش فایلها را مشخص کنید. Claude Code سپس هنگام تحلیل یا تغییر کد، این دستورها را در تصمیمگیری خود لحاظ میکند؛ هرچند خروجی همچنان باید توسط توسعهدهنده بازبینی شود.
برای اطمینان از بارگذاری منبع درست، بخش Project instructions در فرمان /config را بررسی کنید. اگر با عملکرد کلی این دستیار آشنا نیستید، راهنمای Claude Code چیست؟ پیشزمینه مناسبی درباره کاربرد آن در توسعه و نگهداری کد ارائه میدهد.
تنظیم دستورهای پروژه با AGENTS.md و منوی Project Instructions
در آپدیت Claude Code 2.1.277 میتوانید قواعد پروژه را در فایل AGENTS.md ثبت کنید تا دستیار هنگام کدنویسی آنها را در نظر بگیرد. اگر پروژه فایل CLAUDE.md نداشته باشد، ابزار بهصورت جایگزین AGENTS.md را میخواند.
- فایل
AGENTS.mdرا در مسیر اصلی مخزن پروژه قرار دهید. - استانداردهای کدنویسی، فرمانهای تست و محدودیتهای ویرایش را کوتاه و شفاف بنویسید.
- منبع دستورها را از بخش
Project Instructionsدر فرمان/configبررسی یا تغییر دهید.
برای نمونه، میتوانید مشخص کنید کدها با TypeScript نوشته شوند، پیش از تحویل تستها اجرا شوند و فایلهای محیطی و کلیدهای API تغییر نکنند. دستورهای دقیق و قابلاندازهگیری، احتمال تفسیر اشتباه توسط ابزار کدنویسی Claude را کاهش میدهند.
اگر هر دو فایل وجود داشته باشند، طبق رفتار اعلامشده برای این نسخه، AGENTS.md جایگزین خودکار CLAUDE.md نیست؛ قابلیت جدید مشخصاً برای پروژههای فاقد CLAUDE.md ارائه شده است. بنابراین پس از ارتقا، منبع فعال را در منوی Project Instructions کنترل کنید.
این قابلیت در زمان نگارش هنوز برای اجرای Claude Code روی Bedrock، Vertex و Foundry ارائه نشده است. برای آشنایی بیشتر با ساختار این دستیار، راهنمای Claude Code چیست را بخوانید؛ همچنین میتوانید پیشنویس دستورهای پروژه را در GapGPT آماده و سپس بازبینی کنید.
رفع توقف نشست و خروج ناخواسته در ابزار کدنویسی Claude
آپدیت Claude Code 2.1.277 چند اختلال مهم در اجرای نشستها را برطرف میکند. تمرکز این اصلاحات بر پایان صحیح فرایندها، نمایش شفاف خطا و جلوگیری از خروج ناخواسته حساب کاربری است.
- نشستهای
claude -pو Agent SDK پس از خطای داخلی دیگر بدون نتیجه متوقف نمیشوند. - خطا اکنون گزارش میشود و فرایند با کد خروج
1پایان مییابد. - اجرای نسخه قدیمی Claude Code در افزونه IDE دیگر نباید کاربر نسخه فعلی را خارج کند.
پیشتر ممکن بود یک خطای داخلی، اجرای غیرتعاملی یا نشست Agent SDK را در حالت انتظار نگه دارد. در نسخه 2.1.277، ابزار بهجای توقف نامشخص، علت شکست را اعلام میکند؛ تغییری کاربردی برای اسکریپتهای خودکار و پایپلاینهای CI/CD که به کد خروج وابستهاند.
مشکل دیگری به مکالماتی مربوط بود که در یکی از پاسخهای قبلی، بلوک متنی خالی کنار محتوای دیگر داشتند. چنین وضعیتی میتوانست تمام درخواستهای بعدی، حتی پس از استفاده از --resume، را با خطا مواجه کند؛ این رفتار نیز اصلاح شده است.
برای جلوگیری از تداخل نسخهها، CLI اصلی و افزونه IDE را همزمان بهروزرسانی و سپس یک نشست آزمایشی اجرا کنید. اگر همچنان توقف مشاهده میشود، خروجی خطا و کد پایان فرایند را ثبت کنید. برای مقایسه روند اصلاحات نیز گزارش آپدیت Claude Code 2.1.274 مفید است.
نصب مطمئنتر افزونهها و مهمترین اصلاحات Claude Code
آپدیت Claude Code 2.1.277 فرایند نصب مجدد افزونهها را ایمنتر میکند و احتمال آسیبدیدن نسخه نصبشده را کاهش میدهد. این نسخه همچنین چند مشکل مهم در نشستها، احراز هویت و بهروزرسانی ابزار کدنویسی Claude را برطرف کرده است.
- حفظ نسخه سالم افزونه هنگام ناموفقبودن نصب مجدد
- رفع توقف نشستهای
claude -pو Agent SDK پس از خطای داخلی - کاهش خروج ناخواسته و خطاهای مرتبط با پروکسی و بهروزرسانی
پیشتر، نصب دوباره افزونهای که همزمان توسط یک نشست یا برنامه دیگر استفاده میشد، گاهی شکست میخورد و نسخه نصبشده را نیز خراب میکرد. در نسخه 2.1.277، اگر جایگزینی کامل نشود، کپی قبلی بدون تغییر باقی میماند؛ بنابراین بازگشت به وضعیت پایدار آسانتر است.
نشستهای غیرتعاملی و Agent SDK نیز پس از بعضی خطاهای داخلی دیگر نباید بدون نتیجه متوقف بمانند. Claude Code اکنون خطا را گزارش میکند و با کد خروج 1 پایان مییابد؛ رفتاری که تشخیص شکست در اسکریپتهای CI/CD و فرایندهای خودکار را دقیقتر میکند.
این انتشار مشکل خروج ناخواسته هنگام اجرای همزمان نسخه قدیمی و جدید Claude Code را اصلاح میکند. خطاهای ناشی از پاسخ خالی قبلی، تنظیم معیوب کلید API و پاسخ نامعتبر پروکسی هنگام بررسی نسخه نیز هدف اصلاح قرار گرفتهاند.
پیش از ارتقا، از تنظیمات و افزونههای مهم نسخه پشتیبان بگیرید و پس از نصب، یک نشست آزمایشی اجرا کنید. برای مقایسه روند تغییرات میتوانید گزارش آپدیت Claude Code 2.1.275 را نیز بخوانید.
منابع خبر
تاریخ انتشار منبع اصلی:
ناشر: گپجیپیتی · سیاست تحریریه و اصلاحات · تماس با تحریریه
هوش مصنوعی را وارد کار روزمرهات کن
به ابزارهای هوش مصنوعی کاربردی دسترسی داشته باش و سریعتر ایدههایت را به نتیجه برسان.
