weiesky/cc-viewer

CC‑Viewer – Claude Code 的可视化前端与助手

是什么 – CC‑Viewer（以 ccv 命令安装）是 Anthropic 的 Claude Code CLI 的轻量包装器。它启动相同的后端可执行文件，同时还启动一个本地 Web UI，显示会话、日志、文件差异、搜索及其他开发辅助功能。可以把它想象成 Claude Code 的“远程桌面”，让你能从任何浏览器（甚至手机）查看和控制编码会话。

主要功能

• 直接替代 – ccv 将所有参数转发给底层的 claude 二进制文件，因此现有的 Claude Code 脚本可以继续工作。
• Web 查看器 – 会话启动时，浏览器选项卡会打开（默认 http://localhost:7008）。UI 显示实时聊天、代码差异、文件资源管理器、搜索和替换，以及用于移动设备的二维码共享。
• SDK / 无头模式 – ccv --sdk 通过 Claude Agent SDK 运行会话；UI 仅发送消息，CLI 端则隐藏。
• 日志模式 – ccv -logger 将每个 Claude Code 请求记录在按会话划分的目录中（wire-format v2），提供完整、未经删减的交互日志。
• 密码/令牌保护 – 远程 LAN 访问可用短自动生成密码或一次性 ?token= URL 保护。密码加密存储在磁盘上。
• 容器/云就绪 – 服务器默认绑定到 0.0.0.0，因此可以在 Docker 或云虚拟机中运行。管理操作仅在令牌/密码认证后允许。
• 系统提示词管理器 – UI 允许你编辑按模型划分的系统提示词，这些提示词会在启动时自动注入。
• 搜索和替换 – 内置 VS Code 风格的工作区搜索，在可用时使用 ripgrep。

如何获取

• 通过 npm（npm i -g cc-viewer）、Homebrew（brew install cc-viewer）或 pnpm（pnpm add -g cc-viewer）全局安装。
• 确保已安装 Node 20+ 和 Claude Code 二进制文件。
• 运行 ccv（或常规用法 ccv -c --d），UI 将自动出现。

典型工作流程

1. 使用 ccv … 启动 Claude Code 会话。
2. 浏览器 UI 显示聊天以及 Claude 所做的任何文件编辑的实时差异。
3. 使用侧面板搜索、替换或直接打开文件。
4. 扫描显示的二维码，从手机继续会话。
5. 完成后停止进程；日志保存在 ~/.claude/cc-viewer/… 下，供日后查看。

为何重要 – Claude Code 是强大的 LLM 驱动的编码助手，但默认 CLI 仅限终端。CC‑Viewer 增加了可视化、跨设备界面和强大的日志记录，使团队或个人开发人员更容易监控、审计和共享 AI 辅助编码会话。

许可证 – MIT。