diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..62d9e32
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,46 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## 仓库性质
+
+这是一个以 Obsidian 管理的**个人知识库**，用 git 做版本控制。内容全部为 Markdown 文档，没有可执行代码。
+
+## 目录结构语义
+
+| 目录 / 文件 | 用途 |
+|---|---|
+| `学习笔记/` | 学习过程中沉淀的认知结晶，按主题组织 |
+| `日记/` | 日记，文件名格式 `YYYY-MM-DD.md` |
+| `01-work/` | 工作相关内容 |
+| `Claude-Code-启动指南.md` | 本机 Claude Code 启动环境说明 |
+
+## 笔记命名约定
+
+同一主题的系列笔记用数字前缀标识顺序，例如：
+
+```
+00-模型工具调用-原点.md     ← 起点/总纲
+01-本机IPC.md
+02-跨主机IPC.md
+```
+
+新建系列笔记时遵循这个命名模式。
+
+## Git 提交规范
+
+提交信息用中文，格式：`动作 + 内容简述`，例如：
+- `添加学习笔记：XXX`
+- `更新日记：YYYY-MM-DD`
+- `修订笔记：XXX`
+
+## 本机网络环境
+
+Claude Code 在本机运行需要通过 Clash Verge 代理（端口 7897）访问 Anthropic 服务，已写入 `~/.bashrc`，无需手动设置。
+
+## 学习笔记的写作原则
+
+笔记以"长在地基上"为核心——新概念优先用已有知识（操作系统、网络、进程等）类比锚定，而非堆砌新术语。写作时：
+- 用作者自己的语言重新组织，不是原文摘抄
+- 避免孤立定义，每个概念尽量关联到已有知识树
+- 多框架交叉时，明确标注术语映射，维护内部一致性