Skip to main content
操作指南

快速上手

本文介绍如何安装、登录、使用、升级和登出 Qoder CN CLI。

安装

  • 支持的操作系统：macOS、Linux、Windows（Windows Terminal）
  • 支持的 CPU 架构：arm64、amd64
Windows (arm64) 暂时不支持。
可以通过以下方式安装： macOS / Linux 
curl -fsSL https://qoder.cn/install | bash
Windows PowerShell 
irm https://qoder.cn/install.ps1 | iex
Windows CMD 
curl -fsSL https://qoder.cn/install.cmd -o install.cmd && install.cmd
Homebrew（macOS、Linux） 
brew install qoderai/qoder/qoderclicn --cask
安装完成后，运行下列命令。如果打印出 CLI 版本号，则表示安装成功。 
qoderclicn --version

登录

在使用 Qoder CN CLI 之前需要完成身份验证。首次执行命令时，CLI 会自动提示你登录。 有两种主要的身份验证方式：
  • 交互式登录（推荐）
  • 环境变量（用于自动化脚本）
方法一：通过 TUI 登录 此方法支持你直接在终端的文本用户界面（TUI）中登录。 
# 在终端中启动 Qoder CN CLI
qoderclicn

# 在交互式提示符中,输入 /login
/login
选择需要的登录方式：
  • login with browser: 这会在你的默认浏览器中打开登录页面以完成身份验证。
  • login with qoder personal access token: 系统会提示你将 Qoder Personal Access Token 直接粘贴到终端。
在你做出选择后，应用会引导你完成最后的步骤。
你可以在此页面获取 Personal Access Token：https://qoder.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。

升级

默认启用自动升级。你也可以使用以下方法手动升级： macOS / Linux 
curl -fsSL https://qoder.cn/install | bash -s -- --force
Windows PowerShell 
irm https://qoder.cn/install.ps1 | iex
Windows CMD 
curl -fsSL https://qoder.cn/install.cmd -o install.cmd && install.cmd
Homebrew（macOS、Linux） 
brew update && brew upgrade
使用内置的更新功能 
qoderclicn update
要禁用自动更新，请在 ~/.qoder-cn/settings.json 中将 general.enableAutoUpdate 设置为 false。 
{
  "general": {
    "enableAutoUpdate": false
  }
}

退出登录

当你需要登出 Qoder CN CLI 时，可使用 /logout 命令退出登录。 
# 在交互式提示符中,输入 /logout
/logout
如果你是通过 QODERCN_PERSONAL_ACCESS_TOKEN 环境变量完成认证的，在运行 /logout 之前必须先清除该环境变量。
产品概述
操作指南