什么是 Claude Code tmux 运行器？

Claude Code tmux 运行器是一款专为处理 AI 驱动的编码任务并发执行而设计的工具。通过利用 tmux 作为后端，它允许开发人员为 Claude Code 启动多个后台会话，从而有效地将线性工作流转变为并行动力源。对于需要分流模块生成、大规模重构或测试套件创建等长时间运行任务，且不锁定主界面的 Openclaw Skills 用户来说，此技能必不可少。

它专为现代开发人员工作流而构建，确保后台作业保持隔离、可观察且可管理。无论您是同时构建 React 前端、Python 认证模块还是 Go 微服务，此技能都能管理每个智能体进程的生命周期，提供一个最大限度提高生产力的非阻塞环境。

下载入口:https://github.com/openclaw/skills/tree/main/skills/xaiohuangningde/claude-tmux-runner

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Claude Code tmux 运行器 应用场景

• 同时运行多个 Claude Code 任务，而不阻塞终端会话。
• 将耗时的代码生成或重构任务分流到后台进程。
• 在不同项目模块中实时监控多个自主编码智能体的进度。
• 通过 Openclaw Skills 生态系统中的集中式 CLI 管理一套后台 AI 作业。

1. 当用户使用 Claude Code 请求任务时，流程开始，系统将其识别为后台执行的候选任务。
2. 该技能优化提示词并提交给用户进行最终确认。
3. 确认后，该技能触发 claude-tmux.sh 脚本以生成一个新的、命名的 tmux 会话。
4. 智能体在后台执行任务，允许用户继续聊天或立即启动其他任务。
5. 用户可以查询特定任务的状态或列出所有活动作业以监控进度。
6. 完成后，生成的文件将被移至指定的工作区，并归档日志以供查看。

Claude Code tmux 运行器 配置指南

要使用此技能，请确保您的系统中已安装 tmux。核心脚本会自动集成到环境中。

# 启动具有特定名称的后台任务
~/.openclaw/scripts/claude-tmux.sh start "编写 Python 认证模块" auth

# 检查活动会话的状态
~/.openclaw/scripts/claude-tmux.sh list

Claude Code tmux 运行器 数据架构与分类体系

该技能在结构化的目录层次结构中管理其操作数据，以确保持久性和可追溯性：

name: claude-tmux-runner
description: Claude Code parallel task manager with tmux backend. For running multiple Claude Code tasks concurrently, monitoring progress, and managing background jobs. Activate when user mentions: Claude Code, background task, parallel, tmux.
tools: Bash, Read, Write

Claude Code tmux Runner

Overview

Run multiple Claude Code tasks in parallel using tmux sessions. Non-blocking, background execution with status monitoring.

Usage

Start a Task

~/.openclaw/scripts/claude-tmux.sh start "Your task description" [task-name]

Examples:

~/.openclaw/scripts/claude-tmux.sh start "Write a Python auth module" auth
~/.openclaw/scripts/claude-tmux.sh start "Build a React component" ui
~/.openclaw/scripts/claude-tmux.sh start "Create a Go microservice" api

List All Tasks

~/.openclaw/scripts/claude-tmux.sh list

Check Task Status

~/.openclaw/scripts/claude-tmux.sh status 

View Generated Files

~/.openclaw/scripts/claude-tmux.sh files

Stop Tasks

~/.openclaw/scripts/claude-tmux.sh stop 
~/.openclaw/scripts/claude-tmux.sh stop-all

Workflow

1. User says "use Claude Code xxx" → Optimize prompt → Show for approval
2. User confirms → Start background task → Return immediately
3. User can continue chatting → Non-blocking
4. User asks "how is Claude doing" → Check status → Return progress

Industrial Code Standards

Generated code must include:

1. Complete error handling (try-catch, boundary checks)
2. Type annotations (TypeScript, Python type hints)
3. Documentation (JSDoc, docstring)
4. Unit tests (pytest, jest)
5. Performance considerations (time/space complexity)
6. Security best practices (input validation)
7. Maintainability (clear naming, modular)

File Locations

• Script: ~/.openclaw/scripts/claude-tmux.sh
• Logs: ~/.openclaw/logs/claude/
• Files: ~/.openclaw/workspace/
• State: ~/.openclaw/state/claude/