用途
Claude Debugs For You(又称 Vibe Debugging)旨在让 Claude 或其他 LLM 以交互方式调试代码。它由 MCP 服务器和 VS Code 扩展组成,使模型能够通过断点和表达式求值来定位并修复问题。该工具语言无关,前提是调试器控制台支持,并且 VS Code 中存在用于调试的有效 launch.json。
主要能力
- 让 Claude(或其他 LLM)交互式调试并求值表达式。
- 通过 MCP 与 VS Code 扩展协同工作,理论上兼容其他模型和客户端,但官方仅以 Claude Desktop 和 Continue 进行演示。
- 语言无关,依赖调试器控制台支持与有效的 launch.json。
- 模型可自行找出问题并建议修复,用户点击即可应用。
- 需要选择具备工具调用能力的模型;在工具列表中需点击“debug”并将其设为“Automatic”。
使用方式
- 从 releases 或 VS Code Marketplace 下载扩展。
- 安装扩展。若直接使用 .vsix,可在 VS Code 的“Extensions”中点击三个点并选择“Install from VSIX...”。
- 安装后会出现状态菜单项“Claude Debugs For You”,显示运行正常(对勾)或启动失败(叉号)。点击该状态菜单可查看可用命令。
- 根据设置选择以下方式之一:
- 在 VS Code 命令中搜索“Copy MCP Debug Server stdio path to clipboard”复制 stdio 服务器路径,粘贴到 claude_desktop_config.json 中(需更新为实际复制的路径),或按其他 MCP 服务器方式编辑。
- 启动 Claude Desktop(或其他 MCP 客户端)。注意:若其已在运行,可能需要重启。若使用 Continue/Cursor 或其他内置于 VS Code 的客户端,可跳过此步。
- 使用“Copy MCP Debug Server sse address to clipboard”命令获取 MCP 服务器 SSE 地址,也可直接写为 http://localhost:4711/sse,或使用设置中配置的端口。
- 根据客户端要求添加该地址。某些客户端(如 Cursor)可能需要点击“refresh”。
- 启动 MCP 客户端。注意:若其已在运行,可能需要重启。若使用 Continue/Cursor 或其他内置于 VS Code 的客户端,可跳过此步。
- 打开包含 .vscode/launch.json 的项目,且第一个配置已设置为使用 ${file} 调试特定文件。
- 可参考“Run an Example”或观看演示视频。
适用场景
- 在 VS Code 中借助 LLM 对任意语言进行交互式调试。
- 需要模型自动定位问题并给出修复建议的开发流程。
- 使用 Claude Desktop、Continue、Cursor 等支持 MCP 的客户端进行调试。
限制与注意事项
- 语言无关的前提是调试器控制台支持,并且 VS Code 中存在有效的 launch.json。
- 需要选择具备工具调用能力的模型。
- 官方仅以 Claude Desktop 和 Continue 进行演示,其他模型/客户端未明确验证。
- 若在 Continue 中看到 MCP 错误,可尝试禁用/重新启用 Continue 插件。
- 启动多个 VS Code 窗口时会出现弹窗,可在窗口间优雅移交“Claude Debugs For You”。
- 可禁用自动启动,之后需点击状态菜单并选择“Start Server”。
- 项目待办想法包括:使用 ripgrep 查找内容而非列出文件并获取文件内容;支持条件断点;通过允许 MCP 插入 CodeLens 或“auto fix”建议来添加“fix”工具,让用户选择是否应用推荐更改。
从源码运行
- 使用 VS Code 克隆/打开该仓库。
- 运行 npm run install 和 npm run compile。
- 点击“run”会打开一个新的 VS Code。
- 其余与“Getting Started”相同。
- 重新构建可运行 npm run compile。
- 在 VS Code 窗口中打开 examples/python,输入提示词。