[BUG] 'Native installation exists but ~/.local/bin is not in your PATH' warning despite DISABLE_INSTALLATION_CHECKS=1

Open 💬 0 comments Opened Jul 7, 2026 by breun

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?

My claude binary is located at /opt/local/share/claude-code/claude. claude doctor will print this installation warning for this:

Installation warnings ⚠
  ├ Native installation exists but ~/.local/bin is not in your PATH
  └ Run: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc then open a new terminal or run: source ~/.zshrc

This warning is still printed when running DISABLE_INSTALLATION_CHECKS=1 claude doctor, even though DISABLE_INSTALLATION_CHECKS is defined as "Set to 1 to disable installation warnings." The DISABLE_INSTALLATION_CHECKS environment variable doesn't work as described in this case.

What Should Happen?

When the DISABLE_INSTALLATION_CHECKS environment variable is set to 1, no installation warnings should appear.

Error Messages/Logs

Steps to Reproduce

  1. Run DISABLE_INSTALLATION_CHECKS=1 claude when claude is not located at $HOME/.local/bin/claude.
  2. See the installation warning, even though installation checks are disabled.

Claude Model

_No response_

Is this a regression?

I don't know

Last Working Version

_No response_

Claude Code Version

2.1.203 (Claude Code)

Platform

Google Vertex AI

Operating System

macOS

Terminal/Shell

Other

Additional Information

_No response_

View original on GitHub ↗