클로드 코드 개발자가 말아주는 클로드 사용 꿀팁

Claude Code를 직접 개발한 앤스로픽의 보리스(Boris)가 공개한 AI 에이전트 활용의 핵심 원칙과 실전 노하우를 정리했습니다. 단순히 코드를 생성하는 도구가 아닌, 진짜 생산성을 극대화하는 방법을 알아보세요.

#1. 가장 중요한 원칙: 검증 방법을 항상 제공하라

많은 사람들이 Claude에게 작업을 지시했을 때 100% 완료되지 않으면 실망합니다. 하지만 이는 인간 개발자와 작업할 때도 마찬가지입니다.

핵심은 Claude가 스스로 검증할 수 있는 방법을 제공하는 것입니다.

#실천 방법

• 파이썬 코드를 작성하게 할 때는 반드시 테스트 코드도 함께 작성하도록 지시하세요
• "이 기능을 구현하고 테스트도 작성해줘"라고 요청하면 됩니다
• 어떤 테스트를 작성해야 할지 모르겠다면 Claude에게 물어보세요
• 검증 방법은 도메인마다 다릅니다:
  • 백엔드: 단위 테스트, 통합 테스트
  • UI: 브라우저 확장 프로그램으로 실제 화면 검증
  • 모바일: iOS/Android 시뮬레이터 활용

#자동화하기

Claude MD 파일에 다음과 같이 추가하면 매번 지시하지 않아도 됩니다:

모든 기능 구현 시 작업을 시작하기 전에 검증 방법을 먼저 제시하고,
구현 완료 후 반드시 테스트를 실행하여 검증할 것.

#2. Claude MD 파일: 팀 생산성의 핵심

보리스는 Claude MD 파일을 "가장 중요한 기능"이라고 강조합니다. 그와 그의 팀은 일주일에 여러 번 이 파일을 업데이트합니다.

#반드시 포함해야 할 내용

1. 기술 스택: 사용하는 언어, 프레임워크, 라이브러리
2. 프로젝트 구조: 폴더 구조와 핵심 파일 위치
3. 코딩 스타일: 팀이 따르는 규칙과 컨벤션
4. 가장 중요: 하지 말아야 할 것들

#실제 사례

# 하지 말아야 할 것
 
- 절대 프로덕션 데이터베이스에 직접 연결하지 말 것
- 타입스크립트 any 타입 사용 금지
- 컴포넌트에 인라인 스타일 작성하지 말 것
- npm install 전에 반드시 package-lock.json 백업할 것

Claude가 실수할 때마다 이 파일에 추가하면, 같은 실수를 반복하지 않습니다.

#팀 협업

• .claude 폴더는 Git에 커밋하여 팀 전체가 공유합니다
• 마이크로서비스 구조라면 각 서비스마다 별도의 Claude MD 파일을 만드세요
• 파일이 너무 비대해지지 않도록 주의하세요 (보리스의 파일은 약 2,500 토큰)

#3. Skip Permission은 쓰지 마세요

보리스는 놀랍게도 "Skip Permission Code" 기능을 사용하지 않습니다.

#이유

프로덕션 환경에서 단 하나의 터미널 명령어가 전체 프로젝트를 망칠 수 있기 때문입니다.

#대신 이렇게 하세요

Claude Code의 권한 설정을 활용하여:

• ✅ 항상 허용: npm test, git status, git diff
• ❓ 실행 전 확인: npm install, git push, rm -rf
• ❌ 완전 거부: rm -rf /, 프로덕션 배포 명령어

이 설정은 .claude/settings.yaml 파일에 저장되므로 팀과 공유할 수 있습니다.

#4. Claude Code는 코드만을 위한 도구가 아닙니다

보리스는 Claude Code가 "가장 이름이 잘못 지어진 제품"이라고 농담합니다. 실제로는 전체 워크플로우를 제어하는 오케스트레이터입니다.

#활용 사례

• Slack 메시지 자동 발송
• Jira 티켓 생성 및 업데이트
• Sentry 오류 분석 및 대응
• Notion 데이터베이스 생성 및 관리
• 비즈니스 시장 분석 리포트 작성

모든 도구를 MCP 서버를 통해 Claude Code 내에서 통합하여 사용할 수 있습니다.

#5. 올바른 작업 순서: Plan → Execute

보리스의 실제 작업 흐름은 다음과 같습니다:

#1단계: Plan Code로 시작

/plan

사용자 인증 기능을 추가하고 싶어.
JWT 토큰 방식으로 구현하고, 로그인/로그아웃/회원가입이 필요해.

Claude가 상세한 계획을 제시하면 검토하고 승인합니다.

#2단계: Auto Edit Code로 실행

계획이 확정되면 실행 단계로 넘어갑니다. 모든 파일 편집은 자동으로 승인되지만, 터미널 명령어는 여전히 권한 설정을 따릅니다.

#핵심 원칙

"에이전트와의 모든 대화는 Plan 단계에서 이루어져야 합니다. 계획이 검증된 후에야 실행해야 합니다."

