Claude Code Viewer 是一个开源的 Web 端客户端，用于管理 Claude Code 会话历史和分析对话流程。它支持会话日志查看、全局搜索、新会话发起、继续会话机制、项目管理、文件上传预览、浏览器嵌入、消息定时发送、Git 集成及多语言支持。相比官方方案，它更适合本地环境配置、Monorepo 项目及需要自托管的场景。支持通过 npm 或 Docker 部署，基于 Node.js 运行。
当 Claude Code 成为日常开发标配，如何更高效地管理会话历史、分析对话流程就成了开发者的新需求。Claude Code Viewer 应运而生——一个功能完备的 Web 端 Claude Code 客户端。
Claude Code 是 Anthropic 推出的 AI 编程助手，但其原生的会话管理能力相对基础。大多数开发者面临以下痛点：
Claude Code Viewer 正是为解决这些问题而生的开源项目。它采用 Web 架构设计，专注于会话日志的完整分析，通过严格的数据校验和渐进式展示 UI，让每一个对话细节都清晰可见。
Claude Code Viewer 直接读取 Claude Code 的标准日志格式（~/.claude/projects/<project>/<session-id>.jsonl），实时展示会话内容。支持历史日志浏览，新会话会自动被发现。
支持跨会话全文检索，快捷键 ⌘K (macOS) / Ctrl+K (Linux) 即可唤起搜索框。功能包括：
直接在 Web 界面启动 Claude Code 会话，享受完整的文件/命令补全、暂停/恢复、工具授权等功能体验。
独特的继续会话机制：通过 Claude Code Viewer 启动的会话会保持存活状态（除非手动终止），无需重新加载 session-id 即可持续对话，避免了传统 resume 方式的状态丢失。
/init 命令完成初始化支持直接上传图片（PNG、JPEG、GIF、WebP）、PDF 和文本文件。每种文件类型都有专门的预览组件：
在聊天界面右侧嵌入可调整大小的浏览器面板，预览任何 URL。支持：
支持 cron 表达式设置周期性任务，或指定具体时间执行一次性任务。特性包括：
内置 Git 功能，让代码审查和提交流程完全在 Web 端完成：
TodoWrite 项，以可折叠清单形式展示监控 Claude Code 和 Claude Code Viewer 的版本、特性兼容性和系统状态。
完整的国际化支持，涵盖：
直接运行，无需安装：
npx @kimuson/claude-code-viewer@latest --port 3400
或全局安装：
npm install -g @kimuson/claude-code-viewer
服务启动后，访问 http://localhost:3400 即可。
命令行选项：
claude-code-viewer [options]
Options:
-p, --port <port> 端口号 (默认：3000)
-h, --hostname <hostname> 主机名 (默认：localhost)
-P, --password <password> 认证密码
-e, --executable <executable> Claude Code 可执行文件路径
--claude-dir <claude-dir> Claude 目录路径
--api-only API 纯响应模式（无 Web UI）
构建镜像：
docker build -t claude-code-viewer .
运行容器：
docker run --rm -p 3400:3400 \
-e PORT=3400 \
-e CCV_PASSWORD=your-password \
claude-code-viewer
或使用 Docker Compose：
docker compose up --build
⚠️ 注意：默认的 docker-compose.yml 没有挂载
claude_home。如需复用本地 Claude 工作区，需配置 volume 映射：
Anthropic 官方提供 Claude Code on the Web，在云端虚拟机中运行会话。
适合使用官方方案的场景：
适合使用 Claude Code Viewer 的场景：
社区也涌现了不少优秀的 Web 客户端，如 sugyan/claude-code-webui、wbopan/cui、siteboon/claudecodeui 等。
Claude Code Viewer 的差异化优势：
| 特性 | 说明 |
|---|---|
| 零信息丢失 | Zod 严格校验，确保每个对话细节都被保留 |
| 渐进式展示 | 可展开元素和子会话弹窗，管理信息密度 |
| 内置 Git 操作 | 完整 Diff 查看器，支持直接提交 |
| 会话流程分析 | 跨多会话的完整对话追踪 |
| 系统监控 | 实时版本和特性兼容性监控 |
| 国际无障碍 | 多语言支持 |
Claude Code Viewer 从设计之初就考虑了远程托管场景：
基础密码认证可通过 --password 或 CCV_PASSWORD 环境变量启用。如需更复杂的认证方案，建议在基础设施层面实现（如反向代理 OAuth、VPN、IP 白名单）。
Claude Code Viewer 为开发者提供了一个强大且灵活的 Web 端会话管理解决方案。无论你是需要：
Claude Code Viewer 都能满足你的需求。其开源免费、特性丰富且持续活跃维护，值得一试。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online