[BUG]

Resolved 💬 3 comments Opened May 6, 2026 by Guyfyu Closed May 10, 2026

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report (please file separate reports for different bugs)
  • [x] I am using the latest version of Claude Code

What's Wrong?

Title: claude doctor hangs indefinitely on Windows (zero output, killed by timeout)

Environment:

  • OS: Windows 10/11 (请确认)
  • Claude Code: 2.1.131
  • Node.js: v24.15.0
  • npm: 11.12.1
  • Git: 2.54.0.windows.1
  • Git Bash: 5.3.9
  • PowerShell: 7.5.4

Description:
Running claude doctor hangs indefinitely with no output, in any shell
(Git Bash, PowerShell 7, cmd). The process must be killed manually after
timeout.

Steps to reproduce:

  1. Install Claude Code 2.1.131 on Windows via npm
  2. Run claude doctor in any terminal

Expected: Doctor diagnostic completes and prints results.
Actual: Process hangs with zero output, requires kill after 30s+.

Debugging already performed:

  • No .mcp.json exists in cwd, parent dirs, user home, ~/.claude/, or AppData
  • Setting CLAUDE_CODE_DEBUG=1 produces no output before hang
  • Setting NODE_DEBUG=module produces no output before hang
  • Tested via direct pwsh.exe invocation — still hangs
  • Tested via Git Bash — still hangs
  • Active MCP servers (notes-fs, hermes) injected via non-.mcp.json mechanism

Workaround: None found. Core Claude Code functionality (bash, git,
node, MCP servers) works normally — only doctor is affected.

What Should Happen?

claude doctor prints a health check report and exits cleanly within a few seconds.

Error Messages/Logs

No output produced. Process exits with code 124 (killed by timeout).
Tested with: timeout 30 claude doctor 2>&1
CLAUDE_CODE_DEBUG=1 claude doctor — zero output before hang
NODE_DEBUG=module claude doctor — zero output before hang

Steps to Reproduce

  1. Install Claude Code 2.1.131 on Windows via npm
  2. Open Git Bash or PowerShell 7
  3. Run: claude doctor
  4. Command hangs with zero output until killed (exit 124 after timeout)

Claude Model

None

Is this a regression?

I don't know

Last Working Version

_No response_

Claude Code Version

2.1.131

Platform

Other

Operating System

Windows

Terminal/Shell

PowerShell

Additional Information

Also tested in Git Bash (CLAUDE_CODE_GIT_BASH_PATH set explicitly) — same hang.
Direct pwsh.exe invocation with -NoProfile — same hang.
No .mcp.json in cwd, parent dirs, user home, ~/.claude/, or AppData.
MCP servers active in session (notes-fs, hermes) not configured via .mcp.json.
All other claude commands (chat, --version, etc.) work normally.
Core functionality unaffected — diagnostic-only impact.

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