Paperclip: 여러 AI 에이전트를 하나의 회사처럼 관리하는 오픈소스 오케스트레이터

Install

https://github.com/paperclipai/paperclip#quickstart

누구에게 맞는가

Paperclip은 오픈소스 AI 에이전트 오케스트레이션 도구이며, 비유가 직설적입니다. 에이전트는 고용한 직원이고 Paperclip은 그 회사입니다. Node.js 서비스와 React 인터페이스로 구성되며 에이전트는 직접 가져와야 하므로, 이미 코딩 에이전트를 사용하면서 그 에이전트들의 작업·권한·이력을 한곳에 모으고 싶은 기술 책임자나 소규모 팀에 적합합니다.

자주 보이는 세 가지 유형: Claude Code 터미널을 스무 개쯤 동시에 켜 두고 누가 무엇을 하는지 파악이 안 되는 경우, 에이전트가 7×24 스스로 돌게 하면서도 진행 상황을 언제든 확인하고 필요할 때 끼어들어 조정하고 싶은 경우, 에이전트마다 예산 상한을 걸고 비용을 붙잡고 싶은 책임자입니다.

또 하나 딱딱한 전제가 있습니다. 에이전트는 직접 가져와야 합니다. 저장소 첫 화면에 "bring your own agents"라고 명시돼 있으며 모델과 실행 프레임워크도 하나씩 직접 고릅니다. 플랫폼이 담당하는 것은 스케줄링, 비용 기록, 예산 강제입니다.

단일 에이전트로 작업 하나만 끝내고 싶은 경우에는 잘 맞지 않습니다. "목표 정의 → 팀 고용 → 승인 후 실행"이라는 절차가 오히려 추가 부담이 됩니다. 쓸 수 있는 에이전트 계정과 모델 할당량이 없는 상태에서 시작하지 마세요. 에이전트와 모델을 모두 직접 준비해야 하기 때문입니다.

3분 만에 첫 실행까지

공식 경로는 하나뿐입니다. GitHub 저장소 첫 화면의 Quickstart 섹션입니다.

https://github.com/paperclipai/paperclip
https://docs.paperclip.ing/

검증된 내용은 "공식 진입점이 저장소 내부의 Quickstart 섹션이다"라는 수준까지입니다. 구체적인 명령은 Quickstart과 문서 사이트를 기준으로 삼으세요. 검증되지 않은 명령은 여기 옮겨 적지 않습니다.

사전 준비: Node.js 실행 환경과 최소 한 개의 직접 준비한 에이전트(Codex 또는 Claude).
설치 위치: Quickstart에 따라 로컬에서 서비스와 인터페이스를 구동합니다. 출처에 전역 설치 경로나 패키지 이름이 없으니 다른 곳의 설치 방법을 그대로 베끼지 마세요.
위험도가 낮은 작업 실행: 읽기 전용 분석 목표를 새로 만듭니다(예: "어떤 저장소 구조를 분석해 개선 항목 목록 만들기"). 먼저 에이전트 하나만 붙이고 제안된 전략을 확인한 다음 예산 상한을 작은 숫자로 설정하고 실행을 누릅니다. 이 단계에서는 파일 쓰기, 명령 실행, 외부 호출을 허용하지 마세요.
부작용 경계부터 확인: 에이전트는 실행되면 계속 자율적으로 동작하며 실제 비용이 발생합니다. 예산 상한과 읽기 전용 작업이 이번 라운드의 유일한 안전장치이므로 예산을 작게 잡으세요.
성공 신호 관찰: 대시보드에 해당 목표와 작업 항목이 나타나고, 에이전트별 진행 상황과 비용 집계를 볼 수 있으며, 누적 비용이 예산 상한을 넘지 않는지 확인합니다.

첫 라운드에서 하지 말아야 할 것: 에이전트를 한꺼번에 열두 개 넘게 붙이지 말 것, 예산 없이 실행 버튼을 누르지 말 것.

활용 사례

사례 1: 여러 에이전트가 같은 목표를 병렬로 밀어붙여 진행 상황이 더는 사람의 기억에 의존하지 않습니다. 저장소는 "Claude Code 터미널 20개를 동시에 켜 두고 누가 무엇을 하는지 놓쳤던 경험"을 그대로 적용 시나리오로 제시합니다. 방식은 OpenClaw, Codex, Claude, Cursor 같은 서로 다른 에이전트들을 하나의 목표 아래로 묶고, 각각 모델과 실행 프레임워크를 고르게 한 뒤, 작업·스킬·권한·이력을 한곳에 남기는 것입니다. 그다음부터는 대시보드에서 누가 무엇을 하고 비용이 얼마인지만 보면 되고 터미널을 하나씩 뒤질 필요가 없습니다. 누가 진행하고 어디까지 왔는지도 하나의 패널이 알려줍니다.

사례 2: "목표 설정 → 팀 고용 → 승인 후 실행"을 운영의 순환 과정으로 관리합니다. 저장소가 제시한 세 단계는 먼저 목표를 정의하고(예: AI 노트 앱을 $1M MRR까지 키우기), 다음으로 CEO, CTO, 엔지니어, 디자이너, 마케팅 같은 역할의 에이전트 팀을 구성하고(어떤 봇이든 어떤 공급자든 상관없음), 마지막으로 승인하고 실행하는 것입니다 — 전략을 점검하고 예산을 설정한 뒤 시작을 누르고, 대시보드에서 계속 관찰합니다. 이는 원문이 제시한 예시 흐름이며 추측해서 만든 사용법이 아닙니다. 역할 구성과 에이전트 연결 방식은 Quickstart과 문서 사이트를 따르세요.

사용 경계

검증 범위는 저장소 첫 화면으로 한정됩니다. 포지셔닝(AI 에이전트를 일에 투입하는 오픈소스 오케스트레이션), 기술적 형태, 핵심 3단계 흐름, 그리고 "에이전트가 24/7 자율 실행되고 사람이 주시하다가 필요할 때 끼어들며, 비용을 모니터링하고 예산을 강제해야 한다"는 요구 조건 묶음. 설치 명령, 디렉터리 구조, 계정 연동 방식은 검증 범위 밖입니다.
에이전트는 계속 자율 실행되며 실제 비용이 발생하므로, 비용 모니터링과 예산 강제는 플랫폼 기능인 동시에 실행의 전제 조건이기도 합니다.
에이전트와 모델, 실행 프레임워크는 모두 직접 준비합니다. Paperclip이 에이전트 계정을 대신 보관해 주지 않습니다.
첫 라운드는 읽기 전용이고 되돌릴 수 있는 분석 작업을 고르세요. 파일 쓰기, 명령 실행, 외부 호출이 포함되면 영향 범위와 예산을 확인한 뒤 승인하세요.
작업 한 번만 돌리고 싶은 상황이라면 이 절차는 과한 편입니다. 여러 에이전트, 장시간 운영, 예산 제약이 있는 상황에서야 이점을 얻습니다.
에이전트별 지원 깊이, 동시 실행 규모, 장애 복구 방식은 저장소 첫 화면에 나와 있지 않습니다. 공식 문서 사이트를 기준으로 삼으세요.