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.com2
能看到路由表和百度返回 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 -v2
3
4
5
6
7
8
9
10
11
12
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
EOF2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
2.3 配置 systemd 开机自启
先启用 WSL systemd(默认未开启):
sudo tee /etc/wsl.conf << 'EOF'
[boot]
systemd=true
EOF2
3
4
在 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 mihomo2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
看到 Active: active (running) 说明 mihomo 启动成功,订阅节点正在加载。
2.4 验证代理
curl -I https://www.google.com
curl -I https://registry.npmjs.org2
两个都返回 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 --version2
3
4
5
6
7
8
第四步:安装 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 --version2
3
4
5
6
7
8
第五步:安装 tmux
sudo apt update && sudo apt install -y tmux
tmux -V2
第六步:配置 Agent Teams
mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
},
"teammateMode": "auto"
}
EOF2
3
4
5
6
7
8
9
teammateMode: "auto" 会自动检测 tmux 环境并使用 split-pane 模式。
第七步:日常使用
# 启动 tmux session
tmux new-session -s work
# 进入项目目录(访问 Windows 文件)
cd /mnt/c/Users/你的用户名/项目目录
# 启动 Claude Code
claude2
3
4
5
6
7
8
Claude Code 检测到 tmux 环境后,触发 Agent Teams 功能时会自动分屏,每个 agent 独占一个窗格,可以实时观察所有 agent 的工作状态。
Agent Teams 测试用例
在 Claude Code 中输入适合并行处理的任务:
请用 agent teams 模式,并行完成以下任务:
1. 分析当前项目的代码结构
2. 检查潜在的安全问题
3. 评估性能优化点2
3
4
tmux 会自动分裂成多个窗格,每个 agent 独立工作。
tmux 基本操作
| 操作 | 快捷键 |
|---|---|
| 切换窗格 | Ctrl+B + 方向键 |
| 离开 session(保持后台运行) | Ctrl+B + D |
| 重新连接 session | tmux attach -t work |
| 查看所有 session | tmux ls |
重启后的操作顺序
由于 Clash TUN 和 WSL mirrored 网络冲突,每次重启需要:
- 先关闭 Clash TUN(虚拟网卡模式)
- 打开 Windows Terminal,进入 WSL Ubuntu
- 等待 mihomo 自动启动(systemd 开机自启)
- 验证代理正常后,再开启 Clash TUN(Windows 本机使用)
或者直接关闭 Clash TUN,WSL 的 mihomo 已经满足 Claude Code 的所有代理需求。
完整环境总览
| 组件 | 版本 | 说明 |
|---|---|---|
| WSL Ubuntu | 24.04 | 运行环境 |
| mihomo | v1.19.21 | WSL 内代理,TUN 模式 |
| Node.js | v24 LTS | Claude Code 依赖 |
| Claude Code | 2.1.74 | native installer |
| tmux | 3.4 | Agent Teams split-pane 支持 |
总结
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 installer - tmux 是关键:Claude Code Agent Teams split-pane 模式依赖 tmux,必须在 tmux session 内启动 claude
整个配置完成后,在 Windows Terminal 的 WSL 标签里,Agent Teams 的多 agent 并行分屏体验与 macOS/Linux 原生环境完全一致。
💬 评论