Claude Debugs For You

又称“氛围调试” (Vibe Debugging)

让 Claude（或其他任何大语言模型）交互式地调试你的代码

这是一个 MCP (Model Context Protocol) 服务器和 VS Code 扩展，它使 Claude 能够交互式地调试和评估表达式。

这意味着它也应该适用于其他模型/客户端等，但这里我只演示了与 Claude Desktop 和 Continue 的配合使用。

它是语言无关的，前提是支持调试器控制台并在 VSCode 中有有效的 launch.json 用于调试。

入门指南

1. 从 releases 或 VS Code Marketplace 下载扩展
2. 安装扩展

• 如果直接使用 .vsix，请在 VS Code 的“扩展”中点击三个点并选择“从 VSIX 安装..."

3. 你将看到一个名为 "Claude Debugs For You" 的新状态栏菜单项，它会显示是否正常运行（对勾）或启动失败（叉号）

你可以点击此状态栏菜单查看可用命令

根据你的设置，选择以下选项之一

{
  "mcpServers": {
    "debug": {
      "command": "node",
      "args": [
        "/path/to/mcp-debug.js"
      ]
    }
  }
}

准备就绪，开始调试！

VS Code 调试文档

打开一个包含 .vscode/launch.json 的项目，其中第一个配置已设置为使用 ${file} 调试特定文件。

参见下面的 运行示例，和/或观看演示视频。

贡献

发现错误或有改进想法？请提交拉取请求 (pull request) 或记录问题 (issue)。

这个 README 写得烂吗？帮我改进它！

演示

使用 Continue

它能找出问题，然后建议修复方案，我们只需点击应用即可

https://github.com/user-attachments/assets/3a0a879d-2db7-4a3f-ab43-796c22a0f1ef

{
  ...
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "node",
          "args": [
            "/Users/jason/Library/Application Support/Code/User/globalStorage/jasonmcghee.claude-debugs-for-you/mcp-debug.js"
          ]
        }
      }
    ]
  }
}

如果有用，这是我的配置样子！但它与 Claude Desktop 几乎相同。

使用 Claude Desktop

在这个例子中，我故意让它非常谨慎（不做假设等——与下面的提示词相同），但你也可以让它做任何事情。

https://github.com/user-attachments/assets/ef6085f7-11a2-4eea-bb60-b5a54873b5d5

开发

• 使用 VS Code 克隆/打开此仓库
• 运行 npm run install 和 npm run compile
• 点击“运行”，这将打开一个新的 VSCode
• 否则与“入门指南”相同
• 要重新构建，运行 npm run compile

打包

vsce package

运行示例

在 VS Code 窗口中打开 examples/python

输入提示词：

i am building `longest_substring_with_k_distinct` and for some reason it's not working quite right. can you debug it step by step using breakpoints and evaluating expressions to figure out where it goes wrong? make sure to use the debug tool to get access and debug! don't make any guesses as to the problem up front. DEBUG!

其他值得提及的事项

当你启动多个 VS Code 窗口时，你会看到一个弹窗。你可以在窗口之间优雅地移交 "Claude Debugs For You" 的控制权。

你也可以禁用自动启动。然后你只需要点击状态栏菜单并选择“启动服务器”。

简短的想法列表

• 它应该使用 ripgrep 来查找你要求的内容，而不是列出文件 + 获取文件内容。
• 添加对条件断点的支持
• 添加 "fix" 工具，允许 MCP 插入 CodeLens 或“自动修复”建议，以便用户可以选择应用推荐更改或不应用。
• 你的想法在这里！

claude-debugs-for-you 快速上手指南

claude-debugs-for-you 是一个 VS Code 扩展及 MCP 服务器，旨在让 Claude 或其他大语言模型能够交互式地调试和评估您的代码。它支持通过断点、表达式求值等方式辅助定位问题。

1. 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows、macOS 或 Linux
• 编辑器：Visual Studio Code (VS Code)
• 运行时：Node.js (用于运行 MCP 服务器)
• AI 客户端：支持 MCP 协议的大模型客户端（如 Claude Desktop、Continue、Cursor 等）

2. 安装步骤

2.1 安装 VS Code 扩展

1. 打开 VS Code，进入扩展面板。
2. 搜索 claude-degets-for-you 或直接访问 VS Code Marketplace。
3. 点击 Install 进行安装。
   • 若下载了 .vsix 文件，可通过扩展面板菜单选择 "Install from VSIX..."。
4. 安装完成后，查看底部状态栏是否出现 "Claude Debugs For You" 图标（绿色对勾表示运行正常）。

2.2 配置 MCP 连接

根据您使用的 AI 客户端类型，执行以下操作之一：

方案 A：使用 Claude Desktop (推荐 stdio)

1. 在 VS Code 中打开命令面板 (Ctrl+Shift+P / Cmd+Shift+P)。
2. 输入并执行命令："Copy MCP Debug Server stdio path to clipboard"。
3. 编辑您的 claude_desktop_config.json 文件，添加如下配置（注意替换路径）：

{
  "mcpServers": {
    "debug": {
      "command": "node",
      "args": [
        "/path/to/mcp-debug.js"
      ]
    }
  }
}

4. 重启 Claude Desktop 以加载新配置。

方案 B：使用 Cursor / Continue (支持 SSE)

1. 在 VS Code 中执行命令："Copy MCP Debug Server sse address to clipboard"。
2. 将获取到的地址（默认为 http://localhost:4711/sse）添加到您的 MCP 客户端配置中。
3. 刷新客户端配置并重启。

3. 基本使用

3.1 准备调试项目

确保您的项目包含有效的 .vscode/launch.json 配置文件，且第一个调试配置支持 ${file} 变量。

3.2 发起调试请求

打开一个存在问题的代码文件，向 AI 发送如下提示词（Prompt）：

i am building longest_substring_with_k_distinct and for some reason it's not working quite right. can you debug it step by step using breakpoints and evaluating expressions to figure out where it goes wrong? make sure to use the debug tool to get access and debug! don't make any guesses as to the problem up front. DEBUG!

3.3 应用修复

AI 分析后会在工具列表中显示 debug 选项。确认选择该工具后，AI 会尝试定位问题并建议修复方案，您可直接点击应用更改。