False positive PATH warning in MSYS/Git Bash environments

Resolved 💬 3 comments Opened Dec 12, 2025 by senaiverse Closed Dec 16, 2025

Description

Claude Code shows a PATH warning on every startup in MSYS/Git Bash environments, even when the path is correctly configured:

Native installation exists but C:\Users\Senai\.local\bin is not in your PATH. Add
it by opening: System Properties → Environment Variables → Edit User PATH → New → Add the path above. Then restart your terminal.

Evidence

The warning is a false positive:

  1. Directory exists and is functional:

``
$ ls -la C:\Users\Senai\.local\bin
-rwxr-xr-x 1 Senai 197121 217809056 Dec 12 19:28 claude.exe*
``

  1. PATH contains the directory (Unix format):

``
$ echo $PATH | grep -o '/c/Users/Senai/.local/bin'
/c/Users/Senai/.local/bin
``

  1. Claude Code works correctly - the executable is found and runs without issues.

Root Cause

The PATH detection logic appears to check for Windows-style paths (C:\Users\...) but doesn't recognize Unix-style paths (/c/Users/...) that MSYS/Git Bash uses. These are functionally equivalent in MSYS environments.

Environment

  • Claude Code version: 2.0.67
  • OS: Windows (MSYS_NT-10.0-26100 3.6.4)
  • Shell: Git Bash/MSYS

Proposed Solutions

  1. Improve path detection: Recognize Unix-style paths (/c/...) as equivalent to Windows paths (C:\...) in MSYS environments
  2. Add suppression setting: Similar to DISABLE_COST_WARNINGS, add a DISABLE_PATH_WARNINGS environment variable or settings.json option
  3. Silent on false positives: If the executable is found and working, skip the warning

Impact

Low severity - cosmetic issue only. Functionality is not affected, but the warning appears on every startup which can be annoying for users in MSYS environments.

View original on GitHub ↗

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