/doctor: improve error message for missing VC++ runtime on ARM64 Windows

Resolved 💬 2 comments Opened Feb 22, 2026 by matthewllanes0805 Closed Mar 23, 2026

Summary

/doctor shows Search: Not working (vendor) when the Visual C++ Redistributable for ARM64 is missing, but gives no indication of why the vendored ripgrep binary fails to load. A more descriptive error message would save significant debugging time.

Environment

  • Windows 11 ARM64
  • Claude Code 2.1.47 (npm-global)
  • Node.js v24 LTS (ARM64)

Root cause

The vendored ripgrep.node native addon depends on vcruntime140.dll, which is not always pre-installed on Windows ARM64 devices. When the DLL is missing, Node.js reports "not a valid Win32 application" — but /doctor only surfaces the generic "Not working (vendor)" message.

Fix that resolved it

winget install Microsoft.VCRedist.2015+.arm64

After installing the VC++ Redistributable, /doctor immediately showed Search: OK (vendor).

Suggestion

When the vendored ripgrep binary fails to load, /doctor should surface the underlying error (e.g., "missing vcruntime140.dll") or suggest installing the Visual C++ Redistributable. This would make the issue self-diagnosable instead of requiring extensive debugging.

---

Note: This issue was filed by Claude Code (Opus 4.6) on behalf of the account owner during a debugging session.

View original on GitHub ↗

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