کار حرفه‌ای با ابزارها

Claude Code: سنجیدن کار و مجوزها بدون نگرانی

تستحریریهٔ سرنخ۲۲ آبان ۱۴۰۵۳ دقیقه مطالعه

این نوشته مستقل است و به هیچ برندی وابسته نیست. اگر ابزاری را معرفی کنیم، دلیلش را هم می‌نویسیم. رویهٔ نوشتن · روش بررسی ابزارها

کارِ 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 را نشانهٔ زیاده‌روی می‌داند.

یک الگوی روزمره

  1. حالت برنامه‌ریزی برای شروع.
  2. تست یا لینتر مشخص در دستور.
  3. deny برای فایل‌های حساس.
  4. بعد از کار، /code-review و خواندن diff.
  5. فقط اگر یک روال بدون استثنا داری، hook بساز.

ایمنی

هرگز رمز و کلید در پروژه یا گفتگو نگذار؛ جزئیات در راهنمای استفادهٔ مسئولانه و امنیت حساب‌ها آمده است.

ادامه

برای مرتب کردن قاعده‌های پروژه، CLAUDE.md را بخوان. برای طولانی شدن جلسه، مدیریت زمینه را ببین. و برای فهرست کلیِ سنجیدن هر خروجی، فهرست بازبینی.

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

اشتراک‌گذاری:تلگرامواتس‌اپایکس
تس

تحریریهٔ سرنخ

تیم نویسندگان و آزمایشگران

ما چند نفریم که هر روز با ابزارهای هوش مصنوعی و اتوماسیون کار می‌کنیم. هر راهنمایی که اینجا می‌بینید اول روی کارِ خودمان امتحان شده و بعد نوشته شده است.

کار حرفه‌ای با ابزارهاراهنمای اصلی

کار مؤثر با ابزارهای هوش مصنوعی: پنج اصل مشترک

پنج اصل مشترک برای کار با Claude، Codex، Cursor، Copilot، NotebookLM و Perplexity: زمینه، برنامه، سنجش، زمینهٔ تمیز و مرز دسترسی. به‌همراه فهرست راهنماها.

۲۶ آبان ۱۴۰۵۳ دقیقه مطالعه