[BUG]
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:
- Install Claude Code 2.1.131 on Windows via npm
- Run
claude doctorin any terminal
Expected: Doctor diagnostic completes and prints results.
Actual: Process hangs with zero output, requires kill after 30s+.
Debugging already performed:
- No
.mcp.jsonexists 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
- Install Claude Code 2.1.131 on Windows via npm
- Open Git Bash or PowerShell 7
- Run: claude doctor
- 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.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