Claude DevTools
为 Claude Code 打造的调试工具，可视化还原终端里被隐藏的会话记录、工具调用、Token 用量与上下文窗口。
- Star 数
- ★ 4k
- 最近更新
- 23 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 56/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 当 Claude Code 显示'读取 3 个文件'但你不知道具体读了哪些文件时，用它查看确切的路径和内容。
- 不适合
- 只使用其他 AI 编程助手、不用 Claude Code 的开发者
- 希望用轻量 CLI 或纯网页工具、不想装 Electron 桌面应用的用户
- 需要分析 Claude Code v2.1.20 之前旧版日志格式的团队
- 源码审查
- 56/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
claude-devtools 是一款面向 Claude Code 的开源桌面应用（Electron 构建），它读取本机 ~/.claude/ 目录下已有的会话日志，将 Claude Code 中显示的摘要信息（如“读取 3 个文件”）还原为详细的文件路径、语法高亮内容和行号。它还提供工具调用检查器、子代理执行树、上下文窗口的分项 Token 归因、项目记忆 (MEMORY.md) 查看器以及 SSH 远程会话支持。该工具零配置、无需 API 密钥，不会包装或干扰 Claude Code 本体，支持 macOS、Linux、Windows 以及通过 Docker 进行独立部署（无出站网络调用）。
claude-devtools 直接读取 ~/.claude/ 下的 JSONL 会话日志，重构出每次用户与 Claude Code 交互的完整记录。它解析工具调用（Read、Edit、Bash 等），展示语法高亮的文件内容、内联差异和 Bash 输出；按 7 个类别（CLAUDE.md、技能、@提及文件、工具 I/O、思考、团队开销、用户文本）归因每轮 Token 消耗，并可视化上下文压缩时刻。它还渲染每个子代理的执行树（含 Token、时长、成本），支持 SSH 远程读取其它机器上的会话，并将项目记忆层以可点击索引的形式展示。所有消息和代码块均支持一键复制，并可导出为 Markdown、JSON 或纯文本；通过 Cmd+K 可进行跨会话搜索。
- 当 Claude Code 显示'读取 3 个文件'但你不知道具体读了哪些文件时，用它查看确切的路径和内容。
- 当你的 Claude 会话出现上下文压缩导致遗忘时，通过压缩可视化功能定位是什么占满了上下文窗口。
- 排查多代理协作或子代理任务失败时，展开每个子代理的执行树来定位问题环节。
- 需要将 Claude Code 的终端输出分享给同事时，用一键复制或导出 Markdown 功能避免格式混乱。
- 通过 SSH 连接远程服务器，检查远端 Claude Code 会话的运行情况，无需登录服务器。
如何安装或部署这个 Agent？
macOS 可通过 Homebrew 安装：brew install --cask claude-devtools，也可从 GitHub Releases 下载 .dmg（Apple Silicon 选 arm64，Intel 选 x64），首次打开需右键→打开。Linux 提供 .AppImage、.deb、.rpm、.pacman 格式，Windows 提供 .exe 安装包。Docker 部署：在项目目录运行 docker compose up，然后访问 http://localhost:3456；也可手动构建：docker run -p 3456:3456 -v ~/.claude:/data/.claude:ro claude-devtools。
如何使用这个 Agent？
安装并启动应用后，它会自动读取 ~/.claude/ 目录下的会话日志，无需额外配置。打开应用即可浏览所有历史会话；点击会话进入详情页，查看每条消息、工具调用、Token 统计和上下文可视化。使用 Cmd+K 进行跨会话搜索；侧边栏可访问项目记忆，点击某个记忆层可查看并可在编辑器中打开。SSH 远程会话功能可配置 ~/.ssh/config，支持 agent 转发和密钥认证。每条消息和代码块都有复制按钮，可在会话详情页导出 Markdown/JSON/文本。
这个 Agent 有哪些优点和局限？
- 零配置，直接读取现有日志，无需 API 密钥或修改 Claude Code。
- 可视化上下文窗口，按 7 个类别归因 Token，帮助定位上下文溢出。
- 实现子代理执行树，完整展示代理嵌套和工具追踪。
- 提供终端无法获得的详细工具调用、思考步骤和项目记忆。
- 仅适用于 Claude Code，对其他 AI 编码工具无直接支持。
- 依赖 Claude Code 2.1.20 之后的版本（日志格式与内容被简化）。
- 桌面版需要 Electron 环境，可能影响性能或安全审计。
- 有时需处理 SmartScreen 等系统安全警告（Windows）。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Claude DevTools 当前 | 56 · 缺口较多 | 桌面应用免费 | ★ 4k | 23 天前 | TypeScript | Claude Code |
| ccxray | 73 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 296 | 1 天前 | JavaScript | Claude Code · Claude API |
| Agents Observe | 55 · 缺口较多 | Agent 插件 / 技能免费 | ★ 698 | 1 个月前 | TypeScript | Claude Code |
| ccglass | 74 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 853 | 8 天前 | JavaScript | Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：应用读取本地~/.claude日志，无出站网络调用（除自动更新和SSH），IPC输入验证严格，路径包含检查，敏感凭据路径被拒绝。但用户确认机制薄弱，自动更新和SSH连接无需明确用户确认。数据流透明性有文档说明，但未提供代码级证据。敏感数据处理有路径限制，但未详细说明如何处理日志中的敏感信息。依赖安全仅通过package.json列出，未提供漏洞扫描或审计证据。外部影响包括自动更新和SSH，但文档明确。回滚机制未提及。来源归属明确，但发布者未验证。
证据显示：代码结构一致，测试覆盖IPC验证和全局搜索，但未提供失败消息的详细示例。依赖可用性通过package.json和CI配置体现，但未验证实际可用性。失败消息在测试中未充分展示。
证据显示：面向Claude Code用户，提供多种安装方式，支持多平台和Docker。能力边界明确（不包装Claude Code，只读日志）。触发精度在通知功能中有自定义正则，但未详细说明。环境适配良好，支持macOS/Linux/Windows/Docker。
证据显示：信息架构清晰，README详细，安装说明完整。命名稳定性未明确，版本号0.1.0。示例和FAQ较少，已知限制未明确列出。MIT许可证明确，版本变更日志存在。维护责任通过GitHub Actions和社区渠道体现。
证据显示：输出可用性高，提供多种导出格式和复制功能。边际价值高，解决Claude Code日志可视化问题。成本效益合理，免费开源，零配置。
证据显示：README中的声明部分有文档支持，但未提供代码级验证。跨来源佐证有限，仅依赖README和测试。事实与推断分离不明确，部分功能描述可能基于推断。
- 自动更新和SSH功能可能带来外部网络交互，用户需明确知晓。
- 依赖安全未提供漏洞扫描或审计证据，建议检查依赖版本。
- 发布者身份未验证，建议谨慎评估来源可信度。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v0.5.0 0.5.0
发布说明摘录
What's Changed * chore(deps-dev): bump vite from 5.4.21 to 6.4.2 in the npm_and_yarn group across 1 directory by @dependabot[bot] in https://github.com/matt1398/claude-devtools/pull/171 * docs: expand CHANGELOG with full release history and polish README by @matt1398 in https://github.com/matt1398/claude-devtools/pull/196 * fix: align session sidebar recency with file updates by @Arshgill01 in https://github.com/matt1398/claude-devtools/pull/193 * Feat/memory viewer by @matt1398 in https://github.com/matt1398/claude-devtools/pull/197 …在 GitHub 查看 ↗ -
v0.4.16 0.4.16
发布说明摘录
What's Changed * fix(discovery): list sessions from git worktrees by @Arshgill01 in https://github.com/matt1398/claude-devtools/pull/191 * feat(ssh): make SSH connection robust and self-diagnosing by @matt1398 in https://github.com/matt1398/claude-devtools/pull/192 New Contributors * @Arshgill01 made their first contribution in https://github.com/matt1398/claude-devtools/pull/191 Full Changelog: https://github.com/matt1398/claude-devtools/compare/v0.4.15...v0.4.16在 GitHub 查看 ↗ -
v0.4.15 0.4.15
发布说明摘录
What's Changed * fix(release): correct arch routing for macOS dmg + in-app updates by @matt1398 in https://github.com/matt1398/claude-devtools/pull/189 Full Changelog: https://github.com/matt1398/claude-devtools/compare/v0.4.14...v0.4.15在 GitHub 查看 ↗