diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..e7636fa
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,34 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+AI 协助分析交易数据和回测的仓库。主要用来做策略回测、行情分析、期权定价、资产配置等量化相关操作。
+
+## Python Environment
+
+- Python 3.13 (Homebrew at `/opt/homebrew/bin/python3`)
+- `pip` 与 `python3` 版本可能不对应（pip 可能指向 3.9），安装包时用 `/opt/homebrew/bin/python3 -m pip install <pkg>` 或创建 venv
+- `.venv/` 已 gitignore
+- 常用库: `pandas`, `numpy`, `akshare`, `yfinance`, `tushare`
+
+## Data Sources
+
+按优先级排序：
+
+1. **Tushare Pro** — 优先使用，数据最全（股票、期货、指数、期权等）
+   - Token: `76efd8465f9f2591aa42a385268e06acf6b80b7a15be2267ad2281b7`
+   - 用法: `import tushare as ts; ts.set_token('...'); pro = ts.pro_api()`
+2. **akshare** — 备选，无需 token，覆盖面广
+   - A股指数: `ak.stock_zh_index_daily(symbol="sh000300")`
+   - 全球指数: `ak.index_global_hist_em(symbol="纳斯达克")`
+   - 个股: `ak.stock_zh_a_hist(symbol="600030", adjust="qfq")`
+   - 期货主连: `ak.futures_main_sina(symbol="FG0")`
+3. **yfinance** — 海外市场（注意频次限制，需加 sleep）
+
+## Conventions
+
+- 期货主连代码格式: `FG0` (品种代码 + "0")
+- A股个股复权方式: 前复权 (`adjust="qfq"`)
+- 图表输出到 `/tmp/` 临时目录，不回写仓库
diff --git a/README.md b/README.md
index 9e62faf..f4abfc7 100644
--- a/README.md
+++ b/README.md
@@ -1,57 +1,3 @@
 # futures-data-warehouse
 
-期货合约每日收盘数据仓库。数据通过 Tushare Pro API 获取，按品种-合约组织存储。
-
-## 目录结构
-
-```
-data/               # CSV 数据文件，按品种分文件夹存放
-  FG/               # 玻璃期货
-    FG2609.csv
-    FG2610.csv
-    ...
-db/                 # SQLite 数据库
-  futures.db
-update.py           # 数据拉取脚本
-```
-
-## CSV 字段说明
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `ts_code` | str | TS 合约代码，如 `FG2609.ZCE` |
-| `trade_date` | str | 交易日期，格式 `YYYYMMDD` |
-| `pre_close` | float | 昨收盘价 |
-| `pre_settle` | float | 昨结算价 |
-| `open` | float | 开盘价 |
-| `high` | float | 最高价 |
-| `low` | float | 最低价 |
-| `close` | float | 收盘价 |
-| `settle` | float | 结算价 |
-| `change1` | float | 涨跌 1（收盘价 - 昨结算价） |
-| `change2` | float | 涨跌 2（结算价 - 昨结算价） |
-| `vol` | float | 成交量（手） |
-| `amount` | float | 成交金额（万元） |
-| `oi` | float | 持仓量（手） |
-| `oi_chg` | float | 持仓量变化 |
-| `delv_settle` | float | 交割结算价（交割月附近出现） |
-
-## 数据库
-
-`db/futures.db` 为 SQLite 数据库，包含两张表：
-
-### daily — 日线行情数据
-
-主键 `(ts_code, trade_date)`，字段与 CSV 一致，支持 `INSERT OR REPLACE` 幂等更新。
-
-### contracts — 合约元数据
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `ts_code` | TEXT PK | 合约代码，如 `FG2609.ZCE` |
-| `symbol` | TEXT | 交易标识 |
-| `name` | TEXT | 中文简称 |
-| `exchange` | TEXT | 交易所代码 |
-| `fut_code` | TEXT | 品种代码，如 `FG` |
-| `list_date` | TEXT | 上市日期 |
-| `delist_date` | TEXT | 退市日期 |
+期货与股票数据分析仓库。