正文内容
编码智能体（以 Bash 为先）
所有编码智能体工作均使用 bash（可选后台模式）。简洁且高效。
⚠️ 必须启用 PTY 模式！
编码智能体（Codex、Claude Code、Pi）是交互式终端应用，必须依赖伪终端（PTY）才能正常运行。若未启用 PTY，将出现输出错乱、颜色丢失，甚至智能体挂起等问题。
运行编码智能体时务必指定 pty:true：
# ✅ 正确 — 启用 PTY bash pty:true command:"codex exec 'Your prompt'" # ❌ 错误 — 未启用 PTY，智能体可能异常 bash command:"codex exec 'Your prompt'"
Bash 工具参数说明
| 参数 | 类型 | 描述 |
|---|---|---|
command |
string | 要执行的 Shell 命令 |
pty |
boolean | 编码智能体必需！ 为交互式 CLI 分配伪终端 |
workdir |
string | 工作目录（智能体仅可见该目录下的上下文） |
background |
boolean | 后台运行，返回 sessionId 用于后续监控 |
timeout |
number | 超时时间（秒），超时后自动终止进程 |
elevated |
boolean | 在宿主机而非 sandbox 中运行（如权限允许） |
进程工具操作（适用于后台会话）
| 操作 | 描述 |
|---|---|
list |
列出所有正在运行或最近结束的会话 |
poll |
检查会话是否仍在运行 |
log |
获取会话输出（支持可选的 offset/limit 参数） |
write |
向 stdin 写入原始数据 |
submit |
写入数据并附加换行符（模拟输入后按 Enter） |
send-keys |
发送键值令牌或十六进制字节 |
paste |
粘贴文本（支持可选的 bracketed paste 模式） |
kill |
终止该会话 |
标准模式：workdir + background + pty
对于耗时较长的任务，请结合后台模式与 PTY：
# 在目标目录中启动智能体（务必启用 PTY！） bash pty:true workdir:~/project background:true command:"codex exec --full-auto 'Build a snake game'" # 返回 sessionId 用于追踪 # 监控进度 process action:log sessionId:XXX # 检查是否完成 process action:poll sessionId:XXX # 如智能体提出问题，发送输入 process action:write sessionId:XXX data:"y" # 提交输入（类似键入 "yes" 后按 Enter） process action:submit sessionId:XXX data:"yes" # 如需中止，可手动终止 process action:kill sessionId:XXX
为何 workdir 至关重要？
智能体将在指定目录中“苏醒”，不会漫无目的地读取无关文件（比如你的 soul.md