Boris의 Claude Code 30분 마스터하기

🏷️ 정보

Anthropic의 Boris(Claude Code를 만든 사람)가 작년 5월에 했던 컨퍼런스 발표 영상을 다시 보게 됐습니다. 제목은 Mastering Claude Code in 30 minutes. 11개월이 지났는데도 여기서 말하는 패턴이 그대로 통한다는 게 신기해서 정리해 둡니다.

핵심 메시지는 한 줄로 요약됩니다. "Q&A부터 시작하세요." 뒤로 갈수록 도구가 화려해지지만, 처음 Claude Code를 손에 잡았을 때 가장 빠르게 효용을 느끼는 진입점은 코드 편집이 아니라 코드 질문입니다.

Q&A부터 시작하라

Anthropic은 신입 엔지니어 온보딩 첫날에 Claude Code를 깔게 합니다. 그리고 코드를 만지지 말고 질문부터 하라고 가르칩니다. "이 클래스는 어디서 인스턴스화되나요?" "이 함수의 인자가 왜 15개인가요?" 같은 것들을요.

결과는 분명합니다. 기술 온보딩이 2~3주에서 2~3일로 줄었답니다.

이게 가능한 이유는 Claude Code가 단순 텍스트 검색을 하지 않기 때문입니다. Git 히스토리를 뒤져서 그 함수가 왜 그렇게 됐는지 추적하고, GitHub 이슈를 WebFetch로 가져와서 맥락을 붙여주고, 관련 PR까지 묶어서 요약합니다. 시스템 프롬프트에 "Git을 보세요"라고 적혀 있는 게 아니라, 모델이 Git 사용법을 이미 알고 있어서 자연스럽게 합니다.

Boris가 매주 월요일에 쓰는 프롬프트 하나가 좋은 예입니다. "이번 주에 내가 뭘 배포했지?" 사용자명을 알고 있으니 알아서 로그를 훑고, 깔끔한 요약을 돌려줍니다.

복잡한 도구나 편집부터 시작하면 Claude Code의 능력 범위와 한계를 가늠하지 못합니다. Q&A로 시작하면 그 경계가 자연스럽게 잡힙니다. "이건 한 번에 되네", "이건 두세 번 왕복해야 되네", "이건 인터랙티브 모드에서 손잡고 가야겠네" 같은 감을 키우는 게 첫 번째 마일스톤입니다.

환경 세팅 — 처음 깔았을 때 한 번씩

영상에서 추천하는 초기 세팅을 추려보면 이렇습니다.

/terminal-setup 으로 Shift+Enter 줄바꿈 활성화. 백슬래시 안 쳐도 됩니다.
/theme 으로 라이트/다크/달토니즘 테마.
/install-github-app 으로 GitHub 이슈/PR에서 Claude를 멘션할 수 있게 연결.
자주 묻는 도구는 사용자 지정 허용 목록에 넣어두기. 매번 "이거 해도 돼?" 묻는 걸 피합니다.
macOS 사용자라면 시스템 환경설정 > 손쉬운 사용 > 받아쓰기를 켜두면, 길어진 프롬프트를 입으로 말할 수 있습니다. 키보드보다 빠릅니다.

마지막 팁이 의외로 효과가 큽니다. Claude Code는 자세한 프롬프트를 좋아하는데, 자세한 프롬프트는 타이핑이 길어집니다. 받아쓰기로 옆 동료에게 설명하듯 말하면 그게 그대로 좋은 프롬프트가 됩니다.

계획 → 실행 → 검증의 피드백 루프

코드 편집으로 넘어갔을 때 가장 효과적인 패턴은 세 단계입니다.

계획부터. 큰 변경을 시킬 때는 "코드 짜기 전에 먼저 브레인스토밍하고 계획을 보여줘"라고 한 줄 추가합니다. 이게 plan mode 같은 특별한 도구가 아니라, 그냥 평문 한 줄입니다. 모델이 그 의도를 이해합니다.
도구를 알려준다. 팀이 쓰는 사내 CLI(예: barley CLI 같은)나 MCP 도구를 Claude Code에게 등록해 주면, 그 후로는 알아서 씁니다. --help만 던져줘도 사용법을 익힙니다.
검증 도구를 같이 준다. 가장 강력한 패턴이 이겁니다. 단위 테스트, Puppeteer 스크린샷, iOS 시뮬레이터 같은 자기 작업을 검증할 수 있는 도구를 손에 쥐어주면, Claude Code가 스스로 두세 번 반복하면서 결과물을 다듬습니다. 웹 UI 구현에 mockup을 던져주고 검증 도구만 같이 주면 거의 완벽한 결과까지 자동으로 도달합니다.

commit push PR 한 줄만 던져도 커밋·브랜치·푸시·PR 생성까지 처리됩니다. 시스템 프롬프트에 그렇게 시킨 게 아니라, 모델이 깔끔하게 의도를 풀어냅니다.

