Claude Code Stock Deep Research Agent 用 28 个并行研究智能体做 8 阶段尽调WebSearch、WebFetch 会在一轮长会话里反复触发Token 消耗比普通问答快得多。在 TaoTokenhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 Key配进 Claude Code 后同一个 Agent 的代码不用动报告照常输出。跑起来只需要在 Claude Code 里输入 /stock-research 命令例如 /stock-research AAPL, I want a quick overview28 个智能体分头搜最新消息、抓页面、做多空平衡和数据验证。这个项目作者此前开源过两个量化版本一个用 yfinance一个换 akshare 炒 A 股这次的 Deep Research 版本不再依赖历史行情表而是从网上实时信息里做投资尽调宏观因素、地缘消息、财报数据都要抓。研究框架在 README 里写得很清楚8 阶段尽调方法、28 个并行研究智能体、WebSearch/WebFetch/综合分析三种工具。标题里说“放弃了量化”其实是把重心从回测转向了公开信息的深度处理。问题也随之而来长会话里每个智能体每次工具调用都要计费官方 API Key 的额度一旦用完整套研究流程就断在中间。1. 28 个并行智能体的 Token 账单先想清楚再跑1.1 8 阶段尽调不是简单的“多搜几轮”这个项目不只是一段提示词加几次搜索。它把尽调拆成 8 个阶段每个阶段有明确产物阶段之间还要做多空平衡一组研究智能体专门收集看多材料另一组专门收集看空材料最后放在一起对冲避免模型只挑有利于结论的信息。数据验证也不是“读一遍网页摘要”而是用 WebFetch 抓原始页面再跟 WebSearch 返回的结果做交叉比对。这套流程跑一次Agent 的思考链很长但输出质量确实比普通问答高出一个量级。作者之前的两个版本数据源是结构化的行情表和财报字段Token 消耗相对可控。到了 Deep Research 版本数据源变成了互联网上不断变化的网页智能体要从大量页面里筛出有效信息再按 8 个阶段逐个汇总。这个差异决定了它的 Token 消耗会明显高于前两个版本。理解这一层你就明白为什么跑这个 Agent 之前先把通道问题解决掉比急着改 prompt 更重要。1.2 长会话里的计算方式不是“一条消息多少钱”Claude Code 长会话的计费单位是整段思考链不是单条消息。28 个并行智能体也不是每人只搜一次就收工而是每个阶段都要经历“搜索 → 抓取 → 汇总 → 对撞”的循环。把每个智能体想象成一个外出调研的研究员WebSearch 是给总部打一通电话WebFetch 是把一叠网页传真回来电话和传真都按页计费一整轮尽调跑下来几十次甚至上百次工具调用并不夸张。官方额度是按账号维度计算的额度触顶时最尴尬的不是不能继续聊而是报告刚好跑到中间阶段格式化输出被截断只能从头再来。TaoToken 的定位是统一 API 兼容通道跑长任务时用独立 Key 管理用量至少不会因为一个账号的额度上限卡住整条流水线。它的 API 形式与 Anthropic 兼容Claude Code 发出去的请求体没有变化Agent 拿到的响应也一样所以项目代码完全不需要改。2. 在 TaoToken 创建 Key再把 Claude Code 指过去2.1 打开 TaoToken 创建 API Key先去 TaoToken 注册并创建 API Key。官网提供模型广场、用量记录和 API Keys 管理注册后创建一把 Key复制下来本文统一用 YOUR_API_KEY 占位。这个开源项目仓库是公开的Key 不要写进会被 git 追踪的文件里更不要提交到 GitHub。创建 Key 时给个容易识别的名字比如 stock-research-local方便后面和 Coding Plan 的 Key 区分。TaoToken 控制台可以随时吊销重建万一 Key 泄露第一时间去控制台删掉重发。2.2 项目级 settings.json 的 env 配置Claude Code 支持在项目根目录放.claude/settings.json里面的env会作为当前项目的环境变量注入。找到这个开源项目的根目录没有.claude目录就自己建一个写入{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY } }ANTHROPIC_BASE_URL是 Claude Code 发请求的接口地址这里填https://taotoken.net/api末尾不要加/v1。Claude Code 的 SDK 会自动处理版本路径如果你手滑加了/v1后面会拼出重复的路径段直接 404。ANTHROPIC_AUTH_TOKEN填刚才那串YOUR_API_KEY它对应请求头里的 Bearer 认证。环境变量作用填什么ANTHROPIC_BASE_URL接口基地址https://taotoken.net/apiANTHROPIC_AUTH_TOKEN认证令牌YOUR_API_KEYANTHROPIC_MODEL模型 ID选填以模型广场列表为准如果想显式指定模型在这里补一行ANTHROPIC_MODEL模型 ID 以 TaoToken 模型广场当时列表为准不写也能用默认模型先跑。settings.json是合法 JSON 文件不能带注释示例里省略了其他可选字段保存前检查一下逗号和引号。注意项目级settings.json只对当前目录生效。想让所有项目都走 TaoToken可以改用户级配置~/.claude/settings.json两处同时存在时项目级优先。2.3 官网和接口地址是两回事官网落地页负责注册、创建 Key、看模型广场和用量统计真正填进 Claude Code 的是接口地址https://taotoken.net/api。这两个地址用途不同别在设置文件里放官网地址也不要在浏览器里直接打开接口地址。配置保存后重启 Claude Code或在对话窗口执行/status确认环境变量已生效。3. 用 /stock-research 命令跑完并检查报告3.1 在 Claude Code 对话框里敲斜杠命令这个项目的入口是斜杠命令不是终端命令别拿到 shell 里跑。在 Claude Code 对话框输入/stock-research AAPL, I want a quick overview想要换成自己的标的把AAPL换成对应代码即可后面的英文描述保留它告诉 Agent 要快速概览还是完整尽调。你也可以追加要求例如include a valuation comparisonAgent 会把这些写进对应阶段的任务里。3.2 Agent 的行为和输出命令发出后对话区会出现多个并行任务市场分析师在搜、研究员在抓页面、审核智能体在比对多空材料。肉眼看起来跟官方通道跑这个 Agent 完全一样因为 TaoToken 走的是 Anthropic 兼容协议模型拿到的提示词没有变化。最终报告里应该能看到信号评级、投资论点、风险提示、数据验证四个部分项目自带免责声明报告只供研究学习不构成投资建议。建议让 Claude Code 用 Write 工具把报告存成 Markdown 文件放在reports/目录方便对照之前的版本。8 个阶段全部走完需要一段时间期间不要在同一个会话里插入无关问题长上下文会被无关对话稀释。3.3 模型 ID 不对时会发生什么如果你补了ANTHROPIC_MODEL但填的是一个官方命名、TaoToken 模型广场里没有的 IDClaude Code 会在请求阶段就报错根本走不到 Agent。遇到这种情况回到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场按当时列表复制一个可用模型 ID 再试。这个报错格式和 Anthropic 官方 API 的提示一致排查起来不算难。4. 401、404、模型不存在连接报错对号入座4.1 401 认证失败和模型不存在的区别401 authentication_error是密钥层面的问题settings.json里ANTHROPIC_AUTH_TOKEN还是YOUR_API_KEY占位符或者复制 Key 时多带了一个换行符。重新去控制台复制一次即可不用改其他配置。另一种常见报错是invalid model或model not found这就不是密钥问题了而是ANTHROPIC_MODEL里的值不在模型广场列表中按 3.3 的方式处理。遇到报错先看状态码401 一定是 Key 的问题4xx 里带 model 关键词的一定是模型 ID 的问题。不要一上来就怀疑 Base URL改来改去反而把配置弄乱。4.2 Base URL 多写 /v1 导致 404Claude Code 自己会拼/v1你只需要写https://taotoken.net/api。如果填成https://taotoken.net/api/v1SDK 可能拼出/v1/v1之类的路径表现是请求发出后立刻 404、页面不存在。看着像网关问题其实是地址重复。另外有些 Claude Code 插件会在settings.json里自动写一个官方地址手动改成上面那一行就行改完重启一次。4.3 中途中断后怎么恢复长会话报告跑到一半中断不用从头开始。重新打开 Claude Code在项目根目录执行claude --continue恢复上一个会话或使用/resume选择历史会话。已经生成的中间结论会回到上下文里但 WebSearch 的缓存结果不会被持久化恢复后 Agent 可能会重新抓取部分网页产生一小段额外消耗。控制台能看到这次运行的调用记录用它估算重跑成本比较直接。5. 报告生成后回控制台对一下这次的调用5.1 用同一把 Key 做一次快速验证再看用量报告跑完后建议先在 模型对话 里用同一把 Key 发一条测试消息确认 Key 状态正常再到 控制台 API Keys 看这次/stock-research调用记到了哪把 Key 上。用量列表里能看到日期、模型 ID、请求次数和 Token 消耗这轮尽调的真实成本会非常直观。如果你打算长期在 Claude Code 里跑研究型 Agent可以打开 Coding Plan 看看套餐是否更合适环境变量对照表在 Claude Code 接入文档 里也有。5.2 下一步改 Agent 的方向项目本身完全开源跑通之后可以按自己的标的调整 8 个阶段的提示词做 A 股就把数据源换成 akshare 相关工具做港股保留 yfinance或者像作者那样只保留宏观信息源。每一处修改不用动框架代码只改对应阶段的 prompt 和它允许的工具集。等你跑完一次完整尽调再回控制台看调用记录对“长会话成本”会有非常具体的体感。报告只做研究学习不要当成买卖依据。
