企业官网建设流程全解析

Claude Code 报 claude: command not found 怎么解决？claude-howto 的 PATH 检查与 npx 运行步骤

【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto

在终端输入claude启动 Claude Code 时收到claude: command not found，表示当前 shell 找不到claude命令，后续所有基于该命令的操作（REPL、print 模式、会话恢复）都无法进行。claude-howto 仓库的 CLI 参考文档 10-cli/README.md 在 Troubleshooting 一节的 "Command Not Found" 条目下给出了三个处理动作：重新安装、检查 PATH 是否包含 npm 全局 bin 目录、改用npx claude运行。本文按该文档的顺序整理成一条可执行路径，完成后以claude -v能否输出版本号作为验证。

先重装：npm 安装仍是官方推荐路径

文档给出的第一条方案是安装（或重装）Claude Code：

npm install -g @anthropic-ai/claude-code

需要了解的背景：自 v2.1.113 起，Claude Code CLI 通过 npm 可选依赖在各平台（macOS、Linux、Windows）启动原生二进制，二进制在安装时按操作系统和架构匹配，早期捆绑的 JavaScript 运行时在 macOS 和 Linux 上已不再是默认。仓库 README.md 的安装说明补充了一点：npm install -g @anthropic-ai/claude-code仍然可用，原生二进制会在首次使用时作为可选依赖下载。因此这条命令同时覆盖“从未安装”和“安装不完整、命令缺失”两种情况，重装一次即可让 npm 重新拉取匹配当前平台的二进制。

PATH 检查：确认包含 npm 全局 bin 目录

如果npm install -g已经执行成功、但claude仍然报command not found，对应文档列出的第二个成因：PATH 没有包含 npm 全局 bin 目录（Check PATH includes npm global bin directory）。

文档只给出了这一检查要求，没有附具体的查询命令，所以实际操作上以结果反推：

1. 按你的 npm 配置确认 PATH 中包含 npm 全局 bin 目录（不同包管理方式下该目录位置不同，以本机npm install -g的实际安装位置为准）。
2. 调整 PATH 后，用下文“验证结果”一节的方式确认命令是否可被识别。

判断标准很简单：调整前claude报 command not found，调整后claude -v能输出版本号，就说明 PATH 问题已解决。

替代运行方式：npx claude

文档给出的第三条方案原文是 "Try running with full path:npx claude"。在 PATH 问题暂时无法修复（例如权限或 shell 配置不便改动）时，可以先用这条路径把命令跑起来：

npx claude

它属于替代运行方式而非 PATH 修复：只要能用claude裸命令正常启动 REPL，PATH 问题才算彻底解决，建议仍按上一节把全局 bin 目录补进 PATH。

验证结果

修复后按顺序做两项检查：

1. 版本检查：运行claude -v。CLI 参考文档中-v, --version的定义是 "Output version number"，能输出版本号即表示命令可被 shell 识别、安装可用。
2. 安装诊断：进入 REPL（claude）后运行斜杠命令/doctor，文档描述其用途为 "Diagnose installation, config, and plugin health"。自 v2.1.116 起它可以在 Claude 响应过程中打开、行内显示状态图标，并按f键自动修复检测到的问题；v2.1.178 起改为扁平树状布局、状态图标更清晰。

/doctor用于排查安装、配置、插件三类健康问题，claude: command not found修复后如果启动仍异常，用它继续定位。

边界情况：企业代理环境下的安装失败

适用条件：网络要求显式白名单（企业 / 代理出口管控）的环境。

自 v2.1.116 起，原生二进制的下载源为downloads.claude.ai/claude-code-releases。文档明确提示：如果出口规则此前只放行了storage.googleapis.com或 npm registry，claude update和首次安装都会失败——表象同样是命令装上不可用或始终缺失。处理方式是把downloads.claude.ai（含https://downloads.claude.ai/claude-code-releases路径）加入代理出口白名单，再重新执行安装命令。非代理环境无需处理此项。

下一步

claude -v输出版本号后，直接在项目目录运行claude进入交互式 REPL，或运行claude -p "query"体验 print 模式（命令与参数含义见 10-cli/README.md 的 CLI Commands 与 Core Flags 表）。安装或 PATH 问题排除后若遇到鉴权、会话恢复等报错，该文档 Troubleshooting 一节还有对应条目可继续对照。

【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto