Claude Code command not found 解决方法

装好Claude Code，兴冲冲敲了个claude，结果蹦出来command not found？安装没问题，只是系统不知道可执行文件在哪。注册一下PATH就搞定了。

先说解决方法

根据你用的Shell，敲一行命令就行。

Zsh环境（macOS默认）

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Bash环境（Linux默认）

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

现在试试claude，应该能用了。

以上就是解决方法。下面是给好奇"为什么会这样"的人准备的。

---

跟Windows有什么不一样？

Windows的安装程序会自动帮你设好环境变量，所以你根本不用操心。

但Mac和Linux的理念不同："你的环境你自己管。"系统设置和个人设置是隔开的，这是出于安全和效率的考虑。不过说实话，从Windows过来的人一开始会有点不适应。

Shell是什么？

用终端的时候老是看到"Shell"这个词。简单说，它就是你和操作系统之间的翻译官。

你在终端里敲claude，Shell接收后告诉操作系统"把这个跑起来"。那个黑色界面本身不是Shell，里面处理命令的那个软件才是。

最常见的是Zsh和Bash，它们的配置文件不一样，所以得知道自己用的是哪个。

为什么会出现command not found

在终端敲命令时，Shell会在预先注册的目录列表里找"有没有这个名字的程序"。这个列表就是PATH环境变量。

问题在于：Claude Code安装在~/.local/bin，但大多数系统默认没把这个路径加到PATH里。安装脚本会尝试添加，但有时候会遗漏，或者没法立刻在当前终端生效。

所以需要我们自己加上。

怎么查看自己用的是哪个Shell

在终端里敲这个。

echo $SHELL

• 看到/bin/zsh → 配置~/.zshrc
• 看到/bin/bash → 配置~/.bashrc

Bash有时还会读取~/.bash_profile或~/.profile。

如果文件不存在也别担心。>>运算符会自动创建新文件。

逐条拆解命令

搞清楚这些命令具体做了什么，以后装别的工具也用得上。

echo和>> — 把文本输出并追加到文件末尾。意思是"在配置文件最后加一行"。

export PATH="..." — 把~/.local/bin加到现有PATH的前面。放在前面是为了让同名程序优先执行我们指定目录里的那个。

source — Shell配置文件本来只在打开终端时才读取。source的意思是"现在立刻重新读一遍"。不执行这个的话，得关掉终端再重新打开才能生效。

终端命令的结构（附赠）

终端命令基本是**[对谁] [做什么] [怎么做]**的结构。

[可执行文件] [子命令/动词] [选项和参数]

• 对谁：要调用的程序名（如claude、npm、git）
• 做什么：具体动作（如config、install、commit）
• 怎么做：附加信息或详细设置（如--help、-v、文件名）

掌握这个结构，以后遇到陌生命令也能大概看懂。

最后

以后不管装什么，碰到command not found都不用慌了。想一下"哦，PATH没注册"，然后搞定就行。