子命令
| 命令 | 说明 |
|---|---|
vtrix auth login | 发起设备码授权，完成后凭据自动保存 |
vtrix auth set-key <api-key> | 直接设置 API Key，无需浏览器登录 |
vtrix auth status | 显示当前登录状态与账户信息 |
vtrix auth logout | 清除本地凭据 |
login 流程
1
发起登录
vtrix auth login终端输出设备码和授权 URL：
┌─────────────────────────────────────────────┐
│ │
│ Visit: https://vtrix.ai/device │
│ Code: ABCD-1234 │
│ │
└─────────────────────────────────────────────┘
Waiting for authorization... (opens browser automatically)2
在浏览器中完成授权
CLI 会自动尝试打开浏览器。若未自动打开，手动访问上方 URL，输入设备码并点击确认。
3
授权成功
浏览器确认后，终端自动收到响应：
✓ Authenticated as user@example.com
✓ Credentials saved to keychain后续的 vtrix run、vtrix models 等命令无需重新登录。
set-key：直接设置 API Key
适合自动化脚本、CI 环境或已有 API Key 时跳过浏览器授权流程。
vtrix auth set-key <api-key>✓ API Key updatedset-key 只更新本地配置中的 API Key 字段，不影响已有的 AuthToken 和 RefreshToken。
何时用 set-key vs login
- 有 API Key：用
set-key，直接写入，无需浏览器。 - 首次使用 / 需要完整账户凭据：用
login，通过设备码完成授权，同时获取 Token 和 API Key。
凭据存储位置
| 平台 | 位置 |
|---|---|
| macOS / Windows | 系统 Keychain |
| Linux（有 D-Bus） | 系统 Keychain |
| Linux（无 D-Bus） | ~/.config/vtrix/config.yml |
强制使用文件存储
设置环境变量 VTRIX_NO_KEYCHAIN=1 可跳过 Keychain，凭据将始终写入 ~/.config/vtrix/config.yml。
查看当前状态
vtrix auth status● Logged in
User: user@example.com
Expires: 2026-07-10退出登录
vtrix auth logout✓ Credentials cleared