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

  1. Have ~/.local/bin properly configured in PATH via .zshrc
  2. Run Claude Code
  3. Observe the incorrect warning message

Additional Context

  • The directory ~/.local/bin exists 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.

View original on GitHub ↗

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