diff --git a/CLAUDE.md b/CLAUDE.md
index 6e81997..a7bfbf7 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -206,6 +206,7 @@ tail -f logs/container_stats.log
 - **前端改动优先级**：按 `static/src` 现有分层改（`app/` `stores/` `components/` `composables/`）。
 - **CLI 改动优先级**：优先在 `cli/src/App.tsx`、`cli/src/components.tsx`、`cli/src/eventMapper.ts`、`cli/src/api.ts` 内做最小闭环修改。
 - 涉及 monitor 动画/事件联动时，至少同步检查 `MonitorDirector.ts` 与 `stores/monitor.ts`。
+- **前端不强制本地构建**：沙箱环境无法成功执行 `npm run build` / `npm run cli:build`，因此改完前端不必每次都跑构建验证。改动后用类型检查（`npm run lint` / `npm --prefix cli run typecheck`）或人工 review 自查即可，构建交由用户在本机或 CI 完成。
 
 ### Working with Containers