claude-devtools：让 Claude Code 编程过程不再黑盒的开源调试工具-壹联网络

Claude Code 是一款强大的 AI 编程助手，但从 v2.1.20 开始，它将详细操作输出替换成了不透明的单行摘要。你只能看到「读取了 3 个文件」「搜索了 1 个模式」「编辑了 2 个文件」——没有文件路径、没有内容、没有行号。更深层的问题是：Claude 的思维链推理过程在终端中完全不可见，子代理活动只显示最终结果，Token 消耗只能看到一个三段式进度条。claude-devtools 正是来解决这个痛点的。

项目地址：https://github.com/matt1398/claude-devtools

超过 3000 颗星，支持 macOS、Linux、Windows 和 Docker。

核心问题

Claude Code 从某个版本开始隐藏了详细的操作过程，这让开发者面临几个关键困境：

思维步骤不可见——Claude 的思维链推理（chain-of-thought reasoning）在终端中完全隐藏；工具调用详情缺失——只能看到一行摘要，无法看到实际输入输出；子代理活动黑盒——子代理 Spawn 子代理，但你只能看到最终结果；Token 消耗不透明——三段式进度条没有详细分类，不知道哪些内容在消耗 Token。

唯一的临时解决方案是 –verbose 模式，但这会倾倒大量原始 JSON、内部系统提示和数千行噪音信息，没有任何中间地带。

解决方案

claude-devtools 读取本地 ~/.claude/ 目录中已存在的会话日志，重建出完整的信息。它不需要任何配置、不需要 API Key、不需要任何包装器，与你已有的所有会话兼容。

终端隐藏的内容 vs claude-devtools 展示的内容对比：

「读取了 3 个文件」 → 精确的文件路径、带行号和语法高亮的文件内容；「搜索了 1 个模式」 → 正则表达式模式、每个匹配的文件、匹配的行内容；「编辑了 2 个文件」 → 内联 Diff 视图，增加/删除行高亮显示；三段式上下文窗口 → 7 个分类的逐轮 Token 归属，包括 CLAUDE.md、skills、@-mentioned 文件、工具 I/O、thinking、团队开销、用户文本；折叠的子代理输出 → 每个代理的完整执行树，含工具追踪、Token、耗时和成本；Thinking 内容完全不可见 → Thinking 内容完整展示。

核心特色功能

1. 上下文重建

逐轮 Token 归属分 7 个类别：全局/项目/目录级 CLAUDE.md、Skills、@-mentioned 文件、工具 I/O、thinking 内容、团队开销、用户文本。你可以清楚看到上下文窗口里每个时刻具体放了什么。

2. 压缩可视化

可视化展示上下文达到限制的时刻——清楚呈现上下文如何填充、压缩和重新填充，让你准确知道哪些内容被遗弃。

3. 通知触发器

可配置系统通知，触发条件包括：.env 文件被访问、工具执行出错、Token 使用量过高、自定义正则匹配任何字段等。

4. 工具调用检查器

每个工具调用都有专门的查看器：语法高亮的 Read 调用、内联 Edit Diff、Bash 输出和完整的子代理树。

5. 团队和子代理树

每个代理有独立的执行树，含工具追踪、Token 指标、耗时和成本。嵌套代理递归渲染。

6. SSH 远程会话

通过 SSH 检查任何远程机器上的会话，读取 ~/.ssh/config，支持 SSH Agent 转发和密钥认证。

7. 命令面板和多窗格布局

Cmd+K 跨会话搜索。多会话并排显示，支持拖拽分标签页。

安装方法

Homebrew（macOS）

brew install –cask claude-devtools

直接下载

macOS（Apple Silicon）：下载 .dmg 文件（arm64 版本），拖到 Applications 目录，首次打开需右键选择「打开」；macOS（Intel）：下载 .dmg 文件（x64 版本）；Linux：.AppImage / .deb / .rpm / .pacman 格式，根据发行版选择；Windows：标准安装程序，首次可能触发 SmartScreen，点击「更多信息」→「仍要运行」即可。

Docker 部署

docker compose up

# 然后访问 http://localhost:3456

独立 Docker 部署命令：

docker build -t claude-devtools .

docker run -p 3456:3456 -v ~/.claude:/data/.claude:lo claude-devtools

环境变量说明：CLAUDE_ROOT 默认 ~/.claude；HOST 默认 0.0.0.0；PORT 默认 3456。独立服务器零出站网络呼叫，配合 –network none 可实现最大隔离。

源代码构建

前置条件：Node.js 20+，pnpm 10+

git clone https://github.com/matt1398/claude-devtools.git

cd claude-devtools

pnpm install

pnpm dev

常用命令：pnpm dev（热重载开发）；pnpm build（生产构建）；pnpm typecheck（TypeScript 类型检查）；pnpm test（运行所有测试）；pnpm check（完整质量门禁：类型检查 + Lint + 测试 + 构建）。

适用场景

AI 编程调试——需要了解 Claude 代码生成细节时；大型项目开发——需要追踪多轮对话中的上下文变化时；代码审查——需要逐工具验证 AI 执行路径时；性能优化——需要分析 Token 消耗分布时；团队协作——需要了解子代理工作分配时。

开源协议

MIT 开源许可协议，可免费用于个人和商业项目。

总结

claude-devtools 为 Claude Code 提供了缺失的透明度层。它不修改、不包装 Claude Code，只是读取本地的会话日志并以可视化方式重建所有被隐藏的信息。对于重度使用 Claude Code 的开发者来说，这是一个能大幅提升编程效率和代码质量的工具。零配置、零 API Key、多平台支持，是每个 Claude Code 用户都应该安装的伴侣工具。

服务支持：如有兴趣不会搭建，可以联系微信：WRYD6166，开源项目搭建10-50元。

文章版权归作者所有，未经允许请勿转载。

THE END