AI 코딩 에이전트를 여러 개 쓰기 시작하면 각 창에서 무엇을 하고 있는지, 어떤 작업이 끝났는지, 비용은 얼마나 들었는지 따로 확인하게 됩니다. Paperclip은 이런 에이전트의 업무와 실행 기록을 한곳에 모아 관리하는 프로젝트입니다.
2026년 10월 22일 15:07 KST 수집 기준 BlogFlow 월간 인기 저장소 1위였습니다. 순위는 이후 달라질 수 있습니다. 공식 README와 관련 문서를 기준으로, 어떤 상황에서 살펴볼 만한지 정리합니다.
무엇을 하는 앱인가요?
Paperclip은 Node.js 서버와 React 화면으로 구성되며, 여러 AI 에이전트에 목표와 업무를 배정하고 진행 상황을 확인하는 역할을 맡습니다. 작업 내용, 담당 에이전트, 대화와 실행 이력을 연결해 관리합니다. 같은 도구를 쓰는 에이전트만 모아야 하는 것도 아닙니다.
예를 들어 작은 웹 서비스를 만든다면 기획 정리, 화면 구현, 테스트 검토를 각각의 작업으로 나누고 담당을 정하는 방식으로 시작할 수 있습니다. 이는 작업을 나누는 예시입니다. 에이전트 수를 늘렸다는 사실만으로 품질이나 완료 속도가 보장되는 것은 아닙니다.
기존 코딩 에이전트는 어디에 연결되나요?
Paperclip의 어댑터는 업무 관리 화면과 실제 작업을 수행하는 실행 환경을 연결합니다. 실행 환경을 시작하거나 호출하고, 작업 맥락을 전달하고, 결과·세션·사용량 정보를 받아오는 역할입니다.
이미 사용하는 Claude Code나 Codex 같은 로컬 에이전트가 있다면 해당 어댑터의 요구사항부터 확인할 수 있습니다. 실제 모델 실행은 연결한 런타임이 담당하므로 Paperclip 설치와 에이전트 인증·실행 준비는 별개입니다. 처음에는 익숙한 에이전트 한 개를 연결해 작업이 배정되고 결과가 돌아오는 흐름부터 보는 편이 좋습니다.
로컬에서 시작하는 순서
README의 빠른 시작은 Node.js 24.11 이상을 요구하며 다음 명령을 안내합니다. 실행하면 로컬 인스턴스를 위한 초기 설정이 진행됩니다.
npx paperclipai@latest onboard --yes--yes는 안내된 빠른 시작 경로의 옵션입니다. 기존 설정이 있는 컴퓨터나 공용 서버에 적용하기 전에 설치 문서에서 설정·데이터 위치와 실행 방식을 읽어보세요. 처음에는 운영 계정과 연결하지 않은 로컬 실험으로 범위를 좁히는 편이 좋습니다.
- 작은 프로젝트 하나를 정합니다. 완료 여부를 확인할 수 있는 작업과 기대 결과를 적습니다.
- 준비된 에이전트 하나를 연결합니다. 어댑터의 실행 환경 검사를 확인하고 필요한 작업 폴더만 지정합니다.
- 결과 검토 기준을 정합니다. 변경 파일, 테스트 결과, 남은 문제를 사람이 확인할 수 있도록 요청합니다.
- 짧은 작업을 실행해 봅니다. 배정·실행·결과 기록을 확인한 다음 역할과 작업 수를 늘립니다.
비용 화면과 예산 제한은 함께 봐야 합니다
비용·예산 문서는 조직과 에이전트의 월간 예산, 프로젝트 단위의 누적 예산을 구분합니다. 경고와 중지 기준도 서로 다르므로 금액을 넣었다는 사실만으로 어떤 동작이 멈추는지 넘겨짚지 않아야 합니다.
처음에는 작은 한도를 정하고 실제 실행 기록과 함께 확인해 보세요. 에이전트나 제공자가 사용량을 어떤 방식으로 보고하는지에 따라 표시를 해석해야 하며, 화면의 수치와 실제 청구를 같은 것으로 단정하기보다 제공자 사용 내역도 대조하는 편이 좋습니다. 예산을 올리거나 중지된 작업을 재개하는 결정 역시 별도로 검토해야 합니다.
도입 전에 확인할 점
README의 빠른 시작은 로컬 루프백을 신뢰하는 모드를 기본으로 안내합니다. 개인 컴퓨터에서 살펴보는 설정을 그대로 외부에 공개하지 말고, 원격 접근이 필요하다면 인증과 배포 모드를 먼저 확인하세요.
연결 권한도 작업에 맞게 정해야 합니다. 처음부터 모든 저장소와 서비스에 쓰기 권한을 주기보다, 테스트용 저장소 한 개와 제한된 작업으로 결과를 확인할 수 있습니다. 중요한 변경에는 검토 단계를 두고, 에이전트가 만든 결과를 직접 읽고 테스트하는 과정은 유지하세요.
Paperclip GitHub 원본 저장소 보기 · 현재 월간 인기 저장소 보기
공식 자료 확인일: 2026년 10월 22일. 실제 설치·팀 운영을 실행한 후기와 구분되는 프로젝트 소개입니다.
새 글 받아보기
RSS 리더에서 BlogFlow의 새 글을 확인할 수 있습니다.