방법 고르기
앱만 쓰고 싶어요
데스크톱 앱을 설치하세요. 설정 마법사가 안내해 주니 명령어를 입력하지 않아도 돼요.
Docker Desktop과 대화할 AI가 필요해요. 본인의 Claude 계정으로 쓰는 Claude Code, 또는 직접 연결한 다른 모델이면 돼요. AI는 포함되어 있지 않아요. Claude Code가 기본이고 가장 많이 검증된 경로예요. 다른 엔진은 알파이고, Claude Code 이외의 모델은 로그인을 켜 둬야 해요.
- Docker Desktop을 설치하세요. 앱이 도와줄 수 있어요.
- 내 시스템에 맞는 앱을 내려받아 여세요. macOS 10.15~13.3의 Intel Mac에서는 이전 macOS용 파일을 받으세요. 로컬 임베딩이 없으니 Ollama 같은 HTTP 임베딩 제공자를 쓰세요.
- 설정 마법사를 따라가세요. Docker를 확인하고, 선택하면 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 dockerCheck 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 versionDocker 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 | bashCheck 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 --versionRun claude once to sign in. Installation page of the publisher
개발자 단계: 명령줄
시작하기 전에
- Docker
- Neo4j와 Meilisearch를 실행하기 위한 Docker 20.10+와 Compose 2.0+
- MCP 클라이언트
- Claude Code, Cursor 또는 OpenAI 에이전트
- 프로젝트
- 지원하는 17개 언어 중 하나로 된 코드 저장소
1.오케스트레이터 설치하기
Homebrew가 orchestrator(서버), orch(작은 명령줄 도구), mcp_server(내 도구가 시작하는 브리지)를 설치해요. Windows이거나 앱을 선호한다면 다운로드 섹션의 데스크톱 앱을 쓰세요. macOS 13.4보다 오래된 Intel Mac에서는 스크립트가 이전 macOS용 빌드를 알아서 골라요(로컬 임베딩 없음: Ollama 같은 HTTP 임베딩 제공자를 쓰세요).
터미널
brew install this-rs/tap/project-orchestrator# or, without Homebrewcurl -fsSL https://raw.githubusercontent.com/this-rs/project-orchestrator/main/install.sh | sh2.Neo4j와 Meilisearch 시작하기
프로젝트 메모리는 Neo4j에 있고 검색은 Meilisearch에서 실행돼요. 저장소에는 둘을 모두 시작하는 compose 파일이 들어 있어요. 데스크톱 앱은 이것을 대신 해 줘요.
터미널
git clone https://github.com/this-rs/project-orchestrator.gitcd project-orchestratordocker compose up -d neo4j meilisearch3.서버 실행하기
서버는 기본값으로 포트 8080에서 수신하고 웹 인터페이스도 제공해요. http://localhost:8080을 열어 실행 중인지 확인하세요.
터미널
orchestrator serve4.MCP로 Claude Code 연결하기
명령어 하나가 Claude Code를 찾아서 project-orchestrator MCP 서버를 stdio 모드로 추가하고, 도구를 미리 승인해요. 다른 MCP 클라이언트도 PO_SERVER_URL이 내 서버를 가리키도록 해서 같은 방식으로 mcp_server를 시작할 수 있어요. 엔진이 Claude Code만 있는 건 아니에요. 웹 인터페이스의 “제공자” 페이지에서 다른 엔진(OpenAI 호환 모델, Codex, ACP 에이전트, 모두 알파)을 제공자로 추가할 수 있어요.
터미널
orchestrator setup-claude5.프로젝트를 동기화하고 계획 실행하기
저장소를 등록하고 PO가 읽게 하세요. 그다음 어시스턴트에게 계획을 요청하세요. 어시스턴트가 MCP 도구를 호출하고, 작업과 단계는 웹 인터페이스에서 따라갈 수 있어요.
터미널
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.