클로드 코드(Claude Code)에는 푸시 전에 쓰는 점검 명령이 두 개 들어 있어요. /security-review는 내 브랜치 변경에서 보안 위험(입력값 주입, 권한 확인 누락, 개인정보 노출 등)을 찾고, /code-review --fix는 버그를 찾아 바로 고쳐 줘요. 여기에 바뀐 파일 목록을 자동으로 넣고 우리 프로젝트 기준으로 한 번 더 보는 나만의 /ship-check 명령까지 만들어 두면, 배포 전 점검 순서가 매번 같아져요.
이런 분께
- 배포하고 나서야 "여기 권한 확인이 빠졌네" 하고 급하게 고친 적이 있는 개발자
- 혼자 일하거나 리뷰어가 부족해서, PR 올리기 전에 한 번 더 걸러 줄 장치가 필요한 분
끝나면 이렇게 됩니다
공식 문서 기준으로 이렇게 돌아가요.
/security-review: 내 브랜치와 원격 저장소(origin)의 기본 브랜치 사이에 바뀐 코드를 읽고, 주입·인증·데이터 노출 같은 위험을 찾아 대화에 알려 줘요./code-review: 내 브랜치에서 아직 올리지 않은 커밋과 커밋 안 한 변경을 함께 보고 버그를 찾아요. 따로 일하는 도우미(서브에이전트)가 뒤에서 돌기 때문에 그동안 다른 일을 해도 되고, 결과는 끝나면 대화에 도착해요.--fix를 붙이면 찾은 문제를 작업 폴더에 바로 고쳐요. 수정은 내 권한 설정에 따라 허락을 받고 들어가요.- 마지막에
/ship-check를 치면 바뀐 파일 목록과 변경량이 자동으로 들어간 상태에서, 중요 폴더부터 보안·버그를 보고 고칠 목록을 먼저 보여 주는 내 명령이 생겨요.
준비물
- 클로드 코드: 프로(Pro)·맥스(Max)·팀·엔터프라이즈 요금제나 콘솔 계정이 필요해요. 무료 claude.ai 요금제로는 쓸 수 없어요. (2026년 11월 기준)
- 설치: 터미널(컴퓨터에 글자로 명령하는 창)을 열고 아래 한 줄. 윈도우는 시작 메뉴에서 "PowerShell" 검색, 맥은 Spotlight에서 "터미널" 검색.
- 맥·리눅스:
curl -fsSL https://claude.ai/install.sh | bash - 윈도우 PowerShell:
irm https://claude.ai/install.ps1 | iex
- 맥·리눅스:
- git으로 관리하는 프로젝트, 그리고 원격 저장소 이름이
origin으로 연결돼 있어야 해요(/security-review조건). /code-review는 모든 요금제에서 되지만, 쓴 만큼 내 요금제 사용량에서 빠져요.
따라 하기
- 터미널에서 프로젝트 폴더로 들어가
git remote -v를 쳐요.origin이 보이면 준비 끝이에요. claude를 쳐서 클로드 코드를 열어요. 처음이면 브라우저 로그인 안내를 따라가요./security-review를 입력해요. 결과가 나오면 위험도가 높은 것부터 읽고, 고칠 것만 골라 "1번, 3번 고쳐 줘"라고 말해요./code-review high를 입력해요.high는 꼼꼼함 단계예요.low는 확실한 것만,medium부터max까지는 더 넓게 봐요.- 결과가 맞으면
/code-review --fix로 다시 돌려 고치게 해요. - 터미널을 하나 더 열어
git diff로 바뀐 줄을 직접 보고, 테스트를 돌려요. 백그라운드 리뷰가 고친 파일은/rewind로 되돌려지지 않을 수 있어서 git으로 확인하는 게 안전해요. - 매번 쓰고 싶으면 아래 "복사해서 쓰는 프롬프트"로
/ship-check를 만들어요. 새 세션에서/ship-check를 치면 돼요.
