跳到正文

文档 · 快速上手

开始使用 Project Orchestrator

两种开始方式：安装桌面应用，或者部署服务器并通过命令行连接 Claude Code。先讲清前提条件，再一步一步来。

选择你的方式

我只想使用应用

安装桌面应用。设置向导会引导你，不需要输入命令。

你需要 Docker Desktop 和 Claude Code。AI 本身不包含在内：Claude Code 使用你自己的 Claude 账号。

  1. 安装 Docker Desktop。应用可以帮你完成这一步。
  2. 下载适合你系统的应用并打开。
  3. 按设置向导操作。它会检查 Docker，可以安装 Claude Code，并启动各项服务。首次需要几分钟。
前往下载

我是开发者

用命令行安装服务器，再通过 MCP 连接你自己的工具，例如 Claude Code。步骤见下方。

开发者页面

开发者步骤：命令行

开始之前

Docker
Docker 20.10+ 与 Compose 2.0+，用来运行 Neo4j 和 Meilisearch
MCP 客户端
Claude Code、Cursor 或 OpenAI 的代理工具
一个项目
一个代码仓库，使用 17 种受支持语言之一

  1. 1.安装 orchestrator

    Homebrew 会安装 orchestrator（服务器）、orch（一个小型命令行工具）和 mcp_server（由你的工具启动的桥接程序）。在 Windows 上，或者你更喜欢用应用，请使用下载部分的桌面应用。

    Terminal

    brew install this-rs/tap/project-orchestrator# or, without Homebrewcurl -fsSL https://raw.githubusercontent.com/this-rs/project-orchestrator/main/install.sh | sh

  2. 2.启动 Neo4j 和 Meilisearch

    项目记忆存放在 Neo4j 中，搜索由 Meilisearch 提供。仓库里有一个 compose 文件，可以同时启动这两项服务。桌面应用会替你完成这一步。

    Terminal

    git clone https://github.com/this-rs/project-orchestrator.gitcd project-orchestratordocker compose up -d neo4j meilisearch

  3. 3.运行服务器

    服务器默认监听 8080 端口，同时提供网页界面。打开 http://localhost:8080，确认它在运行。

    Terminal

    orchestrator serve

  4. 4.通过 MCP 连接 Claude Code

    一条命令会找到 Claude Code，并以 stdio 模式添加 project-orchestrator MCP 服务器，同时预先批准它的工具。其他 MCP 客户端也可以用同样的方式启动 mcp_server，并让 PO_SERVER_URL 指向你的服务器。

    Terminal

    orchestrator setup-claude

  5. 5.同步项目并运行计划

    登记你的仓库，让 PO 读取它。然后向助手要一份计划。助手会调用 MCP 工具，你可以在网页界面中跟进任务和步骤。

    Terminal

    orchestrator sync --path .# then, in Claude Code:> Create a plan to add rate limiting to the public API,> split it into tasks with dependencies, and run it.