AI 루트
레벨 진단
← Claude Code

Claude Code 고급 워크플로우 — Hooks & MCP 완전 활용

고급약 25분4단계

Claude Code의 Hooks와 MCP 연동으로 코딩 작업을 더욱 자동화할 수 있어요. 파일 저장 시 자동 실행, 테스트 자동화, 외부 도구 직접 제어까지 가능합니다.

따라 하기

1단계 / 4

Claude Code 설치 및 Hooks 설정

  1. 1Claude Code가 아직 없다면 공식 설치 명령으로 설치합니다(Mac·Linux: curl -fsSL https://claude.ai/install.sh | bash, Windows PowerShell: irm https://claude.ai/install.ps1 | iex). 자세한 순서는 Claude Code 시작하기 가이드를 보세요.
  2. Hooks는 Claude Code가 파일을 고치거나 명령을 실행하는 등 정해진 순간에 내가 지정한 명령을 자동으로 실행하게 하는 기능이에요.
  3. 2설정은 모든 프로젝트용이면 ~/.claude/settings.json, 이 프로젝트용이면 프로젝트의 .claude/settings.json에 적습니다.
Claude Code 열기
JSON
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

이해를 돕는 예시 그림이에요. 실제 화면과 다를 수 있어요.

claude.ai/code
Claude Code 실제 화면
실제 화면

누를 위치 ~/.claude/settings.json 또는 .claude/settings.json 편집›claude 실행›/hooks로 등록 확인

팁 Claude Code 공식 문서(2026-09-15 확인): 훅 명령은 도구 정보를 JSON으로 표준입력(stdin)에 받아요. 수정된 파일 경로는 jq로 .tool_input.file_path를 꺼내 씁니다. 설정한 훅은 대화에서 /hooks로 확인할 수 있어요(보기 전용).

처음이라 잘 모르겠다면

Claude Code 설정 파일에 Hooks를 추가하면 저장 시 자동 린트, 커밋 전 테스트 실행처럼 자동화 트리거를 설정할 수 있습니다.

막히면 볼 것

자주 하는 실수 3가지
  1. 1CLAUDE.md 없이 매 세션 규칙 반복 설명 → 비효율 + 규칙 누락 — 프로젝트 루트에 CLAUDE.md 한 번 작성하면 영구 적용
  2. 2Hooks 설정 후 테스트 없이 사용 → Hook 오류 시 모든 파일 저장 실패 — Hook 설정 후 간단한 파일 수정으로 먼저 테스트
  3. 3MCP 토큰을 .claude.json에 평문 저장 → 파일 유출 시 보안 사고 — 환경변수($GITHUB_TOKEN)로 참조, 파일에 직접 입력 금지
AI 없이 할 때와 뭐가 다른가요?

기본 Claude Code 사용 → Hooks + MCP → 완전 자율 개발 에이전트

Claude Code로 코드 생성은 하는데, 저장하고 테스트하고 배포하는 과정은 여전히 수동이야...
나
개발 파이프라인의 각 단계는 여전히 수동 개입이 필요합니다.지금까지