에이전트
verified · type: how-to · verified: 2026-07 · review: 90d · updated: 2026-07-25 · [agentic]

Claude Code — 에이전트 코딩 워크플로우

매일 쓰는 툴이니 개인 관련성 최고 페이지. 6개 원시요소(primitive)와 그것들이 사는 plan→implement→verify→review 루프.

Claude Code 는 Anthropic 의 에이전트 코딩 도구(터미널 CLI·IDE 확장(VS Code/JetBrains)·데스크톱 앱·웹 브라우저 claude.ai/code — verified 2026-07). 자동완성이 아니라 코드베이스를 읽고, 계획하고, 파일을 편집하고, 명령/테스트를 돌리고, 루프를 돈다.

6개 원시요소

원시요소 하는 일 범위
CLAUDE.md 자동 로드되는 메모리 — 규칙, 명령, 가드레일 [Claude 전용]이나 패턴(.cursorrules, AGENTS.md)은 일반
슬래시 명령 /name 으로 부르는 재사용 프롬프트 템플릿 [Claude 전용]
서브에이전트 자기만의 컨텍스트 창을 가진 전문 Claude 인스턴스 [Claude 전용]
훅(Hooks) 라이프사이클 이벤트에 발화하는 결정론적 스크립트 [Claude 전용]
스킬(Skills) 필요시 로드되는 절차적 지시 폴더 [Claude 전용]
MCP 서버 외부 툴/데이터 연결 [일반] — 오픈 표준

암기법: MCP=파이프, Skills=지시서, Subagents=작업자, Hooks=가드레일, Plugins=이걸 다 담은 상자.

훅 — 프롬프팅과의 결정적 차이

훅은 코드라서 항상 실행된다 (모델이 무시할 수 있는 요청이 아니다). settings.json 에 설정. 거의 모든 프로덕션 셋업이 쓰는 5개 이벤트:

  • SessionStart — 컨텍스트 주입, 전제조건 체크, 로깅 초기화
  • UserPromptSubmit — 모델이 보기 전 프롬프트 검증/증강
  • PreToolUse — 가장 강력. 툴 콜을 승인/거부/수정 가능 (.env 읽기 차단, rm -rf 차단)
  • PostToolUse — 완료된 액션에 반응 (자동 린트, 테스트, 로그)
  • Stop — 에이전트가 턴을 끝낼 때

(SDK 는 ~30개 이벤트를 노출하지만 이 5개가 대부분 커버.)

스킬 vs MCP

  • 스킬 = 세션 내 절차적 지식(체크리스트·워크플로우). API 호출/DB 쿼리 못 함. 프로그레시브 디스클로저 — 트리거되기 전엔 ~30~50 토큰만 컨텍스트에 있다가 발동하면 전체 로드.
  • MCP = 외부 툴/데이터. 스킬이 I/O 를 위해 MCP 를 호출한다.

서브에이전트

각자 별도 컨텍스트 창을 가진 전문 인스턴스. 메인 대화가 포커스를 유지하고, 서브에이전트의 탐색이 부모 컨텍스트를 오염시키지 않아 토큰을 아낀다. 빌트인: Explore(읽기전용 검색), Plan(실행 없이 계획), general-purpose.

매일의 루프

1. Spec     → verify: 무엇을 원하는지 경계가 명확한가 (모호한 스펙 = 드리프트 1위 원인)
2. Context  → verify: CLAUDE.md 에 규칙·명령·아키텍처·가드레일이 있는가 (최고 레버리지 셋업)
3. Plan     → verify: 편집 전 계획을 검토했는가 (여기서 고치면 쌈, 나중엔 비쌈)
4. Implement→ verify: 작은 diff 로 편집하는가
5. Verify   → verify: write→run tests→fix 루프가 도는가 (테스트가 존재해야 함)
6. Review   → verify: 에이전트 코드를 사람/두번째 모델이 검토했는가 (절대 무검토 머지 금지)
7. Ship     → verify: 원자적 커밋, PR, CI 게이트
  • Context(2) 가 가장 높은 레버리지. CLAUDE.md 에 관례·명령·아키텍처·가드레일을 넣는 것.
  • Verify(5) 는 에이전트가 빛나는 곳 — 단, 테스트가 있어야. 테스트 강한 팀이 에이전트에서 가장 많이 얻는다.
  • Review(6) — 에이전트 코드는 절대 무검토 머지 금지. 독립 검토(리뷰 서브에이전트, 또는 두 번째 모델을 적대자로)가 작성 모델이 놓친 걸 잡는다.

운영 습관

  • 드리프트하면 에이전트를 멈춰라 — 혼란한 루프를 방치 마라. (Karpathy 규칙: 무엇이 헷갈리는지 모를 때 멈추고 이름 붙여라, 추측하지 마라.)
  • 컨텍스트 관리 — 창이 차기 전에 /compact 또는 새 세션. 탐색은 서브에이전트로 격리.
  • 안전 스코핑 — 편집 범위 제한, 파괴적 명령 경고, 비밀 파일 차단 (훅으로).
  • Simplicity first — 문제를 푸는 가장 작은 diff. 에이전트는 기본적으로 오버엔지니어링하니 scope creep 을 검토하라.

참고