nexus/wiki/concepts/ClaudeCodeTerminalIntegration.md

title, type, tags, last_updated

title	type	tags	last_updated
Claude Code Terminal Integration	concept	claude-code hermes ai-agent terminal tmux subprocess	2026-04-27

Aliases

• TMUX 交互模式
• Claude Code TMUX Mode

Definition

Hermes Agent 通过 terminal 工具启动 Claude Code 进程的两种集成方式：Print Mode（推荐）和 TMUX 交互模式。这两种模式允许 Hermes 作为编排层调用 Claude Code CLI，实现外部 AI 工具的程序化调用。

Two Integration Modes

Mode 1: Print Mode（推荐）

cat << 'TASK_END' | claude -p print \
  --dangerously-skip-permissions \
  --add-dir ~/.claude/skills/[技能名] \
  --max-turns 30 \
  2>&1
[任务描述]
TASK_END

• 非交互单次执行
• 适合绝大多数自动化场景
• 优先选用

Mode 2: TMUX 交互模式

tmux new-session -d -s <session-name> -x 140 -y 40
tmux send-keys -t <session-name> 'claude --permission-mode bypassPermissions' Enter
sleep 8 && tmux capture-pane -t <session-name> -p

• 适合超长任务或需要中途干预
• 任务文本通过 tmux send-keys 发送
• 使用 --permission-mode bypassPermissions 跳过确认

Key Parameters

参数	作用
--permission-mode bypassPermissions	直接设置 bypass 模式，跳过所有交互确认
--dangerously-skip-permissions	同上，但通过 CLI 内部触发，可能仍需交互确认
--add-dir <路径>	添加可访问目录，可多次使用
--max-turns N	最大迭代次数，建议 20-30
--bare	跳过插件/MCP/CLAUDE.md 加载，最快启动

Skill Loading

Claude Code 自动扫描 --add-dir 目录下的 SKILL.md 和 .claude/skills/ 目录。

--add-dir ~/.claude/skills/[技能名]   # 加载指定技能

Sources

• Claude Code 调用方法总结

Connections

• ClaudeCodeTerminalIntegration ← 被 ← Hermes Agent
• ClaudeCodeTerminalIntegration ← 对比 ← SubagentDelegation