False positive: 'Native installation exists but ~/.local isn't in your path' when PATH is correctly configured
Resolved 💬 3 comments Opened Mar 31, 2026 by jmeritt Closed Apr 4, 2026
Bug Description
Claude Code displays the warning message "Native installation exists but ~/.local isn't in your path" even when ~/.local/bin is correctly configured in the PATH.
System Information
- Claude Code version: 2.1.81
- Platform: macOS (Darwin 25.3.0)
- Shell: zsh
Current Configuration
PATH environment variable:
/Users/jaime.meritt/.local/bin:/opt/homebrew/Caskroom/miniconda/base/bin:/opt/homebrew/Caskroom/miniconda/base/condabin:/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:...
Note: ~/.local/bin is the first entry in the PATH.
~/.zshrc configuration (line 117):
export PATH="$HOME/.local/bin:$PATH"
Verification that PATH persists in new shells:
$ zsh -c 'echo $PATH' | tr ':' '\n' | grep -E "local|Local"
/Users/jaime.meritt/.local/bin
/usr/local/bin
/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin
Expected Behavior
Claude Code should recognize that ~/.local/bin is in the PATH and not display the warning message.
Actual Behavior
Claude Code displays the warning "Native installation exists but ~/.local isn't in your path" despite the directory being properly configured as the first entry in PATH.
Steps to Reproduce
- Have
~/.local/binproperly configured in PATH via.zshrc - Run Claude Code
- Observe the incorrect warning message
Additional Context
- The directory
~/.local/binexists but is currently empty - The PATH configuration is working correctly at the shell level
- This appears to be an issue with Claude Code's PATH detection logic
This warning is misleading to users as it suggests a configuration problem that doesn't actually exist.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