“编排多个 AI agent”可以指两件不同的事，只有其中一件需要 Python。选工具之前，先想清楚你是哪一种。
- 任务 A：构建一个 agent 应用。 你要设计做调研、回工单或跑自定义流程的 agent，想控制提示词、工具和流程，并为此写代码。
- 任务 B：把现成的 agent 当作团队来运行。 你在用 Claude Code 或 Codex，想让后端开发、前端开发和审查者同时工作，有个角色来分派任务。你想描述工作，而不是编程。
本文讲任务 B。如果你是任务 A，答案很短，在下一节：用框架。
Python 这条路要你做什么
大多数人最先遇到的框架是 CrewAI。来自它的文档（2026 年 10 月 9 日读取）：
- 安装：
uv tool install crewai，Python 3.10 及以上、低于 3.14。 - 密钥： API 密钥放在项目根目录的
.env文件里。 - 定义： 快速入门用
crewai create flow生成项目，然后在 JSONC 文件里描述每个 agent（角色、目标、背景、工具），在 crew 文件里放 agent 和它们的任务，在main.py里写流程。 - 运行：
crewai install，然后crewai run。
如果你在做应用，这很划算。如果你只需要三个 Claude Code 会话在你的仓库里干活，就太多了。完整对比见 Crewly vs CrewAI。
不写 Python，你能得到什么
Crewly 是一个开源应用（MIT），在你的机器上运行一支长期存在的编程 agent 团队。每个 agent 是在自己终端里运行的真实 Claude Code、Codex 或 OpenCode 会话，带有保存的角色。一个编排 agent 分派工作，你在本地仪表盘里观察和调整。
先说清楚代价，方便你早点排除：
- 它是给编程 agent 用的。 它编排现成的编程 CLI，不构建通用的调研或客服 agent。
- 要安装一个应用并保持运行。
- agent 以完整权限运行，这样才能无人值守地工作，所以请用你放心的环境。
- 只支持 macOS 和 Linux。
开始之前
- macOS 12+ 或 Linux，普通用户账户，已装
jq和curl。 - 已安装并登录 Claude Code。先运行一次
claude，完成它的首次设置，否则你的 agent 会卡在它的主题和登录界面。 - 一个要处理的项目文件夹。
试用 Crewly：请先安装 Node.js 22 或更新版本（nodejs.org 的安装包，或 Homebrew / 系统包管理器），再运行：
curl -fsSL https://crewlyai.com/install.sh | bash
然后打开一个新的终端，运行：
crewly start
想用 npm？如果你的 Node 来自 Homebrew 或 nodejs.org 安装包，npm install -g crewly 也可以。
仪表盘会在 http://localhost:8787 打开。如果有什么不对劲，crewly doctor 会检查你的环境。
第 1 步：添加你的项目
- 打开 Projects，点击 New Project。
- 输入项目的绝对路径，或用 Browse 选择。
- 点击 Create Project。
Crewly 仪表盘里的 Create New Project 对话框，已填入项目的绝对路径，旁边是 Browse 和 Create Project 按钮
第 2 步：创建团队
- 打开 Teams，点击 New Team，起个名字，在 Assigned Project 里选你的项目。
- 每个工作添加一名成员，各有 Agent Name、Role 和 Runtime Type：
| Agent Name | Role | Runtime Type |
|---|---|---|
| Backend Dev | backend-developer | Claude CLI |
| Frontend Dev | frontend-developer | Claude CLI |
| QA | qa-engineer | Claude CLI |
- 点击 Create Team。
Create New Team 表单里成员部分：Agent Name 为 Backend Dev，Role 为 Backend Developer，Runtime Type 为 Claude CLI，另有可选的模型和推理强度
“Claude CLI”就是 Claude Code。运行时是按 agent 选的，所以同一团队里审查者可以用 Codex CLI。每个角色都带有自己的提示词，你也可以在 Settings → Roles 里添加自己的角色。
第 3 步：启动团队
打开团队，点击 Start Team。每个 agent 的状态会依次变为 inactive、starting、started、active。active 表示 agent 已经在运行并完成了注册。等它们都变成 active 再发任务。
Crewly 的团队页面，有 Chat 和 Start Team 按钮，每个成员一行，显示角色和状态
第 4 步：写一条能拆得清楚的交接消息
打开 Chat，把任务描述给编排 agent。拆分得好不好，取决于你消息里写了什么。四个部分起大部分作用：
- 一句话的目标。 “给应用加上用户登录。”
- 谁负责哪些文件。 “Backend Dev 负责
src/api/。Frontend Dev 负责src/ui/。QA 负责tests/。”两个 agent 改同一个文件，是一次运行出问题的常见原因。 - 顺序，如果有的话。 “路由有了之后 QA 再开始。”
- 做完是什么样。 “测试通过，每个 agent 汇报自己改了什么。”
例如：
Add user login. Backend Dev: Express routes in src/api/auth. Frontend Dev:
a login page in src/ui/login. QA: integration tests in tests/auth, once the
routes exist. Each of you reports which files you changed when you finish.
编排 agent 会拆分并分派任务。agent 们会汇报状态、互相发消息，并保存学到的东西，所以重启后的 agent 不用从零开始。
第 5 步：观察，然后检查结果
仪表盘显示每个 agent 的实时终端、是否在工作，以及进行中的任务。给某个 agent 或编排 agent 发消息，就能改变方向。
做完之后，像检查同事的工作一样检查：看 diff，自己跑一遍测试，看每个 agent 汇报了什么。先用两三个 agent，每个负责自己的文件。第一组跑顺了再加。
什么时候用哪个
| 你想要…… | 用 |
|---|---|
| 并行跑两三个 Claude Code 任务，自己来调度 | 不同终端里的 claude --worktree |
| 让一支 Claude Code、Codex 或 OpenCode 团队长期运行，有角色和仪表盘 | Crewly |
| 构建自定义 agent 应用，或不是编程 agent 的 agent | CrewAI 这样的框架 |
常见问题
不写 Python，能编排多个 AI agent 吗？
如果这些 agent 是编程 agent，可以。Crewly 把 Claude Code、Codex 或 OpenCode 会话当作一支团队来运行，你在仪表盘里设置：给 agent 起名，为每个选角色和运行时，再用日常语言描述任务。如果你需要的是做调研、客服等非编程工作流的自定义 agent，用 CrewAI 这样的框架更合适，它通过 Python 和 JSONC 文件配置。
CrewAI 上手需要什么？
按 CrewAI 安装页（2026 年 10 月 9 日读取）：用 uv tool install crewai 安装，Python 要 3.10 及以上、低于 3.14；API 密钥放在 .env 文件里；在项目根目录运行 crewai install，然后 crewai run。快速入门里，agent 和任务写在 JSONC 文件中，再用 Python 把它们接起来。
运行几个 Claude Code agent，一定要用框架吗？
不用。两三个任务，在不同终端里用 claude --worktree 就够了。当你想让同样的角色长期运行，并带有保存的记忆、仪表盘和一个分派任务的编排 agent 时，Crewly 这样的工具才有用。见在 Claude Code 里同时运行多个 agent 的 4 种方法。
一开始用几个 agent？
两三个，每个负责不同的文件。多个 agent 改同一批文件，多半只会带来合并冲突，而不是更快。
来源
Crewly 的步骤和界面标签：来自在 Claude Code 里同时运行多个 agent 中的仪表盘流程，2026 年 9 月 24 日核对。CrewAI 的事实：简介、安装和快速入门，2026 年 10 月 9 日读取。
Crewly 以 MIT 许可证开源。代码在 GitHub。