diff --git a/vscode/CLAUDE.md b/vscode/CLAUDE.md
index 957dec4..ff13400 100644
--- a/vscode/CLAUDE.md
+++ b/vscode/CLAUDE.md
@@ -3,4 +3,5 @@
 - 具体编码任务一律派子代理（Agent 工具）去做，主会话只讨论需求和方案
 - **子代理实施完成后自动 commit**，使用本仓库的 emoji 前缀风格（参考 `git log`）
 - **改完扩展代码必须收尾**：`package.json` version patch +1 → `pnpm ext:package` 打包 VSIX（生成在 `vscode/` 目录，供用户拿去安装）→ 版本号改动一并 commit，不许留脏的 package.json
+- **本机安装 VSIX 必须带 `--profile augment`**（用户的 VS Code 窗口用 augment profile，不带 profile 参数会装进默认 profile，窗口里看不见）；两台 MBP 用默认 profile，直接 `code --install-extension` 即可
 - 代码文件用 Serena MCP 工具读写（`mcp__serena__find_symbol` / `replace_symbol_body` 等），非代码文件才用 built-in Read/Edit