claude-in-tmux

star 561

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.

xiaotianfotos By xiaotianfotos schedule Updated 3/17/2026

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 完成初始化:

  1. 安装 Claude Code: curl -fsSL https://claude.ai/install.sh | bash
  2. 安装 tmux
  3. 复制 claude.sh.templateclaude.sh
  4. 配置你的 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 获取完整的配置指南和故障排除。

Install via CLI
npx skills add https://github.com/xiaotianfotos/skills --skill claude-in-tmux
Repository Details
star Stars 561
call_split Forks 155
navigation Branch main
article Path SKILL.md
More from Creator
xiaotianfotos
xiaotianfotos Explore all skills →