포스트

Claude Code 제작자가 말하는 효과적인 활용법

게시 업데이트
By Juho
11 분읽는 시간

목차

  1. Claude Code란?
  2. Boris Cherny의 작업 환경
  3. 모델 선택 전략
  4. 지식 관리 시스템
  5. 효과적인 실행 패턴
  6. 성공의 핵심 요소
  7. 워크플로우 자동화
  8. 실전 적용 팁

Claude Code란?

Claude Code는 Anthropic에서 개발한 AI 기반 코딩 도우미로, 터미널과 웹 환경에서 개발자와 협업하며 코드 작성, 디버깅, 리팩토링 등을 지원하는 도구이다. 단순한 코드 생성을 넘어 프로젝트의 컨텍스트를 이해하고 복잡한 개발 작업을 수행할 수 있다.

Boris Cherny의 작업 환경

Boris Cherny는 Claude Code의 제작자로, 그가 실제로 어떻게 Claude Code를 활용하는지 살펴보면 흥미로운 패턴이 드러난다.

병렬 작업 환경

  • 로컬 터미널: 5개의 Claude 인스턴스를 동시에 실행
  • 웹 환경: 5-10개의 추가 인스턴스를 브라우저 탭에서 운영
  • 알림 시스템: 시스템 알림을 통해 각 인스턴스에서 입력이 필요한 시점을 추적

이러한 대규모 병렬 작업 환경은 여러 작업을 동시에 진행하면서도 각각의 진행 상황을 효율적으로 모니터링할 수 있게 해준다.

모델 선택 전략

Cherny는 모든 작업에 Opus 4.5 with thinking 모델을 일관되게 사용한다.

Opus 4.5 선택 이유

  • 최고의 코딩 모델: 그가 테스트한 모든 모델 중 가장 우수한 성능
  • 최소한의 가이드: 세밀한 지시 없이도 의도를 정확히 파악
  • 뛰어난 도구 활용: 제공된 도구를 효과적으로 활용하는 능력
  • 속도 vs 품질: 모델 자체는 크고 느리지만, 결과물의 품질이 높아 전체 작업 시간은 오히려 단축

이는 “빠르지만 부정확한 모델”보다 “느리지만 정확한 모델”이 결국 더 효율적이라는 교훈을 준다.

지식 관리 시스템

팀 차원에서 Claude의 성능을 지속적으로 개선하기 위한 체계적인 접근 방식을 사용한다.

CLAUDE.md 파일 활용

1
2
3
4
5

# CLAUDE.md
- 저장소의 루트에 위치
- Claude가 범한 실수와 오류 패턴을 문서화
- 코드 리뷰 시 "@.claude" 태그로 학습 내용 업데이트
- 복합적 엔지니어링(compounding engineering) 원칙 구현

지속적 개선 프로세스

  1. Claude가 실수를 범함
  2. 코드 리뷰에서 실수를 발견
  3. CLAUDE.md에 해당 패턴 문서화
  4. 다음 작업부터 같은 실수 방지

이는 조직의 집단 지식을 축적하고 AI의 성능을 점진적으로 향상시키는 효과적인 방법이다.

효과적인 실행 패턴

Cherny가 권장하는 작업 프로세스는 명확한 단계로 구성되어 있다.

1단계: Plan 모드로 시작

  • 진입 방법: Shift + Tab 두 번 입력
  • 목적: 구현 전략을 팀과 함께 검토하고 다듬기
  • 장점:
    • 작업 범위 명확화
    • 접근 방식 합의
    • 잠재적 문제 사전 파악

2단계: Auto-accept 모드로 전환

  • 실행: 계획이 확정되면 자동 수락 모드로 전환
  • 결과: Claude가 종종 한 번에(single pass) 작업을 완료

이러한 두 단계 접근 방식은 계획과 실행을 분리하여 각각의 품질을 최적화한다.

성공의 핵심 요소

Cherny가 강조하는 가장 중요한 성공 요인은 명확하다.

검증 방법 제공하기

“Claude에게 작업을 검증할 방법을 제공하는 것이 출력 품질을 2-3배 향상시킨다.”

