用途:把编码、审查、诊断、规划等任务委派给独立的 Claude Code 会话执行,可通过 claude -p 作为 Agent SDK 的 CLI 入口。
前置:安装 npm install -g @anthropic-ai/claude-code;完成认证 claude auth login,可用 claude auth status --text 确认;建议先 cd 到目标项目目录。
主要能力:-p 非交互模式支持 text、json、stream-json 输出;json 返回单对象含 result、session_id、usage、total_cost_usd、is_error 等字段,配合 --json-schema 时结构化结果在 structured_output。stream-json 需配 --verbose,可加 --include-partial-messages 取 token 级增量。会话管理支持 --resume、--continue、--fork-session、--name 等;--no-session-persistence 后不可恢复。权限控制含 --permission-mode、--allowedTools、--disallowedTools、--tools。模型与边界含 --model、--effort、--max-turns、--max-budget-usd、--system-prompt、--mcp-config、--bare、--worktree 等。支持管道 stdin 输入日志或长文本。
用法:自动化默认用 claude -p "任务" --output-format json,并显式传 --model、--effort;编码用 bypassPermissions,审查用 plan 加工具白名单;需隔离时用 --worktree,需可复现时用 --bare(注意其不读取本地 OAuth/keychain)。
限制:文档中 <flagship>、<workhorse> 为占位符而非真实模型 ID,实际模型与收费、价格资料暂未提供;--bare 下需自行提供鉴权;p 模式不依赖交互式 slash commands。