finance-talk/CLAUDE.md

CLAUDE.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")