개인용 초보자 매뉴얼 · 2026년 8월 1일
Paperclip을 멋대로 일시키지 않고 안전하게 사용하는 법
결론: 처음에는 “자율 CEO 모드”를 쓰지 말고, 작은 Issue 하나를 Agent 한 명에게 직접 맡기세요.
Paperclip은 기존 프로젝트를 자동으로 찾지 않습니다. 사람이 Project와 실제 폴더를 연결하고, Issue를 구체적으로 작성해야 원하는 범위 안에서 움직입니다.
이 문서는 현재 Mac에 설치된 Paperclip 2026.722.0을 기준으로 만들었습니다. 공식 화면 예시는 공개 저장소의 UI 이미지이며 버전에 따라 배치가 조금 달라질 수 있습니다.
· · ·
1. Paperclip은 무엇인가
Paperclip은 AI 자체가 아니라 AI 작업 관리자입니다. 해야 할 일을 Issue로 적고, Claude나 Codex Agent에게 맡기고, 실행 기록과 결과를 확인합니다.
Paperclip은 관제실이고, 실제 일은 이 Mac에서 실행되는 Claude 또는 Codex가 합니다.
https://paperclip.lollolha.com/에서 접근하며 계정 정보는 캡처하지 않았다.2. 왜 원하지 않은 프로젝트가 생겼나
공식 Quickstart는 CEO Agent에게 Mission을 주는 방식입니다. CEO는 전략을 제안하고, 사람이 승인하면 Agent와 Issue를 스스로 만들 수 있습니다. Mission을 넓게 적으면 신규 제품 계획까지 생길 수 있습니다.
Mission은 단순 소개문이 아닙니다. CEO 모드에서는 실제 조직 운영 목표로 해석됩니다.
3. 대시보드 화면 읽기
- Dashboard — 실행 중 Agent, 비용, 최근 활동 요약
- Issues — 실제 할 일 목록
- Projects — 작업 묶음과 코드 폴더 연결
- Agents — Claude/Codex 작업자 설정과 Runs 확인
- Inbox·Approvals — 사람이 승인하거나 고칠 요청
4. 전체 구조
Company
└─ Mission / Goal
└─ Project ── 실제 Workspace 폴더
└─ Issue ── Agent에게 할당
└─ Run ── 사람이 결과 검토
5. 가장 안전한 첫 연습
연습 폴더
~/Paperclip-Practice처럼 실제 프로젝트와 분리합니다.
연습 Project
Add Project에서 Paperclip Practice를 만듭니다.
Agent 한 명
codex_local, heartbeat 끄기, 동시 실행 1, Agent 생성 권한 끄기로 설정합니다.
읽기 전용 Issue
폴더 상태를 조사하고 5줄 요약하되 파일은 수정하지 말라고 적습니다.
사람 검토
Run 로그와 Issue 코멘트를 읽고 변경 파일 0개를 확인합니다.
6. 기존 프로젝트 연결
Project를 만든 뒤 Configuration에서 repository 또는 Local folder를 직접 지정합니다.
lollolha 사이트 예시
Project: lollolha.com Local folder: ~/Sites/lollolha 첫 Issue: 현재 구조 조사 금지: 파일 수정·commit·push·배포 완료: 변경 파일 0개 + 구조 요약 + 위험 목록
Local folder를 지정하면 Agent가 그 경로를 읽고 권한에 따라 수정할 수 있습니다. ~ 전체를 Workspace로 지정하지 마세요.
공유 Workspace와 격리 Workspace
Primary workspace는 원본 폴더를 직접 사용합니다. Isolated workspace는 별도 Git worktree를 만들어 원본과 분리합니다. 코드 변경은 격리 방식이 더 안전합니다.
7. 좋은 Issue 작성법
New Issue에서 제목, 설명, Project, Agent, Workspace를 정합니다. 할당 시 깨우기가 켜져 있으면 저장 직후 실행될 수 있으므로 설명을 먼저 완성하고 Agent는 마지막에 선택하세요.
제목: lollolha 사이트 구조를 읽기 전용으로 조사 해야 할 일 - 주요 폴더와 페이지 구조 조사 - 실행·배포 구조 요약 금지사항 - 파일 수정 금지 - commit·push·배포 금지 - 새 Agent 생성 금지 완료 기준 - 변경 파일 0개 - 구조 다이어그램 1개 - 위험 3개와 개선 후보 3개를 Issue 코멘트로 제출
8. Claude와 Codex는 어디서 실행되는가
claude_local과 codex_local은 모두 이 Mac에서 로컬 프로세스로 시작됩니다. 모델 계산은 외부 API에서 이뤄질 수 있지만 파일을 읽고 명령을 실행하는 runtime은 이 Mac에 있습니다.
원격 브라우저 → Cloudflare Tunnel → Paperclip server (127.0.0.1:3100) → claude_local 또는 codex_local adapter → 이 Mac의 Claude/Codex 프로세스 → 지정된 Workspace 파일
Cloudflare Tunnel은 대시보드 통로일 뿐 Agent 실행기가 아닙니다.
9. 중지·재개·삭제 구분
| 조작 | 뜻 | 권장 |
|---|---|---|
| Pause Agent | 새 실행을 막는 공식 상태. Resume 가능 | 일단 멈출 때 |
| Heartbeat 끄기 | 정기 실행만 차단. 할당·멘션·수동 호출은 가능 | 자동 주기만 끌 때 |
| Process 종료 | 지금 프로세스만 응급 종료. Paperclip 상태는 남음 | 폭주 응급조치 |
| Resume | Agent를 active로 바꿈. 즉시 Run 생성과는 다름 | 재사용할 때 |
| Run Heartbeat | 지금 한 번 즉시 실행 | 설정 검토 후 |
| Terminate | 영구 종료. 공식 문서도 Pause 우선 권고 | 다시 쓰지 않을 때만 |
| Archive Project | Project를 목록에서 숨기는 가역적 정리 | 연습 Project 정리 |
Delete·Terminate 전에 결과 파일을 보존하고 실행 중 Run이 없는지 확인하세요. 정리가 목적이면 Archive와 Pause가 더 안전합니다.
10. 위험 설정 체크리스트
dangerouslySkipPermissions = falsecanCreateAgents = falseheartbeat.enabled = falsewakeOnDemand는 필요할 때만- 동시 실행 수 1
- Workspace를 특정 프로젝트 폴더로 제한
- 첫 Issue는 읽기 전용, commit·push·deploy 금지
- Company와 Agent 양쪽에 비용 한도 설정
11. Lolhabot·Kai·LOL-1~7의 의미
claude_local Agent. Mission을 전략과 작업으로 바꾸도록 설정됐습니다.codex_local Agent. Lolhabot이 만든 신규 데모 Project의 작업자입니다.이 항목들은 기존 ~/Sites/lollolha가 아니라 Paperclip 관리 폴더의 별도 신규 Project입니다.
2026년 8월 1일 22:21 KST 재검사에서 서버는 정상이고 실제 Claude/Codex Agent runtime은 0개였습니다. runtime 0개는 Pause와 다르므로 Agents 화면에서 Lolhabot과 Kai가 Paused인지 확인하세요.
12. 이상할 때 확인하는 순서
- Issues에서
in_progress·blocked를 봅니다. - Agents에서 Live와 status를 봅니다.
idle은 실행 가능한 대기 상태입니다. - Runs에서 Assignment·On-demand·Timer 중 무엇이 깨웠는지 봅니다.
- Project의 Workspace가 실제 어느 폴더인지 확인합니다.
- 원하지 않는 동작이면 먼저 Pause하고 현재 process를 응급 종료합니다.
git status와 diff를 확인한 뒤에만 Resume합니다.
· · ·
처음 한 번만 따라 할 최소 순서
- 로그인
- Kai와 Lolhabot Pause
Paperclip PracticeProject 생성~/Paperclip-Practice만 Local folder로 연결- 안전 설정의 Codex 연습 Agent 한 명 생성
- 읽기 전용 Issue 작성 후 마지막에 Agent 지정
- Run 로그와 변경 파일 0개 확인
- 연습 종료 후 다시 Pause