diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..2b55a36
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,22 @@
+# huike-e2e-moicen 项目指南
+
+## CI 工作流
+
+### 等待 CI 完成
+
+使用 `gh run watch` 在后台检测，不要轮询：
+
+```bash
+gh run watch <run-id> --repo alchemy-studio/huike-e2e-moicen 2>&1 &
+```
+
+完成后会自动通知。也可以用 `gh run watch --job=<job-id>` 监控特定 job。
+
+注意：`gh run watch` 依赖当前目录的 git remote 确定仓库，所以要在 `huike-e2e-moicen` 目录下跑，或者用 `--repo` 参数显式指定。
+
+### 两个 Workflow
+
+| Workflow | 环境 | 触发方式 | 测试范围 |
+|----------|------|----------|----------|
+| `music-room Playwright` | 测试服 (moicen.com) | push/PR 自动 + 手动 + 每日 06:30 UTC | 全部测试（含登录） |
+| `production Smoke` | 正式服 (huiwings.cn) | 手动触发 + 每日 05:00 UTC | 仅访客测试（`--grep-invert "已登录"`） |