name: claude-in-tmux description: Run Claude Code CLI inside tmux sessions within Docker containers. Use this skill when the user wants to run Claude Code in a tmux session, check running tmux sessions, read logs from tmux sessions, or manage claude.sh wrapper script in OpenClaw agent containers.
Claude-in-Tmux
在 OpenClaw Agent 容器中使用 tmux 运行 Claude Code CLI,实现后台任务执行和日志追踪。
核心功能
- 在 tmux session 中后台运行 Claude Code
- 自动记录日志到
/tmp/tmux-logs/ - 支持读取运行中的 session 日志
- 支持指定 session 名称便于管理
- 支持多种国内模型供应商(Kimi、MiniMax、智谱 GLM-5)
支持的模型
可以根据需要添加供应商
| 简写 | 供应商 | 说明 |
|---|---|---|
glm5 |
智谱 GLM-5 | https://www.z.ai/ |
minimax |
MiniMax M2.5 | https://www.minimaxi.com/ |
kimi |
Kimi K2.5 | https://platform.moonshot.cn/ |
快速开始
1. 初始化配置
首次使用前,请阅读 README_for_Openclaw.md 完成初始化:
- 安装 Claude Code:
curl -fsSL https://claude.ai/install.sh | bash - 安装 tmux
- 复制
claude.sh.template为claude.sh - 配置你的 API Key
2. 使用方法
# 后台运行任务(必需指定 -p 提示词)
./claude.sh -m glm5 -p "检查代码中的bug"
# 指定会话名称
./claude.sh -m minimax -p "优化性能" -s task-001
# 读取日志
./claude.sh -l
./claude.sh -l -s task-001
# 附加到运行中的会话
tmux attach -t claude-task-001
日志位置
/tmp/tmux-logs/<session>-<timestamp>.log
例如:/tmp/tmux-logs/task-001-1710654315.log
常用命令
# 查看所有会话
tmux list-sessions
# 检查 Claude 运行状态
tmux list-sessions | grep "^claude-"
# 读取最新日志
tail -n 50 /tmp/tmux-logs/claude-*.log
# 结束会话
tmux kill-session -t claude-task-001
文件说明
| 文件 | 说明 |
|---|---|
claude.sh.template |
配置模板,包含占位符 |
claude.sh |
你的配置文件(从模板复制) |
README_for_Openclaw.md |
详细的初始化指南 |
技术细节
- 工作目录: 当前目录(可通过
CLAUDE_WORKSPACE配置) - 运行用户: 建议使用非 root 用户
- Claude Code: 自动检测(需确保在 PATH 中)
- 必须环境变量:
HOME,ANTHROPIC_AUTH_TOKEN,ANTHROPIC_BASE_URL
更多信息
详见 README_for_Openclaw.md 获取完整的配置指南和故障排除。