# recursive run
执行单次目标后退出。
```bash
recursive run [选项] <目标>
```
## 参数
| `<目标>` | 传递给 Agent 的目标字符串 |
## 选项
| `--workspace <path>` | 当前目录 | 文件系统沙箱根目录 |
| `--max-steps <n>` | `32` | 步骤预算 |
| `--session <id>` | *(新建)* | 恢复已有会话 |
| `--system-prompt-file <path>` | *(内置)* | 自定义系统提示 |
| `--json` | 关 | 以 JSON 格式输出结果 |
## 示例
```bash
# 基本用法
recursive run "列出 src/ 的文件并总结架构"
# 指定工作区
recursive run --workspace /my/project "审查最近的变更"
# 恢复会话
recursive run --session abc123 "继续上次的工作"
# JSON 输出
## 退出码
| `0` | `FinishReason::NoMoreToolCalls` 或 `FinishReason::ProviderStop` |
| `1` | 运行时错误(作为 `Err(...)` 返回) |
| `2` | `FinishReason::BudgetExceeded` |
| `3` | `FinishReason::Stuck` |