开始用 Crewly 不需要一篇很长的教程。下面就是从安装到跑起一支 AI agent(智能体)团队的完整路径。
最短版本
先安装 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 也可以。
Crewly 会启动后端,并在浏览器里打开网页 dashboard,地址是 http://localhost:8787。在 dashboard 里创建一个团队,然后点击 Start Team。
示意图:安装流程。第 1 步,先安装 Node.js 22 或更新版本,再用 curl -fsSL https://crewlyai.com/install.sh | bash 安装 Crewly,然后打开一个新的终端,运行 crewly start,网页 dashboard 会在 http://localhost:8787 打开。想用 npm?如果你的 Node 来自 Homebrew 或 nodejs.org 安装包,npm install -g crewly 也可以。
安装并启动 Crewly(示意图)。
分步说明
1. 安装 Crewly
先安装 Node.js 22 或更新版本(nodejs.org 的安装包或 Homebrew),再运行:
curl -fsSL https://crewlyai.com/install.sh | bash
想用 npm?如果你的 Node 来自 Homebrew 或 nodejs.org 安装包,npm install -g crewly 也可以。
需要 macOS 或 Linux;Node.js 22 或更高版本(用 node --version 检查);jq 和 curl;以及一个已安装并登录的 AI CLI(Claude Code 或 Codex)。在 macOS 和 glibc Linux(x64/arm64)上不需要 C/C++ 编译工具链,Crewly 使用预编译的二进制文件安装;在 Alpine/musl、glibc 低于 2.28 或其他架构上,或者网络拦截了预编译文件的下载时,需要安装 python3、make 和 g++(crewly doctor 会告诉你)。
2. 安装一个 AI 编码 CLI
你至少需要安装一个 AI 编码 agent。选一个就行(也可以两个都装):
# Claude Code (Anthropic)
npm install -g @anthropic-ai/claude-code
# OpenAI Codex
npm install -g @openai/codex
3. 配置并启动 Crewly
然后打开一个新的终端,运行:
crewly start
网页 dashboard 会自动打开。你会看到一个空白状态:还没有任何团队。
4. 创建你的第一个团队
在 dashboard 里:
- 创建一个项目(Create a Project):把它指向你的代码库目录
- 创建一个团队(Create a Team):添加 2 到 3 个 agent,角色可以是
backend-developer、frontend-developer、qa-engineer - 启动团队(Start the Team):点击 Start Team,看着每个 agent 从
inactive依次变成starting、started(它的 CLI 已经在运行)和active(它已经报到,可以接任务)
这就是你的 AI 开发团队,已经跑起来,随时可以接任务。
Crewly dashboard 里一个团队页面的截图:团队「Acme Studio」有三个 agent(PM、Dev、QA),还有分配的项目,以及团队规范和 SOP 的链接。
Crewly dashboard 里的一个团队。真实界面、演示数据:团队和项目都是虚构的。
你会看到什么
团队启动后,dashboard 会显示:
- agent 状态卡片:谁在线、谁空闲、谁在干活
- 实时终端输出:点击任意 agent,实时查看它的终端输出
- 任务跟踪:分派工作并监控进度
- 聊天界面:用自然语言和编排 agent 对话
分派你的第一个任务
打开 Chat 页面,输入一个请求:
Build a REST API with user authentication. The backend dev should
handle the Express routes and the QA engineer should write tests.
编排 agent 会自动拆解这个任务,并分派给每个 agent。在终端面板里看它们干活。
快速参考
# Start (opens the dashboard)
crewly start
# Start without opening the browser
crewly start --no-browser
常见问题
安装 Crewly 之前需要准备什么?
macOS 或 Linux,Node.js 22 或更高版本,jq 和 curl,以及一个已安装并登录的 AI CLI(Claude Code 或 Codex)。在 macOS 和 glibc Linux(x64/arm64)上不需要 C/C++ 编译器;你的机器是否需要,crewly doctor 会告诉你。
怎么安装并启动 Crewly?
运行 curl -fsSL https://crewlyai.com/install.sh | bash,然后打开新终端运行 crewly start。网页 dashboard 会在 http://localhost:8787 打开,你在那里创建项目和团队。
Crewly 支持哪些 AI 编码 CLI?
Claude Code 和 Codex。启动团队之前,至少安装其中一个并登录。
Crewly 开源吗?
开源。Crewly 以 MIT 许可证开源,代码在 GitHub 上。
接下来
现在你已经跑起来了:
- 完整教程:一步步创建一支 3 个 agent 的团队
- 使用场景参考:多 agent 团队能出成果的 5 个场景
- 浏览 Marketplace:安装社区构建的技能和角色配置
- Crewly 与 CrewAI 对比:看看 Crewly 和其他多 agent 工具有什么不同
Crewly 是一个开源的 AI agent 编排平台,能把多个编码 CLI agent(Claude Code 或 Codex)作为一支协同的团队启动起来,并提供实时的网页 dashboard。用
curl -fsSL https://crewlyai.com/install.sh | bash安装,然后打开新终端运行crewly start。
Crewly 以 MIT 许可证开源。在 GitHub 上给项目一个 Star,开始搭建吧。