核心用法
Claude Code CLI技能是一个强大的编码代理委派工具，通过背景进程运行Anthropic的Claude Code CLI。它提供两种运行模式：交互式PTY模式（pty:true）用于需要确认、权限提示或用户输入的复杂任务；无头管道模式（-p标志）用于自动化脚本和CI场景。
关键执行模式包括：前台同步执行（等待完成）、后台异步执行（返回sessionId可监控）、以及结合Process工具的动作系统（list/poll/log/write/submit/send-keys/kill）进行会话管理。
显著优点
1. 双模式架构灵活：PTY模式解决交互式CLI的伪终端依赖问题，管道模式支持结构化JSON输出和流式响应，覆盖从探索性开发到生产自动化的全场景
2. 会话连续性完善：支持--resume、--continue、--fork-session及PR关联恢复，配合HANDOFF.md模式处理超长任务上下文断裂
3. 安全机制分层：--permission-mode提供default/acceptEdits/plan/dontAsk/bypassPermissions五级权限控制，避免--dangerously-skip-permissions的完全失控风险
4. 并行工作流原生支持：Git worktree集成实现多分支并行修复、Fan-Out批量操作模式、Writer/Reviewer双会话协作审查
5. 资源与预算管控：--max-budget-usd消费上限、--allowedTools工具粒度限制、推荐最多3-4并发会话的资源管理
潜在局限
- 外部依赖重：必须预装Node.js和
@anthropic-ai/claude-codenpm包，对网络环境和Anthropic服务可用性敏感 - PTY模式必需性认知门槛：新手易忽略
pty:true导致代理挂起，文档虽强调但属于常见误用点 - 超时策略复杂：真实任务需1800s+超时，与常规exec工具的短默认值冲突，需显式配置
- 沙箱逃逸风险：
elevated:true允许在主机运行，配合--dangerously-skip-permissions存在权限提升攻击面
适合人群
- 管理大型代码库的资深开发者、需要批量处理技术债务的架构师
- 执行PR审查、安全审计的DevOps工程师（配合隔离的/tmp目录工作流）
- 构建自动化代码分析、迁移脚本的AI工程团队
常规风险
1. 工作区污染：严禁在~/.openclaw/或活动项目目录直接执行分支切换，必须使用独立克隆/worktree
2. 会话泄漏：后台任务未设置完成通知（openclaw system event）时，用户无法感知失败状态
3. 预算失控：未设置--max-budget-usd的管道模式可能在API异常时产生意外费用
4. 权限提示阻塞：后台任务未使用acceptEdits模式会因等待确认而僵死
5. 并发资源争用：超过4个活跃会话可能导致Claude Code CLI响应降级或系统资源耗尽