diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..70c5c02
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,22 @@
+# CLAUDE.md
+
+## Project Overview
+
+CodePilot — Claude Code 的原生桌面 GUI 客户端，基于 Electron + Next.js。
+
+## Release Checklist
+
+**发版前必须更新版本号：**
+
+1. `package.json` 中的 `"version"` 字段
+2. `package-lock.json` 中的对应版本（运行 `npm install` 会自动同步）
+3. 构建命令：`npm run electron:pack:mac`（macOS）/ `npm run electron:pack:win`（Windows）
+4. 上传产物到 GitHub Release 并编写 release notes
+
+## Build Notes
+
+- macOS 构建产出 DMG（arm64 + x64），Windows 产出 NSIS 安装包或 zip
+- `scripts/after-pack.js` 会在打包时显式重编译 better-sqlite3 为 Electron ABI，确保原生模块兼容
+- 构建前清理 `rm -rf release/ .next/` 可避免旧产物污染
+- 构建 Windows 包后需要 `npm rebuild better-sqlite3` 恢复本地开发环境
+- macOS 交叉编译 Windows 需要 Wine（Apple Silicon 上可能不可用），可用 zip 替代 NSIS
diff --git a/package-lock.json b/package-lock.json
index a39eca2..e0c2016 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "codepilot",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "codepilot",
-      "version": "0.2.2",
+      "version": "0.2.3",
       "dependencies": {
         "@anthropic-ai/claude-agent-sdk": "^0.2.33",
         "@hugeicons/core-free-icons": "^3.1.1",
@@ -9824,7 +9824,7 @@
       }
     },
     "node_modules/format": {
-      "version": "0.2.2",
+      "version": "0.2.3",
       "resolved": "https://registry.npmjs.org/format/-/format-0.2.2.tgz",
       "integrity": "sha512-wzsgA6WOq+09wrU1tsJ09udeR/YZRaeArL9e1wPbFg3GG2yDnC2ldKpxs4xunpFF9DgqCqOIra3bc1HWrJ37Ww==",
       "engines": {
diff --git a/package.json b/package.json
index 54e2557..e09c10a 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "codepilot",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "private": true,
   "main": "dist-electron/main.js",
   "scripts": {