[BUG] False positive warning: "~/.local/bin is not in your PATH" when it is

Resolved 💬 3 comments Opened Jan 20, 2026 by Tahinli Closed Jan 24, 2026

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report (please file separate reports for different bugs)
  • [x] I am using the latest version of Claude Code

What's Wrong?

Bug Description

The System Diagnostics shows a warning:
⚠ Native installation exists but ~/.local/bin is not in your PATH

However, ~/.local/bin is actually present in my PATH:
/home/user/.cargo/bin:/home/user/.cargo/bin/:/home/user/.local/bin/:/usr/local/bin:/usr/bi
n

Environment

  • OS: Fedora (Linux 6.18.5-200.fc43.x86_64)
  • Shell: fish / bash
  • Desktop: Hyprland (PATH set via env in hyprland.conf)

Possible Cause

The diagnostic check may not be correctly parsing the PATH variable, possibly due to
trailing slashes (~/.local/bin/ vs ~/.local/bin).

What Should Happen?

No warning should appear when ~/.local/bin is in PATH.

Error Messages/Logs

System Diagnostics
   ⚠ Native installation exists but ~/.local/bin is not in your PATH

Steps to Reproduce

  1. Install Claude Code natively to ~/.local/bin/
  2. Set PATH in Hyprland config with trailing slash: env = PATH, $HOME/.local/bin/:$PATH
  3. Open a terminal and run claude
  4. Run /doctor or check System Diagnostics
  5. Observe the warning despite printenv PATH showing ~/.local/bin/ is present

Claude Model

None

Is this a regression?

I don't know

Last Working Version

_No response_

Claude Code Version

2.1.12

Platform

Anthropic API

Operating System

Other Linux

Terminal/Shell

Other

Additional Information

Terminal doesnt matter. I tried different terms including wezterm, xterm, kitty etc

View original on GitHub ↗

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