CLI 登录令牌

更新于: 2026-06-11 19:19:14

你可以使用 CLI 登录令牌完成身份验证并登录 TRAE CLI。该功能用于解决 TRAE CLI 在 Docker、CICD 等自动化场景中无法唤起浏览器进行登录的问题。

套餐要求

旗舰版。

使用限制

CLI 登录令牌仅限创建者本人使用,不可与企业其他成员共享。

生成 CLI 登录令牌

  1. 登录 TRAE 企业版控制台
  2. 前往 个人信息 > 访问令牌
  3. CLI 登录令牌 处,点击 生成登录令牌 按钮。
  4. 生成 CLI 登录令牌 弹窗中,填写令牌的名称,设置有效期,然后点击 保存 按钮。
    页面上将展示平台为你生成的令牌。

    提示

    令牌仅展示一次,离开当前页面后将无法再次查看。务必立即复制。

    Image
  5. 复制完整的令牌。

使用 CLI 登录令牌登录 TRAE CLI

在 CLI 登录令牌的有效期内,你可以通过配置以下环境变量来登录 TRAE CLI。

提示

填入的登录令牌务必包含开头的 trae-lt- 部分,例如 trae-lt-1caa28e261b7e0d334ccxxxxxxxxxxb870bef62278edd483ec7905e1

macOS & Linux

通过配置临时环境变量来启动并登录 TRAE CLI:

TRAECLI_PERSONAL_ACCESS_TOKEN="your_personal_access_token" traecli

若企业已配置专属域名,还需额外配置 TRAECLI_HOST

TRAECLI_HOST=https://example.com TRAECLI_PERSONAL_ACCESS_TOKEN="your_personal_access_token" traecli

Windows

通过配置用户环境变量来登录 TRAE CLI:

$env:TRAECLI_PERSONAL_ACCESS_TOKEN="your_personal_access_token"
traecli

若企业已配置专属域名,还需额外配置 TRAECLI_HOST

$env:TRAECLI_HOST="https://example.com"
$env:TRAECLI_PERSONAL_ACCESS_TOKEN="your_personal_access_token"
traecli

通过配置用户环境变量来登录 TRAE CLI:

set TRAECLI_PERSONAL_ACCESS_TOKEN=your_personal_access_token
traecli

若企业已配置专属域名,还需额外配置 TRAECLI_HOST

set TRAECLI_HOST=https://example.com
set TRAECLI_PERSONAL_ACCESS_TOKEN=your_personal_access_token
traecli

Windows 环境变量配置建议:
如果你希望长期使用 TRAE CLI,推荐将以下环境变量配置到 Windows 的用户环境变量中。不推荐优先配置到系统环境变量,因为系统环境变量通常需要重启系统后才能完全生效。

  • TRAECLI_PERSONAL_ACCESS_TOKEN
  • TRAECLI_HOST(如企业配置了专属域名)

环境变量配置完成后,务必重新启动 PowerShell 或 CMD,以加载新的配置。
如果 PowerShell 或 CMD 通过其他工具启动,对应工具也需要重新启动。这是因为 Windows 的环境变量会从父进程继承,已启动的程序不会自动感知新的环境变量。