#6. 규모 있게 활용하기: 병렬 세션

보리스는 Claude Code 세션을 5개나 병렬로 실행합니다.

#병렬 작업 팁

• 각 터미널 탭에 번호를 매겨 어떤 작업이 진행 중인지 추적
• 웹 버전 Claude Code를 GitHub에 연결하여 클라우드에서 작업
• 백그라운드 에이전트 기능으로 오래 걸리는 작업 분리
• 휴대폰으로도 Claude Code 세션에 접근하여 진행 상황 확인

#주니어 개발자처럼 대하기

"이 기능 구현을 새 브랜치에서 작업하고,
완료되면 PR을 생성해서 나한테 알려줘.
백그라운드에서 작업해도 돼."

작업이 완료되면 Claude가 새 브랜치를 생성하고, 모든 변경사항을 푸시하고, PR까지 만들어줍니다. 마치 실제 팀원과 일하는 것처럼요.

#7. 모델 선택: Opus 4.5를 사용하세요

보리스는 거의 모든 작업에 **Opus 4.5 (Thinking 활성화)**를 사용합니다.

#이유

• Sonnet이나 Haiku보다 느리지만, 오류를 범할 확률이 훨씬 낮습니다
• 결과적으로 수정하고 재지시하는 데 드는 전체 시간이 오히려 적습니다
• 한 번에 제대로 하는 것이 여러 번 고치는 것보다 빠릅니다

#언제 다른 모델을 쓸까?

• 간단한 검색이나 파일 읽기: Haiku
• 일반적인 코드 작성: Sonnet
• 복잡한 아키텍처 설계나 중요한 기능: Opus 4.5

#8. 장기 실행 작업 관리 3가지 방법

#방법 1: 백그라운드 검증

"이 기능을 구현하고 테스트를 작성해서 백그라운드에서 실행해줘.
테스트가 통과하면 알려줘."

#방법 2: Stop Hook 활용

Claude가 출력을 멈출 때 자동으로 검증을 트리거하는 훅을 설정합니다.

# .claude/settings.yaml
hooks:
  on_stop:
    - command: "npm test"

#방법 3: 린터와 포매터

다양한 언어의 린터와 포매터를 자동으로 실행하여 코드 형식을 검증합니다.

hooks:
  on_edit:
    - command: "prettier --write {file}"
    - command: "eslint --fix {file}"

모델이 99% 올바른 코드를 생성하더라도, 포매터가 나머지 1%를 정리해줍니다.

#9. 간단한 내장 기능으로 90% 생산성 달성

복잡한 설정 없이도 Claude Code의 기본 기능만으로 충분합니다.

#슬래시 명령어 활용

하루에도 여러 번 반복하는 작업을 슬래시 명령어로 만드세요:

# .claude/commands/commit.md
현재 변경사항을 검토하고, 의미 있는 커밋 메시지를 작성해서 커밋해줘.
커밋 전에 테스트를 실행하고, 통과하면 커밋해.

사용할 때는 /commit만 입력하면 됩니다.

#서브 에이전트

보리스는 서브 에이전트를 다음 용도로 사용합니다:

• 코드 아키텍처 검증: 작성된 코드가 설계 원칙을 따르는지 확인
• 리팩토링: 기존 코드를 개선하되 기능은 유지
• 최종 빌드 검증: 배포 전 모든 것이 작동하는지 확인

과하게 사용하지 마세요. 정말 다른 지침이 필요한 경우에만 활용하세요.

#10. GitHub 통합으로 팀 학습 강화

Claude Code GitHub Action을 활용하면 PR 리뷰 과정에서도 학습할 수 있습니다.

#실천 방법

PR 리뷰 중 실수를 발견하면:

"이 실수들을 Claude MD 파일에 추가해줘.
다음에는 이런 실수를 하지 않도록."

Claude가 자동으로 Claude MD 파일을 업데이트하고, 팀 전체가 그 교훈을 공유하게 됩니다.

#결론: Claude Code를 주니어 개발자처럼 대하세요

보리스의 핵심 철학은 간단합니다:

"Claude Code를 단순한 코드 생성 도구가 아닌, 피드백과 검증을 통해 성장하는 주니어 개발자처럼 대하세요."

#실천 체크리스트

• 모든 작업에 검증 방법 제공
• CLAUDE.md 파일에 팀의 지식 축적
• Plan Code로 시작, Auto Edit Code로 실행
• 권한 설정으로 안전장치 마련
• 중요한 작업은 Opus 4.5 사용
• 반복 작업은 슬래시 명령어로 자동화
• 린터/포매터로 코드 품질 보장

이러한 원칙들을 따르면 Claude Code는 단순한 도구를 넘어, 여러분의 생산성을 10배 이상 향상시키는 진정한 개발 파트너가 될 것입니다.

이 글은 Anthropic Claude Code 개발자 Boris의 X 내용을 바탕으로 작성되었습니다.