Nothing is broken. The installer put Claude Code in a folder, and your shell does not look in that folder when you type a command. The first thing to try is simply to close the terminal and open a new one, because a fresh window reads the updated settings. If it still says not found, the fix is two lines that add the folder to your PATH, run once. Then claude –version should print a version number.
Key facts
- 1folder the installer uses: ~/.local/bin on Mac and Linux, %USERPROFILE%\.local\bin on Windows
- 4spellings of the same error, one per shell: zsh, bash, Command Prompt, PowerShell
- 2commands that fix it permanently on a Mac, an echo and a source
- 0reinstalls needed; the program is already there, your shell just cannot see it
- code.claude.com, Troubleshoot installation and login, sections 'command not found: claude after installation' and 'Verify your PATH', read 6 November 2026
What does the error actually mean?
Your shell keeps a list of folders where it looks for programs. That list is called the PATH. When you type a word and press Enter, the shell walks the list, and if the word is not a program in any of those folders, it says command not found. The Claude Code installer places the program at ~/.local/bin/claude on a Mac or Linux, and at %USERPROFILE%\.local\bin\claude.exe on Windows. If that folder is not on the list, the program exists and the shell cannot see it. The installer even tells you this at the end, under Setup notes, with the line Native installation exists but ~/.local/bin is not in your PATH. It prints the fix; it does not apply it for you.
| Where you typed it | What it says |
|---|---|
| Mac (zsh) | zsh: command not found: claude |
| Linux (bash) | bash: claude: command not found |
| Windows Command Prompt | 'claude' is not recognized as an internal or external command |
| Windows PowerShell | claude : The term 'claude' is not recognized as the name of a cmdlet |



