Claude Code 입문 가이드는 충분히 많다. 그러나 일상 코딩에서 결과를 바꾸는 것은 설치 단계가 아니라 그다음, 워크플로우 패턴이다. Anthropic 공식 문서와 공개 자료에서 가장 자주 회자되는 패턴 5가지를 정리한다.
Claude Code는 챗봇이 아니라 코딩 에이전트
Anthropic은 Claude Code를 “대화를 통해 소통하는 코딩 에이전트”로 정의한다. 챗봇과의 차이는 세 가지에서 분명히 드러난다.
- 로컬 파일 직접 접근: 사용자의 코드베이스에서 직접 실행되어 파일을 읽고, 편집하고, 명령을 실행한다.
- 권한 시스템: 모든 파일 변경과 명령 실행에 사용자 승인이 필요하다.
- 프로젝트 색인: 전체 디렉토리 구조를 색인화해 컨텍스트로 활용한다.
이 세 가지 특성 때문에 Claude Code의 성과는 “어떤 질문을 잘 답해주는 모델인가”보다 “어떤 환경을 깔아주느냐” 로 갈린다. 그래서 워크플로우 설계가 핵심이다.
패턴 ①: Plan Mode 우선 — 비싼 실수 방지
복잡한 다중 파일 작업에서 가장 자주 회자되는 패턴이다. Shift+Tab을 누르면 Normal → Auto-Accept → Plan 세 모드를 순환할 수 있고, Plan Mode에서는 접근 방식을 먼저 보여준 뒤 승인을 기다린다.
builder.io 엔지니어링 블로그는 이 패턴의 가치를 한 문장으로 정리한다. “plan을 짜는 데 몇 분이 들지만, 그 단계가 없으면 Claude가 잘못된 문제를 20분 동안 푼다.” (builder.io 분석) 토큰 비용 관점에서도 명확한 이득이다.
사용자가 실제 운영하는 itinsights의 발행 파이프라인 publish.py(약 300줄)도 사전 계획 단계를 거쳐 한 번에 안정적으로 작성됐다. 단순 명령 입력보다 약간 느린 대신, 작성 후 큰 수정이 필요 없는 경우가 훨씬 많아진다.
패턴 ②: CLAUDE.md로 컨텍스트 압축
CLAUDE.md는 프로젝트 루트에 두는 마크다운 파일로, Claude Code가 매 세션 시작 시 자동으로 읽는 컨텍스트다. Anthropic 공식 문서는 이를 “프로젝트별 메모리”로 부른다 (Anthropic 공식 워크플로우 문서).
Claude Code 책임 엔지니어 Boris Cherny가 공개한 CLAUDE.md 사례는 약 2,500토큰, 100라인 수준으로 짧다 (mindwiredai 분석). 핵심 룰은 단 한 가지다.
“Claude가 틀린 걸 하면, CLAUDE.md에 추가한다. 그래야 다시 안 틀린다.”
이 룰은 학습 루프를 만든다. 잘못된 패턴이 발견될 때마다 CLAUDE.md에 한 줄씩 누적되고, 다음 세션부터는 같은 실수가 반복되지 않는다. itinsights 프로젝트 CLAUDE.md도 운영 룰·금지 사항·서버 경로 같은 사실을 짧게 쌓아간다. 새 세션마다 같은 설명을 반복할 필요가 사라진다.
패턴 ③: 슬래시 커맨드·서브에이전트로 반복 자동화
슬래시 커맨드는 사용자 정의 단축어다. /clear로 컨텍스트를 비우고, /agents로 등록된 서브에이전트를 본다 (Dale Seo 한국어 정리). 자주 쓰는 프롬프트를 .claude/commands/이름.md로 저장하면 /이름으로 즉시 트리거된다.
서브에이전트는 다르게 동작한다. 슬래시 커맨드처럼 직접 호출되지 않고, 프롬프트와 description을 보고 Claude가 자동 위임하거나 @이름으로 명시 호출한다 (서브에이전트 정리). 코드 리뷰·SEO 분석·문서화처럼 전문 영역을 분리할 때 적합하다.
| 도구 | 호출 방식 | 주요 용도 |
|---|---|---|
| 슬래시 커맨드 | /이름 직접 |
자주 쓰는 워크플로우 일괄 트리거 |
| 서브에이전트 | 자동 위임 또는 @이름 |
전문 영역(리뷰·SEO·문서) 격리 |
같은 반복 작업을 둘 중 어느 것으로 묶을지 결정하는 단계가 워크플로우 설계의 절반이다.
패턴 ④: MCP로 외부 도구 연결
MCP(Model Context Protocol)는 Anthropic이 공개한 오픈 표준으로, Claude Code를 Slack·Notion·Jira·Figma·Google Drive 같은 외부 도구에 직접 연결한다. 디자인 문서를 읽어 코드로 옮기고, 티켓을 갱신하고, Slack에서 데이터를 끌어오는 식이다.
입문 가이드에는 거의 다루지 않는 영역이지만, 기업 운영 단계에서는 차이가 분명하다. 코드만 만지는 단계를 넘어 업무 시스템 전반과 통합되는 지점이기 때문이다.
다만 MCP 서버 구축·인증·권한 설계는 단순하지 않다. 이 글에서는 큰 흐름만 다루고, 별도 분석 글에서 MCP 프로토콜의 입문과 운영을 정리할 예정이다.
패턴 ⑤: 모델 선택 — Sonnet 4.6 vs Opus 4.6 분기
마지막은 모델 선택이다. Anthropic 권장은 명확하다.
- 일상 작업(코드 탐색·간단한 수정·테스트 작성) → Sonnet 4.6: 빠른 응답, 낮은 토큰 비용
- 복잡한 다중 파일 리팩토링·아키텍처 결정·Agent Teams → Opus 4.6: 느린 대신 깊은 추론
비용 효율로만 보면 Sonnet 4.6이 일상 작업에 충분하다. 그러나 다중 파일 리팩토링에서 Sonnet이 잘못된 방향으로 가버리면, 사람이 다시 잡는 시간이 더 든다. 언제 비싼 모델로 갈아탈지를 명시적으로 정해두는 것이 결국 가장 비용 효율적이라는 결론이 나온다.
정리 — 5가지 패턴이 가리키는 한 방향
다섯 가지 패턴을 묶어보면 공통점이 보인다. Claude Code의 가치는 모델 자체가 아니라 그 주변에 깔린 워크플로우 환경에서 나온다. Plan Mode로 시간을 아끼고, CLAUDE.md로 컨텍스트를 압축하고, 슬래시·서브에이전트로 반복을 자동화하고, MCP로 외부 시스템과 연결하고, 모델을 분기시키는 흐름이다.
물론 한계도 있다. 권한 승인 피로, MCP 서버 설정 복잡성, 모델 선택 판단의 어려움은 입문자에게 작지 않은 진입 장벽이다. 어떤 환경에서 더 적합한가? 단발성 스크립트를 빠르게 짜는 자리보다는, 장기 운영하는 프로젝트에 환경(CLAUDE.md·커맨드·에이전트)을 누적할 수 있을 때 효과가 커진다.
이 다섯 가지 중에서 가장 입문 가이드가 다루지 않는 영역은 MCP다. 다음 글에서 MCP 프로토콜의 입문과 운영을 별도로 정리한다.