diff --git a/.claude/settings.json b/.claude/settings.json
new file mode 100644
index 0000000..8630ebd
--- /dev/null
+++ b/.claude/settings.json
@@ -0,0 +1,7 @@
+{
+  "mcpPermissions": {
+    "gitea": {
+      "level": "allow"
+    }
+  }
+}
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..a1398cb
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,51 @@
+# sanguo_llmwiki - Claude Code 项目配置
+
+## 项目说明
+
+混合架构 Wiki 系统 - MCP Server (Python) + Wiki Skills
+
+## 开发/安装目录
+
+- **开发目录**: `~/.openclaw/sanguo_projects/sanguo_llmwiki`
+- **安装目录**: `~/.sanguo_projects/sanguo_llmwiki`
+
+## 项目结构
+
+```
+sanguo_llmwiki/
+├── mcp_server/      # MCP Server 实现 (Python)
+├── skills/          # Wiki Skills (11 个)
+├── tests/           # 测试套件
+├── docs/            # 文档
+└── ecosystem.config.cjs  # PM2 配置
+```
+
+## 快速命令
+
+```bash
+# 运行测试
+pytest
+
+# 启动 MCP Server (开发)
+python3 -m mcp_server.main
+
+# 部署到安装目录
+# 从 ~/.openclaw/sanguo_projects/sanguo_llmwiki
+# 到 ~/.sanguo_projects/sanguo_llmwiki
+```
+
+## MCP 工具
+
+服务器提供 8 个工具：
+- wiki_query: 搜索 wiki
+- memory_bridge: 记忆桥接
+- wiki_status: 状态查询
+- wiki_lint: 健康审计
+- cross_linker: 交叉链接
+- tag_taxonomy: 标签分类
+- wiki_synthesize: 主题综合
+- daily_update: 日常维护
+
+## Wiki Skills
+
+11 个一次性操作技能位于 skills/ 目录下。