Warning 'Native installation exists but ~/.local/bin is not in your PATH' fires even when ~/.local/bin is in PATH
Resolved 💬 2 comments Opened May 29, 2026 by davemoz Closed Jul 6, 2026
Description
Claude Code shows the following warning beneath the input prompt even when ~/.local/bin is already present in $PATH:
Native installation exists but ~/.local/bin is not in your PATH. Run: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
Steps to reproduce
- Install Claude Code natively (binary at
~/.local/bin/claude) - Add
~/.local/binto PATH via~/.zshenv(or~/.zshrc/~/.zprofile) - Fully quit and relaunch VSCode
- Open a new terminal —
echo $PATHconfirms~/.local/binis present - Run
claudefrom that terminal - Warning still appears beneath the input prompt
Expected behavior
Warning should not appear when ~/.local/bin is verifiably in $PATH.
Actual behavior
Warning appears regardless. Running the suggested fix command has no effect since the entry is already present.
Environment
- macOS 25.5.0 (Darwin)
- Shell: zsh
- Terminal: VSCode built-in terminal
- Claude Code launched as CLI from terminal (not VSCode extension)
~/.local/binconfirmed in PATH viaecho $PATH | tr ':' '\n' | grep local:
````
/Users/mozdzanowski/.local/bin
- Native binary confirmed at
~/.local/bin/claude
Notes
Debugging revealed that Claude Code's PATH check may be reading PATH from a different source than process.env.PATH (e.g. a freshly-spawned non-interactive shell, or a macOS system-level API). The terminal's PATH is correct; the discrepancy appears to be in how the check is performed internally.
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