Claude Code 창시자 Boris의 사용법과 개발팀 협업 노하우
클로드 코드를 만든 보리스의 X 포스팅을 번역하였습니다. 클로드 코드를 사용하는 방법에 대한 노하우입니다.
원본은 @bcherny 에서 확인하실 수 있습니다.
저는 Boris이고, Claude Code를 만들었습니다. 많은 분들이 제가 Claude Code를 어떻게 사용하는지 물어봐서 제 셋업을 조금 공유하려고 합니다.
제 셋업은 의외로 평범할 수 있어요! Claude Code는 기본 상태로도 훌륭하게 작동해서, 저는 개인적으로 많이 커스터마이징하지 않습니다. Claude Code를 사용하는 정답은 없습니다. 우리는 의도적으로 여러분이 원하는 대로 사용하고, 커스터마이징하고, 해킹할 수 있도록 만들었어요. Claude Code 팀원들도 각자 매우 다르게 사용합니다.
자, 시작합니다.
1/ 저는 터미널에서 5개의 Claude를 병렬로 실행합니다. 탭에 1-5 번호를 매기고, Claude가 입력을 기다릴 때 시스템 알림을 받습니다. https://code.claude.com/docs/en/terminal-config#iterm-2-system-notifications
(iterm2 와 시스템 알림을 통해 작업하는 화면. 1~5까지의 탭이 있다.)
2/ 또한 claude.ai/code에서 5-10개의 Claude를 로컬 Claude들과 병렬로 실행합니다.
터미널에서 코딩하다가 로컬 세션을 웹으로 핸드오프하거나(&사용), Chrome에서 직접 세션을 시작하기도 하고, 가끔 --teleport로 왔다 갔다 합니다.
3/ 저는 모든 작업에 thinking이 켜진 Opus 4.5를 사용합니다. 제가 써본 최고의 코딩 모델이고, Sonnet보다 크고 느리지만 조종을 덜 해도 되고 도구 사용 능력이 뛰어나서 결국 작은 모델보다 거의 항상 더 빠릅니다.
4/ 우리 팀은 Claude Code 레포에 하나의 CLAUDE.md를 공유합니다. git에 체크인하고, 팀 전체가 매주 여러 번 기여합니다. Claude가 뭔가 잘못하는 걸 볼 때마다 CLAUDE.md에 추가해서 다음에는 그렇게 하지 않도록 합니다.
5/ 코드 리뷰 중에 동료의 PR에 @claude를 태그해서 PR의 일부로 CLAUDE.md에 내용을 추가하곤 합니다. 이를 위해 Claude Code GitHub 액션(/install-github-action)을 사용합니다. 이건 @danshipper의 Compounding Engineering 개념을 우리 식으로 구현한 것입니다.
(참고) Compounding Engineering 이란?
한 줄 정의: 코드를 짤수록 다음 코드가 더 쉬워지는 개발 방식
기존 vs Compound
기존: 기능 추가할수록 복잡해지고 느려진다
Compound: 기능 추가할수록 AI가 똑똑해지고 빨라진다
4단계 루프
Plan - AI에게 코드베이스 조사시키고 계획서 작성 (80%)
Work - AI가 코드 작성
Assess - AI + 사람이 검토
Compound - 배운 것을 기록해서 다음에 재사용 (핵심) - 예 : CLAUDE.md 등에 기록.
왜 "Compound"인가
버그 고쳤으면 "왜 발생했고 어떻게 고쳤는지" 기록한다. 다음에 AI가 같은 실수 안 한다. 이게 쌓이면 신입도 베테랑처럼 일한다.
결과
Every 팀: 15명이 5개 제품 운영, 엔지니어는 코드 거의 안 씀. 1인이 과거 5인 생산성.
Boris가 말한 맥락:
Boris 팀이 CLAUDE.md에 Claude가 잘못한 것을 계속 추가하는 게 바로 이 개념의 적용. 코드베이스가 점점 "self-teaching"이 되어서, 새 팀원이 코드 구조를 몰라도 바로 생산적으로 일할 수 있게 됨.
요약하면: AI가 실수할 때마다 기록해서 다음엔 그 실수를 안 하게 만들고, 이게 복리처럼 쌓이는 것.
참고로 여기에서 Boris 가 말한 워크플로우는 코드 리뷰를 하다가 클로드가 한 실수를 발견했을 때 PR 코멘트에 @claude CLAUDE.md에 "X 상황에서는 Y 방식으로 처리할 것" 추가해줘 라고 작성하는 것.
6/ 대부분의 세션은 Plan 모드로 시작합니다(shift+tab 두 번). 제 목표가 Pull Request 작성이라면 Plan 모드를 사용하고, Claude의 계획이 마음에 들 때까지 여러 차례 주고받습니다. 그 다음 auto-accept edits 모드로 전환하면 Claude가 대개 한 번에 완성합니다. 좋은 계획이 정말 중요합니다!
7/ 저는 하루에 여러 번 반복하는 모든 "inner loop" 워크플로우에 슬래시 명령어를 사용합니다. 이렇게 하면 반복적인 프롬프트 입력을 줄일 수 있고, Claude도 이 워크플로우들을 활용할 수 있습니다. 명령어들은 git에 커밋되어 .claude/commands/에 저장됩니다.
예를 들어, Claude와 저는 /commit-push-pr 슬래시 명령어를 매일 수십 번 사용합니다. 이 명령어는 인라인 bash를 사용해 git status와 몇 가지 정보를 미리 계산하므로 명령어가 빠르게 실행되고 모델과의 불필요한 왕복을 줄일 수 있습니다https://code.claude.com/docs/en/slash-commands#bash-command-execution
8/ 저는 몇 가지 서브에이전트를 정기적으로 사용합니다: code-simplifier는 Claude가 작업을 마친 후 코드를 단순화하고, verify-app은 Claude Code를 엔드투엔드로 테스트하기 위한 상세한 지침을 담고 있습니다. 슬래시 명령어와 마찬가지로, 서브에이전트는 대부분의 PR에서 제가 수행하는 가장 흔한 워크플로우를 자동화하는 것이라고 생각합니다.
9/ 저희는 Claude의 코드를 포맷하기 위해 PostToolUse 훅을 사용합니다. Claude는 보통 기본적으로 잘 포맷된 코드를 생성하고, 훅이 나머지 10%를 처리해서 나중에 CI에서 포맷팅 오류가 발생하는 것을 방지합니다.
10/ 저는 --dangerously-skip-permissions를 사용하지 않습니다. 대신 /permissions를 사용해 제 환경에서 안전하다고 알고 있는 일반적인 bash 명령어들을 미리 허용해서 불필요한 권한 프롬프트를 피합니다. 이 설정들 대부분은 .claude/settings.json에 커밋되어 팀과 공유됩니다.
11/ Claude Code는 제 모든 도구들을 대신 사용합니다. Slack에서 검색하고 글을 올리고(MCP 서버를 통해), 분석 관련 질문에 답하기 위해 BigQuery 쿼리를 실행하고(bq CLI 사용), Sentry에서 에러 로그를 가져오는 등의 작업을 자주 합니다. Slack MCP 설정은 저희 .mcp.json에 커밋되어 팀과 공유됩니다.
12/ 매우 오래 걸리는 작업의 경우, 저는 (a) Claude가 작업을 마치면 백그라운드 에이전트로 검증하도록 프롬프트하거나, (b) 에이전트 Stop 훅을 사용해 더 결정론적으로 처리하거나, (c) ralph-wiggum 플러그인을 사용합니다(원래 @GeoffreyHuntley가 고안 - 목표에 이를 때 까지 AI를 반복 시키는 플러그인). 또한 샌드박스에서 --permission-mode=dontAsk 또는 --dangerously-skip-permissions를 사용해 세션 동안 권한 프롬프트를 피하고, Claude가 저를 기다리지 않고 작업을 계속할 수 있게 합니다.
github.com/anthropics/claude-plugins-official/tree/main/plugins/ralph-wiggum
https://code.claude.com/docs/en/hooks-guide
13/ 마지막 팁: Claude Code에서 훌륭한 결과를 얻기 위해 아마도 가장 중요한 것은 Claude가 자신의 작업을 검증할 수 있는 방법을 제공하는 것입니다.
Claude에게 그 피드백 루프가 있으면 최종 결과물의 품질이 2-3배 향상됩니다. Claude는 제가 http://claude.ai/code 에 반영하는 모든 변경 사항을 Claude Chrome 확장 프로그램을 사용해 테스트합니다.
브라우저를 열고, UI를 테스트하고, 코드가 작동하고 UX가 만족스러울 때까지 반복합니다. 검증은 각 도메인마다 다르게 보입니다.
bash 명령어를 실행하는 것처럼 간단할 수도 있고, 테스트 스위트를 실행하거나, 브라우저나 폰 시뮬레이터에서 앱을 테스트하는 것일 수도 있습니다. 이것을 견고하게 만드는 데 투자하세요.
https://code.claude.com/docs/en/chrome
code-simplifier
Claude Code 팀에서 사용하는 code-simplifier 에이전트를 오픈소스로 공개했습니다.
사용 방법 :
claude plugin install code-simplifier
또는 세션 내에서:
/plugin marketplace update claude-plugins-official
/plugin install code-simplifier
긴 코딩 세션이 끝날 때 Claude에게 code simplifier 에이전트를 사용하도록 요청하거나, 복잡한 PR을 정리하는 데 활용하세요. 의견을 알려주세요!