/ 目錄 / 演練場 / claude-debugs-for-you
● 社群 jasonjmcghee ⚡ 即開即用

claude-debugs-for-you

作者 jasonjmcghee · jasonjmcghee/claude-debugs-for-you

將 VS Code 的除錯器變成 Claude 的除錯器——在任何 VS Code 支援的語言中設定中斷點、逐步執行、評估運算式。

一個將即時除錯工作階段公開為 MCP 工具的 VS Code 擴充功能。Claude 可以設置中斷點、繼續/逐步執行,並針對您正在執行的程式評估運算式。不限語言——Python、Node、Go、Rust,以及任何具有 VS Code 除錯配接器的語言均可使用。

為什麼要用

核心特性

即時演示

實際使用效果

claude-debugs-for-you.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-debugs-for-you": {
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-debugs-for-you": {
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-debugs-for-you": {
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-debugs-for-you": {
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-debugs-for-you",
      "command": "npx",
      "args": [
        "-y",
        "claude-debugs-for-you"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-debugs-for-you": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "claude-debugs-for-you"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add claude-debugs-for-you -- npx -y claude-debugs-for-you

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: claude-debugs-for-you

讓 Claude 驅動除錯器來縮小錯誤範圍

👤 卡在不明顯錯誤上的開發者 ⏱ ~20 min intermediate

何時使用: 你已經看了 20 分鐘的日誌。是時候讓 Claude 設定策略性中斷點並檢查變數狀態了。

前置條件
  • 具有可執行設定的 .vscode/launch.json — 在第一個設定中使用 ${file},這樣 Claude 就可以執行你目前開啟的任何檔案
  • 已安裝 claude-debugs-for-you 擴充功能 — VS Code Marketplace
步驟
  1. 啟動擴充功能伺服器
    啟動除錯 MCP 伺服器。記下它印出的路徑並貼入 Claude Desktop 設定中。✓ 已複製
    → 擴充功能狀態列顯示執行中
  2. 描述錯誤
    我的函式 computeTotal() 在購物車有特價商品時回傳 NaN。在開頭設置中斷點,逐步執行,並告訴我哪裡出了問題。✓ 已複製
    → 中斷點已設定,程式執行到該點,Claude 檢查區域變數
  3. 診斷
    根據每個步驟的值,根本原因是什麼?最小的修復方案是什麼?✓ 已複製
    → 根本原因 + 修補方案

結果: 由 Claude 驅動除錯器找到錯誤——比加 print 日誌更快。

注意事項
  • launch.json 設定錯誤導致除錯器無法啟動 — 先在 VS Code 中用 F5 測試;確認沒問題後再讓 Claude 驅動
  • Claude 設定了太多中斷點,導致一切變得很慢 — 告訴它盡可能使用條件式中斷點
搭配使用: git-2

透過運算式評估來理解複雜的執行時期狀態

👤 對不熟悉的程式碼進行逆向工程的開發者 ⏱ ~15 min intermediate

何時使用: 程式可以執行但你不知道為什麼。在關鍵行設置中斷點,請 Claude 探索狀態。

步驟
  1. 暫停
    在第 X 行設置中斷點,執行測試,暫停後告訴我目前作用域內有什麼。✓ 已複製
    → 作用域內容列表
  2. 評估
    評估 this.store.getState().users.filter(u => u.active).length,然後顯示 this.config 給我看。✓ 已複製
    → 評估結果

結果: 不需要撰寫測試程式碼即可進行即時探索。

注意事項
  • 帶有副作用的評估會改變狀態 — 除非你刻意要修改狀態,否則只使用唯讀運算式

組合

與其他 MCP 搭配,撬動十倍槓桿

claude-debugs-for-you + git-2

除錯 → 修復 → 提交的循環流程

除錯失敗的測試,套用你提出的修復方案,然後用描述問題所在的訊息進行提交。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
set_breakpoint file, line, condition? 在除錯工作階段開始前或進行中呼叫 free
remove_breakpoint id 在工作階段之間進行清理 free
continue 繼續執行;回傳下一個暫停位置資訊 free
step_over 逐步執行但不進入函式內部 free
evaluate expression: str 在目前暫停點檢查變數值 free
get_stack 查看呼叫鏈 free

成本與限制

運行它的成本

API 配額
每次呼叫 Token 數
每次呼叫用量小;但若在工作階段中大量探索狀態,累計可達 10-50k
費用
免費,MIT 授權
提示
請 Claude 先建立假設,再用針對性的中斷點驗證——避免漫無目的地逐步執行。

安全

權限、密鑰、影響範圍

憑證儲存:
資料出站: 本地除錯器;變數值會傳送至您的 LLM 提供商
切勿授予: Arbitrary `evaluate` on production databases via a debugger session

故障排查

常見錯誤與修復

Extension doesn't start / no 'running' in status bar

開啟 VS Code 開發者工具主控台。通常是連接埠被佔用的問題——在擴充功能設定中更換連接埠。

Debugger fails to start

先手動用 F5 測試。確認 launch.json 中的第一個設定使用 ${file}

Claude says 'no active debug session'

你需要有一個正在執行中的程式。請 Claude 啟動除錯,這會觸發 VS Code 的預設設定。

替代方案

claude-debugs-for-you 對比其他方案

替代方案何時用它替代權衡
VS Code + Copilot chat with debug context你已付費使用 Copilot 且原生使用 VS Code可腳本化程度較低;與 Copilot 的模型綁定

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills