
Plannotator, 에이전트에 붙이기 전에 뭘 확인해야 할까요? Inbox 미리보기 2026 기준
무료 자료
PDF · 무료
AI가 일하기 전에 계획부터 고치는 도구, 설치 전 점검표
긴 글을 다 읽기 전에, 실무 가이드부터 먼저 챙겨가세요.
Plannotator, 에이전트에 붙이기 전에 뭘 확인해야 할까요? Inbox 미리보기 2026 기준
Plannotator는 AI 코딩 에이전트의 계획에 사람이 주석을 달아 돌려보내는 로컬 도구예요. 새로운 것은 2026-10-08 KST에 미리보기로 나온 Inbox예요.
Plannotator는 정확히 어떤 도구인가요?
'로컬에서 돌면 안전하겠지?' 이런 질문부터 떠오르실 거예요. 맞는 부분도 있고 아닌 부분도 있어서 하나씩 짚어 볼게요.
Plannotator는 정확히 어떤 도구인가요?
계획 검토는 ExitPlanMode 호출로 시작해 승인이나 거절로 갈려요
자료: Plannotator README(GitHub) · QJC 재구성
README는 이렇게 소개해요. "Plannotator is a local, browser-based review surface for AI coding agents: Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp, DeepSeek Harness, and Pi." 에이전트가 낸 계획과 코드 변경을 내 컴퓨터 브라우저에 띄워 주석을 달고 되돌려 보내는 화면이라는 뜻이에요.
저장소는 2025-12-28 11:09 KST에 생겼고 2026-11-17 07:09 KST GitHub API 기준 별 12,492개예요. 계획 검토는 Claude Code의 경우 에이전트가 ExitPlanMode를 부르면 로컬 서버가 검토 화면을 여는 방식이고, 다른 에이전트는 각자의 훅·플러그인·명령을 써요. 승인하면 진행하고 거절하면 피드백이 에이전트로 가요. 문서는 이 서버의 API를 "session-scoped, unauthenticated"라고 적어요. 세션마다 뜨고 인증이 없다는 뜻이고 로컬 모드는 127.0.0.1에만 묶여요.
Inbox 미리보기는 무엇을 하나요?
릴리스 노트는 v0.28.8(2026-10-08 07:49 KST)에서 Inbox를 "(preview)"로 표기했어요. 지금도 미리보기인지는 원문에 없어서 정식 출시라고는 쓰지 않을게요.
Inbox는 에이전트가 사람에게 메시지와 질문, 파일을 남기는 내 컴퓨터의 창이에요. 사람이 시간 날 때 답하고 Send를 누르면 질문한 세션으로 가요. 에이전트는 기다리지 않고 일을 계속해요. 저장은 ~/.plannotator/inbox/ 아래예요. 프로젝트 계정 @plannotator의 Inbox 소개 X 게시물은 2026-10-10 01:03 KST에 올라왔고 좋아요 475개(2026-11-17 07:27 KST 수집)였어요.
주의할 점은 묻지 않고 바뀌는 것들이에요. 직접 plannotator inbox를 실행하면 이 컴퓨터에서 찾은 미연결 에이전트를 연결해요(PLANNOTATOR_INBOX_CONNECT=0으로 끔). 안내 메모는 Inbox가 시작할 때마다 연결된 에이전트의 지시 파일에 붙고, 레퍼런스 문서는 이 일을 "Nothing asks you first."라고 적어요(PLANNOTATOR_INBOX_NOTES=0으로 끔).
v0.28.10 이상은 Tailscale Serve로 tailnet 안에 공개할 수도 있어요. 설정 문서는 다른 로그인을 들이는 설정을 두고 "Allow only people you would let run your agents."라고 경고해요. 에이전트를 돌려도 되는 사람만 허용하라는 뜻이고, v0.28.65(2026-11-15 09:07 KST)부터는 컴퓨터 소유 계정만 들어오도록 바뀌었어요. 끄는 설정은 PLANNOTATOR_INBOX_TAILSCALE=0이에요.
공유 링크와 원격 모드는 어디까지 열리나요?
공식 문서는 공유 기능을 deprecated로 분류하고 호환용으로 남겨 뒀다고 적어요. 폐지 일정은 발표되지 않았고 새 팀 공유는 호스팅 제품 Workspaces로 안내해요. 핵심 기능처럼 권하기는 어려워요.
경고는 분명해요. "Anyone with the complete URL can read the review." 전체 URL을 아는 사람은 누구나 검토 내용을 읽는다는 뜻이라 링크를 비밀번호처럼 다뤄야 해요. 긴 문서의 짧은 링크는 기본 서비스에서 7일 뒤 삭제돼요. 끄는 설정은 PLANNOTATOR_SHARE=disabled예요.
원격 모드는 더 신경 써야 해요. 문서 원문은 "Remote mode binds the unauthenticated server to 0.0.0.0."이에요. 인증 없는 서버를 모든 네트워크 인터페이스에 묶는다는 뜻이고 SSH 터널을 써도 호스트의 다른 인터페이스 포트는 닫히지 않아요. SSH 접속 안에서는 원격 모드가 저절로 켜지고 포트 19432를 써요. PLANNOTATOR_REMOTE=0이면 로컬 모드를 강제해요.
로컬인데도 밖으로 나가는 것이 있나요?
있어요. 개인정보 문서에 따르면 검토 화면이 뜰 때마다 GitHub API로 최신 릴리스를 확인해요. 검토 내용은 담기지 않지만 "Plannotator OSS does not currently provide a setting to disable this release check."라서 이 확인은 끌 수 없어요.
AI 기능은 따로 봐야 해요. Ask AI와 Agent Reviews 같은 기능은 설정한 AI 제공자로 프롬프트와 저장소 내용을 보낼 수 있어요. 끄는 설정은 PLANNOTATOR_AI=disabled예요. 리뷰 잡의 읽기 전용도 프롬프트로 시킬 뿐 실행을 강제하지 않는다고 문서가 밝혀요.
제3자 정리 글인 explainx.ai는 "not an agent-security product"라고 결론 냈어요. 보안 도구가 아니라 검토 화면이라는 그 글의 의견이에요.
Claude Code에 붙이면 Claude는 기다리나요?
설치는 셸에서 설치 스크립트를 돌리고 Claude Code 안에서 /plugin 명령 2개를 입력한 뒤 다시 시작하는 순서예요. 업데이트는 바이너리와 플러그인을 따로 올려야 해요.
기다리는지는 환경마다 달라요. Claude Code 2.1.287 이상, 대화형 터미널, 플러그인 기본 설정, 최신 바이너리가 모두 맞으면 문서 기준으로 Claude는 멈추지 않아요. 경고 원문은 "While a plan review is open, Claude is not blocked."예요. 검토 창이 열려 있어도 Claude가 막히지 않으니 승인 전에 plan mode를 직접 나가면 편집을 시작할 수 있다는 뜻이에요. 옛 Claude Code, claude -p나 SDK 실행, PLANNOTATOR_CLAUDE_MOD=0, 옛 바이너리, 수동 훅에서는 기다려요.
설치 스크립트는 최신 버전 확인용 GitHub API 요청에 GITHUB_TOKEN이나 gh 토큰을 보낼 수 있어요. 버전을 고정하면 그 조회를 건너뛰어요.
붙이기 전에 무엇을 점검하면 되나요?
점검 항목 5개를 순서대로 보면 돼요.
- 버전을 봐요. Claude Code 2.1.287 이상인지, 바이너리와 플러그인이 각각 최신인지 확인해요.
- 공유를 정해요. 안 쓰면 PLANNOTATOR_SHARE=disabled로 꺼요. 짧은 링크는 기본 서비스에서 7일 뒤 지워져요.
- AI 기능을 정해요. 안 쓰면 PLANNOTATOR_AI=disabled로 꺼요.
- Inbox 자동 변경을 정해요. PLANNOTATOR_INBOX_CONNECT=0과 PLANNOTATOR_INBOX_NOTES=0, PLANNOTATOR_INBOX_TAILSCALE=0 중 무엇을 끌지 켜기 전에 결정해요.
- 원격 환경을 봐요. SSH에서 쓰면 19432 포트가 0.0.0.0에 묶이니 방화벽으로 막고 필요 없으면 PLANNOTATOR_REMOTE=0을 써요.
연습용 저장소에서 먼저 시험해 보는 편이 안전해요.
마무리
Plannotator는 보안 도구가 아니라 검토 화면이라고 우리는 봐요. 공식 문서를 읽고 정리한 우리 의견이에요. 팀 상황에 맞는지부터 따져보셔도 충분해요. 판단에 필요한 기준은 위에 정리해 뒀어요.
관련 글: shadcn improve, 코드는 안 고치고 계획서만 쓴다는데 뭐가 다를까요? · AI 코딩 도구 보안, 내장 브라우저 결함 어디까지 사실일까요?
자주 묻는 질문
Plannotator Inbox는 정식 기능인가요?
릴리스 노트는 v0.28.8(2026-10-08 07:49 KST)에서 Inbox를 미리보기로 표기했어요. 지금도 미리보기인지는 원문에 없어서 알 수 없어요.
내 컴퓨터에서만 쓰면 밖으로 나가는 게 없나요?
아니에요. 개인정보 문서 기준으로 검토 화면이 뜰 때마다 GitHub 릴리스를 확인하고 이 확인은 끌 수 없어요. 검토 내용은 담기지 않아요.
공유 링크를 팀원에게 보내도 되나요?
권하지 않아요. 문서가 공유 기능을 deprecated로 적었고 전체 URL을 아는 사람은 누구나 읽어요. PLANNOTATOR_SHARE=disabled로 끌 수 있어요.


