简介由于 Windows 原生终端并不支持 tmux为了获得完整且稳定的多智能体分屏体验我们需要借助 WSLWindows Subsystem for Linux来安装和使用 tmux。本文将指导你如何在 Windows Subsystem for Linux (WSL) 环境中完成 Claude Code 的完整部署并利用 tmux 开启强大的 Agent Team 模式实现多智能体协同开发。我们将涵盖从环境安装、配置到高级模式启用的全过程。第一部分WSL 环境准备与配置首先我们需要在 Windows 系统上搭建 WSL 环境。如果你尚未安装 WSL请以管理员身份打开 PowerShell 或 Windows Terminal 并执行以下命令wsl--install该命令会自动启用所需功能并安装默认的 Linux 发行版。如果你想指定安装特定发行版如 Ubuntu可以使用wsl--install-dUbuntu安装完成后可以通过以下命令查看已安装的发行版及其状态wsl-l-v数据备份与迁移可选为了防止数据丢失或便于迁移我们可以将 WSL 实例导出为 tar 文件。例如将 Ubuntu 实例导出到 E 盘wsl--exportUbuntu E:\wsl\wsl-ubuntu26.04.tar若需重新导入例如在新电脑上先注销旧实例如果存在wsl--unregisterUbuntu然后从 tar 文件导入wsl--importUbuntu E:\wsl\wsl-ubuntu26.04 E:\wsl\wsl-ubuntu26.04.tar导入后使用以下命令启动wsl-dUbuntu第二部分系统更新与依赖安装进入 WSL 终端后首先更新系统包列表并升级现有包sudoaptupdatesudoaptupgrade-y安装 tmux分屏模式必备为了支持 Claude Code 的 Agent Team 分屏模式我们需要安装终端复用器 tmuxsudoaptinstalltmux-y安装完成后可以简单验证一下是否安装成功tmux-V安装 Node.js 和 npm这是运行 Claude Code 的基础环境sudoaptinstallnodejsnpm-y安装完成后验证版本以确保安装成功node--versionnpm--version第三部分Claude Code 安装与配置1. 全局安装 Claude Code CLI使用 npm 全局安装anthropic-ai/claude-code包npminstall-ganthropic-ai/claude-code2. 配置全局路径为了避免权限问题建议配置 npm 的全局安装路径。首先设置 prefixnpmconfigsetprefix ~/.npm-global然后将该路径添加到系统环境变量 PATH 中编辑~/.bashrc文件echoexport PATH~/.npm-global/bin:$PATH~/.bashrc使配置立即生效source~/.bashrc3. 重新安装可选如果之前安装失败或路径配置有变可以重新执行安装命令npminstall-ganthropic-ai/claude-code第四部分配置文件详解与 Agent Team 模式Claude Code 的核心配置位于~/.claude/settings.json不存在则新建。要开启 Agent Team 模式我们需要精细调整此文件。配置文件内容解析请在你的用户目录下创建或编辑该文件内容如下{env:{ANTHROPIC_AUTH_TOKEN:sk-xxxx,ANTHROPIC_BASE_URL:https://api.minimaxi.com/anthropic,ANTHROPIC_DEFAULT_HAIKU_MODEL:MiniMax-M2.7,ANTHROPIC_DEFAULT_OPUS_MODEL:MiniMax-M2.7,ANTHROPIC_DEFAULT_SONNET_MODEL:MiniMax-M2.7,ANTHROPIC_MODEL:MiniMax-M2.7,API_TIMEOUT_MS:3000000,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1,CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS:1},includeCoAuthoredBy:false,teammateMode:tmux}关键配置项说明ANTHROPIC_AUTH_TOKEN: 替换为你的实际 API 密钥。ANTHROPIC_BASE_URL: 根据参考信息此处配置为https://api.minimaxi.com/anthropic指向 MiniMax 的服务端点。模型配置: 将默认模型Haiku, Opus, Sonnet均指向MiniMax-M2.7确保请求被正确路由。超时设置:API_TIMEOUT_MS设置为 300000050分钟防止长时间运行的任务被中断。Agent Team 核心配置:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: 必须设置为1以启用实验性的多智能体团队功能。teammateMode: 设置为tmux这将利用 tmux 会话管理器来隔离和管理不同的智能体终端。第五部分启动与使用1. 启动 tmux 会话在项目目录下启动 tmuxcd/mnt/e/project/xx-project tmux new-sclaude_team2. 启动 Claude Code在 tmux 会话中运行claude此时Claude Code 应该会检测到teammateMode配置并尝试在 tmux 环境中启动 Agent Team 模式。你将能够看到多个智能体在不同的 tmux 窗格中协同工作处理代码生成、审查和测试任务。示例Prompt创建一个 agent team 来审查当前项目一个队友负责检查代码安全风险另一个队友负责检查性能问题最后汇总成一份报告。总结通过以上步骤你已经成功在 WSL 环境中部署了 Claude Code并利用 tmux 开启了 Agent Team 模式。这种配置不仅利用了 Linux 环境的稳定性还通过 tmux 实现了高效的多智能体协作开发流。上一篇Windows 环境下 Claude Code 安装与配置完全指南含国产模型切换