Claude Code 单次编码 CLI

问题

很多自动化编码流程卡在交互式确认、PTY 依赖或后台任务不可观测上。Claude Code CLI 本身能力可用，但如果直接嵌入脚本，常遇到权限弹窗、前台阻塞和目录漂移，导致任务无法无人值守完成。脚本集成时尤其明显：任务需要可预测的输出、可控的工作目录，以及不依赖人工确认的执行路径。

工作方式

该技能把 Claude Code 封装为一次性编码代理，核心要求是始终使用 --print 和 --permission-mode bypassPermissions，避免确认弹窗并保持非交互输出。任务可以在当前目录运行，也可通过 workdir 指定项目目录；短任务适合前台执行，长任务放入后台，再用 process action:log 观察进度。文档强调不使用 PTY，因为 Claude Code 不依赖 PTY，且 PTY 会破坏流程。

边界与注意

它适合构建功能、重构、调试、测试和代码审查这类边界较清晰的工程任务，但提示词必须具体。bypassPermissions 降低了交互摩擦，也扩大了自动执行范围，因此不适合在不可信目录中随意运行。后台任务如果没有监控，容易看起来已完成却缺少验证。