False warning: native installation path is not in PATH even though it already is (Windows)

Resolved 💬 3 comments Opened Mar 8, 2026 by qiyuey Closed Apr 14, 2026

Bug Description

Claude Code shows the following warning on every new session startup:

Warning: Native installation exists but C:\Users\yuchuan\.local\bin is not in your PATH

However, the path is already present in the user's PATH environment variable, confirmed via PowerShell:

[System.Environment]::GetEnvironmentVariable('PATH', 'User')
# Output includes: C:\Users\yuchuan\.local\bin

The warning appears on every new session despite the path being correctly configured.

Steps to Reproduce

  1. Install Claude Code on Windows
  2. Confirm C:\Users\<user>\.local\bin is in the user PATH (via System Environment Variables or PowerShell registry query)
  3. Open a new terminal session and run claude
  4. Warning appears every time on startup

Environment

  • Claude Code version: 2.1.3
  • Platform: Windows (win32)

Expected Behavior

No warning should appear if the path is already present in the user PATH environment variable.

Possible Root Cause

The detection logic may be reading the current process's inherited %PATH% instead of querying the user PATH from the Windows registry via [System.Environment]::GetEnvironmentVariable('PATH', 'User'). These can differ depending on how the terminal session was launched, leading to a false positive warning.

View original on GitHub ↗

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