跳到正文

文档 · 快速上手

开始使用 Project Orchestrator

有两种开始方式:安装桌面应用,或者部署服务器,再通过命令行连接 Claude Code。先把各项前提条件讲清楚,再一步一步地带你完成整个过程。

选择你的方式

我只想使用应用

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

你需要 Docker Desktop 和一个能对话的 AI:用你自己 Claude 账号的 Claude Code,或你连接的其他模型。AI 本身不包含在内。Claude Code 是默认且最久经考验的路径;其他引擎处于 alpha 阶段,而且使用 Claude Code 之外的模型需要先开启登录。

  1. 安装 Docker Desktop。应用可以帮你完成这一步。
  2. 下载适合你系统的应用并打开。在运行 macOS 10.15 至 13.3 的 Intel Mac 上,请选择适用于旧版 macOS 的文件:它不含本地嵌入,请改用 Ollama 等 HTTP 嵌入提供方。
  3. 按设置向导操作。它会检查 Docker,你选择的话可以安装 Claude Code,并启动各项服务。首次需要几分钟。

我是开发者

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

Install what you need, right here

Two things must be on your computer first. Pick your system, download or paste, check, and come back: you never have to leave this page to find an installer.

Docker Desktop

Runs the two services that hold the project memory (Neo4j and Meilisearch).

Open the downloaded .dmg, drag Docker into Applications, then open Docker once and wait for the whale icon to stop moving.

Or in a terminal

brew install --cask docker

Check that it works

Each line should print a version number. If you see « command not found », open a new terminal window and try again.

docker --versiondocker compose version

Docker must be running (open it once) before you start Project Orchestrator. Installation page of the publisher

Claude Code

The assistant Project Orchestrator works with. It uses your own Claude account.

Paste the command in a terminal. It installs everything it needs and asks for your password only if required.

Command

curl -fsSL https://claude.ai/install.sh | bash

Check that it works

Each line should print a version number. If you see « command not found », open a new terminal window and try again.

claude --version

Run claude once to sign in. Installation page of the publisher

开发者步骤:命令行

开始之前

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

    Homebrew 会安装 orchestrator(服务器)、orch(一个小型命令行工具)和 mcp_server(由你的工具启动的桥接程序)。在 Windows 上,或者你更喜欢用应用,请使用下载部分的桌面应用。在 macOS 低于 13.4 的 Intel Mac 上,脚本会自动选择适用于旧版 macOS 的构建(不含本地嵌入:请使用 Ollama 等 HTTP 嵌入提供方)。

    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 指向你的服务器。Claude Code 不是唯一的引擎:可在 Web 界面的“提供方”页面中,把另一个引擎(兼容 OpenAI 的模型、Codex 或 ACP 智能体,均为 alpha)添加为提供方。

    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.