Dev.to헤드라인2026. 06. 07. 14:59

Claude Code 치트시트: 명령어, Hooks 및 Subagents

요약

Claude Code의 잠재력을 극대화하기 위한 명령어, Hooks, Subagents 활용법을 다룬 가이드입니다. 단순 자동 완성을 넘어 터미널 에이전트로서의 고급 기능을 활용하여 개발 생산성을 높이는 방법을 설명합니다.

핵심 포인트

CLAUDE.md는 권고 사항을, Hooks는 강제적인 규칙을 설정할 때 사용합니다.
Subagents를 활용해 병렬 작업을 수행함으로써 작업 시간을 대폭 단축할 수 있습니다.
슬래시 명령어와 단축키를 익히면 Claude Code 제어 효율이 높아집니다.
Hooks를 통해 보안 및 코드 스타일 규칙을 결정론적으로 강제할 수 있습니다.

대부분의 개발자들은 Claude Code를 화려한 자동 완성(autocomplete) 기능처럼 사용합니다. 하지만 그것은 Claude Code가 할 수 있는 일의 약 20%에 불과합니다.

Claude Code는 프로젝트 전체에 대한 접근 권한을 가진 터미널 에이전트(terminal agent)입니다. 파일을 읽고, 셸 명령어(shell commands)를 실행하며, git에 커밋하고, 병렬로 서브에이전트(subagents)를 실행하며, 라이프사이클 훅(lifecycle hooks)을 통해 규칙을 강제합니다. 전체 기능 세트를 파악하고 나면, 당신의 작업 방식이 바뀔 것입니다.

저는 다음 내용을 포함하는 완전한 참조 가이드를 정리했습니다:

모든 슬래시 명령어(/ command)와 각 명령어를 사용해야 하는 시점
암기할 가치가 있는 키보드 단축키 (Esc Esc, Ctrl+B, !command)
CLAUDE.md — 모든 세션을 형성하는 파일
Hooks — Claude가 말 그대로 무시할 수 없는 규칙들
커스텀 슬래시 명령어 vs Skills (및 선택 기준)
Subagents — 병렬 작업자가 어떻게 20분짜리 작업을 7분으로 단축하는지
인라인 GitHub 댓글을 활용한 PR 리뷰 설정

대부분의 사람들이 놓치는 것: CLAUDE.md vs. Hooks

CLAUDE.md는 _권고 사항(advisory)_입니다. Claude는 세션 시작 시 이 파일을 읽고 지침의 약 80%를 따릅니다. 스타일 선호도, 스택 컨텍스트(stack context), 그리고 리마인더(reminders)를 작성하기에 적합한 곳입니다.

Hooks는 결정론적인(deterministic) 셸 스크립트입니다. 코드 1로 종료되는 PreToolUse 훅은 Claude를 즉시 중단시킵니다. 예외도 없고, 모델의 판단도 개입할 수 없습니다. 이를 통해 rm -rf를 차단하고, 모든 쓰기 작업에 Prettier를 강제하며, .env 파일이 커밋에 포함되는 것을 방지할 수 있습니다.

{
  "hooks": {
    "PreToolUse": [{
...

경험 법칙(Rule of thumb): 가이드라인이 필요할 때는 CLAUDE.md를 사용하고, "대부분의 경우"만으로는 충분하지 않은 모든 상황에는 hooks를 사용하세요.

Subagents는 긴 작업의 계산법을 바꿉니다

컨텍스트 윈도우(Context windows)는 가득 차기 마련입니다. 긴 세션에서는 대화의 앞부분이 Claude의 작업 메모리에서 사라지며 출력 품질이 저하됩니다.

Subagents는 깨끗하고 비어 있는 컨텍스트를 가진 별도의 Claude 인스턴스로 작업을 오프로딩(offloading)함으로써 이 문제를 해결합니다. Claude는 세 개의 서브에이전트를 동시에 실행할 수 있습니다. 코드 리뷰, 테스트 실행, DB 마이그레이션 확인을 순차적이 아니라 병렬로 수행합니다. 단일 세션에서 20분이 걸리던 작업들이 정기적으로 7분 만에 완료됩니다.

모든 명령어, 단축키, Hook (훅) 유형, Subagent (서브에이전트) 설정 및 전반에 걸친 작동 예시를 포함한 전체 치트시트: