Claude Code 제작자 Boris Cherny의 실전 워크플로우 분석

커뮤니티 반응

대체로 매우 긍정적이며, 특히 CLAUDE.md를 통한 컨텍스트 유지와 병렬 실행 아이디어에 대해 많은 사용자가 실무 적용 의사를 밝혔다.

주요 논점

01찬성다수

에이전트를 단순 도구가 아닌 병렬 워커로 취급하는 사고의 전환이 생산성을 혁신한다.

합의점 vs 논쟁점

합의점

LLM의 컨텍스트 유지를 위한 프로젝트별 설정 파일(CLAUDE.md)의 필요성
단순 코드 생성이 아닌 설계 단계에서의 비판적 검토 과정의 중요성

논쟁점

5개의 병렬 인스턴스 실행 시 발생하는 API 비용과 토큰 소모량에 대한 효율성 문제

실용적 조언

프로젝트 루트에 CLAUDE.md를 만들고 에이전트가 지켜야 할 코딩 스타일과 PR 규칙을 적으세요.
자주 쓰는 복잡한 프롬프트는 .claude/commands/에 슬래시 명령어로 등록해 자동화하세요.

섹션별 상세

프로젝트 루트에 2,500토큰 규모의 CLAUDE.md 파일을 배치하여 영구적인 컨텍스트를 유지한다. 세션마다 초기화되는 LLM의 한계를 극복하기 위해 코드베이스 컨벤션, PR 템플릿, 아키텍처 규칙을 기록하며, 실수가 발생할 때마다 이를 업데이트하여 재발을 방지한다. 동료의 PR에 @.claude 태그를 사용하여 지식 캡처를 자동화하는 방식이 실무에 적용됐다.

iTerm2 시스템 알림을 활용하여 5개의 Claude Code 인스턴스를 병렬로 실행한다. 단일 터미널에서 순차적으로 작업하는 대신, 각각 독립적인 Git 체크아웃 환경을 가진 5개의 탭에서 기능 개발, 테스트, 디버깅 등을 동시에 수행한다. 이를 통해 개발자는 직접 코딩하는 역할에서 인지 능력을 스케줄링하고 관리하는 감독자 역할로 전환된다.

코드 작성 전 반드시 'Plan Mode'를 통해 설계 문서를 작성하고 시니어 엔지니어의 관점에서 비판하도록 유도한다. 에이전트에게 '당신이 시니어 엔지니어라면 이 계획의 결함은 무엇인가?'라고 질문하여 계획을 견고하게 다듬은 후 편집을 승인한다. 이 과정을 거치면 실제 구현 단계에서 단 한 번에 성공(1-shot)할 확률이 비약적으로 상승한다.

작업 완료의 기준을 코드 작성이 아닌 자동화된 검증 루프 통과에 둔다. verify-app이라는 서브에이전트가 엔드투엔드 테스트를 실행하며, 실패 시 스스로 코드를 수정하고 테스트를 재실행하는 과정을 성공할 때까지 반복한다. 반복되는 프롬프트는 .claude/commands/ 폴더에 슬래시 명령어(/commit-push-pr 등)로 등록하여 팀 전체의 워크플로우를 표준화했다.

용어 해설

클로드 코드(Claude Code): — Anthropic에서 개발한 CLI 기반의 자율 코딩 에이전트입니다. 터미널 환경에서 직접 코드 작성, 테스트 실행, Git 작업 등을 수행하며 개발자의 워크플로우를 자동화하는 도구입니다.
컨텍스트 윈도우(Context Window): — LLM이 한 번에 처리하고 기억할 수 있는 정보의 양입니다. 세션이 종료되면 이전 대화 맥락이 사라지므로, 지속적인 프로젝트 지침을 유지하기 위해 별도의 설정 파일이 필요합니다.
서브에이전트(Subagent): — 메인 에이전트의 지시를 받아 특정 하위 작업(예: 테스트 검증, 코드 수정)을 전문적으로 수행하는 독립적인 AI 프로세스입니다. 복잡한 작업을 분할하여 정확도를 높이는 데 사용됩니다.

언급된 도구

Claude Code추천

CLI 기반 자율 코딩 에이전트

iTerm2추천

병렬 터미널 실행 및 시스템 알림 수신

언급된 리소스

문서7 Ways the Creator of Claude Code Actually Uses It