快速开始

安装 flintrix-online 后，按下列顺序可在数分钟内跑通 CLI 与 MCP。

---

1. 加载环境

source /etc/profile.d/flintrix.sh
which klymora-run klymora-mcp

应指向 /opt/flintrix/bin/ 下二进制。

---

2. 门户账户与设备关联（默认 CLI）

安装前在浏览器完成：

1. 注册 并完成邮箱验证
2. 登录，在 账户 确认试用或订阅有效
3. 从 下载页 获取并安装生产包

安装后用 CLI login 关联本机（默认路径；适合 ECS/SSH，无需浏览器）：

source /etc/profile.d/flintrix.sh
kay-license-runtime login
# 或: kay-license-runtime login --email you@company.com --password-env FLINTRIX_PASSWORD
klymora-mcp doctor   # 应看到 license.dat present

浏览器备用：kay-license-runtime associate。

关联成功后，本机出现在 账户 设备列表；计费调用会扣减当期用量，用量不足则工具不执行。

详见 CLI 登录与设备关联 与 License 授权与用量。

---

3. CLI 快速检查

klymora-run --help
klymora-sweep --help
verilator --version    # 或 vcs -ID / iverilog -V

在测台目录（含 klymora.toml）冒烟：

cd /path/to/your_tb
klymora-run --simulator verilator .

闭环验证：

klymora-run --verify --simulator verilator .

产物默认在 reports/loop/summary.json，关键字段为 stop_reason。

---

4. Agent / MCP 快速检查

sudo /opt/flintrix/setup/install-klymora-agent.sh
klymora-mcp doctor

脚本会对接 Cursor、OpenCode、Kimi Code、Claude Code / Desktop、VS Code（含 Lingma / Trae）、Qoder、Codex 系 等（已安装的才写入配置，详见 MCP 与 Skills）。

重启你使用的 IDE 后，在 Agent 中应能看到 klymora_* 工具。常用首轮序列：

1. klymora_stimulus_check
2. klymora_verify
3. klymora_read_loop_summary

---

5. 常用路径

路径	内容
/opt/flintrix/bin/	klymora-run、klymora-mcp、klymora-sweep
/opt/flintrix/skills/	内置 Skills 源
~/.cursor/mcp.json	Cursor MCP（示例之一）
~/.config/opencode/opencode.json	OpenCode MCP
~/.kimi-code/mcp.json	Kimi Code MCP
/opt/flintrix/local/agent-integration.json	安装清单
<测台>/reports/loop/	闭环 summary

---

下一步

• 完整安装与依赖：安装与部署
• 授权与用量：License 授权与用量
• MCP / Skills：MCP 与 Skills