一、先识别当前 aihf 版本和模型路由
当前项目已改用 hedge_fund 包及 aihf 命令。llm/client.py 的 OpenAI 分支使用 ChatOpenAI，并显式读取 OPENAI_API_BASE；本页旧 OPENAI_BASE_URL 和 python src/main.py --ticker 组合不能当成本版本操作。
模型先由 api_models.json 的 provider 决定客户端。未知 ID 会回退 Anthropic，因此换成任意网关型号可能走错鉴权。示例中的 gpt-6-sol 只是源码登记值，不保证当前 apizt 可售。这里的回测和 paper 使用模拟资金，不是实盘下单教程。
二、环境准备
锁定源码后用 Poetry 安装并先查看 --help。根目录与 ~/.hedge-fund/.env 都可能提供配置，现有 shell 导出会优先；核对实际来源而不是只改某个同名文件。
- 本页对应当前 hedge_fund 包，旧 src/main.py --ticker 命令不适用。
- 源码项目用 poetry install；安装包入口为 aihf。不要把未锁版本的包与本文源码混称。
- OPENAI_API_BASE 是本版本客户端实际读取的地址名；shell 中导出的值优先于保存文件。
- 示例 gpt-6-sol 在锁定 api_models.json 中登记为 OpenAI，但当前网关供应需用户另核对；没有执行回测。
继续配置 AI Hedge Fund
先看对应接入页，核对本文的配置字段与验证步骤，再回到原运行环境测试。
三、模型凭据与数据凭据分开配置
只有选择本文已定位的兼容Provider时，才把自己的apizt令牌放到对应模型Key字段。行情、数据库、券商或交易所凭据使用原项目各自配置；本页没有创建账户凭据或在线调用。
四、修改 AI Hedge Fund 模型配置
下面是该版本 OpenAI 客户端的地址字段。gpt-6-sol 必须同时在上游登记为 OpenAI、并在你当前端点可用；不满足时先选可用登记项或审阅 registry 后再做代码扩展。
OPENAI_API_KEY=sk-替换为自己的apizt令牌
OPENAI_API_BASE=https://api.apizt.com/v1
HEDGE_FUND_LLM_MODEL=gpt-6-sol
FINANCIAL_DATASETS_API_KEY=替换为自己的行情数据凭据AI Hedge Fund 的配置字段与任务检查
本站绘制的内容说明图：按本页 .env 与命令提取配置字段；需核对自己的项目版本，不把通用变量名当所有上游项目的统一配置。
本站绘制的内容说明图：本页项目的运行与记录检查说明；不画虚构收益、策略成绩或调用成功界面，模型输出与真实财务结果分开记录。
先核对登记模型，再做一段历史研究
apizt 只提供当前兼容模型入口；行情凭据、基金定义和模拟账本仍由原项目负责。本文没有验证在线供应、回测收益或真实成交。
查看相关型号
在型号详情中核对最低价格、参数、接口示例与使用限制，再选择配置方式。
五、运行明确范围的历史回测
使用仓库内真实存在的 fund/example.yaml，限定一只股票与短日期区间，保存 --out JSON。请先阅读该 mandate 的策略与资金口径；运行可能产生数据和多次模型费用，本文没有执行。
poetry install
poetry run aihf --help
# 先确认该模型在当前apizt分组可用；主动执行才会调用数据和模型
poetry run aihf --model gpt-6-sol backtest hedge_fund/fund/example.yaml --universe AAPL --start 2024-01-02 --end 2024-01-05 --out aapl-backtest.json- 确认模型登记为OpenAI且地址为预期网关。
- 检查原始行情、基本面与收益会话日期，避免将数据错误当Key问题。
- 保存完整回测JSON、mandate和每个SessionRecord，而不是只看最终NAV。
- 区分真实市场日、模拟资金和模拟成交，不把paper基金称为券商实盘。
六、查看 apizt 请求日志和成本
结果默认写到 ~/.hedge-fund/research，--out 另保存本次结果。逐会话核对决定时间与后续执行时间，LLM选择只影响投资分析Agent，纯量化模型可忽略该模型参数。
适合的量化调用场景
按任务与分组选择模型
必须先查 registry 的 provider，而不是只填看似正确的模型字符串。当前模型菜单是版本内容；自定义模型需要明确登记或实现对应客户端，不能由Key自动推断。
七、常见报错排查
本项目当前版本的首要问题是旧命令和模型登记错配；先查源码版本，再看数据或模型响应。
常见问题
AI Hedge Fund API 配置从哪里配置？
当前版本使用 aihf/hedge_fund 包，OpenAI 分支从 OPENAI_API_BASE 取地址，并由 api_models.json 把模型路由到 OpenAI；未知 ID 会默认走 Anthropic。使用已登记且目标端点可用的模型，再用 backtest 明确 mandate、universe 与日期。本页未执行回测或模型请求。
这份配置已经在线运行验证了吗？
没有。本页依据锁定官方源码给出配置和操作；未启动上游平台、调用模型或数据服务，也没有执行任何交易。请用当前账号的实际供应和输出逐项验证。
继续配置 AI Hedge Fund
先看对应接入页，核对本文的配置字段与验证步骤，再回到原运行环境测试。
参考资料
本文依据下列项目源码说明接入位置与配置字段。不同版本先核对自己的入口和变量；上方通用界面示意不代替实际项目、模型调用与费用验收。