claudekit / tools / paperclip
[ Tool · Productivity ]

Paperclip

여러 AI 에이전트를 조직도, 목표, 예산, 승인 절차 아래에서 팀처럼 운영하는 오픈소스 자체 호스팅 앱. Claude Code, Codex, Cursor 같은 에이전트에 역할과 월 예산을 주고, 작업을 티켓으로 할당하며, 모든 실행을 대시보드에서 추적합니다.

paperclipai/paperclip ·updated
$ npx paperclipai onboard --yes copy

paperclipai가 만든 오픈소스 프로젝트(paperclipai/paperclip, MIT).

왜 필요한가?

Claude Code를 여러 개 동시에 돌리다 보면 어느 터미널이 무엇을 하고 있는지 놓치기 쉽습니다. 재부팅하면 진행 중이던 맥락이 사라지고, 에이전트에게 지금 하는 일이 무엇인지 매번 다시 설명해야 합니다. 루프에 빠진 에이전트가 모르는 사이 토큰을 대량으로 쓰기도 합니다. 고객 지원이나 리포트처럼 반복되는 일은 사람이 기억해서 매번 시작해 줘야 합니다.

Paperclip은 이 조율 작업을 맡는 서버와 대시보드입니다. 에이전트를 조직도 안의 구성원으로 등록하고, 작업은 티켓으로 할당하며, 예산과 승인 절차로 통제합니다. README는 이를 “OpenClaw가 직원이라면 Paperclip은 회사”라고 설명합니다. 에이전트 자체를 만드는 도구가 아니라, 이미 쓰는 에이전트를 묶어 운영하는 도구입니다.

무엇을 할 수 있나

기본 흐름은 README에 나오는 3단계입니다.

  1. 목표 정하기 — 조직이 달성할 목표를 적습니다.
  2. 팀 구성하기 — CEO, CTO, 엔지니어, 디자이너, 마케터 같은 역할로 에이전트를 배치합니다. 어떤 제공자의 에이전트든 넣을 수 있습니다.
  3. 승인하고 실행하기 — 전략을 검토하고 예산을 정한 뒤 실행하고, 대시보드에서 지켜봅니다.

README의 “Problems Paperclip solves” 표가 드는 쓰임새는 다음과 같습니다.

  • 아이디어를 작업으로 넘기기 — 저장소를 찾아 Claude Code를 띄우고 탭을 지켜보는 대신, Paperclip에 작업을 추가하면 코딩 에이전트가 끝날 때까지 작업하고 관리자 역할이 결과를 검토합니다.
  • 반복 업무 자동 실행 — 고객 지원, 소셜 미디어, 리포트 같은 정기 업무를 Heartbeat 일정에 맡깁니다.
  • 흩어진 에이전트 정리 — 폴더마다 흩어진 에이전트 설정 대신 조직도, 티켓, 위임, 승인 체계 안에서 운영합니다.
  • 비용 폭주 방지 — 에이전트별 토큰 예산을 추적하고, 예산이 떨어지면 속도를 줄이거나 멈춥니다.

핵심 기능

  • Bring Your Own Agent

    Claude Code, Codex, Cursor/Gemini/bash 같은 CLI 에이전트, OpenClaw 같은 HTTP/webhook 봇을 모두 같은 조직도에 넣을 수 있습니다. README의 표현으로는 “Heartbeat를 받을 수 있으면 채용됩니다.”

  • Heartbeat

    에이전트는 계속 돌아가는 대신 정해진 주기에 깨어나 할 일을 확인하고 처리합니다. 작업 할당이나 @멘션 같은 이벤트로도 깨어납니다. 같은 작업의 맥락을 Heartbeat 사이에 이어받기 때문에 매번 처음부터 시작하지 않습니다.

  • 목표 연결

    모든 작업이 프로젝트 목표와 회사 목표로 거슬러 올라가는 연결을 가집니다. 에이전트는 작업 제목만이 아니라 그 작업을 하는 이유까지 함께 받습니다.

  • 예산과 비용 관리

    에이전트마다 월 예산을 두고, 한도에 닿으면 자동으로 멈춥니다. 초과하면 대기 중인 작업도 취소됩니다. 토큰과 비용은 회사, 에이전트, 프로젝트, 목표, 제공자, 모델별로 집계됩니다.

  • 티켓과 감사 기록

    작업은 티켓으로 관리되고 대화는 스레드로 남습니다. 모든 도구 호출이 추적되며, 수정할 수 없는 감사 로그에 기록됩니다. 작업 checkout이 원자적으로 처리되어 두 에이전트가 같은 일을 중복으로 하지 않습니다.

  • 승인 절차(Governance)

    에이전트 채용 승인, 전략 수정, 에이전트 일시 정지와 종료를 언제든 할 수 있습니다. 설정 변경은 버전으로 남아 문제가 생기면 되돌릴 수 있습니다.

  • 여러 조직 운영과 템플릿

    하나의 설치로 여러 회사를 데이터가 분리된 채 운영합니다. 조직, 에이전트, 스킬을 내보내고 가져올 수 있으며, 이때 secret은 제거됩니다.

사용 방법

Node.js 24.11 이상이 필요합니다. 가장 빠른 방법은 npx로 온보딩을 바로 실행하는 것입니다.

npx paperclipai onboard --yes

로컬에서는 Node.js 프로세스 하나가 내장 PostgreSQL과 로컬 파일 저장소를 함께 관리하므로 데이터베이스를 따로 준비하지 않아도 됩니다. 기본값은 이 컴퓨터에서만 접속하는 모드입니다. 다른 기기에서 접속하려면 인증 모드로 시작합니다.

