diff --git a/AGENTS.md b/AGENTS.md
index f8f2cc7..0ac3475 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -14,6 +14,60 @@ AI 协助分析交易数据和回测的仓库。主要用来做策略回测、
 - 无可用镜像时才允许拉取，默认拉取 `python:3.11-slim`
 - 示例: `docker images | grep python` 查看已有镜像，再用已有镜像执行
 
+## 环境搭建（首次使用）
+
+### 1. 创建容器
+
+检查是否已有 `finance-talk` 容器（名称固定，在终端中运行）：
+
+```bash
+docker ps -a --filter "name=finance-talk" --format "{{.Names}}"
+```
+
+若无输出，则按以下步骤创建：
+
+```bash
+# 查看已有 Python 镜像，优先复用
+docker images | grep python
+
+# 无可用镜像时才拉取（默认 python:3.11-slim）
+docker pull python:3.11-slim
+
+# 创建并启动容器（映射当前目录到 /workspace）
+docker run -d \
+  --name finance-talk \
+  -v $(pwd):/workspace \
+  -w /workspace \
+  python:3.13.11-slim \
+  sleep infinity
+```
+
+### 2. 安装依赖包
+
+```bash
+docker exec finance-talk pip install tushare akshare
+```
+
+### 3. 验证
+
+```bash
+docker exec finance-talk python -c "import tushare; import akshare; print('OK')"
+```
+
+### 4. 日常使用
+
+Python 脚本通过 `docker exec` 在容器中执行：
+
+```bash
+docker exec finance-talk python your_script.py
+```
+
+若容器已存在但未运行，先启动：
+
+```bash
+docker start finance-talk
+```
+
 ## Data Sources
 
 按优先级排序：
diff --git a/CLAUDE.md b/CLAUDE.md
index 7e425c2..0dc1298 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -14,6 +14,60 @@ AI 协助分析交易数据和回测的仓库。主要用来做策略回测、
 - 无可用镜像时才允许拉取，默认拉取 `python:3.11-slim`
 - 示例: `docker images | grep python` 查看已有镜像，再用已有镜像执行
 
+## 环境搭建（首次使用）
+
+### 1. 创建容器
+
+检查是否已有 `finance-talk` 容器（名称固定，在终端中运行）：
+
+```bash
+docker ps -a --filter "name=finance-talk" --format "{{.Names}}"
+```
+
+若无输出，则按以下步骤创建：
+
+```bash
+# 查看已有 Python 镜像，优先复用
+docker images | grep python
+
+# 无可用镜像时才拉取（默认 python:3.11-slim）
+docker pull python:3.11-slim
+
+# 创建并启动容器（映射当前目录到 /workspace）
+docker run -d \
+  --name finance-talk \
+  -v $(pwd):/workspace \
+  -w /workspace \
+  python:3.13.11-slim \
+  sleep infinity
+```
+
+### 2. 安装依赖包
+
+```bash
+docker exec finance-talk pip install tushare akshare
+```
+
+### 3. 验证
+
+```bash
+docker exec finance-talk python -c "import tushare; import akshare; print('OK')"
+```
+
+### 4. 日常使用
+
+Python 脚本通过 `docker exec` 在容器中执行：
+
+```bash
+docker exec finance-talk python your_script.py
+```
+
+若容器已存在但未运行，先启动：
+
+```bash
+docker start finance-talk
+```
+
 ## Data Sources
 
 按优先级排序：