AI Coding Assistant Lingma：快速上手

安裝

• 支援的作業系統：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://qoder.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

NPM

npm install -g @qodercn-ai/qoderclicn

使用內建的更新功能

qoderclicn update

要禁用自動更新，請在 ~/.qoder-cn.json 中將 autoUpdates 設定為 false。

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

退出登入

當你需要登出 Qoder CN CLI 時，可使用 /logout 命令退出登入。

# 在互動式提示符中,輸入 /logout
/logout

如果你是通過 QODERCN_PERSONAL_ACCESS_TOKEN 環境變數完成認證的，在運行 /logout 之前必須先清除該環境變數。