Skip to main content
Getting started

Installation and Upgrade

Requirements

Before installing Qoder CLI CN, make sure your environment meets the following requirements:
  • Operating system: macOS, Linux, Windows (Windows Terminal recommended).
  • CPU architecture: arm64, amd64.
  • Node.js: Node.js >= 20.18.1 is required only for the legacy npm installation method.
Windows (arm64) is not supported yet.

Install

Use the installation script for new installations. It installs the native standalone executable and typically provides better startup and runtime performance than the npm package, especially on Windows. The install script automatically selects a compatible native build for your operating system and CPU architecture, downloads it, and sets up the executable. macOS / Linux 
curl -fsSL https://static.qoder.com.cn/qoder-cli-cn/install.sh | bash
Windows PowerShell 
irm https://static.qoder.com.cn/qoder-cli-cn/install.ps1 | iex
Windows CMD 
curl -fsSL https://static.qoder.com.cn/qoder-cli-cn/install.cmd -o install.cmd && install.cmd
The npm package runs the JavaScript bundle on Node.js instead of using the native standalone runtime, so startup and runtime performance may be lower, particularly on Windows. This method is retained for compatibility with existing environments; use the installation script for new installations. If you still need the npm compatibility path, install Node.js >= 20.18.1 and run: 
npm install -g @qodercn-ai/qoderclicn

Verify the installation

After installation, run the following command. If it prints the CLI version number, the installation succeeded: 
qodercn --version
If the command is not found, check whether the installation directory has been added to your system PATH. For troubleshooting steps, see Installation and Upgrade Issues.

First run

Run the following command in any project root to enter the default interactive (TUI) mode: 
qodercn
On first run, Qoder CLI CN guides you through sign-in. For sign-in methods, see Sign-in and Authentication.

Upgrade

Qoder CLI CN has auto-update enabled by default. You can also manually upgrade to the latest version at any time.

Upgrade with the install script

macOS / Linux 
curl -fsSL https://static.qoder.com.cn/qoder-cli-cn/install.sh | bash -s -- --force
Windows PowerShell 
irm https://static.qoder.com.cn/qoder-cli-cn/install.ps1 | iex
Windows CMD 
curl -fsSL https://static.qoder.com.cn/qoder-cli-cn/install.cmd -o install.cmd && install.cmd

Using the built-in update command

qodercn update

Upgrade an Existing npm Installation

Existing npm installations can continue to upgrade with the following command while migrating to the recommended installation script: 
npm install -g @qodercn-ai/qoderclicn@latest

Auto-update settings

Auto-update is enabled by default. To disable it, set general.enableAutoUpdate to false in ~/.qoder-cn/settings.json: 
{
  "general": {
    "enableAutoUpdate": false
  }
}
For configuration file scopes and precedence, see Settings Files and Precedence.

Uninstall

How to uninstall depends on how you installed:
  • Installed via npm: run npm uninstall -g @qodercn-ai/qoderclicn.
  • Installed via the install script: delete the executable placed by the install script, and remove the corresponding directory from PATH.
If you also want to clean up configuration and local data, delete the config directory (default ~/.qoder-cn). Before deleting, make sure it contains no sessions, memory, or settings you want to keep.
The config directory location can be customized with the QODERCN_CONFIG_DIR environment variable; the default is ~/.qoder-cn. If you have set this variable, delete the corresponding directory instead.
Getting started
Core concepts
Using Qoder CLI
Extending Qoder CLI
Integrations and remote
Configuration and security
Reference
Troubleshooting