Claude Code Cheatsheet: Commands, Hooks & Subagents

개요

Claude Code는 단순한 자동 완성 기능을 넘어, 파일 읽기, 쉘 명령어 실행, Git 커밋, 병렬 서브에이전트 실행, 라이프사이클 훅을 통한 규칙 강제 등 전체 프로젝트에 접근 가능한 터미널 에이전트입니다.

주요 내용

* 명령어 및 단축키: Claude Code의 모든 슬래시(slash) 명령어와 주요 키보드 단축키(Esc Esc, Ctrl+B, !command)에 대한 설명과 사용 시점을 제공합니다.
* CLAUDE.md: 각 세션의 동작 방식을 정의하는 CLAUDE.md 파일의 역할과 중요성을 설명합니다. 이 파일은 스타일 선호도, 스택 컨텍스트, 알림 등 가이드라인 역할을 하며, Claude는 이를 약 80%의 확률로 따릅니다.
* Hooks: PreToolUse와 같은 라이프사이클 훅은 결정론적인 쉘 스크립트로, 특정 조건을 만족하지 못할 경우 Claude의 실행을 즉시 중단시킵니다. 이를 통해 rm -rf 명령 실행 방지, 모든 쓰기에 대한 Prettier 적용, .env 파일 커밋 방지 등 엄격한 규칙을 강제할 수 있습니다.
* Custom slash commands vs. Skills: 사용자 정의 슬래시 명령어와 스킬(Skills)의 차이점 및 선택 기준을 제시합니다.
* Subagents: 긴 작업의 시간 복잡도를 개선하기 위해 여러 개의 독립적인 Claude 인스턴스(서브에이전트)를 병렬로 실행하는 방법을 설명합니다. 이를 통해 20분 소요 작업을 7분으로 단축하는 것이 가능하며, 코드 리뷰, 테스트 실행, DB 마이그레이션 확인 등을 동시에 수행할 수 있습니다.
* PR 리뷰 설정: GitHub 인라인 주석을 활용한 PR(Pull Request) 리뷰 설정 방법을 안내합니다.
* CLAUDE.md vs. Hooks: CLAUDE.md는 가이드라인 제공에, 훅은 "대부분의 경우"가 아닌 결정론적인 제어가 필요한 경우에 사용되는 상반된 역할을 강조합니다.

시사점

Claude Code의 전체 기능 세트를 이해하고 활용하면 개발 작업 방식에 근본적인 변화를 가져올 수 있으며, 특히 서브에이전트를 통한 병렬 처리 기능은 장기적인 작업 효율성을 극대화할 잠재력을 지닙니다.