@ciandt-flow/flow-ai-obs

中文文档
1.1.0发布于 2026/11/17SEE LICENSE IN LICENSE.mdCommonJS零依赖近 30 天下载 8951

Claude Code hooks for Langfuse OTLP tracking — 跨平台

中文使用文档
文档目录5 节
  1. 所需资源
  2. 快速启动
  3. CLI 命令
  4. 内置旗帜
  5. 许可证

流线

Claude 代码会话的自动可观察性——由 CI&T 的流量。 。 。 .

flow-ai-obs 配置 Claude 代码的本地 OpenTeleometry 集成, 以报告参数和日志到 Flow, 并用单个参数认证 FLOW_API_KEY ——没有代理,没有单独的登录步骤.

  • 原生的OTEL计量和日志 ——克洛德代码直接报告,不涉及钩子或子进程
  • 零冷冻剂 - 一个环境变量(FLOW_API_KEY,无交互式登录
  • 直接模式( opt- in) - 直接向自己的Langfuse实例发送痕迹 FLOW_TELEMETRY=true (见 docs/work-modes/(中文(简体) )

所需资源


快速启动

# 1. Set your Flow API key (see your Flow tenant's setup guide for where to get it)
export FLOW_API_KEY="<YOUR_FLOW_API_KEY>"

# 2. Install globally
npm install -g @ciandt-flow/flow-ai-obs

# 3. Run init — configures native OTEL telemetry for Claude Code
flow-ai-obs init

# 4. Verify
flow-ai-obs status

就是这样。 Claude Code现在通过本地OpenTeleometter自动报告测量和日志.


CLI 命令

命令说明
flow-ai-obs init配置环境:克劳德代码的本地 OTEL 遥测
flow-ai-obs status显示当前认证和可观察性配置
flow-ai-obs update最新版本的更新

FLOW_API_KEY 是唯一支持的认证方法——没有 login 命令.

内置旗帜

flow-ai-obs init --custom-url https://your-tenant.ciandt.com   # custom domain
flow-ai-obs init --no-interactive                               # CI/CD mode

许可证

这个软件包是由CI&T Inc.提供的专有软件,在npm公共登记册上提供,用于授权的CI&T产品和服务.

版本与发布记录

@ciandt-flow/flow-ai-obs 共发布 124 个版本,首次发布于 2026/04/20;过去 12 个月发布了 124 个版本。

版本发布日期距今
1.1.0latest2026/11/17今天
1.1.0-beta.172beta2026/11/17今天
1.1.0-beta.1692026/11/17今天
1.1.0-beta.1662026/11/17今天
1.1.0-beta.1642026/11/16今天
1.0.1-beta.1582026/11/134 天前

关于 @ciandt-flow/flow-ai-obs 的常见问题

@ciandt-flow/flow-ai-obs 是什么?

Claude Code hooks for Langfuse OTLP tracking — 跨平台

如何安装 @ciandt-flow/flow-ai-obs?

在项目目录运行 npm install @ciandt-flow/flow-ai-obs,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 flow-ai-obs、flow-ai-obs-setup,可以用 npx flow-ai-obs 直接运行。

@ciandt-flow/flow-ai-obs 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/ciandt-flow__flow-ai-obs 是否存在。

@ciandt-flow/flow-ai-obs 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@ciandt-flow/flow-ai-obs 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@ciandt-flow/flow-ai-obs 可以商用吗?

@ciandt-flow/flow-ai-obs 使用 SEE LICENSE IN LICENSE.md 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@ciandt-flow/flow-ai-obs 的下载量有多少?

根据 npm 官方下载统计,@ciandt-flow/flow-ai-obs 在 2026/10/10 – 2026/11/08 这 30 天内被下载 8,951 次,日均约 298 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@ciandt-flow/flow-ai-obs 还在维护吗?

最新版本 1.1.0 发布于 2026/11/17(今天);至今共发布 124 个版本,其中过去 12 个月发布了 124 个;首次发布于 2026/04/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。