Anthropic이 직접 알려주는 Claude Code 베스트 프랙티스: Code w/ Claude 컨퍼런스 핵심 정리

2025년 5월 22일 San Francisco에서 열린 Anthropic의 "Code w/ Claude" 컨퍼런스에서 Cal Rueb(Anthropic Applied AI core / Cloud Code core contributor)이 26분짜리 세션 "Cloud Code best practices"를 발표했습니다. Cal은 Anthropic에 1.5년 전 합류해 Applied AI 팀 출범 멤버가 됐고, 작년 weekend hackathon으로 Cloud Code(공식 명칭 Claude Code)를 처음 써 본 후 사내 employee usage leaderboard 1위에 올라 core contributor로 합류한 인물입니다. 그가 발표에서 풀어낸 것은 Anthropic 내부 14개월 운영 노하우와 사용자 데이터를 바탕으로 정리한 "Claude Code를 가장 잘 쓰는 법"입니다. 이 책은 그 26분 세션을 5장 구조로 한국 실무 개발자 관점에서 재구성한 한국어 실용서입니다.

1장은 Cal의 weekend hackathon 일화, "Tony, that coworker who lives in the terminal"이라는 mental model, Anthropic의 "simple thing that works" 원칙으로 정의된 pure agent 구조, RAG·indexing을 쓰지 않는 agentic search 방식, 그리고 한국 개발자가 첫 일주일에 마주치는 5가지 오해(IDE 대체·자동화 슬라이더·CLAUDE.md 만능설·MCP 우선론·permission 무시)로 책의 토대를 깝니다. 2장은 가장 강력한 두 손잡이 — CLAUDE.md 4가지 위치(project·home·subdirectory·@reference)와 permission system을 분해합니다. shift+tab autoaccept, settings.json allow-list, 한국 팀이 CLAUDE.md를 표준화하는 4단계(draft → 리뷰 → check-in → 분기 업데이트)까지 의사코드와 합성 사례로 풀어냅니다.

3장은 효율적 워크플로 5가지입니다. /clear vs /compact 결정 트리(200K context), Cal의 "don't start working, don't write files yet" Plan-first 패턴, TODO 리스트와 watching the agent + ESC interjection, TDD·small changes·commit regularly·lint check의 smart vibe coding 4중 안전망, 마지막으로 screenshot 디버깅과 mock.png로 빌드하는 multimodal 활용까지. 4장은 Claude Code의 손을 늘리는 4단계입니다. Cal의 "CLI > MCP for well-known tools" 권고, MCP가 적합한 internal·custom·specialized 경계 조건, multiple Claude Codes(Cal 2개·사내 4개·T-Mux), 그리고 SDK headless·GitHub Actions·CI/CD 자동화 시나리오. 한국 SaaS·핀테크 합성 사례 4가지(결제 PR 리뷰·docs 자동 동기화·flaky test triage·PR description 자동 생성)로 마무리합니다.

5장은 Advanced Techniques + 6주 학습 로드맵입니다. ESC와 ESC×2 hidden feature 비교, Claude 4의 think-between-tool-calls 신기능, /model·/config 런타임 스위치와 VS Code·JetBrains 통합, github.com/anthropics/claude-code public repo의 weekly changelog 체크 루틴, 그리고 한국 개발자 6주 학습 로드맵(설치+첫 CLAUDE.md → permission → /clear·/compact·plan-first → subagent·MCP·CLI 확장 → GitHub Actions headless → 팀 표준 발표). 마지막은 Cal의 "great commits and PR messages" 일화로 책을 닫습니다. fact-check critical 14건 + design pass 1 2건을 본문에 반영했고, Cloud↔Claude 명칭 통일·github.com/anthropics/claude-code 슬러그 정정·coup 가상 명세 라벨링·한국 사례 합성 라벨링까지 모두 정정 완료했습니다.