paperclipai onboard --yes --bind lan
# 또는
paperclipai onboard --yes --bind tailnet

관리형 CLI 설치와 백그라운드 서비스 등록까지 원하면 설치 스크립트를 내려받아 checksum을 확인한 뒤 실행합니다.

curl -fsSLO https://paperclip.ing/install.sh
curl -fsSLO https://paperclip.ing/install.sh.sha256
shasum -a 256 -c install.sh.sha256
bash install.sh

설치 없이 CEO 에이전트가 미리 설정된 격리된 테스트 인스턴스로 먼저 둘러볼 수도 있습니다.

ANTHROPIC_API_KEY=... npx paperclipai test-drive

알아두면 좋은 점

  • 텔레메트리가 기본으로 켜져 있습니다 — 익명 사용 데이터를 수집하며, 개인 정보, 작업 내용, 프롬프트, 파일 경로, secret은 수집하지 않는다고 밝힙니다. PAPERCLIP_TELEMETRY_DISABLED=1, DO_NOT_TRACK=1, 설정 파일의 telemetry.enabled: false 중 하나로 끌 수 있고, CI=true 환경에서는 자동으로 꺼집니다.
  • 모델 비용은 별도입니다 — Paperclip은 에이전트를 조율할 뿐이고, 실제 실행 비용은 각 에이전트의 API 키나 구독으로 발생합니다. 예산 기능은 이 비용을 통제하기 위한 장치입니다.
  • 설치 스크립트 실행 전 확인 — README는 checksum이 스크립트와 같은 서버에서 내려오므로 전송 오류만 잡아낸다고 밝힙니다. 독립적인 출처가 필요하면 GitHub의 릴리스 태그나 커밋에 고정된 사본을 쓰라고 안내합니다.
  • private npm 레지스트리 사용 시 — 전역 ~/.npmrc로 사설 레지스트리를 쓰고 있으면 npx가 paperclipai를 찾지 못하고 E404가 날 수 있습니다. 이때는 npx --registry https://registry.npmjs.org paperclipai onboard --yes로 공개 레지스트리를 지정합니다.
  • 운영 환경 — 운영 배포 시에는 직접 준비한 PostgreSQL에 연결해 원하는 방식으로 배포합니다.
  • 출처 — paperclipai/paperclip (MIT), 문서: docs.paperclip.ing.
§ 6

See also

same category · curated
[01]
[Plugin] AI Job Search · Claude Code 위에 구축된 구직 지원 프레임워크. 슬래시 명령어로 공고를 평가하고, 이력서를 맞춤 편집하고, 커버레터를 쓰고, 면접을 준비한다. 모든 작업이 로컬에서 돌아가며, fork해서 자기 것으로 만든다.
tool · claudekit.io / tools / ai-job-search
[02]
[Tool] Career-Ops · 여러 AI 코딩 CLI에서 로컬로 도는 오픈소스 구직 도구. 채용 포털을 스캔해 공고를 A-F로 채점하고, ATS 최적화 이력서와 커버레터를 맞춤 생성하며, 지원 파이프라인을 추적한다. 자동 제출은 하지 않는다.
tool · claudekit.io / tools / career-ops
[03]
[Tool] Browser Use · 🌐 AI 에이전트가 실제 브라우저를 제어해 온라인 작업을 자동화하는 오픈소스 프레임워크. 멀티 LLM을 지원하고 헤드리스, 병렬 실행과 클라우드 호스팅으로 확장된다. Claude Code용 공식 스킬(`browser-use skill`)로도 연동할 수 있으며, browser-use.com 클라우드의 기반 엔진이다.
tool · claudekit.io / tools / browser-use
§ 7

자주 묻는 질문

자주 묻는 질문
§ 7.1
Paperclip은 무엇인가요?
여러 AI 에이전트를 하나의 팀처럼 운영하는 오픈소스 앱입니다. Node.js 서버와 React UI로 구성되며, 에이전트에 역할과 예산을 주고 작업을 할당한 뒤 진행 상황과 비용을 대시보드 하나에서 추적합니다.
§ 7.2
Claude Code와는 어떤 관계인가요?
Paperclip은 Claude Code를 대체하지 않고 사용합니다. Claude Code, Codex, Cursor 같은 에이전트를 조직도 안의 구성원으로 등록하고, 목표, 예산, 승인 절차를 붙여 조율합니다.
§ 7.3
어떻게 설치하나요?
`npx paperclipai onboard --yes`로 바로 시작할 수 있습니다. Node.js 24.11 이상이 필요하며, 로컬에서는 내장 PostgreSQL이 자동으로 만들어져 별도 데이터베이스 설정이 필요 없습니다.
§ 7.4
무료로 사용할 수 있나요?
MIT 라이선스 오픈소스이며 자체 호스팅 방식이라 Paperclip 계정이 필요 없습니다. 다만 에이전트를 실행하는 모델 비용은 각 에이전트의 API 키나 구독으로 따로 발생합니다.
§ 7.5
에이전트가 비용을 과도하게 쓰는 것을 막을 수 있나요?
에이전트마다 월 예산을 두고, 한도에 닿으면 에이전트가 자동으로 멈춥니다. 회사, 에이전트, 프로젝트, 모델별로 토큰과 비용을 집계하며 경고 기준선도 설정할 수 있습니다.
§ 7.6
사용 데이터를 수집하나요?
익명 사용 텔레메트리가 기본으로 켜져 있습니다. 개인 정보, 작업 내용, 프롬프트, 파일 경로, secret은 수집하지 않는다고 밝히며, `PAPERCLIP_TELEMETRY_DISABLED=1` 또는 `DO_NOT_TRACK=1`로 끌 수 있습니다.