Claude Tmux Bridge

克劳德码MCP-tmux桥

一个MCP服务器，将Claude Desktop连接到在tmux终端中运行的交互式Claude Code会话。它不是为每个提示符生成一个一次性进程，而是与一个持久的、可见的会话进行通信——这样你就可以在Desktop编排任务的同时实时观看Claude的工作。

运作原理

Claude Desktop  →  claude_code MCP tool  →  tmux session  →  Claude Code (interactive)
                        (this repo)

• 克劳德桌面版 保存您的项目上下文、设计决策和任务历史。它会生成提示，并知道接下来需要做什么。
• 克劳德代码 在您可以观看的tmux终端中交互式运行。它可以访问您配置的所有MCP工具，并保留通话之间的完整对话历史。
• 此服务器 是它们之间的管道——它将Desktop的提示传递给Code的会话，并将响应带回。

需求

• macOS
• Node.js v20或更高版本
• 终端复用器 — brew install tmux
• 克劳德代码CLI-- npm install -g @anthropic-ai/claude-code

设置

1.安装此服务器

git clone https://github.com/DaRealDaHoodie/claude-tmux-bridge.git
cd claude-tmux-bridge
npm install
npm run build

2.配置克劳德桌面

将此服务器添加到您的Claude Desktop MCP配置中(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "claude-tmux-bridge": {
      "command": "node",
      "args": ["/path/to/claude-tmux-bridge/dist/server.js"]
    }
  }
}

保存后重新启动Claude Desktop。

使用工具

配置后，Claude Desktop可以访问 claude_code 工具。发送提示时，告诉Desktop：

• 该怎么办 --Claude Code的任务或问题
• 哪个项目 --通行证 workFolder 作为项目目录的绝对路径

桌面示例说明：

将claude_code工具与workFolder一起使用 /Users/you/my-project 并要求Claude Code实现我们刚才设计的功能。

其他一切都是自动的——tmux会话和Claude Code实例是在第一次使用时创建的。

会话命名

tmux会话名称来源于项目文件夹的基名称：

看着克劳德工作

会话在后台自动运行。附上任何时间观看：

tmux attach -t claude-my-project
# Detach with Ctrl+B D

工具参数

行为

• 会话未找到 --自动创建植根于以下位置的tmux会话 workFolder
• Claude代码未运行 --自动发射 claude 在会话中，等待长达30秒才能准备就绪
• 会话繁忙 --以“仍忙”消息拒绝；不排队
• 超时 --通过检查Claude是否已结束通话，在下次通话时自动恢复
• 对话历史 --通话之间完全保留（同一交互会话）

环境变量

多个项目

每个项目都有自己的命名tmux会话。您可以同时打开多个会话——只需传递正确的 workFolder 桌面将以正确的为目标。

许可证

麻省理工学院