본문 바로가기

Claude Code 창시자의 사용법

이 장에서는 Claude Code를 만든 Boris Cherny가 직접 공개한 사용법을 소개합니다. 2025년 1월 2일 X(구 트위터)에 공개된 스레드를 바탕으로, 창시자가 실제로 어떻게 Claude Code를 활용하는지 살펴봅니다.

1. Boris Cherny는 누구인가?

Boris Cherny는 2024년 9월 Anthropic에서 사이드 프로젝트로 Claude Code를 만든 개발자입니다. 현재 Anthropic의 Claude Code 팀을 이끌고 있으며, Meta에서 시니어 엔지니어로 근무한 경력이 있습니다. 그는 2024년 12월 한 달간 259개의 PR을 머지했는데, 497개의 커밋과 4만 줄 추가, 3만 8천 줄 삭제가 모두 Claude Code + Opus 4.5로 작성되었다고 밝혔습니다.

2. Boris의 기본 세팅

2.1 병렬 세션 운영

Boris는 15개 이상의 Claude 세션을 동시에 운영합니다.

플랫폼세션 수용도
터미널5개메인 코딩 작업, 탭 1-5로 번호 지정
웹 (claude.ai/code)5-10개코드 리뷰, 문서화, 시각적 비교
iOS 앱수 개아침에 작업 시작, 나중에 데스크톱에서 확인

터미널에서는 시스템 알림을 설정하여 Claude가 입력을 기다릴 때 알림을 받습니다. 로컬 세션을 웹으로 넘기거나(& 사용), --teleport 명령으로 세션을 기기 간에 이동시킵니다.

2.2 모델 선택

Boris는 모든 작업에 Opus 4.5 + thinking 모드를 사용합니다. 더 크고 느린 모델임에도 불구하고 선택하는 이유는 다음과 같습니다.

  • 더 적은 조율(steering)이 필요함
  • 도구 사용 능력이 뛰어남
  • 반복 횟수가 줄어들어 결과적으로 더 빠름
Sonnet (빠름) → 5번 반복 → 총 소요시간: 5분
Opus (느림) → 1번에 완료 → 총 소요시간: 2분

진짜 병목은 AI 처리 시간이 아니라, 사람이 방향을 잡아주고 수정하는 데 쓰는 시간입니다.

3. CLAUDE.md 팀 운영

Claude Code 팀은 단일 CLAUDE.md 파일을 git에 체크인하여 공유합니다. 팀 전체가 일주일에 여러 번 기여하며, Claude가 실수할 때마다 해당 내용을 추가합니다.

CLAUDE.md에 들어가는 내용은 다음과 같습니다.

  • 자주 쓰는 bash 명령어
  • 코드 스타일 가이드라인
  • 브랜치 네이밍, 머지/리베이스 등 저장소 규칙
  • 개발 환경 설정
  • 흔히 하는 실수와 피해야 할 것들

3.1 GitHub Action으로 자동 추출

코드 리뷰 시 PR에 @.claude를 태그하면, Claude가 자동으로 CLAUDE.md에 새로운 패턴이나 컨벤션을 추가합니다.

/install-github-action

이를 통해 지식이 일회성이 아닌 누적되는 자산이 됩니다.

4. Plan 모드 활용

대부분의 세션은 Plan 모드로 시작합니다. Shift + Tab을 두 번 눌러 진입합니다.

  1. Plan 모드에서 Claude와 계획을 주고받으며 다듬습니다.
  2. 계획이 만족스러우면 auto-accept 모드로 전환합니다.
  3. Claude가 대부분 한 번에 작업을 완료합니다.

좋은 계획이 정말 중요합니다. 계획 수립에 투자한 시간이 실행 단계에서 훨씬 더 큰 시간 절약으로 돌아옵니다.

5. 슬래시 커맨드 활용

하루에 여러 번 반복하는 "내부 루프" 작업에는 슬래시 커맨드를 만들어 사용합니다. .claude/commands/ 폴더에 저장하고 git에 체크인하여 팀과 공유합니다.

예를 들어, /commit-push-pr 커맨드는 매일 수십 번 사용됩니다.

---
description: 변경사항 커밋, 원격 푸시, PR 생성
---

# Git Status
!`git status --short`

# Current Branch
!`git branch --show-current`

# Recent Commits
!`git log -5 --oneline`

