Paperclip 사용법, AI 에이전트 팀을 회사처럼 운영하는 새로운 프레임워크

회사처럼 역할을 나눠 사용자의 요청을 처리하는 AI 프레임워크가 출시된 지 한 달 만에 깃허브 스타 5만 개를 넘기며 주목받고 있습니다. 바로 'Paperclip(페이퍼클립)'입니다.

Paperclip은 여러 AI 에이전트를 연결해 하나의 작업 흐름으로 실행할 수 있도록 만든 멀티 에이전트 오케스트레이션 플랫폼입니다. 단순히 사용자의 질문에 답하는 수준을 넘어, AI가 스스로 기획·작성 · 검토 · 정리 같은 과정을 역할 단위로 나눠 조직을 구성하고 처리하는 구조가 특징입니다.

이 글에서는 페이퍼클립이 어떤 방식으로 동작하는지, 기존 AI 활용 방식과 무엇이 다른지, 실제 업무 자동화에 어떻게 활용할 수 있는지를 정리해보겠습니다.

Paperclip(페이퍼클립) 핵심 요약

• Paperclip은 AI 에이전트를 회사처럼 운영하는 프레임워크입니다 CEO, CMO, 리서처, 기획자처럼 AI 에이전트에 역할을 나누고 하나의 조직처럼 협업해 사용자의 요청을 처리합니다.
• 작업 흐름을 이슈와 조직도로 확인할 수 있습니다 작업을 이슈, 스레드, 하위 작업 형태로 기록해 어떤 에이전트가 어떤 일을 했는지 추적하기 쉽습니다. 완료, 실패, 진행 중 상태가 한눈에 표시되기 때문에 멀티 에이전트 작업의 흐름을 효율적으로 관리할 수 있습니다.
• 목표와 모델 배분이 결과 품질을 좌우합니다 처음 설정하는 Company 목표가 구체적일수록 CEO 에이전트가 하위 업무를 더 정확하게 나눌 수 있습니다. 전략 판단이 필요한 역할에는 고성능 모델을, 반복 실무에는 가성비 모델을 배치하면 품질과 비용 효율을 함께 높일 수 있습니다.
• 예산, 승인, API 키 관리는 필수입니다 에이전트가 늘어나면 비용과 구조 관리가 복잡해질 수 있어 예산 한도와 신규 에이전트 승인 옵션을 반드시 설정해야 합니다. 외부 API나 스킬을 연결할 때는 API 키 유출과 무단 과금을 막기 위해 환경 변수(Secret) 방식으로 안전하게 관리해야 합니다.

Paperclip(페이퍼클립)이란?

Paperclip은 여러 AI 에이전트를 모아 실제 하나의 회사처럼 작동하게 만들어주는 무료 오픈소스 프레임워크입니다. 

개별 AI 에이전트가 '직원'이라면, Paperclip은 이 직원들이 명확한 역할과 공동의 목표 아래 움직일 수 있도록 잡아주는 '회사 운영 시스템'입니다. 

조직 구조 관리, 목표 설정, 에이전트 간 업무 분배를 페이퍼클립이 처리하기 때문에, 사용자는 매번 지시를 내리는 대신 방향을 설정하고 팀 구성과 예산을 승인하는 경영자 역할만 맡으면 됩니다.

설치와 설정에 기술적인 이해가 필요한 CLI 기반 도구지만, 비용 통제, 작업 세션 유지, 24시간 자율 운영 등 기존 멀티 에이전트 환경에서 겪던 문제들을 구조적으로 해결한다는 점에서 2026년 3월 출시 직후 빠르게 주목받고 있습니다.

출시된 지 한 달 만에 깃허브 Star 5만 개 돌파,

Paperclip(페이퍼클립)이 떠오르는 이유

페이퍼클립은 2026년 3월 4일 출시 직후 단 몇 주 만에 깃허브(GitHub)에서 5만 개 이상의  '스타'를 받으며 폭발적인 관심을 받고 있습니다. 단기간에 이렇게 큰 관심을 끄는 이유를 5가지로 정리해봤습니다.

1. AI '베이비시팅'의 종료 

AI 베이비시팅이란 여러 AI 에이전트를 사용할 때 사람이 중간에서 결과물을 옮기고, 맥락을 반복 설명하고, 작동 여부를 계속 확인해야 하는 현상을 말합니다. 

기존에는 에이전트마다 터미널 창을 따로 열어두고 한 AI의 결과물을 복사해 다른 AI에게 붙여넣어야 했기 때문에, 정작 업무보다 AI를 돌보는 데 더 많은 시간이 소요됐습니다. 

