Installation and Upgrade Issues

This page collects common issues and solutions when installing or upgrading Qoder CLI CN. For installation steps, see Installation and Upgrade.

Command not found

If running qodercn after installation reports command not found, the directory containing the executable is usually not on PATH.

After a global npm install, confirm the global bin directory is on PATH:

npm config get prefix   # Show the global install prefix
# Add <prefix>/bin to PATH

Changes to PATH need to take effect: on Linux / macOS, reopen the terminal or run source after editing your shell config file (such as ~/.zshrc, ~/.bashrc); on Windows, reopen the terminal after changing system environment variables.

Verify the install location:

# Linux / macOS
which qodercn

# Windows
where qodercn          # Command Prompt
Get-Command qodercn    # PowerShell

If installation fails or no binary is available on Windows arm64 devices: that platform is not supported yet; see Installation and Upgrade.

If you hit permission errors during a global install, avoid forcing the install with administrator privileges. Instead, change the npm global directory to a user-writable path and reinstall.
Using a version manager (such as nvm) to manage the runtime avoids permission issues in system-level directories.

First run the built-in update command:
```
qodercn update
```
If the old version still shows after upgrading, first confirm which binary is being invoked (use where qodercn on Windows):
```
which qodercn
qodercn --version
```
If you installed through multiple channels (such as both npm and Homebrew), multiple qodercn binaries may exist, and the one earlier on PATH is invoked first. Uninstall the versions from the extra channels and keep only one.
After cleanup, reinstall the latest version through the original channel: for the script install, use curl -fsSL https://static.qoder.com.cn/qoder-cli-cn/install.sh | bash -s -- --force to force a reinstall; for npm, use npm install -g @qodercn-ai/qoderclicn@latest. See Installation and Upgrade for details.

List all matching executables to confirm whether multiple copies exist: on Linux / macOS use which -a qodercn; on Windows use where qodercn (Command Prompt) or Get-Command qodercn -All (PowerShell).
Keep one installation channel and remove the rest to avoid version confusion.

After installation, run the following commands to confirm it works:

qodercn --version
qodercn --help

If both produce normal output, the installation succeeded.