智能编码助手灵码：快速上手

安装

• 支持的操作系统：macOS、Linux、Windows（Windows Terminal）

• 支持的 CPU 架构：arm64、amd64

Windows (arm64) 暂时不支持。

可以通过以下方式安装：

cURL（macOS、Linux）

curl -fsSL https://qoder.com.cn/install | bash

NPM（macOS、Linux、Windows）

npm install -g @qodercn-ai/qoderclicn

安装完成后，运行下列命令。如果打印出 CLI 版本号，则表示安装成功。

qoderclicn --version

登录

在使用 Qoder CN CLI 之前需要完成身份验证。首次执行命令时，CLI 会自动提示你登录。

有两种主要的身份验证方式：

• 交互式登录（推荐）

• 环境变量（用于自动化脚本）

方法一：通过 TUI 登录

此方法支持你直接在终端的文本用户界面（TUI）中登录。

# 在终端中启动 Qoder CN CLI
qoderclicn

# 在交互式提示符中,输入 /login
/login

选择需要的登录方式：

• login with browser: 这会在你的默认浏览器中打开登录页面以完成身份验证。

• login with qodercn personal access token: 系统会提示你将 Qodercn Personal Access Token 直接粘贴到终端。

在你做出选择后，应用会引导你完成最后的步骤。

你可以在此页面获取 Personal Access Token：https://qodercn.com.cn/account/integrations

方法二：通过环境变量登录

对于非交互式会话或自动化环境（例如 CI/CD 流水线），你可以通过设置环境变量进行身份验证。

# Linux/macOS 示例
export QODERCN_PERSONAL_ACCESS_TOKEN="your_personal_access_token_here"

# Windows 示例(命令提示符)
set QODERCN_PERSONAL_ACCESS_TOKEN="your_personal_access_token_here"

如果同时通过 /login 命令和该环境变量设置了有效令牌，则以 /login 提供的令牌为准。

使用

现在你已登录，可参考使用 CLI 了解如何使用 Qoder CN CLI。

升级

默认启用自动升级。你也可以使用以下方法手动升级：

cURL

curl -fsSL https://qoder.com.cn/install | bash -s -- --force

Homebrew（macOS、Linux）

brew update && brew upgrade

NPM

npm install -g @qodercn-ai/qoderclicn

使用内置的更新功能

qoderclicn update

要禁用自动更新，请在 ~/.qodercn.json 中将 autoUpdates 设置为 false。

{
  "autoUpdates": false,
  "...": "..."
}

退出登录

当你需要登出 Qoder CN CLI 时，可使用 /logout 命令退出登录。

# 在交互式提示符中,输入 /logout
/logout

如果你是通过 QODERCN_PERSONAL_ACCESS_TOKEN 环境变量完成认证的，在运行 /logout 之前必须先清除该环境变量。