---
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]]