CLI 参考 · 引擎与运行

引擎

当前仅完整支持 Claude Code 引擎。更多引擎（Codex、Cursor、Gemini CLI、Qoder、OpenCode、Kimi CLI、Pi 等）正在后续扩展中。

• 新建智能体时选择 Claude Code，智能体将使用该主机上 Claude Code 的完整能力运行
• 你本机 Claude Code 的配置会被智能体复用：技能、命令、MCP、登录态等
• CLI 会检测本机是否安装了 Claude Code（claude 命令或 ~/.claude 目录）；未安装时，CLI 会提示确认 Claude Code 已安装并在 PATH 中

智能体如何运行

一次会话的完整链路：

你在网页对话
  → 平台定位智能体绑定的主机与工作目录
  → 下发运行任务到该主机上的 CLI
  → CLI 在会话工作目录里启动引擎执行
  → 引擎的思考/增量/工具调用/权限请求逐帧回传
  → 网页实时流式展示
  → 运行完成后统计 Token 与模型并持久化

你的网页只是前端，真正干活的是你机器上由 CLI 拉起的引擎进程。

工作目录

• 会话运行在「主机根目录（-dir）+ 智能体选择的相对子目录 + .raagent/workdir-<会话ID>」下，每个会话独立，互不干扰
• 会话中的文件面板、工具读写都发生在这个目录
• 删除会话时，对应工作目录会被回收

权限确认

引擎需要调用工具或修改文件时，会发出权限请求：

• 网页端会弹出确认卡片，由使用者同意或拒绝
• 拒绝后引擎不会执行该操作

并发

一台主机默认最多同时运行 10 个任务，达到上限后新任务会排队等待。可用 -concur <N> 或环境变量 RAAGENT_MAX_CONCUR 调整（命令行优先；daemon install -concur 会持久化）。详见安装与连接 - 最大并发控制。

引擎异常

• 引擎未安装：CLI 会提示确认引擎已安装并在 PATH 中
• 引擎进程异常退出：该次运行记为失败，并回传错误信息

常见排查

主机在线但智能体不可用 确认该智能体绑定的主机就是当前这台、引擎已安装，且智能体处于启用状态。

对话一直「运行中」 查看主机并发是否已满；确认 CLI 进程存活、引擎能正常启动。