ClaudeMD가 컨텍스트의 출발선

CLAUDE.md는 프로젝트 루트에 두면 매 세션 시작 시 자동으로 읽힙니다. 팀과 공유할 내용이라면 소스 컨트롤에 넣고, 개인 환경 설정은 로컬 파일로 둡니다.

들어갈 만한 내용:

자주 쓰는 bash 명령어
주요 MCP 도구 사용법
아키텍처 결정 사항
중요 파일 위치
코드 스타일 가이드

핵심 원칙은 짧게입니다. 길어지면 매 세션마다 컨텍스트를 잡아먹는데 정작 모델이 필요로 하지 않습니다. 하위 디렉토리에 별도 CLAUDE.md를 두면, Claude가 그 디렉토리에서 작업할 때만 자동으로 읽습니다. 비용 효율이 좋습니다.

/memory 명령으로 현재 어떤 메모리가 로드돼 있는지 확인할 수 있고, # 기호로 새 정보를 어디에 저장할지 골라서 추가할 수 있습니다. 같은 계층 구조가 슬래시 명령(.claude/commands/)·권한·MCP 서버 설정에도 적용됩니다. 프로젝트 → 전역 → 엔터프라이즈 정책 순으로 덮어쓰는 식입니다.

가장 추천되는 시작점은 공유 프로젝트 컨텍스트입니다. 한 사람이 잘 다듬어 두면 팀원 전체가 즉시 이득을 보는 네트워크 효과가 있습니다.

외워두면 평생 쓰는 키 바인딩

영상에서 정리해 준 키 바인딩 시트가 의외로 알려지지 않아서 옮겨둡니다.

키	동작
`Shift+Tab`	auto-accept-edits 모드. 편집 승인 다이얼로그 생략. bash는 여전히 승인 필요
`#`	Claude에게 기억시킬 내용 입력 → CLAUDE.md에 자동 저장
`!`	bash 모드 진입. 결과물이 컨텍스트로 들어감
`Esc`	Claude의 동작 안전하게 중단. 세션 안 깨짐
`Esc` × 2	이전 히스토리로 점프
`Ctrl+R`	모델이 보고 있는 컨텍스트 전체 출력 확인
`--resume` / `--continue`	이전 세션 재개

Shift+Tab은 단위 테스트 반복처럼 "방향이 명확할 때" 켜고, Esc는 마음에 안 들면 즉시 중단하고 한 줄 수정 지시를 던지는 용도로 씁니다. 20줄 편집 중 19줄이 마음에 들고 1줄만 마음에 안 들면 Esc → 한 줄만 수정 요청 → 다시. 이 루프가 손에 익으면 작업 속도가 체감적으로 다릅니다.

SDK와 병렬 워크플로우

claude -p는 같은 엔진을 비-인터랙티브 모드로 호출하는 SDK입니다. 프롬프트, 허용된 도구, 출력 포맷(JSON, streaming JSON)을 인자로 넘깁니다. 본질적으로 유닉스 유틸리티처럼 다룰 수 있습니다.

가능한 것들:

CI 파이프라인에서 호출
인시던트 응답 자동화
git status | claude -p '...' 같은 파이프
GCP 버킷의 거대 로그를 파이핑해서 "뭐가 흥미로운지" 분석시키기
Sentry CLI 출력을 받아 자동 분류

여기까지가 표준이고, 파워 유저들의 패턴은 한 단계 더 갑니다. SSH 세션 + Tmux + 여러 체크아웃 + Git worktree로 여러 Claude Code를 동시에 돌립니다. 한 사람이 동시에 4~5개 작업을 굴리면서, 각각이 자기 고유의 디렉토리·세션·컨텍스트를 갖는 식입니다. Worktree를 활용하면 같은 리포에서도 격리가 됩니다.

11개월이 지나도 통하는 이유

이 영상은 작년 5월 발표라 일부는 이미 진화했습니다. SDK는 Agent SDK로 더 발전했고, 모델은 Opus 4.7까지 왔습니다. 그런데도 패턴 대부분이 그대로 통하는 이유는, Boris가 한 말 그대로 **"우리는 이걸 유닉스 유틸리티로 만들었지 전통적인 제품으로 만들지 않았다"**라는 설계 철학 때문입니다.

작은 빌딩블록 — 도구 호출, 텍스트 입출력, 파일 시스템 — 위에 얹은 패턴은 모델이 바뀌어도 살아남습니다. 반대로 특정 모델 버전에만 통하는 프롬프트 트릭은 빠르게 낡습니다. 이 발표가 Q&A부터 키 바인딩까지 모두 작은 빌딩블록 차원의 이야기라는 점이 1년 후에도 유효한 이유입니다.

원본 영상은 Anthropic의 YouTube에 그대로 있습니다. 30분짜리니 점심 시간에 한 번 보시면 됩니다.