安装与升级问题

​

命令未找到（command not found）

• 通过 npm 全局安装后，确认全局 bin 目录已加入 PATH：
  Copy

  npm config get prefix   # 查看全局安装前缀
  # 将 <prefix>/bin 加入 PATH
  
• 修改 PATH 后需让其生效：Linux / macOS 改完 shell 配置文件（如 ~/.zshrc、~/.bashrc）后重开终端或执行 source；Windows 在系统环境变量中修改后需重开终端。
• 验证安装位置：
  Copy

  # Linux / macOS
  which qodercli
  
  Copy

  # Windows
  where qodercli          # 命令提示符
  Get-Command qodercli    # PowerShell
  
• 若在 Windows arm64 设备上安装失败或无可用二进制：该平台暂不支持，见 安装与升级。

​

权限被拒绝（permission denied）

• 全局安装时如遇权限错误，避免使用管理员权限强装。推荐将 npm 全局目录改到用户可写路径，再重新安装。
• 使用版本管理器（如 nvm）管理运行时，可避免系统级目录的权限问题。

​

升级失败或版本未更新

• 先运行内置更新命令：
  Copy

  qodercli update
  
• 升级后仍显示旧版本，先确认当前调用的是哪一个二进制（Windows 用 where qodercli）：
  Copy

  which qodercli
  qodercli --version
  
• 若存在多个渠道安装（如同时用 npm 与 Homebrew），可能产生多个 qodercli，PATH 中靠前的会被优先调用。卸载多余渠道的版本，只保留一个。
• 清理后按原渠道重新安装最新版本：脚本安装用 curl -fsSL https://qoder.com/install | bash -s -- --force 强制重装，npm 安装用 npm install -g @qoder-ai/qodercli@latest。详见 安装与升级。

​

重复安装 / 多版本冲突

• 列出所有匹配的可执行文件，确认是否有多份：Linux / macOS 用 which -a qodercli，Windows 用 where qodercli（命令提示符）或 Get-Command qodercli -All（PowerShell）。
• 保留一个安装渠道，移除其余，避免版本混淆。

​

验证安装

qodercli --version
qodercli --help

​

下一步

• 安装与升级指南：安装与升级。
• 下载或安装过程中的网络问题：网络、代理与 VPC 问题。
• 登录问题：登录与认证问题。