CLI 登录与设备关联

Flintrix Online 默认路径:用 CLI 邮箱 + 密码 把本机关联到门户账户。浏览器 device-code 关联仅为备用。


前置条件

  1. 注册 并完成邮箱验证
  2. 在 账户 确认试用或订阅有效
  3. 已安装 flintrix-online(source /etc/profile.d/flintrix.sh)

默认:CLI login

kay-license-runtime login
# 交互输入邮箱 / 密码(密码不回显)——最简单

或只传邮箱,密码交互输入:

kay-license-runtime login --email you@company.com

非交互(脚本 / CI):设置 FLINTRIX_PASS 后不必再写 --password-env:

export FLINTRIX_PASS='...'
kay-license-runtime login --email you@company.com

也可用 --password-env NAME 指定任意环境变量名;-p / --password 仍可用(会进 shell 历史,仅适合临时自测)。

成功后写入加密 license.dat(通常在 ~/.config/kay-license-runtime/)。然后:

klymora-mcp doctor   # 应看到 license.dat present

共享主机上的多用户

多人共用同一台 Linux(实验室服务器、云测机等)时:

项目范围说明
工具(/opt/flintrix)整机共享装一份即可
Skills / MCP 配置每个 Linux 用户各自一份写在该用户的 ~/.config、~/.cursor 等
license.dat每个 Linux 用户各自一份~/.config/kay-license-runtime/license.dat
用量与套餐门户账号谁登录、谁扣费

建议:一人一个 Linux 登录名 + 一个门户账号。各自执行:

source /etc/profile.d/flintrix.sh
kay-license-runtime login
kay-license-runtime verify
bash /opt/flintrix/setup/install-klymora-agent.sh --agent-only

然后重启自己的 IDE。不同 Linux 用户可同时并行使用工具;额度与并发席位按各自门户套餐计算。

请勿多人共用同一个 Linux 用户轮流 login(会覆盖同一份 license.dat,计费会串户)。也不要互相拷贝 license.dat。

若小组共用一个门户账号、多人使用:工具仍可运行,但额度与并发席位共用该账号,流水按账号汇总,一般无法按人名拆分。


备用:浏览器 associate

kay-license-runtime associate

生成关联码并打开门户 URL;在浏览器确认后 CLI 轮询完成。无桌面浏览器的 ECS/SSH 请优先用 login。

若提示 待确认关联码过多:

# 可按本机指纹列出/清理 pending(API: GET/DELETE /api/v1/device-code/pending)
# 或等待 retry_after_secs / 关联码过期(约 10 分钟)后重试
# 更推荐直接改用: kay-license-runtime login

设备数上限

各套餐有最大已激活设备数。若提示设备上限:

  1. 打开 账户 → 设备
  2. 解绑旧设备
  3. 重新执行 kay-license-runtime login

界面语言

CLI 文案优先级:

  1. KLYMORA_LANG=zh|en
  2. 会话 LANG / LC_ALL / LC_MESSAGES(en_* / zh_*)
  3. /etc/flintrix/ui-lang(安装器默认 en;中文:echo zh | sudo tee … 或安装时 FLINTRIX_UI_LANG=zh)
  4. 默认英文

若选中文但 locale 看起来不是 UTF-8,会回退英文(避免部分 SSH 客户端乱码)。


相关文档