核心用法
coding-agent 是一套通用编码代理封装方案，支持 Codex（OpenAI）、Claude Code（Anthropic）、OpenCode（开源）三种主流工具。通过 exec 指令调用，支持 PTY 交互模式、后台并行执行及进程监控。
典型工作流：
1. 快速原型：codex exec '添加登录功能'（需 pty:true）
2. 复杂重构：claude --permission-mode bypassPermissions --print '重构认证模块'
3. 多任务并行：结合 Git Worktree 创建独立工作区，启动多个后台代理同时处理不同 issue
4. 监控管理：通过 process 系列指令（list/log/poll/kill）追踪进度
显著优点
- 灵活适配：三引擎可选，Codex 速度快、Claude 理解力强、OpenCode 轻量开源
- 后台执行：支持
background:true长时间任务不阻塞主会话 - 安全可控：
--full-auto沙箱自动批准、--yolo极速模式、权限模式分级 - Git Worktree 集成：天然支持并行分支开发，避免代码冲突
- 进度透明：内置里程碑通知机制，关键节点主动反馈
潜在局限
- 环境依赖：Codex 强制要求 Git 目录，无 git 需手动初始化临时目录
- PTY 配置复杂：Codex/OpenCode/Pi 需
pty:true，Claude 不需要，易混淆 - 权限风险：
--yolo无沙箱模式存在文件误删风险；~/.openclaw/目录启动可能泄露敏感配置 - Claude 参数易错：早期版本
--dangerously-skip-permissions已废弃，需使用--permission-mode bypassPermissions --print
适合人群
- 中大型项目开发者，需批量处理 issue/PR 重构
- 需要并行开发多条分支的 Tech Lead
- 希望自动化代码审查、测试补全的 DevOps 工程师
常规风险
- 敏感信息泄露：代理可能读取
.env、密钥文件，建议隔离工作目录 - 代码破坏性变更：
--yolo模式无确认，生产环境慎用 - 僵尸进程：后台任务异常退出时，需手动
process action:kill清理 - 模型幻觉：复杂架构描述可能生成不符合项目规范的代码，需人工审查 PR