需将Qwen CLI安装路径加入系统PATH:先用npm config get prefix查全局路径,再确认node_modules/.bin中存在qwen文件,最后将对应bin目录添加至PATH环境变量并重启终端。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

安装完 Qwen Code CLI 后在终端输入 qwen 却提示“不是内部或外部命令”,说明系统根本没找到这个可执行文件,问题不出在工具本身,而在于它被装到了哪里、PATH 是否指向了那里、以及你用的是哪个包管理器装的。
确认 npm 全局安装路径
打开终端(Windows 用 PowerShell 或 CMD,macOS/Linux 用 Terminal),执行:
npm config get prefix
这条命令会输出 npm 全局包的实际安装目录。Windows 用户常见路径是 C:\Users\你的用户名\AppData\Roaming\npm,macOS 用户通常是 /usr/local 或 $HOME/.npm-global。如果输出为空或报错,说明 npm 配置异常,先运行 npm config edit 检查配置文件是否损坏。
验证 qwen 可执行文件是否真实存在
根据上一步得到的 prefix 路径,拼出可执行文件位置:
Windows:进入 prefix 目录 → 打开 node_modules\.bin 文件夹 → 查看是否存在 qwen.cmd 和 qwen.ps1;
macOS/Linux:进入 prefix/bin → 查看是否存在 qwen 文件(无后缀,且有可执行权限)。
如果文件不存在,说明 npm install -g @qwen-code/qwen-code 实际未成功写入全局目录——可能因权限不足被静默降级到本地 node_modules,此时需加 --location=global 强制指定位置:npm install -g @qwen-code/qwen-code --location=global。
将安装路径加入系统 PATH
方法一:Windows 手动添加(推荐给非管理员用户)
① 复制上一步查到的 prefix 路径(例如 C:\Users\fs\AppData\Roaming\npm);
② 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”;
Qwen 视频智能分析基础客户端(免费版),基于 Qwen 3.5 Plus 多模态模型对本地视频进行内容分析,支持场景描述与基础内容理解,采用默认抽帧频率和提示词,适合快速概览视频,API Key 读取自 ~/.skill-platform/skill-platform.json 的 skills 配置。
③ 在“用户变量”区域选中“Path”,点“编辑”→“新建”→粘贴路径→“确定”;
【必须关闭所有已打开的终端窗口再重新打开,否则新 PATH 不生效】。
方法二:macOS/Linux 临时生效(测试用)
在当前终端运行:export PATH="/usr/local/bin:$PATH"(把 /usr/local 替换为你真实的 prefix/bin 路径);
方法三:macOS/Linux 永久生效(推荐)
编辑 shell 配置文件:echo 'export PATH="你的prefix/bin:$PATH"' >> ~/.zshrc(zsh 用户)或 >> ~/.bash_profile(bash 用户),然后执行 source ~/.zshrc。
区分 npm 与 corepack 安装来源
如果你用 corepack enable 启用了 Node.js 自带的包管理器,又用 pnpm add -g 或 yarn global add 安装过 qwen-code,那么可执行文件不会出现在 npm 的 prefix 下,而是落在 pnpm/yarn 自己的全局 bin 目录里。
查 pnpm 全局路径:pnpm root -g → 然后进该目录下的 node_modules/.bin;
查 yarn 全局路径:yarn global dir → 然后进 node_modules/.bin。
这时候不能只盯着 npm config get prefix,必须对应查你实际用的包管理器的全局 bin 路径,并把那个路径加进 PATH。

















