کارِ Claude Code وقتی قابلاتکاست که راهی برای سنجیدنِ خودش داشته باشد و مجوزهایش با خطر کار جور باشد. مستندات رسمی علت اصلی «گفت تمام شد ولی نشده بود» را همین نبودنِ راه سنجش میداند.
بر پایهٔ مستندات که در ۲۶ آبان ۱۴۰۵ خواندیم. حالتهای مجوز و نامها در نسخههای مختلف ممکن است فرق کند؛ همیشه در جلسه با /permissions وضعیت را ببین.
بخش اول: راه سنجیدن
چیزی بده که اجرا شود و نتیجهاش «موفق» یا «ناموفق» باشد. مستندات اینها را مثال میزند: یک فایل تست، خروجی بیلد، یک لینتر، یک اسکریپت که خروجی را با یک فایل نمونه مقایسه میکند، یا یک اسکرینشات مرورگر.
- در دستور: «تستهای
tests/authرا بعد از تغییر اجرا کن و تا موفق شدن ادامه بده.» /goal: یک شرط مینویسی، مثلاً «همهٔ تستهایtests/authموفق و لینت تمیز»، و مدلی جدا بعد از هر نوبت بررسی میکند./code-review: تغییرات را در یک subagent تازه که گفتگو را ندیده بازبینی میکند./verify: برنامه را اجرا میکند و نتیجه را میبیند.- از Claude مدرک بخواه: دستوری که اجرا کرد و خروجیاش، نه فقط «همهچیز موفق است».
بخش دوم: مجوزها
مستندات چند حالت را نام میبرد. در حالت دستی هر ویرایش و هر دستور غیرفقطخواندنی را تو تأیید میکنی. حالت خودکار (auto) از یک مدل طبقهبند استفاده میکند و کارهایی مثل curl | bash، انتشار روی تولید و force push روی کار دیگران را مسدود میکند. با Shift+Tab بین حالتها میچرخی.
مستندات این هشدار را میدهد که حالت bypassPermissions فقط در یک کانتینر یکبارمصرف معنا دارد. روی سیستم شخصیات که فایلهای واقعی دارد، آن را روشن نکن.
قاعدههای deny
برای چیزهایی که هرگز نباید خوانده شوند، قاعدهٔ صریح بنویس. مثال خود مستندات:
"deny": ["Read(./.env)", "Read(./.env.local)", "Read(./secrets/**)"]
hook برای قاعدههای بدون استثنا
hook یک فرمان است که در نقاط مشخص اجرا میشود (مثلاً پیش از استفاده از ابزار یا هنگام توقف). مثال مستندات برای هنگام توقف: اگر بررسی نوعها شکست خورد، با کد خروج ۲ Claude را به کار برگردان. بعد از چند توقف پشتسرهم بدون ابزار، نوبت خودش تمام میشود.
مستندات هشدارهایی دارد که ارزش دانستن دارند:
- قاعدههای مجوز با فراخوانی ابزار تطبیق میخورند، نه با نیت. مثلاً deny روی
Readجلوی اسکریپتی را نمیگیرد که همان فایل را باز میکند. - ارجاع
@فایلhookهایPreToolUseرا فعال نمیکند. - نقطههای بازگشت (checkpoint) فقط فایلهایی را برمیگردانند که با ابزارهای فایلِ خود Claude ویرایش شدهاند، نه فایلهایی که یک دستور Bash تغییر داده.
- hook برای یک سلیقه ارزش ندارد؛ برای قاعدهٔ بدون استثنا بساز. مستندات چهل hook و deny را نشانهٔ زیادهروی میداند.
یک الگوی روزمره
- حالت برنامهریزی برای شروع.
- تست یا لینتر مشخص در دستور.
- deny برای فایلهای حساس.
- بعد از کار،
/code-reviewو خواندن diff. - فقط اگر یک روال بدون استثنا داری، hook بساز.
ایمنی
هرگز رمز و کلید در پروژه یا گفتگو نگذار؛ جزئیات در راهنمای استفادهٔ مسئولانه و امنیت حسابها آمده است.
ادامه
برای مرتب کردن قاعدههای پروژه، CLAUDE.md را بخوان. برای طولانی شدن جلسه، مدیریت زمینه را ببین. و برای فهرست کلیِ سنجیدن هر خروجی، فهرست بازبینی.
سوالات متداول
راهنمای اصلی این بخش
کار مؤثر با ابزارهای هوش مصنوعی: پنج اصل مشترکتحریریهٔ سرنخ
تیم نویسندگان و آزمایشگران
ما چند نفریم که هر روز با ابزارهای هوش مصنوعی و اتوماسیون کار میکنیم. هر راهنمایی که اینجا میبینید اول روی کارِ خودمان امتحان شده و بعد نوشته شده است.