Finterm 完全指南：给 Claude Code 装上 Bloomberg 终端，一句话查透金融数据

AI 编码 Agent 擅长写代码，但在处理金融数据时却很尴尬——让它查一家公司的财报，它要么胡编数字，要么抓取的网页内容杂乱无章。公司文件、SEC 申报、期权流、内部交易——这些结构化的金融数据对 Agent 来说就像一座信息迷宫。

Finterm（npm 包 @finterm-ai/cli）正是为解决这个痛点而生：它是一个 CLI 数据层，专为 AI 编码 Agent（Claude Code、OpenCode、ChatGPT 等）设计，将财报、市场数据、所有权流动和深度研究转化为结构化输出，一条命令即可调用。

本文带你从安装到实战，完整掌握 Finterm 的使用方法。

Finterm 是什么？

Finterm 的核心定位是「Claude Code 的 Bloomberg 终端」。它是一个 CLI 金融数据平台，Agent 通过命令行获取结构化的金融数据，无需硬编码 API 密钥、无需处理 HTML 解析、无需担心数据源碎片化。

与传统的财经 API 不同，Finterm 专为 Agent 上下文优化：

• 结构化输出：返回 YAML/JSON 格式，Agent 直接消费
• 去噪预处理：对爬取的 600-800 条链接自动过滤 AI 垃圾内容、SEO 作弊、转载文章
• 源标注：每条数据标注 Primary / Secondary / Boilerplate 等级别
• Agent 原生集成：支持 Claude Code 的 .claude/settings.json、OpenCode 插件等

安装

Finterm 是 npm 包，安装方式与普通 CLI 工具相同：

npm install -g @finterm-ai/cli

或者用 npx 直接运行：

npx @finterm-ai/cli@latest --help

安装后验证可用：

finterm --help

如果看到命令列表，说明安装成功。

快速上手：给 Claude Code 接入金融数据

Finterm 的使用流程只有三步：认证 → 配置 → 查询。

第一步：认证

finterm auth login

这会打开浏览器跳转登录页面，同时在终端打印登录链接（方便无桌面环境使用）。登录后会自动生成并保存 API 密钥。

查看认证状态：

finterm auth status

自动化环境中使用 --non-interactive 模式：

export FINTERM_API_KEY="your-api-key"
finterm auth status

第二步：集成到 Claude Code

Finterm 提供了自动化集成命令，一键安装 Agent 配置文件：

finterm setup --check

这会检查并配置 Finterm 与当前 Agent 的集成状态。支持的 Agent 包括 Claude Code、OpenCode、Cursor 等主流 AI 编码工具。

第三步：查询金融数据

现在你的 Claude Code 可以直接调用 Finterm 获取金融数据了。我们来试几个核心命令：

获取公司深度研究报告：

finterm bundle run company_deep_research NVDA \
  --param q=Q1 --param fy=2027 \
  --param prev_q=Q3 --param prev_fy=2026
finterm bundle wait 
finterm bundle download  --room ./datarooms/nvda

查询财报差异比较：

finterm tool sec_filing_diff NVDA \
  --base 2025:Q3 --compare 2026:Q1

输出包含清晰的逐节对比，如 MD&A 章节的收入变化、风险因素中的关税影响等。

检查期权市场情绪：

finterm tool options_overview NVDA

返回 P/C 比率、IV30、预期波动区间等数据。

核心命令详解

Finterm 的 CLI 分为两大模块：Bundle（研究报告包）和 Tool（单点数据工具）。

Bundle 命令

Bundle 是 Finterm 的核心——它执行一次完整的研究流程，包括搜索、爬取、去重、标注和结构输出。

目前发布的两个研究包：

• company_deep_research：异步网页研究报告，抓取 600-800 条链接，去重后保留核心内容
• ticker_data：一键式股票快照（也可通过 finterm tool ticker_data 快速调用）

Point Data Tool 命令

Tool 是单点查询，即时返回结果，无需等待异步处理：

开发者工具

反馈与排错

Finterm 内置了 CLI 反馈系统，无需离开终端即可报告问题：

finterm feedback bug "某命令返回空结果" --body "复现步骤..."
finterm feedback question "如何使用自定义数据源？"
finterm feedback feature-request "添加加密货币支持"

--dry-run 预览发送内容，--last 附加最近一次失败请求的上下文。

实战场景：让 Claude Code 做投资研究

以下是一个完整的工作流——让 Claude Code 使用 Finterm 做一家公司（以 NVIDIA 为例）的快速研究。

步骤 1：获取全面快照

向 Claude Code 发送指令：

用 Finterm 获取 NVIDIA 的全面数据快照

Claude Code 会执行 finterm bundle run ticker_data NVDA，返回一个结构化的 YAML 文件，包含：

• 财报数据（营收 570 亿美元净利润 47.6 亿 → 营收 816 亿净利润 583 亿，同比 +85%）
• 期权市场情绪（P/C 比率 0.72，IV30 36.9%，预期波动 ±8.7%）
• 技术指标（RSI / MACD / SMA）
• 内部交易（高管卖出约 3 亿美元）

步骤 2：对比财报变化

对比 NVIDIA 最近两个季度的 SEC 申报变化，特别是风险因素部分

Claude Code 调用 finterm tool sec_filing_diff NVDA --base 2025:Q3 --compare 2026:Q1，逐节返回差异：

• 营收从 570 亿增至 816 亿（+43%）
• H200 面临 25% 关税，中国区无 Hopper 出货
• 新投资 186 亿进入私有公司和基础设施基金

步骤 3：获取市场情绪

NVIDIA 最近的内部交易情况和期权情绪怎么样？

Claude Code 并行调用 insider_trades 和 options_sentiment，返回高管卖出记录和期权市场倾向。

环境变量与配置

Finterm 支持通过环境变量进行配置：

• FINTERM_API_KEY：API 密钥（跳过 auth login 直接在 CI/CD 中使用）
• FINTERM_API_URL：API 基础地址（默认为生产环境）
• FINTERM_CONFIG：配置文件目录覆盖（默认 ~/.finterm）

本地运行后的数据存储在 ~/.finterm/ 目录下，包含令牌、运行记录和最近的请求历史。

免费计划 vs 付费计划

Finterm 提供免费计划，这对个人开发者和学习用途已经足够。免费版支持所有 Tool 命令和 Bundle 基础功能。付费 Pro 计划提供更高的查询限额和并发研究能力。

免费用户同样可以使用 finterm feedback 提交反馈——该功能不消耗查询配额。

总结

Finterm 解决了一个实际的问题：AI 编码 Agent 在处理金融数据时的信息碎片化和幻觉问题。它将 Bloomberg 级别的金融数据通过 CLI 接口暴露给 Agent，让 Claude Code、OpenCode 和 ChatGPT 能够直接消费结构化的财报、市场情绪和深度研究数据。

对于做量化分析、投资研究的开发者来说，Finterm 是一个实用的工具——它把 Agent 从「编造数字」的尴尬境地中解放出来，让其真正成为金融数据的研究助手。

相关链接：

• GitHub 仓库
• npm 包 @finterm-ai/cli
• 官方网站