Auto-sync: 2026-04-27 12:02

wiki/concepts/ClaudeCodeTerminalIntegration.md

@@ -0,0 +1,62 @@
+---
+title: "Claude Code Terminal Integration"
+type: concept
+tags: [claude-code, hermes, ai-agent, terminal, tmux, subprocess]
+last_updated: 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（推荐）
+```bash
+cat << 'TASK_END' | claude -p print \
+  --dangerously-skip-permissions \
+  --add-dir ~/.claude/skills/[技能名] \
+  --max-turns 30 \
+  2>&1
+[任务描述]
+TASK_END
+```
+- 非交互单次执行
+- 适合绝大多数自动化场景
+- 优先选用
+
+### Mode 2: TMUX 交互模式
+```bash
+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/` 目录。
+```bash
+--add-dir ~/.claude/skills/[技能名]   # 加载指定技能
+```
+
+## Sources
+- [[Claude Code 调用方法总结]]
+
+## Connections
+- [[ClaudeCodeTerminalIntegration]] ← 被 ← [[Hermes Agent]]
+- [[ClaudeCodeTerminalIntegration]] ← 对比 ← [[SubagentDelegation]]