Files
nexus/wiki/concepts/ClaudeCodeTerminalIntegration.md
2026-04-27 12:03:03 +08:00

63 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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]]