검증 방법의 예시:

  • 웹 개발: 브라우저에서 직접 테스트
  • 백엔드 개발: 테스트 스위트 실행
  • API 개발: 엔드포인트 호출 및 응답 확인
  • 데이터 처리: 출력 데이터 검증 스크립트

왜 검증이 중요한가?

1
2
3
4
5
6
7
8
9

# 검증 없이 작업
Claude: 코드를 작성했습니다.
개발자: (나중에 문제 발견) 다시 수정해주세요.

# 검증과 함께 작업
Claude: 코드를 작성하고 테스트를 실행했습니다.
       테스트 10개 중 8개 통과, 2개 실패
       실패한 테스트를 분석하고 수정했습니다.
       재실행 결과 모두 통과했습니다.

즉각적인 피드백 루프가 Claude의 자체 수정 능력을 활성화하여 결과물의 품질이 비약적으로 향상된다.

워크플로우 자동화

반복적인 작업을 효율화하기 위한 슬래시 커맨드 활용법이다.

커맨드 저장 위치

1

.claude/commands/

실전 예시: commit-push-pr

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

#!/bin/bash
# .claude/commands/commit-push-pr

# 현재 브랜치 정보 가져오기
BRANCH=$(git branch --show-current)
BASE_BRANCH=$(git remote show origin | grep 'HEAD branch' | cut -d' ' -f5)

# 변경사항 커밋
git add .
git commit -m "$1"

# 원격 저장소에 푸시
git push origin $BRANCH

# Pull Request 생성
gh pr create --base $BASE_BRANCH --head $BRANCH --title "$1" --body "$2"

사용 빈도

  • 하루에 수십 번 사용
  • 인라인 bash를 활용한 동적 정보 계산
  • 일관된 워크플로우 유지

실전 적용 팁

실제 개발 환경에서 Claude Code를 효과적으로 활용하기 위한 구체적인 팁들이다.

1. 컨텍스트 관리

1
2
3
4
5

# 프로젝트 루트에 .claud/CONTEXT.md 생성
- 프로젝트 구조 설명
- 주요 규칙과 컨벤션
- 자주 사용하는 패턴
- 피해야 할 안티패턴

2. 단계별 작업 분해

1
2
3
4
5
6
7
8
9
10

❌ 나쁜 예:
"사용자 인증 시스템을 만들어줘"

✅ 좋은 예:
"사용자 인증 시스템을 만들고 싶어.
먼저 데이터베이스 스키마를 설계하고,
그 다음 회원가입 API를 구현한 뒤,
로그인 API를 만들고,
마지막으로 통합 테스트를 작성해줘.
각 단계마다 테스트를 실행해서 확인해줘."

3. 에러 대응 패턴

1
2
3
4

단계 1: 에러 발생 시 즉시 Claude에게 에러 메시지 제공
단계 2: Claude가 원인 분석 및 수정안 제시
단계 3: 수정 후 테스트로 검증
단계 4: 성공 시 다음 단계 진행, 실패 시 반복

4. 병렬 작업 활용

1
2
3
4
5

터미널 1: 백엔드 API 개발
터미널 2: 프론트엔드 컴포넌트 개발
터미널 3: 테스트 코드 작성
터미널 4: 문서화
웹 1-3: 리서치 및 참고 자료 분석

5. 품질 체크리스트

작업 완료 전 항상 확인할 항목들:

  • 모든 테스트가 통과하는가?
  • 에러 처리가 적절히 구현되었는가?
  • 코드가 프로젝트의 컨벤션을 따르는가?
  • 성능상 문제는 없는가?
  • 보안 취약점은 없는가?

마치며

Boris Cherny의 Claude Code 활용법에서 배울 수 있는 핵심은 다음과 같다:

  1. 강력한 모델 선택: 속도보다 품질을 우선시
  2. 체계적 지식 관리: 실수를 문서화하고 학습
  3. 명확한 프로세스: 계획과 실행의 분리
  4. 검증의 중요성: 즉각적인 피드백 루프 구축
  5. 자동화: 반복 작업의 효율화

단순히 AI에게 코드를 생성시키는 것이 아니라, AI와 효과적으로 협업하는 방법을 체계화하는 것이 진정한 생산성 향상의 열쇠다.

AI Tools
Claude Code AI LLM Coding Productivity