‏claude-devtools: ببین Claude Code پشت پرده چیکار می‌کنه

اگه با Claude Code کار می‌کنی، احتمالاً این صحنه‌ها برات آشناست: «Read 3 files»، «Edited 2 files»، «Ran bash command» — و تمام. از نسخه ۲.۱.۲۰ به بعد، Claude Code جزئیات واقعی اجرا رو از ترمینال حذف کرده و به جاش خلاصه‌های کلی نشون می‌ده. تنها گزینه رسمی، فلگ --verbose بود که هزاران خط JSON خام بهت می‌ریخت — نه خیلی مفید.

claude-devtools برای حل همین مشکل ساخته شده. این ابزار نه یه wrapper روی Claude Codeه، نه به API متصل می‌شه. فقط می‌ره سراغ پوشه ~/.claude/ که Claude Code خودش لاگ‌های session رو اونجا ذخیره می‌کنه، و اون اطلاعات رو به شکل قابل‌فهم نمایش می‌ده. همه session‌هایی که تا حالا اجرا کردی، حتی از ابزارهای دیگه، قابل بررسیه.

یکی از مهم‌ترین قابلیت‌هاش Context Reconstruction یا بازسازی context پنجره‌ست. این بخش مصرف توکن رو به ۷ دسته تقسیم می‌کنه: فایل‌های CLAUDE.md (گلوبال، پروژه، دایرکتوری)، skill activation ها، فایل‌های @-mention شده، ورودی و خروجی tool ها، thinking، overhead تیمی، و متن کاربر. می‌تونی ببینی context چطور پر می‌شه، کِی compaction اتفاق می‌افته، و بعد از compaction چی توش می‌مونه.

قابلیت Tool Call Inspector هم خیلی جالبه — هر «Read 3 files» که ترمینال نشون می‌داد رو کامل باز می‌کنه. فایل‌های خونده‌شده با syntax highlighting، diff اینلاین برای ویرایش‌ها، خروجی bash، و درخت کامل اجرای subagent‌ها رو می‌بینی.

برای تیم‌هایی که با multi-agent کار می‌کنن، قابلیت Team & Subagent Trees خیلی به کار میاد. هر agent یه درخت اجرای مجزا داره با tool trace، متریک توکن، مدت اجرا، و هزینه. agentهای تودرتو هم به شکل درخت‌های بازگشتی رندر می‌شن.

یه قابلیت امنیتی جالب هم داره: Notification Triggers. می‌تونی برای دسترسی به فایل‌های حساس مثل .env، خطاهای tool، یا مصرف بالای توکن هشدار سیستمی تنظیم کنی. حتی می‌شه با regex، مسیرهای خاص مثل فایل‌های پرداخت رو زیر نظر گرفت.

از نظر تجربه کاربری، یه Command Palette با Cmd+K داره که جستجوی cross-session رو ممکن می‌کنه. چند session رو می‌تونی کنار هم باز کنی، تب‌ها رو drag & drop کنی بین pane ها، و session‌های مختلف رو با هم مقایسه کنی. برای کار روی سرورهای ریموت هم SSH Remote Sessions داری که از ~/.ssh/config می‌خونه.

نصب روی مک با Homebrew خیلی سادست:

brew install --cask claude-devtools

برای self-host هم می‌شه با Docker اجرا کرد:

docker compose up

که یه UI روی localhost:3456 می‌ده، بدون هیچ درخواست شبکه‌ای به بیرون.

نکات کلیدی:

• claude-devtools لاگ‌های ~/.claude/ رو می‌خونه — هیچ داده‌ای رو از خودش تولید نمی‌کنه
• رایگان، اوپن‌سورس، بدون نیاز به API key یا تنظیمات اضافه
• Context Reconstruction مصرف توکن رو به ۷ دسته تفکیک می‌کنه
• Tool Call Inspector همه tool call های مخفی‌شده رو با جزئیات نشون می‌ده
• پشتیبانی از SSH برای بررسی session روی ماشین‌های ریموت
• قابلیت Notification Triggers برای هشدار دسترسی به فایل‌های حساس
• پشتیبانی از macOS، Windows، Linux و Docker