diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..ca41046
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,7 @@
+# zcbot 开发笔记 (给 Claude Code)
+
+## 环境
+
+- **Python 虚拟环境**: `.venv/`(项目根目录下),所有依赖装在里面
+- 跑脚本 / 测试一律用 `.venv/Scripts/python.exe ...`,**不要用全局 `python`**(没装 litellm/python-pptx 等会报 ModuleNotFoundError)
+- requirements 见 `requirements.txt`