X-ray goggles for Claude Code's API chatter

What it does

cc-viewer wraps the Claude Code CLI and intercepts every API request and response in real time, piping the raw payloads to a local web dashboard. You get a live view of your context window, token accounting, and the exact JSON flying between your machine and Anthropic’s servers—or a third-party proxy.

The interesting bit

The dashboard auto-labels Main Agent and Sub Agent traffic, then diffs each Main Agent JSON body against the previous turn so you can pinpoint exactly when your context window ballooned. It also ships a QR-code mode for mobile debugging over the LAN, which is either liberating or a warning about your work-life balance.

Key highlights

• Intercepts raw API payloads in real time, bypassing censored logs.
• Inline token accounting—input, output, cache creation/read, and hit rate—for every request.
• Diffs Main Agent JSON bodies across turns to highlight context drift.
• LAN sharing with password protection and a QR-code mobile view.
• Built-in proxy switching for third-party models (DeepSeek, GLM, Kimi) without external router tools.

Caveats

• Conflicts with claude-code-switch and claude-code-router due to proxy contention; you must disable them.
• Setup can be brittle on server-side or non-standard Claude Code deployments, and the official troubleshooting advice is to let Claude Code patch findcc.js itself.
• Passwords are base64-obfuscated rather than encrypted in a local preferences.json file.

Verdict

Worth installing if you treat Claude Code as a production tool and need to audit context bloat, token accounting, or proxy traffic. Skip it if you’re happy with the black-box CLI or rely on conflicting router tools.