做 Windows 远程开发有一段时间了中间换过不少工具链最后固定下来的组合里tmux 会话管理加 Claude Code 自动化是提升效率最明显的一组搭档。这篇文章我会从需求拆解开始把环境配置、tmux 的日常用法、Claude Code 的自动化和常见坑一次讲清楚适合工作在 Windows 机器上、但经常要登录远程服务器开发的人也适合想把自己本地开发流程升级成更可维护状态的朋友。先说明一点我讲的不是“Windows 原生终端里硬跑 Linux 工具”而是基于 Windows 子系统WSL的完整方案这也是目前 Windows 上做远程开发最顺手的一条路。1. 为什么 Windows 远程开发里tmux 和 Claude Code 要一起用1.1 我的工作场景与核心痛点我日常工作分两块一是开发部署在 Linux 服务器上的后端服务二是维护一批定时脚本和批处理任务。过去最难受的地方是SSH 连上去跑一个耗时任务本地网络一波动终端一断任务就跟着断同时开好几个远程会话窗口一多根本分不清哪个在跑什么改完代码还要手动重复执行一堆命令比如重启服务、跑测试、查看日志既无聊又容易漏。之前也用 Windows 自带的命令提示符和 PowerShell 折腾过后来切到 WSL 之后舒服了很多但真正把体验拉上一个台阶的是引入了 tmux 会话管理。tmux 能让我把所有远程操作装进一个可以随时挂起和恢复的容器里网络断了没关系重新连回去一切还在。然后再配合 Claude Code把那些重复性极强的命令变成半自动甚至全自动的流程。1.2 tmux 解决的是“远程操作的生命周期”问题很多人第一次接触 tmux 会觉得它只是一个“终端分屏工具”其实分屏只是最表层的能力。它真正解决的是远程操作的生命周期问题你的终端进程是在 tmux 的 server 进程里运行的和某个 SSH 连接没有直接绑定关系。SSH 断掉tmux server 还活着里面跑的进程就都活着。我把这个特性理解成“远程桌面的最小实现”。比如你在公司电脑上开着远程会话回家后重新连上服务器输入tmux attach看到的是走之前一模一样的界面这比任何需要重跑的流程都省心。对于开发、部署、日志跟踪这些长时间操作价值非常大。1.3 Claude Code 解决的是“重复劳动”问题Claude Code 是运行在终端里的一款命令行 AI 编程助手它能在项目目录下读取代码、分析问题、生成修改方案并直接执行命令。对我这种经常要跨多个项目改代码的人来说它相当于一个能听懂中文指令的“驻场实习生”你说“帮我看看这个文件为什么报错”它会自己去读报错日志、定位文件、给出修改建议甚至可以直接动手改。但 Claude Code 也好其他 AI 工具也好如果只是打开一个对话框点来点去效率提升有限。真正有价值的是把它接入到命令行工作流里让它能读取 tmux 里的运行日志、监听某个目录变化后自动执行修复脚本这就走到了自动化这一步。1.4 两个工具结合后的工作方式当 tmux 和 Claude Code 配合起来我的典型工作流变成了这样在 tmux 会话里开几个窗口一个跑后端服务一个跑前端构建一个留作交互终端需要动代码时在交互窗口里唤起 Claude Code让它直接分析刚才的报错内容分析完如果需要重启服务我可以手动敲命令也可以写一个小脚本让 Claude Code 调用 tmux 的 send-keys 去重启指定窗口里的进程。这样一套组合下来我的远程开发环境就不是“一个终端 一个 AI 对话框”而是一个可持续、可恢复、可自动化的开发台。下面我会逐个环节讲清楚怎么搭起来。2. 环境准备从 Windows 到 Linux 子系统的完整搭建2.1 先装好 WSL 子系统别在原生命令行上硬撑要在 Windows 上用 tmux 和 Claude Code 达到比较好用的状态我建议先把 Linux 子系统装上。这不是说 Windows 原生的 PowerShell 不能用而是 tmux 本身是 Linux 生态的工具在 WSL 里跑最顺同时很多远程开发场景下的路径、权限、换行符问题也能在 WSL 里少踩很多坑。启用 WSL 很简单。在 Windows 10/11 上以管理员身份打开 PowerShell运行wsl --install默认会安装 Ubuntu安装完成后重启系统按照提示创建 Linux 用户名和密码。装好后建议顺手更新一下软件源和系统包sudo apt update sudo apt upgrade -y这里有几个细节值得注意WSL 的发行版安装在虚拟磁盘里和 Windows 主系统共享一部分资源如果你的宿主机内存不大建议控制同时运行的任务规模另外 WSL 里面的网络和 Windows 不完全一样它的 localhost 一般可以直接映射到 Windows但反过来访问 Windows 上的服务需要留意 IP 地址这点后面会讲到。2.2 安装并配置 tmux先跑通再个性化apt 里面直接就有 tmux安装命令很简单sudo apt install -y tmux安装完先不用急着改配置直接输入tmux就能进入一个默认会话。但我建议还是建一个基础的~/.tmux.conf否则默认的前缀键Ctrlb和状态栏信息量都偏简陋。一个让我长期用下来的最小配置是这样# 修改前缀键为 Ctrla离主键区更近 set -g prefix C-a unbind C-b bind C-a send-prefix # 开启鼠标模式方便滚动和选择窗格 set -g mouse on # 用 | 和 - 快速分屏 bind | split-window -h bind - split-window -v # 重载配置 bind r source-file ~/.tmux.conf \; display-message 配置已重载配置文件保存后在 tmux 里按Ctrla再按r就能生效不需要退出重新进。这里我不建议一开始就堆大量插件插件只会增加排查问题的难度先跑通最核心的分屏、会话保持、重连这三件事后面再按需加。2.3 安装 Node.js 和 Claude CodeClaude Code 本身是 npm 包所以要先有 Node.js 环境。WSL 里安装 Node.js 有几个路子我比较推荐先用 NodeSource 或直接系统包管理装因为这样和系统集成更自然sudo apt install -y nodejs npm安装完检查一下版本Claude Code 现在要求 Node 版本不能太低如果版本太老建议用 nvm 管理node -v npm -v确认 Node 环境没问题后全局安装 Claude Codenpm install -g anthropic-ai/claude-code安装完运行一下claude第一次启动会进入登录授权流程按照提示完成账号授权。登录成功后在项目目录里直接输入claude它就会读取当前目录的文件作为上下文。这里我实际踩过的坑是npm 全局安装目录有时不在 PATH 里装完提示claude: command not found。解决办法是用npm config get prefix查一下安装路径然后把这个路径加到.bashrc的 PATH 里或者直接用npx anthropic-ai/claude-code临时跑。2.4 Windows Terminal 和 VS Code Remote 的配套设置命令行本身我推荐 Windows Terminal它能把 PowerShell、CMD、WSL 的 Ubuntu 放在同一个标签页里。安装后新建一个 Ubuntu 配置默认进去就是 Linux 环境字体用 Cascadia Mono 或 MesloLGS 都不错关键是得开“等宽字体”的 ligature 支持否则代码里一些箭头字符会显示得很难看。如果你主要用 VS Code 写代码那一定要装 Remote - WSL 扩展。装完之后在 VS Code 左下角点绿色远程按钮选择“连接到 WSL”就能直接在 Windows 的图形界面里编辑 WSL 内的文件。这时候打开终端终端会自动进入 WSL 环境tmux 和 Claude Code 都能直接用。从 Windows 复制文件到 WSL我常用的方式有两种。一种是在 Windows 文件管理器地址栏输入\\wsl$\Ubuntu直接访问 WSL 文件系统另一种是在 WSL 里访问 Windows 的挂载盘路径通常是/mnt/c/。两种方式各有适用场景前者适合把 Windows 文件拖进 Linux 目录后者适合在 Linux 里直接操作 Windows 盘里的文件。要注意的是换行符问题Windows 下编辑过的文本文件一般是 CRLF在 Linux 里经常会出现\r导致脚本执行异常用dos2unix转一下就好。3. tmux 会话管理实操从入门到顺手3.1 核心概念会话、窗口、窗格tmux 有三个抽象层我习惯用酒店来类比会话是“你住的那间房”窗口是“房里的房间”窗格是“房间里的隔断”。会话一组窗口的集合是你tmux attach时进入的容器。一个 tmux server 上可以有多个会话。窗口相当于一个标签页默认都在同一个会话里切换。窗格一个窗口被分屏后的格子每个格子运行一个 shell 进程。理解这三层之后tmux 的所有操作逻辑就清晰了你是在某个会话的某个窗口的某个窗格里做事情可以把某一部分工作抽成独立会话也可以把多个任务放到一个会话的不同窗格里并行查看。3.2 高频操作速查下面是我日常用到的最高频操作整理成一张速查表操作目标命令/快捷键备注新建会话tmux new -s 名称直接创建并进入临时退出会话Ctrla后按d进程继续运行列出所有会话tmux ls也叫 session list重新进入会话tmux attach -t 名称或tmux a横向分屏Ctrla后按|需要配置纵向分屏Ctrla后按-需要配置切换窗格Ctrla后按方向键可重复操作关闭当前窗格exit会话最后一个窗格退出则会话结束新建窗口Ctrla后按c窗口相当于标签页切换窗口Ctrla后按数字键按窗口编号重命名会话Ctrla后按$方便记忆滚动查看历史开启鼠标后滚轮默认可能要进入复制模式我个人的习惯是每个项目开独立的 tmux 会话命名用项目名缩写。比如在 blog 项目里就是tmux new -s blog这样长时间挂着多个项目时用tmux ls一看就知道哪个会话是哪个。3.3 SSH 断开后的会话保持与恢复这是 tmux 最值钱的一个能力。以前我在 Windows 上用普通 SSH 连服务器跑一个数据同步脚本中间只要网络闪断脚本就白跑了只能重新来过。用 tmux 之后登录服务器第一件事就是tmux attach或者新建会话之后所有操作都在会话里跑。实测下来的场景是这样的我开了一个数据库迁移任务预计要跑 40 分钟中途电脑合盖休眠了第二天重新连上服务器运行tmux attach发现迁移任务还在跑而且日志显示早就成功结束。这种“任务不会因为本地断网而消失”的体验一旦习惯了就回不去了。3.4 一个多服务开发的会话实例为了更直观地说明 tmux 的用法我给一个常见场景本地后端项目依赖数据库和前端构建三个任务需要同时监控。我会这样组织# 新建项目会话 tmux new -s myproject # 先拆出数据库窗口 Ctrla c # 窗口名改成 db Ctrla , # 然后在 db 窗口里启动数据库服务 sudo service postgresql start # 回到第一个窗口跑后端 Ctrla 0 # 启动后端开发服务 npm run dev # 新建窗口跑前端 Ctrla c npm run build -- --watch这样一来后端、数据库、前端三个进程就在同一个 tmux 会话里但分别位于不同窗口随时可以切换查看。如果我想同时看两个窗口的输出就在其中一个窗口里分屏比如在“后端”窗口里分一个窗格去实时看日志文件Ctrla | tail -f /var/log/app.log这个结构的最大好处是所有任务都在一个会话内断线重连后布局不丢也不用每次重新启动一堆服务。3.5 状态栏与配置优化默认状态栏其实够用但我会把会话名、窗口名、时间显示调得醒目一些。在~/.tmux.conf里可以做简单定制set -g status-left #[bgblue]#S set -g status-right #[bgblack]%H:%M set -g window-status-current-style reverse改完之后会话名会在状态栏左侧高亮显示时间在右侧当前活动窗口反色显示。配置不用过度够用就好。4. Claude Code 自动化实操从对话到脚本化4.1 基础使用对话式修改代码在项目根目录执行claude会进入交互模式。你可以直接用自然语言提需求比如“帮我看看 src 目录下最近改过的文件有没有明显问题”。Claude Code 会读取项目上下文给出回答并在需要时列出计划。我实际的体验是它最擅长的事情有三类第一类是解释陌生代码比如拿到一个没文档的老项目直接让它梳理模块关系比自己翻省太多时间第二类是按指令修改代码比如“把所有 console.log 替换成统一日志函数”它能自动化完成大部分文件替换第三类是跑命令和读取结果比如让它运行测试并分析失败原因。用的时候也有边界它毕竟不是人对于复杂业务逻辑的判断不能全信尤其涉及数据删除、配置变更这类高风险操作我会让它在计划阶段停下来自己确认后再继续。4.2 非交互执行与脚本集成Claude Code 真正进入“自动化”阶段是使用非交互模式。在命令行里直接传参数执行claude -p 请检查当前目录的 Python 代码是否有语法错误并给出修复方案-p代表 print意思是执行完直接输出结果并退出不进入交互界面。这个模式非常适合嵌入到脚本和 CI 流程里。比如我可以写一个 Shell 脚本定时让 Claude Code 检查某个目录下的语法问题#!/bin/bash cd /path/to/project claude -p 请检查 src/**/*.py 中是否有语法错误如有列出文件和错误位置注意非交互模式同样会消耗模型额度所以不要无脑在循环里调用。我一般会在命令里加上明确的输出格式要求比如“只输出 JSON 数组”再配合jq做后续处理。4.3 结合 tmux 的实战工作流把 Claude Code 和 tmux 结合起来是这篇文章的核心场景。一个典型需求是半夜有一个批量任务可能出错我想让它自动重试并且把过程记录到 tmux 窗口里。我的做法是先启动一个专门的 tmux 会话用于自动化任务tmux new -s sleeper -d然后写一个脚本让 Claude Code 在指定目录执行修复逻辑再用 tmux send-keys 把结果发送到那个会话窗口# 在自动化会话里运行一个循环任务 tmux send-keys -t sleeper while true; do claude -p 运行 pytest如果失败就查看最近日志并给出修复建议; sleep 300; done Enter这样就能创建一个后台循环每 5 分钟跑一次测试如果失败Claude Code 自动分析日志并提出修复建议。注意这里需要确保claude命令在 tmux 的非交互 shell 里可用所以启动 tmux 之前最好先确认 PATH 环境变量已经加载。4.4 在 VS Code 和 Windows 侧的联动配置VS Code 里也能直接用 Claude Code不一定非要切到独立终端。在 Remote - WSL 打开的窗口中直接打开集成终端输入claude效果跟在独立终端里一样还能即时看到编辑器里的文件改动。如果你的工作流里需要在 Windows 侧调用 WSL 里的命令比如写一个批处理脚本可以用wsl命令前导wsl tmux new -s backup -d wsl claude -p 检查 /data/backup 目录是否已备份但这里要注意一个容易踩的坑Windows 的wsl命令默认进入 WSL 的登录 shell但工作目录路径和 Windows 路径映射有时候会不一致。最好用wsl --cd ~/project指定起始目录避免路径错乱。5. 常见问题与排查技巧实录5.1 安装类问题WSL、tmux、Claude Code我在配置过程中遇到过一个很典型的问题WSL 安装完成后Windows Terminal 里打开 Ubuntu 却提示当前系统没有已安装的发行版。这个一般是因为 WSL 内核没更新或默认发行版没有设置解决方法是wsl --set-default Ubuntu wsl --updateClaude Code 安装失败更多是 Node 版本太旧或者 npm 源不稳定。建议先用npm -v检查版本如果太旧优先升级 Node 而不是升级 npm 本身如果反复装不上可以清理缓存后从官方源全局安装。5.2 tmux 会话丢失与恢复问题tmux 会话本身很稳定但如果整个 WSL 被强制终止比如 Windows 重启没有额外配置的话会话会丢。要解决这个问题可以用tmux-resurrect这类插件做持久化或者在 Windows 侧设置 WSL 不要自动关闭。我实际更常用的方案是把关键任务的日志落盘这样即使会话丢了任务文件和日志还在可以快速恢复现场。不要把所有东西都寄托在 tmux 的持久化上尤其涉及定时任务务必保证日志可追溯。5.3 Claude Code 的权限、额度与输出问题用久了我发现有几个高频问题登录后提示权限不足一般是账号授权过期或 API 限额问题重新claude /login即可。非交互模式输出不稳定有时候会给很多解释性文字要拿到干净结果建议在提示词里明确指定输出格式。额度消耗太快非交互模式下频繁调用尤其明显。我的经验是把多个小任务合并成一个大任务批量处理远比重复调用省额度。另外避免让 Claude Code 直接操作生产环境的重要数据我一般只让它处理本地开发目录生产环境操作始终留给人来确认。5.4 从 Windows 复制文件到 Linux 的常见坑很多人从 Windows 复制代码文件进 WSL 后发现脚本执行不了十有八九是换行符问题。Windows 默认 CRLFLinux 默认 LF在 WSL 里执行时会出现$\r: command not found之类的报错。解决办法是sudo apt install -y dos2unix dos2unix 你的文件更彻底一点在 Windows 侧使用支持 LF 的文本编辑器VS Code 右下角可以切换行尾序列这样从一开始就不会产生 CRLF 文件。6. 进阶技巧与个人使用习惯6.1 我常用的自动化脚本模板这里分享一个我经常用到的脚本模板作用是“一键进入项目开发会话并启动常用服务”#!/bin/bash PROJECT_NAME$1 WORK_DIR${2:-$PWD} if ! tmux has-session -t $PROJECT_NAME 2/dev/null; then tmux new-session -d -s $PROJECT_NAME -c $WORK_DIR tmux new-window -t $PROJECT_NAME -n code -c $WORK_DIR tmux select-window -t $PROJECT_NAME:code fi tmux attach -t $PROJECT_NAME这个脚本的逻辑是如果会话不存在就新建存在就直接进入。窗口布局也预设好省得每次手动分屏。6.2 资源控制与后台任务管理WSL 默认会占用不小内存如果你想限制它可以在 Windows 用户目录下建.wslconfig文件[wsl2] memory4GB processors2 swap2GB重启 WSL 后生效。我在跑多个 tmux 会话时经常用到这个配置避免把宿主机内存吃满。6.3 我的使用习惯与最后一点建议最后分享一个我个人的使用习惯每天开工第一件事不是直接进编辑器而是先tmux ls看一下昨天留下了哪些会话再逐个attach进去查看状态。这种“先看现场再动手”的顺序能帮我快速恢复上下文也避免遗漏还在跑的任务。Claude Code 我也不会时刻开着只在需要理解陌生代码、批量替换、跑完测试后看报错时才调用。工具是辅助不是主角保持对项目状态的控制权才是关键。这套 Windows WSL tmux Claude Code 的组合我用了大半年整体稳定性和效率提升都让我满意希望你也能搭出适合自己的版本。