Windows 10 LTSC 上用 WSL + mihomo 实现 Claude Code Agent Teams 分屏模式完整指南
本文记录了在 Windows 10 LTSC 环境下,从零开始配置 WSL Ubuntu、mihomo 代理、Claude Code,最终实现 Agent Teams tmux 分屏模式的完整过程,包含所有踩坑经验。
背景
Claude Code 的 Agent Teams 功能支持多个 AI agent 并行工作,每个 agent 独占一个终端窗格,实时观察所有 agent 的工作进度。但这个 split-pane 模式官方只支持 tmux 和 iTerm2,不支持 Windows Terminal 原生分屏。
在 Windows 上实现这个功能,唯一的路径是:WSL + tmux。
环境说明
操作系统:Windows 10 LTSC 2021 (Build 19044)
终端:Windows Terminal
代理工具:Clash Verge(TUN 虚拟网卡模式)
目标:WSL Ubuntu + mihomo + Claude Code + tmux
坑点预警:WSL mirrored 模式与 Clash TUN 冲突
Windows 10 LTSC 安装 Docker Desktop 后,WSL 会被配置为 mirrored 网络模式,与 Clash TUN 虚拟网卡(占用 198.18.0.0/30 网段)冲突,导致 WSL 网卡 eth0 处于 DOWN 状态,完全无法上网。
解决方案:临时关闭 Clash TUN,安装并启动 WSL 内部的 mihomo,之后 WSL 完全依赖自己的代理,不再依赖 Windows Clash。
第一步:安装 Ubuntu WSL
临时关闭 Clash Verge 的「虚拟网卡模式(TUN)」,然后在 PowerShell 执行:
wsl --install -d Ubuntu
安装完成后设置用户名和密码,进入 Ubuntu,验证网络:
ip route show
curl -I https://baidu.com
能看到路由表和百度返回 301 说明网络正常。
第二步:WSL 内安装 mihomo
网络通了之后,直接在 WSL 内完成所有操作,不再依赖 Windows。
2.1 下载 mihomo
# 查询最新版本文件名
curl -s https://api.github.com/repos/MetaCubeX/mihomo/releases/latest \
| grep "browser_download_url" | grep "linux-amd64" | grep -v "compatible"
# 下载(以 v1.19.21 为例,实际以查询结果为准)
wget https://github.com/MetaCubeX/mihomo/releases/download/v1.19.21/mihomo-linux-amd64-v3-v1.19.21.gz
gunzip mihomo-linux-amd64-v3-v1.19.21.gz
chmod +x mihomo-linux-amd64-v3-v1.19.21
sudo mv mihomo-linux-amd64-v3-v1.19.21 /usr/local/bin/mihomo
# 验证
mihomo -v
2.2 创建 mihomo 配置
使用订阅链接作为 proxy-provider,开启 TUN 模式,所有流量走代理:
sudo mkdir -p /etc/mihomo
sudo tee /etc/mihomo/config.yaml << 'EOF'
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
ipv6: false
tun:
enable: true
stack: gvisor
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
dns:
enable: true
listen: 0.0.0.0:53
nameserver:
- 223.5.5.5
- 119.29.29.29
proxy-providers:
subscription:
type: http
url: "https://你的订阅链接" # ← 替换这里
interval: 86400
health-check:
enable: true
url: https://www.gstatic.com/generate_204
interval: 300
proxy-groups:
- name: "PROXY"
type: url-test
use:
- subscription
url: https://www.gstatic.com/generate_204
interval: 300
rules:
- MATCH,PROXY
EOF
2.3 配置 systemd 开机自启
先启用 WSL systemd(默认未开启):
sudo tee /etc/wsl.conf << 'EOF'
[boot]
systemd=true
EOF
在 PowerShell 执行 wsl --shutdown 重启 WSL 后,回到 Ubuntu 创建 systemd 服务:
sudo tee /etc/systemd/system/mihomo.service << 'EOF'
[Unit]
Description=Mihomo Proxy
After=network.target
[Service]
Type=simple
ExecStart=/usr/local/bin/mihomo -d /etc/mihomo
Restart=on-failure
RestartSec=5
LimitNOFILE=1048576
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable mihomo
sudo systemctl start mihomo
sudo systemctl status mihomo
看到 Active: active (running) 说明 mihomo 启动成功,订阅节点正在加载。
2.4 验证代理
curl -I https://www.google.com
curl -I https://registry.npmjs.org
两个都返回 200 说明代理完全正常。
第三步:安装 Node.js
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
# 安装最新 LTS
nvm install --lts
node --version
npm --version
第四步:安装 Claude Code
Anthropic 官方推荐使用 native installer(不依赖 Node.js,自动更新):
curl -fsSL https://claude.ai/install.sh | bash
# 添加 PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
# 验证
claude --version
第五步:安装 tmux
sudo apt update && sudo apt install -y tmux
tmux -V
第六步:配置 Agent Teams
mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
},
"teammateMode": "auto"
}
EOF
teammateMode: "auto" 会自动检测 tmux 环境并使用 split-pane 模式。
第七步:日常使用
# 启动 tmux session
tmux new-session -s work
# 进入项目目录(访问 Windows 文件)
cd /mnt/c/Users/你的用户名/项目目录
# 启动 Claude Code
claude
Claude Code 检测到 tmux 环境后,触发 Agent Teams 功能时会自动分屏,每个 agent 独占一个窗格,可以实时观察所有 agent 的工作状态。
Agent Teams 测试用例
在 Claude Code 中输入适合并行处理的任务:
请用 agent teams 模式,并行完成以下任务:
1. 分析当前项目的代码结构
2. 检查潜在的安全问题
3. 评估性能优化点
tmux 会自动分裂成多个窗格,每个 agent 独立工作。
tmux 基本操作
重启后的操作顺序
由于 Clash TUN 和 WSL mirrored 网络冲突,每次重启需要:
先关闭 Clash TUN(虚拟网卡模式)
打开 Windows Terminal,进入 WSL Ubuntu
等待 mihomo 自动启动(systemd 开机自启)
验证代理正常后,再开启 Clash TUN(Windows 本机使用)
或者直接关闭 Clash TUN,WSL 的 mihomo 已经满足 Claude Code 的所有代理需求。
完整环境总览
总结
Windows 10 LTSC 上实现 Claude Code Agent Teams split-pane 模式的关键点:
WSL 网络问题:Clash TUN 与 WSL mirrored 模式冲突,需在 WSL 内独立运行 mihomo
systemd:WSL 默认不启用 systemd,需手动在
/etc/wsl.conf开启包名变更:Claude Code 官方包名已从
@anthropic/claude-code更名为@anthropic-ai/claude-code,但推荐直接使用 native installertmux 是关键:Claude Code Agent Teams split-pane 模式依赖 tmux,必须在 tmux session 内启动 claude
整个配置完成后,在 Windows Terminal 的 WSL 标签里,Agent Teams 的多 agent 并行分屏体验与 macOS/Linux 原生环境完全一致。