nexus/wiki/concepts/ClaudeCodePrintMode.md

title, type, tags, last_updated

title	type	tags	last_updated
Claude Code Print Mode	concept	claude-code hermes ai-agent terminal non-interactive	2026-04-27

Aliases

• Print Mode
• claude -p

Definition

Claude Code 的非交互单次执行模式。通过 claude -p print 命令调用，配合 stdin 传递任务描述文本，适合绝大多数自动化场景和 Hermes Agent 的程序化调用。

How It Works

cat << 'TASK_END' | claude -p print \
  --dangerously-skip-permissions \
  --add-dir ~/.claude/skills/[技能名] \
  --add-dir [项目源码路径] \
  --add-dir /tmp \
  --max-turns 30 \
  2>&1
[具体任务描述]
TASK_END

Key Parameters

• --dangerously-skip-permissions：跳过交互确认（信任目录、权限提示）
• --add-dir <路径>：添加可访问目录，可多次使用
• --max-turns N：最大迭代次数，建议 20-30
• --bare：跳过插件/MCP/CLAUDE.md 加载，最快启动
• --model <模型>：指定模型，如 sonnet、opus
• --output-format json：结构化 JSON 输出

Task Text Structure（stdin 写法规范）

1. 告诉 Claude Code 要做什么
2. 告诉它用哪个 skill
3. 告诉它目标文件输出到哪里
4. 如果需要格式转换（如 SVG → PNG），明确写出转换命令
5. 最后要求它输出 "done: 文件路径"

Relationship to TMUX Mode

• Print Mode：适合绝大多数自动化场景，单次执行，无需后续交互
• TMUX 交互模式：适合超长任务或需要中途干预的场景

Sources

• Claude Code 调用方法总结

Connections

• ClaudeCodePrintMode ← 推荐使用 ← Claude Code
• ClaudeCodePrintMode ← 对比 ← ClaudeCodeTerminalIntegration