CC-Viewer：Claude Code 请求监控台

项目简介

CC-Viewer（命令 ccv）是给 Claude Code 用的请求监控系统，会实时捕获并可视化所有 API 请求与响应，帮助开发者在 Vibe Coding 过程中查看 Context、复盘并调试。它是 claude 命令的直接替代品：启动时把参数原样透传给 claude，同时并行启动 Web 查看器。启动后网页会自动打开，也可访问 http://localhost:7008 查看监控界面。

默认以静默模式运行：终端输出保持和原生一致的干净体验，所有日志都在后台记录。

主要功能

• 请求监控：捕获 Claude Code 的请求与响应，在网页端查看会话日志、流式打字机效果和用量统计。
• 编程模式：编辑完成后可直接查看代码 diff；也支持手动打开文件和代码。
• 跨文件搜索：活动栏内置 VS Code 风格的搜索视图，支持关键字或正则、匹配大小写、整词匹配、include / exclude glob；使用 ripgrep（已安装时）加速，未安装则回退到内置扫描器。支持跨文件替换，正则模式支持 $1 / $& 捕获组。
• 定时任务：从 (+) 菜单打开 Scheduled tasks，可用预设（每小时 / 每天 / 工作日 / 每周）、自定义 5 段 cron 或一次性时间跑一个 prompt；既可注入当前活动会话，也可新开隔离的 headless 会话（仅 SDK 模式）。任务定义存在 preferences.json 的 scheduledTasks 键，运行历史保留最近 20 次。
• SDK 模式：ccv --sdk 通过 Agent SDK 运行会话，不再使用主 PTY，在浏览器里收发消息；Bash / Edit / Write / WebFetch 等审批以弹窗形式出现，支持允许、拒绝、本会话内允许。
• 日志模式：ccv -logger 适合继续使用原生 claude 或 VS Code 插件的用户，日志写入 ~/.claude/cc-viewer/<你的项目>/sessions/。
• 代理热重载：内置代理热切换，可为主 Agent、Sub-Agents、Teammates 分别指定代理来源。
• 可执行文件选择：在 Global Settings → Claude executable 里指定 CLI、ccv run -- claude 和桌面版使用的 Claude Code 安装位置，保存在 ~/.claude/cc-viewer/preferences.json 的 claudeExecutablePath。

安装与使用

前置条件：Node.js 20.0.0+，且已安装 claude code。

npm install -g cc-viewer --registry=https://registry.npmjs.org

macOS / Linux 也可以用 Homebrew：

brew tap weiesky/cc-viewer
brew install cc-viewer

启动方式与 claude 一致，参数全部透传：

ccv                    # 等同 claude 交互模式
ccv -c --d             # 等同 claude --continue --dangerously-skip-permissions
ccv --sdk              # headless SDK 模式，在浏览器里对话
ccv --sdk -c --model sonnet
ccv -logger            # 启用日志模式
ccv --uninstall        # 卸载日志模式
ccv -h                 # 查看其他辅助命令

更多说明见官网：https://weiesky.github.io/cc-viewer/ ，桌面版可从 releases 下载。

注意事项

• 与 claude-code-switch、claude-code-router 存在代理争用问题，使用时需要先关闭它们；cc-viewer 自带代理热重载可替代。
• 从 1.7.0 起日志改为按会话目录存储（wire-format v2），体积约小 90%。旧的 v1 .jsonl 文件不会被修改或删除，可用 ccv convert <project> 或 ccv convert --all 迁移，ccv verify <v1-file> 校验。
• 通过 Homebrew 或 pnpm 安装的，升级时请使用对应的包管理器，不要用 npm install -g 升级。
• 启动异常时，README 建议直接在 Claude Code 里让它检查并适配 cli.js 与 findcc.js。

---

本作品整理自 GitHub 开源项目 weiesky/cc-viewer，原作者 @weiesky，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。