claude-devtools

你的Claude正在盲编码。查看它所做的一切。

问题

Claude Code 开始隐藏其执行细节。

自 v2.1.20 起，Claude Code 将详细的输出替换为模糊的摘要：读取了3个文件、搜索了1个模式、编辑了2个文件。没有文件路径，没有内容，也没有行号。社区对此立即发出了强烈反响（详情）。

但问题远不止于文件路径被折叠：

• 思考步骤 — Claude 的思维链推理在终端中完全不可见
• 工具调用详情 — 你只能看到一行摘要，而无法获取实际的输入和输出
• 子代理活动 — 代理会生成其他代理，但你只能看到最终结果
• 上下文窗口 — 一个由三部分组成的进度条，却没有细分哪些内容占用了你的 token
• 团队协作 — 同事的消息、任务分配、关闭请求等都被埋没

唯一的解决办法是使用 --verbose 参数，但这会输出原始 JSON、内部系统提示以及成千上万行的噪音。没有任何折中方案。

解决方案

claude-devtools 会读取你机器上的 ~/.claude/ 目录——即已有的会话日志——并重建所有内容。

无需配置，无需 API 密钥，无需封装器。适用于你运行过的每一个会话。

安装

Homebrew（macOS）

brew install --cask claude-devtools

直接下载

核心功能

上下文重构

每轮次的 token 分配情况，细分为7类——CLAUDE.md（全局、项目、目录）、技能、提及的文件、工具输入输出、思考、团队开销、用户文本。让你精确了解任意时刻上下文窗口中的内容。

紧凑可视化

直观展示你的上下文何时达到上限。清晰地呈现上下文如何填充、压缩和重新填充——从而让你确切知道哪些内容丢失了。

通知触发器

系统通知功能，可针对 .env 文件访问、工具错误、高 token 使用量，以及任何字段中的自定义正则表达式模式进行触发。

工具调用检查器

每个工具调用都会展开显示，配备专门的查看器——语法高亮的读取操作、内联编辑差异、Bash 输出，以及完整的子代理执行树。

团队与子代理树

每个代理都有独立的执行树，包含工具调用轨迹、令牌指标、执行时长和费用。嵌套代理会递归渲染。

SSH 远程会话

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

命令面板与多窗格布局

使用 Cmd+K 进行跨会话搜索。通过拖放标签页，可并排打开多个会话。

并非封装工具

claude-devtools 不 封装、修改或干扰 Claude Code。它仅读取您本地已有的会话日志。支持来自终端、IDE 或任何使用 Claude Code 的工具的会话。

Docker / 独立部署

无需 Electron 即可运行——可在 Docker 容器中、远程服务器上，或任何 Node.js 可运行的地方部署。

docker compose up
# 打开 http://localhost:3456

或手动：

docker build -t claude-devtools .
docker run -p 3456:3456 -v ~/.claude:/data/.claude:ro claude-devtools

独立服务器 完全无 出站网络请求。为实现最高隔离级别：docker run --network none -p 3456:3456 -v ~/.claude:/data/.claude:ro claude-devtools。详情请参阅 SECURITY.md。

开发

git clone https://github.com/matt1398/claude-devtools.git
cd claude-devtools
pnpm install
pnpm dev

贡献

请参阅 CONTRIBUTING.md 获取贡献指南。同时请阅读我们的 行为准则。

安全性

IPC 处理程序会对所有输入进行严格的路径限制校验。文件读取仅限于项目根目录和 ~/.claude。详情请参阅 SECURITY.md。

许可证

MIT

claude-devtools 快速上手指南

claude-devtools 是一个用于可视化分析 Claude Code 会话日志的工具。它能还原被终端隐藏的详细执行过程（如文件读写内容、思维链、子代理活动等），帮助开发者全面掌握 AI 的编码行为。该工具直接读取本地日志，无需 API Key，不修改或封装原始程序。

环境准备

• 操作系统：macOS (Intel/Apple Silicon)、Linux、Windows 或支持 Docker 的环境。
• 前置依赖：
  • 已安装并运行过 Claude Code，确保本地存在 ~/.claude/ 会话日志目录。
  • （可选）若从源码构建，需 Node.js 20+ 和 pnpm 10+。
• 网络要求：工具本身无需联网即可运行（纯本地日志分析）。

安装步骤

根据你的系统选择以下任一方式安装：

方式一：Homebrew (推荐 macOS 用户)

brew install --cask claude-devtools

方式二：直接下载安装包

访问 GitHub Releases 下载对应系统的安装包：

• macOS: 下载 .dmg 文件（Apple Silicon 选 arm64，Intel 选 x64）。拖入应用程序文件夹，首次启动时右键点击“打开”。
• Linux: 根据发行版选择 .AppImage、.deb、.rpm 或 .pacman。
• Windows: 下载 .exe 安装程序。若触发 SmartScreen 警告，点击“更多信息” -> “仍要运行”。

方式三：Docker 部署 (适用于服务器或隔离环境)

docker compose up
# 启动后访问 http://localhost:3456

或者手动运行：

docker run -p 3456:3456 -v ~/.claude:/data/.claude:ro ghcr.io/matt1398/claude-devtools:latest

基本使用

安装完成后，工具会自动读取本地的 Claude 会话记录，无需额外配置。

1. 启动应用

   • 桌面版：直接在应用程序菜单中启动 claude-devtools。
   • Docker 版：在浏览器中访问 http://localhost:3456。

2. 查看会话详情 界面将自动加载最近的会话列表。点击任意会话即可查看还原后的详细信息，包括：

   • 完整文件操作：查看具体读取/编辑的文件路径、内容及行号差异（Diff）。
   • 思维链 (Thinking)：展示 Claude 完整的推理思考过程。
   • 上下文分析：可视化展示 Token 消耗分布（如提示词、工具调用、记忆压缩等）。
   • 子代理追踪：展开查看嵌套调用的子代理执行树及耗时。

3. 高级功能

   • 按下 Cmd+K (Mac) 或 Ctrl+K (Win/Linux) 唤出命令面板，跨会话搜索关键词。
   • 支持拖拽标签页并排对比多个会话。
   • 可配置通知触发器（如监测 .env 访问或特定错误模式）。

注意：本工具仅作为日志阅读器，不会干扰正常的 Claude Code 终端运行。