diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..e648112
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,39 @@
+# AGENTS.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+AI 协助分析交易数据和回测的仓库。主要用来做策略回测、行情分析、期权定价、资产配置等量化相关操作。
+
+## Python 执行环境
+
+按优先级选择：
+
+1. **Docker（推荐）** — 隔离环境，避免依赖冲突
+   - 已有镜像优先使用（`docker images` 查看），不要重复拉取
+   - 无可用镜像时默认拉取 `python:3.11-slim`
+   - 示例: `docker run --rm -v "$PWD:/work" -w /work python:3.11-slim bash -c "pip install akshare -q && python3 script.py"`
+2. **设备 Python + venv** — Docker 不可用时的降级方案
+   - 检测 Python: `which python3 || which python`，取其路径
+   - 在项目目录创建 `.venv/`（已 gitignore），`<python> -m venv .venv && source .venv/bin/activate`
+   - 安装包: `pip install <pkg>`
+
+## 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"`)