cctrace

See what Claude really sends.

看看 Claude 到底发了什么。

LLM tracing — what Claude Code sends and receives each turn. Security & privacy tracing — what actually leaves your machine. One command. Traces the Codex, Grok, and Kimi Code CLIs too.

LLM 追踪：Claude Code 每轮到底发送和接收了什么。 安全/隐私审计：哪些请求出站、去了哪些 host、payload 里带了什么。一行命令。也支持追踪 Codex、Grok 和 Kimi Code CLI。

$ npm install -g @thevibeworks/cctrace

or bunx @thevibeworks/cctrace to run without installing 或 bunx @thevibeworks/cctrace 直接运行，无需安装

Full picture

完整全貌

Captures /v1/messages, OAuth, usage/credits, MCP registry, bootstrap, and telemetry — not just the chat endpoint.

捕获 /v1/messages、OAuth、用量/额度、MCP registry、bootstrap、遥测 — 不只是聊天端点。

Live categorized UI

实时分类界面

Filter chips with live counts, colored category badges, expandable headers and bodies, decoded SSE streams. System, light, and dark themes.

带实时计数的筛选标签、彩色分类徽章、可展开的 headers/bodies、解码后的 SSE 流。支持跟随系统、浅色和深色主题。

Sessions, reconstructed

重建的会话

The conversation on one rail: threads with per-turn cost and latency, subagents attached at the turn that spawned them, model switches as epochs, compactions as break nodes with the context collapse in turns and tokens, superseded exchanges kept at their timeline position. Plus time-travel replay; view --html exports a self-contained snapshot.

对话在一条轨道上重建：线程带每轮成本与延迟，子代理挂在派发它的回合下， /model 切换成为 epoch，compact 压缩成为断点节点（上下文收缩了多少回合/ token 一目了然），被覆盖的交互保留在原本的位置。外加时间轴回放； view --html 可导出自包含快照分享。

Scoped interception

有边界的拦截

First-party hosts are decrypted; everything else your session touches — npm, GitHub, apt — passes through as an opaque byte-counted tunnel. An audit trail without the payload copies; --capture-external when you need every byte.

只解密第一方主机；会话触碰到的其他主机 — npm、GitHub、apt — 以不解密的字节计数隧道通过：留下审计线索，不复制 payload。需要全量时用 --capture-external。

Safe by default

默认安全

Credentials are redacted from headers, bodies, and URLs before anything hits disk. Your API keys stay your API keys.

凭据在落盘前就已从 headers、bodies 和 URL 中脱敏。你的 API key 还是你的 API key。

Zero config

零配置

Auto-generates a CA, auto-detects your Claude install, and captures everything by default. Run cctrace and you're done.

自动生成 CA、自动识别 Claude 安装、默认捕获全部。运行 cctrace 就完事了。

Coming soon

即将推出

Full interception 完整拦截 Dynamic certs for all hosts — Datadog, MCP servers, everything 为所有主机动态生成证书 — Datadog、MCP 服务器，全覆盖
Smart categories 智能分类 Count Tokens separated from Messages, External host filter Count Tokens 独立于 Messages，外部主机筛选
Copy + token summary 复制 + Token 摘要 Copy button on JSON blocks, token usage bar on message pairs JSON 块复制按钮，消息请求的 token 用量摘要栏
Sessions view 会话视图 Split-pane: wire view + reconstructed conversation side by side 分屏模式：原始请求 + 还原的对话并排显示
Codex, Grok & Kimi support Codex、Grok 与 Kimi 支持 cctrace codex / cctrace grok / cctrace kimi / cctrace opencode — same MITM front door, per-request dialect detection (Anthropic, OpenAI Responses, Chat Completions) cctrace codex / cctrace grok / cctrace kimi / cctrace opencode — 同一套 MITM 前门，按请求识别方言（Anthropic、OpenAI Responses 与 Chat Completions）
Token metrics Token 指标 Per-request cost estimates, cache verdicts, usage-limit bars, first-token latency 每请求费用估算、缓存判定、用量限额进度条、首 token 延迟
Agent skill Agent Skill skills/cctrace teaches coding agents to drive cctrace and read traces skills/cctrace 让编码代理会用 cctrace、会读 trace
Sessions layer Sessions 层 0.18: sessions > threads > turns on one rail — epochs, subagent branches, compaction boundaries, superseded exchanges 0.18：sessions > threads > turns 一条轨道 — epoch、子代理分支、compact 断点、被覆盖的交互
Kimi Code client Kimi Code 客户端 0.19: cctrace kimi — Chat Completions dialect, prompt_cache_key session identity, auto-compaction boundaries, pay-per-token cost estimates 0.19：cctrace kimi — Chat Completions 方言、prompt_cache_key 会话标识、自动 compact 分界、按量计价的费用估算
Showcase trace 示例 trace A real (sanitized) session published here — browse the Sessions view without installing 在这里发布一份真实（已脱敏）的会话 — 无需安装即可体验 Sessions 视图
Conversation dump 对话导出 Export reconstructed conversations as Markdown or JSON 将还原的对话导出为 Markdown 或 JSON
Timed replay 计时回放 --record-timing: replay streams at their captured chunk cadence --record-timing：按捕获时的分块节奏回放流式输出