@ciandt-flow/flow-ai-obs

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

Claude Code hooks for Langfuse OTLP tracing — cross-platform

原始使用文档
文档目录5 节
  1. Requirements
  2. Quick Start
  3. CLI Commands
  4. init flags
  5. License

flow-ai-obs

Automatic observability for Claude Code sessions — powered by Flow by CI&T.

flow-ai-obs configures Claude Code's native OpenTelemetry integration to report metrics and logs to Flow, authenticated with a single FLOW_API_KEY — no proxy, no separate login step.

  • Native OTEL metrics and logs — Claude Code reports directly, no hooks or subprocesses involved
  • Zero-friction auth — one environment variable (FLOW_API_KEY), no interactive login
  • Direct mode (opt-in) — send traces straight to your own Langfuse instance via FLOW_TELEMETRY=true (see docs/work-modes/)

Requirements


Quick Start

# 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

That's it. Claude Code now reports metrics and logs automatically via native OpenTelemetry.


CLI Commands

CommandDescription
flow-ai-obs initConfigure environment: native OTEL telemetry for Claude Code
flow-ai-obs statusShow current authentication and observability configuration
flow-ai-obs updateUpdate to the latest version

FLOW_API_KEY is the only supported authentication method — there is no login command.

init flags

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

License

This package is proprietary software by CI&T Inc., made available on the npm public registry for use within authorized CI&T products and services.

版本与发布记录

@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 tracing — cross-platform

如何安装 @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 和提交记录判断。