若终端提示“command not found”，说明qoderwake路径未加入PATH；需先定位二进制文件（如~/qoderwake/bin/qoderwake），再临时或永久将该目录添加至PATH，并确保文件有执行权限且格式有效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在终端中尝试运行 QoderWake 相关命令（如 qoderwake 或 wake-cli），但系统返回 “command not found”，则很可能是该命令的可执行文件路径未被纳入 Shell 的 PATH 环境变量中。以下是解决此问题的步骤：
一、确认 QoderWake 可执行文件的实际位置
QoderWake 的二进制文件通常安装在用户主目录下的特定子目录（如 ~/qoderwake/bin/）或通过包管理器安装至系统路径（如 /usr/local/bin/）。需先定位其真实路径，才能将其加入 PATH。
1、打开终端，执行以下命令查找是否存在已知命名的可执行文件：
which qoderwake || find ~/qoderwake -name "qoderwake" 2>/dev/null | head -n1
2、若未返回结果，尝试搜索常见安装路径：
ls -l ~/qoderwake/bin/qoderwake 2>/dev/null || ls -l /usr/local/bin/qoderwake 2>/dev/null
3、记录输出中显示的完整绝对路径（例如：/home/user/qoderwake/bin/qoderwake）。
二、临时添加路径至当前 Shell 的 PATH
该方法仅对当前终端会话生效，适用于快速验证是否为 PATH 缺失所致，不改变系统持久配置。
1、将上一步获取的可执行文件所在目录（非文件本身）代入以下命令：
export PATH="/home/user/qoderwake/bin:$PATH"
2、立即验证是否生效：
echo $PATH | grep -o "/home/user/qoderwake/bin"
3、运行测试命令：
qoderwake --version
三、永久配置 PATH（针对 Bash/Zsh 用户）
修改 Shell 启动文件（如 ~/.bashrc 或 ~/.zshrc），使 PATH 更新在每次新终端启动时自动加载。
1、使用文本编辑器打开对应配置文件：
nano ~/.bashrc（Bash）或 nano ~/.zshrc（Zsh）
2、在文件末尾新增一行（将路径替换为实际路径）：
export PATH="/home/user/qoderwake/bin:$PATH"
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、保存并退出编辑器（Nano 中按 Ctrl+O → Enter → Ctrl+X）。
4、立即应用变更：
source ~/.bashrc 或 source ~/.zshrc
四、永久配置 PATH（针对 Windows Git Bash 用户）
Git Bash 使用 ~/.bash_profile 或 ~/.bashrc 加载环境变量，需确保配置写入正确文件并适配 POSIX 路径格式。
1、在 Git Bash 中执行：
echo 'export PATH="/c/Users/YourName/AppData/Local/qoderwake/bin:$PATH"' >> ~/.bash_profile
2、注意路径转换：Windows 中的 C:\Users\YourName\AppData\Local\qoderwake\bin 需写作 /c/Users/YourName/AppData/Local/qoderwake/bin。
3、重新加载配置：
source ~/.bash_profile
五、检查并修复权限与文件完整性
即使路径已加入 PATH，若可执行文件缺失执行权限或已被损坏，仍会触发 “command not found” 错误（某些 Shell 将无权限文件视作不存在）。
1、进入可执行文件所在目录：
cd /home/user/qoderwake/bin
2、检查文件权限是否包含执行位（x）：
ls -l qoderwake（应显示类似 -rwxr-xr-x）
3、若无执行权限，添加之：
chmod +x qoderwake
4、验证文件是否为有效 ELF（Linux/macOS）或 PE（Windows）格式：
file qoderwake（输出应含 “executable” 字样）
