agent-teams-ai

环境要求

• 桌面系统：macOS（arm64/x64）、Windows 或 Linux（AppImage/deb/rpm/pacman）
• 无强制前置依赖，应用会自动探测已安装的 Claude Code、Codex、OpenCode 运行时
• 可选：Cursor、SuperGrok、GitHub Copilot、Z.AI、MiniMax、Kiro 等提供商账号（也可直接用免认证免费模型）
• 仅在源码调试模式下需要 Node.js 与 pnpm 环境

安装与启动步骤

1. 1下载安装包

   按系统选择官方最新版安装包：macOS 用 Agent.Teams.AI-arm64.dmg 或 -x64.dmg；Windows 用 Agent.Teams.AI.Setup.exe；Linux 用 AppImage 或 deb/rpm/

2. 2安装并启动应用

   双击安装包完成安装后启动桌面应用。Windows 若弹出 SmartScreen，点“更多信息”再点“仍然运行”；仅当应用报 OpenCode 符号链接或权限错误时才需要管理员模式

3. 3选模型或连代理

   首次启动可用免认证的免费模型，无需注册、API Key 或信用卡；也可跟随设置向导让它自动探测本机已装的 Claude Code、Codex、OpenCode，并在界面中连接 Cursor、SuperGrok、GitHub Copilot

4. 4创建团队与角色

   在应用中选定一个项目，定义团队角色分工，并写一段 provisioning prompt（任务分配/初始化提示词），让代理团队按角色自动拆解工作

5. 5看板观察执行

   下达高层指令后，代理会自动生成任务、分工执行并互相审查；你在看板视图上实时查看每个代理的任务状态与产出

6. 6可选：调试模式

   仅在源码调试时使用：默认走应用托管的进程后端，加环境变量后可在 tmux 面板中查看队友进程。注意这是运维/调试模式，正常使用建议保持默认

   CLAUDE_TEAM_TEAMMATE_MODE=tmux pnpm dev

   复制

关键配置

如何确认成功

桌面应用成功打开，设置向导能探测出已安装的代理运行时（或免费模型可直接使用），创建团队后看板出现代理自动生成的任务。

常见问题

注意事项

• 桌面应用是主产品，Web 版本仍在开发中。
• tmux 队友模式属于运维/调试用途，默认进程后端在生命周期管理、诊断和清理上更完善。
• 命令不要带 $ 或 > 提示符，安装包请从官方 releases/latest 页面获取以保证版本最新。
• Linux 用户可根据发行版选择 AppImage、deb、rpm 或 pacman 包。