Paperclip은 여러 AI 에이전트를 하나의 시스템 안에서 관리하고 목표와 맥락을 자동으로 공유하도록 설계되어 있어, 에이전트들이 사람의 개입 없이도 공동의 목표를 향해 유기적으로 협력할 수 있습니다. 

2. 작업 세션 유지와 투명한 과정 추적 

Paperclip은 모든 작업을 Jira나 Trello처럼 티켓과 스레드 형태로 기록합니다. 

컴퓨터를 재부팅하면 진행하던 작업이 모두 날아가는 기존 에이전트(예: 클로드 코드, OpenClaw 등)의 단점을 보완해, 재부팅 후에도 작업이 유지되며 진행 상황을 투명하고 체계적으로 추적할 수 있습니다. 

3. 무한 루프로 인한 '토큰 비용 폭탄' 방지 

기존에는 AI가 오류로 무한 루프에 빠져 예상치 못한 비용이 청구되는 경우가 있었습니다. Paperclip은 에이전트별로 월별 예산을 설정할 수 있고, 사용 한도에 도달하면 즉시 에이전트 작동을 멈추는 비용 통제 시스템을 갖추고 있어 이를 사전에 차단합니다. 

4. 팀 단위 협업을 원활하게 만들어주는 하트비트(Heartbeat)

Paperclip에는 에이전트들이 정해진 주기마다 자동으로 실행되어 새로운 업무가 있는지 확인하고 처리하는 '하트비트(Heartbeat)' 기능이 있습니다. 

한 에이전트가 업무를 마치면 다음 에이전트에게 티켓이 넘어가고, 그 에이전트는 다음 하트비트 주기에 자동으로 이를 이어받아 처리합니다. 

덕분에 CEO, CTO, 콘텐츠 팀 등 역할을 나눈 에이전트들이 사람의 개입 없이도 24시간 끊김 없이 협업할 수 있습니다. 

5. 쉬운 도구(스킬) 확장성 

Paperclip에서는 스킬 저장소의 URL만 붙여넣는 것으로 손쉽게 외부 도구를 연결해 기능을 확장할 수 있습니다. 덕분에 웹 검색, 이메일 발송, 구글 워크스페이스 연동 등을 간단히 설정하여 에이전트들이 실제 실무를 수행하게 만들 수 있습니다. 

Paperclip(페이퍼클립) 사용법

- 설치부터 작업 진행까지

Paperclip을 사용하기 위해서는 먼저 Paperclip을 설치해야합니다. 설치에는 사용조건이 있는데요. Node.js 20 또는 pnpm 9.15 이상을 사용해야 합니다.

로컬 설치 

npx paperclipai onboard 명령어 하나로 초기 설정부터 서버 실행까지 자동으로 진행됩니다. 

Paperclip 설치가 완료되면 http://localhost:3100에서 대시보드에 접속됩니다.  PostgreSQL 데이터베이스도 별도 설정 없이 자동으로 생성됩니다.

VPS 환경 설치 (Docker) 

VPS(Virtual Private Server)란 인터넷으로 빌려 쓰는 가상 서버로, 내 컴퓨터와 달리 24시간 켜진 상태를 유지합니다. 페이퍼클립을 항상 돌아가게 하려면 VPS 환경이 필요하며, AWS, DigitalOcean, Hostinger 같은 서비스에서 월 몇 달러에 빌릴 수 있습니다. 

Docker를 설치한 뒤 docker compose -f docker-compose.quickstart.yml up --build 명령어로 실행할 수 있으며, AI 모델 공급자의 API 키를 대시보드에서 반드시 추가해야 에이전트가 실제 작업을 수행할 수 있습니다. 

Paperclip 설정하기

Paperclip 초기 대시보드 화면에는 총 4가지의 옵션이 나옵니다. 

• Company: 회사 이름과 목표(Mission/Goal)를 설정하는 단계입니다. 에이전트들이 공유할 조직의 기본 정보를 입력합니다.
• Agent: 에이전트를 추가하고 역할(CEO, CTO 등)을 부여하는 단계입니다. 어떤 AI 모델을 쓸지도 여기서 설정합니다.
• Task: 에이전트들이 처음 수행할 초기 작업을 등록하는 단계입니다.
• Launch: 모든 설정을 확인하고 회사를 실제로 가동하는 마지막 단계입니다.

Paperclip을 사용하기 위해 Company에 제시된 회사명과 목표를 입력합니다. 

회사명과 목표를 입력한 뒤 Next 버튼을 누르면 Agent 설정 화면이 나옵니다. 아래 내용을 참고해 진행하면 됩니다.

