用途:监控 WSL2 内存使用,对 Claude Code 实例和并行智能体强制执行安全扩展上限,防止 WSL 因内存耗尽而崩溃。
激活时机:在启动 3 个以上并行 Task 智能体前;运行 npm run build 等耗内存操作前;SessionStart 钩子报告 WARNING 或 CRITICAL 内存状态时;用户提及运行多个 CC 实例时。
内存检查命令:free -m | awk '/^Mem:/{printf "RAM: %dMB/%dMB (%d%%)\n", $3, $2, $3*100/$2} /^Swap:/{if($3>0) printf "Swap: %dMB/%dMB\n", $3, $2}'
扩展规则:绿区(RAM < 75%)并行 Task 智能体最多 4 个,后台构建安全,无限制;黄区(75–89%)并行最多 2 个,优先串行,避免构建与智能体同时运行,并警告“内存压力偏高,并行智能体限制为 2”;红区(≥ 90%)并行最多 1 个或改为串行,禁止后台构建,建议关闭其他 CC 实例,并警告按串行工作以防 WSL 崩溃。
恢复操作:ps aux --sort=-%mem | head -20 查看内存占用;pkill -f "node.*claude" 2>/dev/null 结束旧会话遗留的 node 进程;echo 1 | sudo tee /proc/sys/vm/drop_caches 2>/dev/null 让内核释放缓存(非破坏性)。
集成方式:钩子 .claude/hooks/memory-check.sh 在 SessionStart 时运行;若钩子触发警告,状态栏显示内存百分比;技能为自执行式,CC 读取后会在扩展前自我限制。
参考配置:宿主 16GB RAM,WSL 上限 12GB(C:\Users\Frank.wslconfig),Swap 12GB,每个 CC 实例约 500MB 加每个 MCP 服务器 100–150MB,安全并发 CC 实例 4–5 个,autoMemoryReclaim 为 dropcache(激进)。
限制:以上为资料给出的参考环境与规则,其他硬件或 WSL 配置下的具体阈值和效果暂未提供。