{"id":"claude-code-subagent-code-review","kind":"workflow","testedWith":[],"durationMin":null,"url":"https://opencurrent.ai/w/claude-code-subagent-code-review","title":"변경한 코드를 읽기 전용 검토 전담에게 맡기기 (Claude Code 서브에이전트)","summary":"리뷰를 맡겨도 하던 대화가 길어지지 않고, 검토 전담은 읽기만 하므로 리뷰 중에 코드가 바뀔 걱정이 없습니다.","category":"개발","categoryId":"dev","domain":"dev","domainLabel":"개발","capabilities":[{"id":"code","label":"코드 작성"}],"topics":[{"id":"dev","label":"개발"}],"tools":["Claude Code"],"whenToUse":"검토 기준을 담은 code-reviewer 정의 파일을 하나 만들고, 필요하면 Claude Code를 다시 시작합니다. 이후 최근 변경을 검토해 달라고 하면 검토 전담이 따로 읽고 결과만 돌려줍니다.","body":"## 준비\n\n- Claude Code가 설치된 프로젝트 폴더\n- 검토할 코드 변경분\n\n### 1. 저장 위치 선택\n\n팀과 함께 쓰려면 프로젝트의 `.claude/agents/`(버전 관리 대상)에, 내 모든 프로젝트에서 쓰려면 `~/.claude/agents/`에 둡니다. 이름이 겹치면 프로젝트 쪽이 우선합니다.\n\n### 2. code-reviewer 정의 파일 작성\n\n`.claude/agents/code-reviewer.md`에 아래 내용을 저장합니다. 직접 써도 되고 Claude에게 맡겨도 됩니다. 본문이 서브에이전트의 시스템 프롬프트가 되며, 머리말에는 name과 description 두 칸이 꼭 있어야 합니다.\n\n```bash\n---\nname: code-reviewer\ndescription: Reviews code for quality and best practices\ntools: Read, Glob, Grep\nmodel: sonnet\n---\n\nYou are a code reviewer. When invoked, analyze the code and provide\nspecific, actionable feedback on quality, security, and best practices.\n```\n\n### 3. 필요하면 세션 다시 시작\n\n보통 몇 초 안에 반영됩니다. agents 폴더에 처음 파일을 만들었다면 Claude Code를 다시 시작합니다. 프롬프트에 `@`를 입력해 목록에 code-reviewer (agent)가 보이면 준비된 것입니다.\n\n### 4. 최근 변경 검토 요청\n\n@-멘션을 쓰면 그 서브에이전트가 확실히 실행됩니다. 서브에이전트는 대화 기록을 보지 못하므로 검토 범위를 메시지에 적습니다.\n\n```prompt\n@\"code-reviewer (agent)\" 최근 변경한 인증 관련 코드 검토해 줘\n```\n\n품질·보안·모범 사례 기준의 구체적인 지적이 돌아옵니다. `git status`로 파일이 바뀌지 않았는지도 확인합니다.\n\n### 5. 자동 위임 설정 (선택)\n\ndescription에 'use proactively' 같은 문구를 더하면 Claude가 알맞은 작업에서 스스로 맡깁니다. 세션 전체를 검토 전담으로 시작하려면 아래 명령을 씁니다.\n\n```bash\nclaude --agent code-reviewer\n```\n\n이 세션에서 파일 수정 도구가 막히는지 확인합니다.\n\n## 주의\n\n- 서브에이전트는 빈 컨텍스트에서 시작합니다. 대화 기록을 보지 못하므로 필요한 내용은 맡길 때 함께 전달합니다.\n- agents 폴더에 첫 파일을 만든 직후, `--add-dir`로 더한 폴더의 에이전트를 고친 경우, `--disable-slash-commands`로 시작한 세션은 다시 시작해야 반영됩니다.\n- 머리말 필드 이름은 camelCase로 정확히 적습니다. 모르는 필드는 오류 없이 무시됩니다.\n- 직접 만든 서브에이전트들의 description 합이 15,000 토큰을 넘으면 시작할 때 경고가 나옵니다. 설명은 짧게 쓰고 자세한 내용은 본문에 둡니다.\n- `/agents`는 최신 버전에서 안내만 출력하고, v2.1.197 이하에서는 만들기 마법사가 열립니다.","prerequisites":["Claude Code 설치된 프로젝트 폴더","검토할 코드 변경분"],"inputs":[],"howToFollow":"1. 준비물이 갖춰졌는지 먼저 확인할 것.\n2. body를 처음부터 끝까지 읽고 순서대로 따라 할 것. 코드 블록의 명령은 사용자의 허락을 받고 실행하고, 사람이 해야 하는 일은 사용자에게 안내하고 끝났는지 물을 것.\n3. 본문에 확인 방법이 있으면 그대로 확인하고, 다르면 다음으로 넘어가지 말고 사용자에게 알릴 것.\n4. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.","steps":[{"n":1,"kind":"human","title":"저장 위치 선택","body":"팀과 함께 쓰려면 프로젝트의 .claude/agents/ (버전 관리 대상), 내 모든 프로젝트에서 쓰려면 ~/.claude/agents/. 이름이 겹치면 프로젝트 쪽이 우선","expected":"정해진 저장 폴더","check":"폴더 경로 확인","tool":"Claude Code"},{"n":2,"kind":"command","title":"code-reviewer 정의 파일 작성","body":".claude/agents/code-reviewer.md에 아래 내용 저장. 본문이 서브에이전트의 시스템 프롬프트. Claude에게 파일 작성을 맡겨도 되고, 직접 써도 됨","prompt":"---\nname: code-reviewer\ndescription: Reviews code for quality and best practices\ntools: Read, Glob, Grep\nmodel: sonnet\n---\n\nYou are a code reviewer. When invoked, analyze the code and provide\nspecific, actionable feedback on quality, security, and best practices.","expected":".claude/agents/code-reviewer.md","check":"머리말에 name·description 두 필수 칸이 있는지 확인","tool":"Claude Code"},{"n":3,"kind":"human","title":"필요하면 세션 다시 시작","body":"보통 몇 초 안에 반영. agents 폴더에 처음 파일을 만든 경우엔 Claude Code를 다시 시작","expected":"code-reviewer를 인식한 세션","check":"프롬프트에 @ 입력 · 목록에 code-reviewer (agent)가 보이면 준비됨","tool":"Claude Code"},{"n":4,"kind":"ai","title":"최근 변경 검토 요청","body":"@-멘션은 그 서브에이전트 실행이 확실. 서브에이전트는 대화 기록을 보지 못하므로 검토 범위를 메시지에 적음","prompt":"@\"code-reviewer (agent)\" 최근 변경한 인증 관련 코드 검토해 줘","expected":"품질·보안·모범 사례 기준의 구체적 지적 목록","check":"응답이 code-reviewer 실행 결과로 표시되고 파일이 바뀌지 않았는지 git status로 확인","tool":"Claude Code"},{"n":5,"kind":"command","title":"자동 위임 설정 (선택)","body":"description에 'use proactively' 같은 문구를 더하면 Claude가 알맞은 작업에서 스스로 맡김. 세션 전체를 이 설정으로 돌리려면 아래 명령","prompt":"claude --agent code-reviewer","expected":"검토 전담으로 시작한 세션","check":"세션에서 파일 수정 도구가 막히는지 확인","tool":"Claude Code"}],"pitfalls":["서브에이전트는 빈 컨텍스트에서 시작 · 대화 기록을 보지 못하므로 필요한 내용은 맡길 때 함께 전달","agents 폴더에 첫 파일을 만든 직후, --add-dir로 더한 폴더의 에이전트를 고친 경우, --disable-slash-commands로 시작한 세션은 다시 시작해야 반영","머리말 필드 이름은 camelCase로 정확히 · 모르는 필드는 오류 없이 무시","직접 만든 서브에이전트들의 description 합이 15,000 토큰을 넘으면 시작 시 경고 · 설명은 짧게, 자세한 내용은 본문에","/agents는 최신 버전에서 안내만 출력, v2.1.197 이하에서는 만들기 마법사가 열림"],"sources":[{"title":"Create custom subagents","url":"https://code.claude.com/docs/en/sub-agents"}],"verification":{"status":"pending","label":"검수 대기","detail":"사람 확인 전","verifiedBy":0,"lastVerifiedAt":null},"quality":{"score":32,"components":{"result":0.5,"trust":0,"freshness":0.4},"explanation":"확인 없음 · 검수 대기"},"workedFor":0,"trials":{"summary":"","lastAt":null,"total":0,"worked":0,"partial":0,"failed":0,"recent":[]},"asOf":{"date":"2026-11-15T07:14:52.106705+00:00","basis":"updated"},"updatedAt":"2026-11-15T07:14:52.106705+00:00","goals":[{"id":"dev","title":"개발"}],"uses":34,"likes":0}