• Agent name: 기본값으로 CEO가 입력되어 있습니다. 첫 번째 에이전트는 CEO로 두는 게 좋습니다.
• Adapter type: 어떤 AI 에이전트를 연결할지 선택합니다. Claude Code가 설치되어 있으면 Claude Code를, Codex를 쓰고 있다면 Codex를 선택하면 됩니다.
• Model: 사용할 AI 모델을 선택합니다. Default로 두면 어댑터의 기본 모델이 자동으로 적용됩니다.
• Test now: 선택한 어댑터가 정상적으로 작동하는지 확인하는 버튼입니다. Next 누르기 전에 한 번 눌러보는 것을 권장합니다.

다음에는 Task 설정 화면이 나옵니다. CEO 에이전트에게 처음 수행할 업무를 지시하는 단계로 아래를 참고해 내용을 입력합니다.

• Task title: 작업의 제목입니다. 기본값으로 "첫 번째 엔지니어를 채용하고 채용 계획을 세워라"가 입력되어 있습니다.
• Description: 작업의 세부 지시사항입니다. CEO 에이전트가 이 내용을 읽고 업무를 수행합니다.

원하는 업무로 내용을 바꿔서 입력하거나, 기본값 그대로 두고 Next를 눌러도 됩니다. 나중에 대시보드에서 언제든 수정하거나 새 Task를 추가할 수 있습니다.

Launch 화면입니다. 지금까지 설정한 내용이 모두 체크된 상태로 요약되어 나옵니다. Create & Open Issue 버튼을 누르면 설정이 완료되고 CEO 에이전트가 첫 번째 Task를 받아 작업을 시작합니다. 

요청한 프롬프트에 맞춰 CEO 에이전트가 스스로 업무를 시작합니다. 최신 AI/IT 뉴스 리서치 팀을 구성하고, 주제 서칭에 필요한 팀원을 스스로 고민해 채용하는 모습을 확인할 수 있습니다. 

작업 내역 확인

좌측 사이드바에서 Issues를 클릭하면 작업 현황을 확인할 수 있습니다. 완료된 작업은 초록색, 실패한 작업은 빨간색으로 표시됩니다. 초반에 에이전트 모델 설정이 잘못되어 실패한 항목을 제외하면 나머지 요청은 모두 정상적으로 완료된 것을 확인할 수 있습니다. 

초기 세팅 시 요청한 이슈를 확인해 보면, 2026년 4월 6일부터 5월 6일 사이에 공개된 주요 AI/IT 뉴스를 12개의 핵심 소스로 나눠 정리해 놓은 것을 볼 수 있습니다. 

하단에는 초기 요청에 맞게 5개의 콘텐츠 콘셉트도 함께 정리되어 있습니다. 

뉴스 정보를 수집해 편집할 리서치 팀을 구성하고 5개의 콘텐츠를 추천해달라는 요청에 맞게, 자료 수집과 정리까지 모두 완료된 것을 확인할 수 있습니다. 

생성된 조직 확인하기

Paperclip은 다른 AI 에이전트와 달리 사용자의 요청을 처리할 팀을 직접 구성해 작업을 진행합니다. 실제 회사처럼 역할을 나눠 협업하는 방식으로, 생성된 조직은 좌측 사이드바의 Org에서 확인할 수 있습니다.

CEO 에이전트를 중심으로 AI/IT 뉴스 리서치와 콘텐츠 분석, 기획을 담당할 CMO, 뉴스 리서처, 트렌드 분석가, 콘텐츠 기획자가 자동으로 구성된 것을 볼 수 있습니다.

새로운 작업 요청하기

초기 작업이 완료된 후 새로운 작업을 요청하려면 왼쪽 사이드바에서 New Issue를 클릭합니다. 

작업 목적과 내용을 입력하는 창이 열리며, CEO · CMO 등 작업을 지시할 역할과 모델을 별도로 선택할 수 있습니다. 역할과 모델을 선택한 뒤 요청 내용을 입력하고 Create Issue를 클릭하면 됩니다. 

새로 지시한 요청에 맞춰 일을 처리합니다. CEO에게 작업의 진행을 요청했는데, CMO에게 작업을 위임해 처리하는 모습을 볼 수 있습니다.

Paperclip 결과물의 

퀄리티를 높여주는 활용 노하우 4가지

1. 명확하고 구체적인 상위 목표(Mission) 설정 

AI 에이전트가 방향을 잃지 않고 고품질의 결과물을 내려면, 회사 설립 시 비즈니스 목표를 최대한 구체적이고 명확하게 설정해야 합니다. 

