diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..11d9bbf
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,71 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## 项目概述
+
+这是一个 Electron + React + TypeScript 的桌面应用，用于管理和切换 Claude Code 的不同供应商配置（Anthropic、OpenRouter 等）。
+
+## 开发命令
+
+```bash
+# 开发模式（同时启动 Vite 开发服务器和 Electron 主进程监听）
+npm run dev
+
+# 仅构建主进程
+npm run build:main
+
+# 仅构建渲染进程
+npm run build:renderer
+
+# 完整构建
+npm run build
+
+# 启动应用（需要先构建）
+npm start
+# 或
+electron .
+
+# 打包发布
+npm run dist
+```
+
+## 代码架构
+
+### 三层架构设计
+
+1. **主进程 (src/main/)**
+   - `index.ts`: Electron 主进程入口，处理窗口创建和 IPC 通信
+   - `services.ts`: 核心业务逻辑，包含供应商状态检查和 Claude Code 配置文件操作
+   - `preload.ts`: 预加载脚本，提供安全的 IPC API 接口
+
+2. **渲染进程 (src/renderer/)**
+   - `App.tsx`: 主应用组件，状态管理和业务逻辑协调
+   - `components/`: React 组件
+     - `ProviderList.tsx`: 供应商列表显示和操作
+     - `AddProviderModal.tsx`: 添加供应商的模态框
+     - `EditProviderModal.tsx`: 编辑供应商的模态框
+
+3. **共享类型 (src/shared/types.ts)**
+   - 定义主进程和渲染进程间的数据结构
+   - 声明 `window.electronAPI` 接口用于类型安全的 IPC 调用
+
+### 数据流
+
+- 使用 `electron-store` 在主进程中持久化供应商配置
+- 通过 IPC 在主进程和渲染进程间通信
+- 供应商状态通过 HTTP 请求实时检测
+- 切换供应商时直接修改 `~/.claude/settings.json` 文件
+
+### 关键文件操作
+
+- Claude Code 配置文件路径: `~/.claude/settings.json`
+- 配置更新通过 `services.ts` 中的 `switchProvider()` 函数完成
+- 应用配置存储在 `electron-store` 默认位置
+
+## 构建配置
+
+- 主进程使用 `tsconfig.main.json` 配置
+- 渲染进程使用 `tsconfig.json` + Vite 构建
+- 开发时渲染进程运行在 `localhost:3000`
+- 生产时渲染进程文件位于 `dist/renderer/`
\ No newline at end of file