위 git status를 바탕으로:

1. 변경사항을 스테이지하고 설명적인 메시지로 커밋
2. 원격 저장소에 푸시
3. PR 생성

인라인 bash(! 명령)를 사용하면 git status 등의 정보를 미리 계산하여 모델과의 왕복을 줄일 수 있습니다.

6. 서브에이전트 활용

Boris는 도메인별 특화 작업을 위해 서브에이전트를 사용합니다.

서브에이전트역할
code-simplifierClaude 작업 완료 후 코드 단순화
verify-appClaude Code 앱 E2E 테스트

서브에이전트는 별도의 컨텍스트 윈도우를 가지며, 커스텀 시스템 프롬프트와 도구 접근 권한을 설정할 수 있습니다.

7. Hook 활용

Hook은 Claude Code가 특정 동작을 수행할 때 자동으로 실행되는 사용자 정의 스크립트입니다. 예를 들어 파일을 수정할 때마다 자동으로 포맷팅을 실행하거나, Claude가 작업을 멈추려 할 때 조건을 확인하고 계속 실행시킬 수 있습니다.

7.1 PostToolUse Hook

Claude가 코드를 작성할 때 자동으로 포맷팅하는 hook을 사용합니다.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$CLAUDE_FILE_PATH\""
          }
        ]
      }
    ]
  }
}

Claude가 대부분 잘 포맷팅된 코드를 생성하지만, 마지막 10%를 hook이 처리하여 CI 포맷팅 오류를 방지합니다.

7.2 Stop Hook

장시간 작업에서 Claude가 중간에 멈추는 것을 방지합니다. Boris의 최장 실행 기록은 약 42시간이며, 수백 개의 PR을 중간 개입 없이 처리했습니다.

ralph-wiggum 플러그인은 실제 완료 조건이 충족될 때까지 Claude를 계속 실행시킵니다.

8. 권한 관리

Boris는 --dangerously-skip-permissions를 사용하지 않습니다. 대신 /permissions로 안전하다고 알려진 명령어들을 미리 허용합니다.

/permissions

허용된 명령어들은 .claude/settings.json에 저장되어 팀과 공유됩니다. 이를 통해 불필요한 권한 프롬프트 없이 Claude가 자율적으로 실행되면서도 안전을 유지합니다.

9. MCP 통합

Claude Code는 MCP(Model Context Protocol)를 통해 외부 도구들과 연결됩니다.

도구용도
Slack검색 및 메시지 전송
BigQuerybq CLI로 분석 쿼리 실행
Sentry에러 로그 조회

MCP 설정은 .mcp.json에 저장되어 팀과 공유됩니다.

10. 가장 중요한 팁: 검증

Claude에게 자신의 작업을 검증할 방법을 제공하세요. 이 피드백 루프가 있으면 최종 결과물의 품질이 2-3배 향상됩니다.

Boris는 claude.ai/code에 배포하는 모든 변경사항을 Claude Chrome 익스텐션으로 테스트합니다. 브라우저를 열고, UI를 테스트하고, 코드가 작동하고 UX가 좋아질 때까지 반복합니다.

검증 방법은 도메인마다 다릅니다.

도메인검증 방법
명령줄 도구bash 명령 실행
백엔드테스트 스위트 실행
프론트엔드브라우저 또는 폰 시뮬레이터
APIcurl 또는 API 테스트 도구

검증 시스템에 투자하세요. 이것이 고품질 결과물을 만드는 핵심입니다.

11. 정리

Boris Cherny의 Claude Code 사용법을 요약하면 다음과 같습니다.

  1. 15개 이상 병렬 세션 - 터미널, 웹, iOS
  2. Opus 4.5 + thinking - 더 적은 반복, 결과적으로 더 빠름
  3. 팀 CLAUDE.md - git으로 공유하는 지식 베이스
  4. GitHub Action - PR에서 자동으로 CLAUDE.md 업데이트
  5. Plan 모드 → Auto-accept - 2단계 워크플로우
  6. 슬래시 커맨드 - 반복 작업 자동화
  7. 서브에이전트 - 특화된 AI 어시스턴트
  8. PostToolUse Hook - 자동 코드 포맷팅
  9. 스마트 권한 관리 - 안전한 명령어 사전 허용
  10. MCP 통합 - 모든 도구와 연결
  11. 검증 - 가장 중요한 피드백 루프