环境要求
安装 Qoder CLI 前，请确认你的环境满足以下要求：
- 操作系统：macOS、Linux、Windows（推荐使用 Windows Terminal）。
- CPU 架构：arm64、amd64。
- Node.js：仅旧版 npm 安装方式需要 Node.js >= 20.0.0。
Windows (arm64) 暂时不支持。
安装
新安装请使用安装脚本。它会安装原生独立可执行文件，尤其在 Windows 上可获得更好的启动和运行性能。
使用安装脚本（推荐）
安装脚本会根据操作系统和 CPU 架构自动选择兼容的原生版本，完成下载并配置可执行文件。
macOS / Linux
使用 npm 安装（不推荐新安装使用）
npm 包通过 Node.js 运行 JavaScript bundle，不使用原生独立运行时，因此启动和运行性能可能较低，在 Windows 上尤其明显。该方式仅为兼容现有环境而保留；新安装请使用安装脚本。
如果仍需使用 npm 兼容方式，请先安装 Node.js >= 20.0.0，再运行：
验证安装
安装完成后，运行下列命令。如果打印出 CLI 版本号，则表示安装成功：
PATH。相关排查步骤见 安装与升级问题。
首次运行
在任意项目根目录运行以下命令，即可进入默认的交互式（TUI）模式：
升级
Qoder CLI 默认启用自动升级。你也可以随时手动升级到最新版本。
使用安装脚本升级
macOS / Linux
使用内置更新命令
升级已有的 npm 安装
已有 npm 安装在迁移到推荐的安装脚本前，可以继续使用以下命令升级：
自动升级设置
自动升级默认开启。要禁用自动升级，在 ~/.qoder/settings.json 中把 general.enableAutoUpdate 设置为 false：
卸载
卸载方式取决于你的安装方式：
- 通过 npm 安装：执行
npm uninstall -g @qoder-ai/qodercli。 - 通过安装脚本安装：删除安装脚本放置的可执行文件，并从
PATH中移除对应目录。
~/.qoder）。删除前请确认其中没有需要保留的会话、记忆或设置。
配置目录位置可以通过QODER_CONFIG_DIR环境变量自定义，默认是~/.qoder。如果你设置过该变量，请删除对应目录。