diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..36da81a
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,14 @@
+# CLAUDE.md — 客迹（KEJI）项目约定
+
+## 部署（唯一入口）
+
+- 一键部署：`bash deploy/deploy.sh <server|admin|sdk|all> [--skip-tests] [--allow-dirty]`
+- 用户说"部署到线上" = 执行上述命令（按改动范围选目标）并汇报验证结果与版本标识
+- `all` 顺序固定 server → admin → sdk（SDK 新事件依赖 server 白名单先上线）
+- 部署日志：deploy/logs/（gitignore）；线上真挂载点 /opt/cms-cj/{admin/dist, sdk/dist}（tar 真实路径直落，禁止 cp/暂存方案）
+- 严格不触碰服务器其他项目（1Panel/OpenResty/其他容器）
+
+## 红线（沿袭 spec §4.5 等）
+
+- SDK 任何回调异常不得冒泡宿主页；业务代码禁 v-html（admin README-dev.md）
+- 一切改动走 TDD；用中文交流