Claude Code error
Claude Code: zsh: command not found: claude
zsh: command not found: claudeStatus: WorkaroundLast verified 4 documented fixes2 sources
What it means
The install finished but the install directory is not in your PATH. Platform variants: bash: claude: command not found (Linux), 'claude' is not recognized as an internal or external command (Windows CMD), claude : The term 'claude' is not recognized as the name of a cmdlet (PowerShell). The installer reports Native installation exists but ~/.local/bin is not in your PATH.
Causes
- ~/.local/bin (macOS/Linux) or %USERPROFILE%\.local\bin (Windows) missing from PATH
- A terminal opened before the PATH change
- Only the VS Code extension installed, which does not add claude to PATH
How to fix it
- Fix 1.
Check that the binary exists.
Snippetls -la ~/.local/bin/claude - Fix 2.
For Zsh (macOS default), add the install directory to PATH and reload.
Terminalecho 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc - Fix 3.
For Bash on Linux, use ~/.bashrc; for Bash on macOS, use ~/.bash_profile.
Terminalecho 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc source ~/.bashrc - Fix 4.
Open a new terminal window and verify.
Terminalclaude --version
More Claude Code errors
All 18 Claude Code errorsAPI Error: 500 Internal server error. This is a server-side issue, usually temporaryStatus: WorkaroundAPI Error: Repeated 529 Overloaded errors. The API is at capacityStatus: WorkaroundAPI Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"messages.5: `tool_use` ids were found without `tool_result` blocks immediately after: toolu_01FRvEykWmCgrgJ22mvBbKhV. Each `tool_use` block must have a corresponding `tool_result` block in the next message."}}Status: OpenUnable to connect to API. Check your internet connectionStatus: WorkaroundUnable to connect to API: SSL certificate verification failed (UNABLE_TO_GET_ISSUER_CERT_LOCALLY).Status: WorkaroundPlease run /login · API Error: 401 OAuth token has expiredStatus: WorkaroundOAuth error: timeout of 15000ms exceededStatus: OpenPrompt is too longStatus: Workaround
Related reading
- Conductor Joins Meta: Shutdown Dates and AlternativesConductor is joining Meta. Cloud goes read-only Nov 13 and shuts down Nov 20, and the local Mac app winds down in early 2027. The dates, what to export, and what to move to.
- Claude Code Limits Draining Faster? What the Evidence ShowsWeekly Claude Code limits are draining faster for many users since mid-October. What the GitHub measurements show, the headless claude -p metering gap, and what to check first.
- Claude Code Game Rule: It Won't Remake Existing GamesClaude Code on Opus 5.5 now refuses to recreate specific existing games, even renamed. What the two-sentence rule says, what it blocks, and what builders do next.
- Claude Ultra Plan: Max 20x Renamed, 5-Hour Limit GoneAnthropic renamed Max 20x to Ultra and dropped the five-hour limit for verified accounts. What the 10x weekly label means, how to check yours, and Max vs Ultra.
- Claude Code blockWritesOutsideWorkingDirectories: Keep Edits Inside the ProjectSince Claude Code 2.1.314, one setting makes Write, Edit and NotebookEdit refuse paths outside your working directories in every mode, including bypassPermissions.
- Opus 4.8 Fast Mode Ends Nov 30: Migrate to Opus 5.5Claude Code deprecated Opus 4.8 fast mode on Oct 30 and removes it Nov 30, 2026. Requests then error. Opus 5.5 fast costs $8/$40 per MTok - here is the fix.
FAQ
What does "zsh: command not found: claude" mean in Claude Code?
The install finished but the install directory is not in your PATH. Platform variants: bash: claude: command not found (Linux), 'claude' is not recognized as an internal or external command (Windows CMD), claude : The term 'claude' is not recognized as the name of a cmdlet (PowerShell). The installer reports Native installation exists but ~/.local/bin is not in your PATH.
How do I fix "zsh: command not found: claude"?
There are 4 documented fixes. Start with the first: Check that the binary exists.
Is this Claude Code error fixed?
Status: Workaround. No release removes the cause. The documented fixes work around it.
Sources
Last verified against 2 sources: official docs, maintainer replies and release notes.
Newsletter
Fixes for the tools you use, weekly
One email per week. New coding agent releases, what broke, and how developers are working around it.