사람한테 보여주기 전에, /code-review로 내 코드 AI한테 먼저 검사받기

혼자 코딩하다 보면 "이거 어디 버그 숨어 있는 거 아냐?" 하는 불안이 들죠. 리뷰해줄 사람이 없으면 특히 더요. 그렇다고 사람에게 보여주기 전에 점검할 방법이 마땅치 않았는데, 이제 있습니다. /code-review예요. 작성한 코드의 버그와 개선점을 AI가 검토해주고, 원하면 그 자리에서 고쳐줍니다.

정의

/code-review는 작성된 코드의 버그·개선점을 검토하는 명령입니다. 사람 리뷰어가 PR(코드 변경 제안)을 살펴보듯, Claude가 코드를 훑어 문제점과 고칠 부분을 짚어줘요.

검토 강도를 고를 수 있는 게 특징입니다. 평소엔 가볍게 검토만, 중요한 변경은 깊게 정밀 검토하는 식으로요. 옵션을 붙이면 발견한 문제를 바로 고치게 할 수도 있습니다.

사용법 (난이도별)

기초 — 검토만 받기

대화창에 이렇게만 입력합니다.

/code-review

입력하면 Claude가 작성된 코드를 살펴보고, 발견한 버그·개선점을 항목별로 보고합니다. 어디가 문제이고 왜 그런지 설명해줘서, 고칠지 말지는 내가 판단할 수 있어요.

응용 — 검토하고 바로 고치기

/code-review --fix

--fix(픽스 — '고친다'는 뜻의 옵션)를 붙이면 검토에서 그치지 않고, 발견한 문제를 바로 코드에 반영해 고쳐줍니다. 자잘한 버그나 중복 코드를 한 번에 정리할 때 편해요.

심화 — 클라우드에서 정밀 검토

/code-review ultra

ultra(울트라 — 정밀 모드)를 붙이면 클라우드(인터넷 너머 서버)에서 여러 에이전트(보조 AI 일꾼)가 코드를 깊게 검토합니다. 시간은 더 걸리지만 그만큼 꼼꼼해서, 배포 직전이나 중요한 변경에 씁니다.

흔한 함정 — 보안 점검은 따로입니다

/code-review는 품질 위주의 검토예요. 버그, 중복 코드, 개선점 같은 걸 봅니다. 그런데 입문자가 "이걸 돌렸으니 보안도 다 봤겠지" 하고 오해하기 쉬운데, 그렇지 않습니다.

보안 취약점(해킹·정보 유출 위험 등)을 집중적으로 점검하려면 /security-review(보안 리뷰 — 보안 전용 검토 명령)를 따로 돌려야 해요. 중요한 코드라면 /code-review로 품질을, /security-review로 보안을 둘 다 점검하는 게 안전합니다.

실전 사례

블로그 백엔드에 새 기능을 붙인 뒤, 사람에게 보여주거나 배포하기 전에 한 번 점검하고 싶었어요. 그래서 이렇게 돌렸습니다.

/code-review --fix

Claude가 자잘한 버그 몇 개와 중복된 코드를 찾아 그 자리에서 정리해줬습니다. 혼자였으면 놓쳤을 부분을 잡아준 거죠. 사람 리뷰어 없이도 '한 번 거른' 코드가 되니 마음이 한결 놓였습니다.

이렇게 더 씁니다

• 자동 수정: --fix를 붙이면 발견한 문제를 바로 고쳐줍니다.
• 클라우드 정밀: 중요한 변경은 /code-review ultra로 여러 에이전트가 심층 검토합니다.
• PR 댓글로 남기기: --comment(코멘트 옵션)를 붙이면 깃허브 PR에 줄별로 코멘트를 달아줍니다.
• 보안까지 이중 점검: /security-review와 묶어 품질과 보안을 함께 봅니다.

팁: 평소엔 가볍게 /code-review로 빠르게, 배포 직전이나 중요한 코드는 ultra로 정밀하게 — 이렇게 강도를 나눠 쓰면 효율적입니다. 사람에게 보여주기 전 AI한테 먼저 거치는 걸 습관으로 만들어보세요.

다른 사람들은 이렇게 씁니다

• 실제 프로젝트들에서 얻은 교훈 — 리뷰를 워크플로에 넣어 품질을 끌어올린 사례 모음. — Best Practices: Lessons From Real Projects (RanTheBuilder)
• 첫날부터 알았으면 좋았을 팁들 — 리뷰·검증을 습관화한 실전 경험. — Tips I Wish I'd Had From Day One (Marmelab)

정리

핵심은 한 문장입니다. 내 코드, 사람한테 보여주기 전에 AI한테 먼저 검사받아라. /code-review로 버그와 개선점을 짚고, --fix로 바로 고치고, 중요하면 ultra로 깊게 보세요. 단, 보안은 /security-review로 따로 점검해야 합니다.

기준: Claude Code v2.1.154 (2026.05)