플래노테이터로 클로드 코드·코덱스 계획에 브라우저에서 주석 다는 법

플래노테이터(Plannotator)는 코딩 에이전트가 내놓은 계획·문서·코드 변경을 브라우저에서 열어 주석을 달고, 그 피드백을 에이전트에게 바로 돌려보내는 로컬 도구다. 설치해 두면 클로드 코드(Claude Code)가 계획 모드에서 계획을 만들 때마다 리뷰 화면이 저절로 열린다.

1. 설치 스크립트를 돌린다(macOS·리눅스·WSL). plannotator 바이너리를 깔고, 설치된 에이전트를 찾아 훅·스킬·슬래시 명령을 넣는다.

curl -fsSL https://plannotator.ai/install.sh | bash

1. 클로드 코드에서는 플러그인을 설치한 뒤 클로드 코드를 다시 켠다. 코덱스는 설치 스크립트가 실험 기능인 Stop 훅으로 계획 리뷰를 켜 주므로 따로 할 일이 없다.

/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator

1. 자주 쓰는 명령은 아래와 같다.

/plannotator-review                  # 커밋 안 한 변경 리뷰
/plannotator-review <github-pr-url>  # 깃허브 PR 리뷰
/plannotator-annotate README.md      # 마크다운 파일에 주석
/plannotator-last                    # 에이전트의 마지막 답에 주석

코덱스에서는 슬래시 명령 대신 $plannotator-review·$plannotator-annotate·$plannotator-last 스킬이나 !plannotator review를 쓴다.

클로드 코드 2.1.287 이상에서는 리뷰하는 동안 클로드가 기다리지 않고 턴을 끝내고, 리뷰 결과는 나중에 메시지로 들어간다. 예전처럼 기다리게 하려면 PLANNOTATOR_CLAUDE_MOD=0을 설정한다. 사용 통계는 모으지 않고 계획·주석은 로컬에 남지만, 화면을 열 때마다 최신 릴리스를 확인하려고 깃허브에 요청을 보낸다. 라이선스는 Apache-2.0이다.