avatar

范伟彬个人网

https://fanweibin.cn

  • 首页
  • 归档
  • 链接
  • 关于
  • AI 导航
  • 健康指南
主页 Windows 10 LTSC 上用 WSL + mihomo 实现 Claude Code Agent Teams 分屏模式完整指南
文章

Windows 10 LTSC 上用 WSL + mihomo 实现 Claude Code Agent Teams 分屏模式完整指南

发表于 昨天 更新于 昨天
作者 Administrator
23~30 分钟 阅读

本文记录了在 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 基本操作

操作

快捷键

切换窗格

Ctrl+B + 方向键

离开 session(保持后台运行)

Ctrl+B + D

重新连接 session

tmux attach -t work

查看所有 session

tmux ls


重启后的操作顺序

由于 Clash TUN 和 WSL mirrored 网络冲突,每次重启需要:

  1. 先关闭 Clash TUN(虚拟网卡模式)

  2. 打开 Windows Terminal,进入 WSL Ubuntu

  3. 等待 mihomo 自动启动(systemd 开机自启)

  4. 验证代理正常后,再开启 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 模式的关键点:

  1. WSL 网络问题:Clash TUN 与 WSL mirrored 模式冲突,需在 WSL 内独立运行 mihomo

  2. systemd:WSL 默认不启用 systemd,需手动在 /etc/wsl.conf 开启

  3. 包名变更:Claude Code 官方包名已从 @anthropic/claude-code 更名为 @anthropic-ai/claude-code,但推荐直接使用 native installer

  4. tmux 是关键:Claude Code Agent Teams split-pane 模式依赖 tmux,必须在 tmux session 内启动 claude

整个配置完成后,在 Windows Terminal 的 WSL 标签里,Agent Teams 的多 agent 并行分屏体验与 macOS/Linux 原生环境完全一致。

许可协议: 
分享

相关文章

下一篇

FastTunnel v2 内网穿透 Docker 部署完整指南(服务端 + 客户端)

上一篇

OpenClaw 完整安装与使用指南:零成本打造全能 AI 助理

最近更新

  • FastTunnel v2 内网穿透 Docker 部署完整指南(服务端 + 客户端)
  • Windows 10 LTSC 上用 WSL + mihomo 实现 Claude Code Agent Teams 分屏模式完整指南
  • OpenClaw 完整安装与使用指南:零成本打造全能 AI 助理
  • Debian 13 虚拟机安装与配置完全指南(Parallels / VMware 双平台)
  • Claude Code Agent Teams:多智能体协作编程的完全指南

热门标签

MCP 并发编程 通义千问 代码审查 版本对比 数字人 开发效率 DevOps 结构化并发 永久投资组合

目录

©2026 范伟彬个人网. 保留部分权利。

使用 Halo 主题 Chirpy