delexw/claude-code-trace helps add AI capability without starting from a blank model stack

说明与用途

**项目简介**
delexw/claude-code‑trace 是一款用于查看 ~/.claude/projects 目录下 JSONL 会话日志的工具，支持在桌面、浏览器以及 TUI 中浏览 Claude Code 对话、工具调用、 token 消耗，并可实时 tail 会话。

**价值**

• **快速赋能 AI 功能**：无需自行搭建模型堆栈，直接读取 Claude Code 的会话日志即可进行原型验证、RAG/Agent 工作流调试或工具链评估。
• **多端统一视图**：桌面、Web 与终端三种 UI 同时可用，方便不同角色（开发者、产品、运维）统一查看和分析。
• **实时监控**：支持 live‑tail，帮助在调试阶段即时捕获模型输出和工具调用细节，提升迭代效率。

**典型接入方式**

1. **依赖安装**：项目基于 Rust，使用 cargo install claude-code-trace 或下载预编译二进制。
2. **配置路径**：确保 Claude Code 将日志写入 ~/.claude/projects/*.jsonl（默认行为），或在启动时通过 --log-dir 指定自定义目录。
3. **启动方式**

• **桌面/Web**：claude-code-trace --mode gui（会启动本地 Electron/wasm 前端）。
• **TUI**：claude-code-trace --mode tui（在终端直接交互）。
• **实时 tail**：claude-code-trace --tail，配合 CI/CD 或本地调试脚本使用。

1. **集成到 CI**：在测试脚本结束后调用 claude-code-trace export --format html 生成可视化报告，供团队审阅。

**生产可用性**

• **成熟度**：GitHub ★271，最近一次更新 2026‑05‑11，代码以 Rust 编写，社区活跃度一般。
• **适用场景**：内部原型、研发调试、日志审计等 **中等** 可靠性需求。
• **风险与准备**
• 依赖链相对简单，但需自行管理 Rust 环境和二进制分发。
• 文档主要在 README，缺少完整的 CI/CD 集成示例，建议先做 **POC**（如在开发分支集成一次日志可视化），确认部署成本与安全合规后再推广。
• 生产环境使用前，建议：

1. 对日志目录进行访问控制。
2. 评估二进制的安全签名与更新策略。
3. 在非关键业务上做容错测试（如日志滚动、异常退出恢复）。

综上，delexw/claude-code-trace 能显著降低 AI 功能原型的搭建门槛，适合作为内部研发或实验平台的日志可视化组件；在经过小规模验证并做好依赖与安全审查后，可逐步推广到生产环境。

问题

delexw/claude-code-trace helps add AI capability without starting from a blank model stack.

结果

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.

工作流

• prototype AI features
• build RAG or agent workflows
• evaluate model tooling

证据

Claude Code session log viewer for JSONL files in ~/.claude/projects. Browse conversations, tool calls, tokens, and live tail sessions on desktop, web, and TUI.

来源