예를 들어 단순히 "이메일을 작성해라"라고 지시하기보다 "가장 이슈가 되고 최신의 기술 뉴스를 찾아 이메일로 제공한다"처럼 목표 지향적으로 작성할수록, CEO 에이전트가 더 정확한 판단과 방향성을 가지고 하위 에이전트들에게 업무를 위임할 수 있습니다.

2. 역할의 중요도에 따른 전략적인 AI 모델 배분 

모든 에이전트에게 동일한 모델을 사용하기보다 역할에 따라 모델을 다르게 배치하는 것이 효율과 품질을 모두 높이는 핵심입니다. 

전략 수립과 팀 구성을 담당하는 CEO 에이전트에게는 고성능 모델(예: 클로드 오퍼스 4.6)을 할당해 판단력을 극대화하고, 리서치나 코딩 등 실무를 담당하는 하위 에이전트에게는 가성비가 좋은 모델(예: GPT-5.4 mini)을 할당하면 예산을 절감하면서도 최적의 결과물을 얻을 수 있습니다.

3. 스킬 및 외부 API를 통한 적극적인 도구 부여 

에이전트가 실제로 유용한 결과물을 만들어내려면 외부 도구와의 연동이 필수입니다. 스킬 저장소 URL을 붙여넣거나 외부 서비스의 API 키를 입력해 에이전트에게 적절한 도구를 연결해야 합니다. 

리서치 담당에게는 Tavily API를, 이메일 발송 담당에게는 SendGrid API를, 팀 전체 협업 담당에게는 Slack 스킬을 연결해 주면 에이전트의 작업 품질과 실행력이 크게 향상됩니다. 

4. 에이전트 간 상호 검토 파이프라인 및 이사회 승인 시스템 활용 

결과물의 오류를 줄이려면 작업 단계를 세분화해 에이전트끼리 서로 검토하는 파이프라인을 구축해야 합니다. 

예를 들어 뉴스 리서처가 수집한 자료를 콘텐츠 매니저가 검토해 상위 3개를 선정한 뒤 스크립트 라이터에게 넘기는 방식의 교차 검토 구조를 만들 수 있습니다. 

또한 이사회 역할로서 수신함(Inbox)에 들어오는 주요 의사결정과 신규 채용 요청을 직접 승인하는 과정을 거치면, 결과물의 방향을 완벽하게 통제할 수 있습니다.

Paperclip(페이퍼클립) 사용 시 주의 사항

Paperclip은 AI 에이전트 팀을 실제 조직처럼 운영할 수 있게 해주는 강력한 프레임워크이지만, 원활하고 안전한 사용을 위해 다음 주의사항을 숙지해야 합니다.

1. 예산 설정은 필수 

에이전트별로 월별 예산 한도를 반드시 설정해야 합니다. 모든 에이전트에 고성능 모델을 적용하면 비용이 급증하므로, CEO급 에이전트에만 고성능 모델을 배정하고 실무 에이전트에는 GPT-5.4 mini 같은 저렴한 모델을 활용하는 것이 좋습니다.

2. 24시간 운영이 목적이라면 VPS 필요 

개인 컴퓨터에서도 실행할 수 있지만, 전원을 끄는 순간 모든 업무가 멈춥니다. 24시간 자율 운영을 원한다면 가상 사설 서버(VPS) 환경을 권장합니다.

3. 신규 에이전트 채용 승인 옵션은 켜두기 

이사회 승인 옵션을 꺼두면 에이전트가 무분별하게 늘어나 비용과 구조 관리가 어려워집니다. 새 에이전트 채용 시 수동 승인하는 옵션은 켜두는 것이 좋습니다.

4. API 키 유출 주의 

API 키가 유출되면 무단 사용과 예상치 못한 과금이 발생할 수 있습니다. 환경 변수(Secret) 기능을 활용해 안전하게 관리해야 합니다.

5. 단일 에이전트 용도에는 부적합 

Paperclip은 다수의 에이전트가 협력하는 팀 단위 시스템입니다. AI 비서 한 명만 필요한 상황이라면 오히려 너무 무거운 도구가 될 수 있어, 사용 목적에 맞는지 먼저 확인하고 도입해야 합니다. 

AI 에이전트를 활용한 작업 노하우가 궁금하다면 

젠스파크, 이것까지 된다고? 실전 사용법 6가지

Manus AI(마누스 AI), Meta가 선택한 AI 에이전트 사용법

클로드 코드 에이전트 팀 사용법, 역할별 AI 팀으로 개발 자동화하기