一、为什么 TradingAgents-CN 要接国内可直连 API 中转站
TradingAgents-CN 在量化任务里通常不是只请求一次模型，而是围绕新闻、研报、行情、策略和风控连续调用。国内用户如果直接连接海外官方接口或海外聚合接口，常见问题是请求超时、任务中断、429 限流和成本不好追踪。
QuickRouter 的作用是把 TradingAgents-CN 的模型请求统一接到国内可直连 API 中转站。工具里仍然按 OpenAI-compatible 方式填写 API Key、Base URL 和模型名，但实际请求由 QuickRouter 统一转发、记录和计费。
二、环境准备
如果你已经能在本地启动 TradingAgents-CN，只需要重点检查模型配置。如果还没部署，先按项目文档完成依赖安装、项目启动和基础任务验证。
- TradingAgents-CN 项目已拉取并安装依赖。
- 本地可以找到 .env、config.toml 或项目里的模型 Provider 配置。
- 已经注册 QuickRouter 账号，并准备创建一个单独给量化任务使用的 API Key。
- 建议先准备 1 个标的、1 个策略、2-5 路并发，用最小任务验证链路。
继续配置 TradingAgents-CN
如果你还没确定 Base URL、模型和并发参数，先看对应配置页，再回到本文按步骤测试。
跑不通先查这些报错
量化工具接模型失败时，最常见是 Key、Base URL、模型名和限流问题。
三、创建 QuickRouter API Key
登录 QuickRouter 后台，进入 API 令牌页面，新建一个专门用于 TradingAgents-CN 的 Key。建议名称写成 tradingagents_cn_quickrouter_api_test 或 quant_agent_prod，后续查日志、看成本、定位 401/429 都更清楚。
四、修改 TradingAgents-CN 模型配置
只要 TradingAgents-CN 支持 OpenAI-compatible Provider，一般改这三个值就够了：API Key、Base URL、Model。核心是把 Base URL 改成 QuickRouter 的国内可直连中转地址。
OPENAI_API_KEY=sk-你的QuickRouter令牌
OPENAI_BASE_URL=https://api.quickrouter.ai/v1
OPENAI_MODEL=claude-haiku-4-5-20251001
MAX_CONCURRENCY=3
REQUEST_TIMEOUT=60
先用 TradingAgents-CN 跑一轮低并发测试
注册后创建 API Key，把 Base URL 改成 https://api.quickrouter.ai/v1，先用 claude-haiku-4-5-20251001 验证国内直连、并发稳定性和成本。
五、运行最小任务验证连通性
第一次不要直接全市场扫描，也不要把多 Agent、高并发、长上下文全部打开。先用一个标的和一个短任务确认链路能跑通，再逐步扩大任务规模。
python -m tradingagents
# 建议先只选择 1 个标的，低并发验证
MAX_CONCURRENCY=3
六、查看 QuickRouter 请求日志和成本
量化任务最重要的是连续请求稳定性。QuickRouter 后台可以看到模型、状态码、耗时、token 消耗和失败原因。你可以先用 Haiku、mini、Flash 类轻量模型跑新闻摘要和因子解释，把复杂总结留给更强模型。
适合的量化调用场景
便宜模型选择建议
量化场景里不要一开始就用最贵模型跑全量任务。更稳的做法是：高频摘要和初筛用便宜轻量模型，少量关键结论再切强模型复核。
七、常见报错排查
TradingAgents-CN 跑不通时，不要先怀疑策略代码，先按 Key、Base URL、模型名、并发、余额这几个方向排查。
常见问题
TradingAgents-CN 接 QuickRouter 后还能换模型吗？
可以。工具侧保持同一个 Base URL 和 API Key，只需要把模型名换成 QuickRouter 支持的模型 ID。
高频量化一定要用 Claude Haiku 吗？
不一定。Haiku、mini、Flash 这类轻量模型更适合高频任务，中文研报和公告也可以测试 Qwen、DeepSeek。
教程里的配置能直接用于实盘吗？
建议先用于 paper trading、回测、研究和低并发测试。实盘前要单独做风控、日志、限流和失败重试。
继续配置 TradingAgents-CN
如果你还没确定 Base URL、模型和并发参数，先看对应配置页，再回到本文按步骤测试。
跑不通先查这些报错
量化工具接模型失败时，最常见是 Key、Base URL、模型名和限流问题。
参考资料
本文按中文教程常见结构重新组织，并围绕 QuickRouter 国内可直连 API 中转站场景重写。第三方资料只作为配置结构和排查思路参考。