본문으로 건너뛰기

팀 협업 패턴

Claude Code를 혼자 잘 쓰는 것과, 팀 전체가 일관되게 잘 쓰는 것은 다릅니다. 팀 레벨에서 Claude Code를 효과적으로 도입하고 운영하는 패턴을 알아봅시다.

팀 공유 설정 체계​

파일별 역할 분담​

프로젝트/
  CLAUDE.md               ← 팀 공통 컨텍스트 (git 포함)
  .claude/
    settings.json         ← 팀 공통 도구 설정 (git 포함)
    settings.local.json   ← 개인 설정 (.gitignore 처리)
    commands/             ← 팀 공통 Skills (git 포함)
      commit.md
      review.md
      standup.md

.gitignore 설정:

# 개인 설정만 제외 (팀 설정은 포함)
.claude/settings.local.json

팀 CLAUDE.md 템플릿​

# [프로젝트명] — 팀 가이드

## 프로젝트 컨텍스트
- **기술 스택**: [스택 목록]
- **아키텍처**: [간략 설명]
- **테스트 프레임워크**: [Jest/Pytest 등]

## 코딩 컨벤션
- 함수명: camelCase (TypeScript), snake_case (Python)
- 에러 처리: [방식 설명]
- 로깅: [방식 설명]

## 금지 사항
- 프로덕션 DB 직접 연결
- 고객 데이터 컨텍스트 포함
- API 키 하드코딩

## 테스트 실행
- 단위: `npm run test:unit`
- 통합: `npm run test:integration`
- 커버리지: `npm run test:coverage`

## 배포 프로세스
[팀 배포 절차 요약]

## 자주 쓰는 Skills
- `/commit` — Conventional Commits 자동 작성
- `/review` — PR 리뷰
- `/standup` — 스탠드업 요약

온보딩 워크플로우​

신규 팀원 온보딩 체크리스트​

## Claude Code 온보딩

### 1단계: 설치 및 설정 (30분)
- [ ] Claude Code 설치: `npm install -g @anthropic-ai/claude-code`
- [ ] API 키 발급 및 설정
- [ ] `CLAUDE.md` 읽기 (프로젝트 컨텍스트 파악)

### 2단계: 기본 실습 (1시간)
- [ ] 코드베이스 탐색: "이 프로젝트의 전체 구조를 설명해줘"
- [ ] 버그 수정 실습: 간단한 이슈 하나 Claude와 함께 해결
- [ ] `/review` Skill로 PR 리뷰 경험

### 3단계: 팀 패턴 습득 (첫 1주일)
- [ ] 페어 프로그래밍 세션 (숙련자와 함께)
- [ ] 첫 PR에 `/commit` Skill 사용
- [ ] 팀 Claude Code 사용 가이드라인 리뷰

온보딩용 첫 질문 템플릿​

신규 팀원이 코드베이스를 이해하는 데 유용한 질문들:

> 이 프로젝트의 전반적인 아키텍처를 설명해줘.
  핵심 디렉토리들의 역할과 서로 어떻게 연결되는지 알려줘.

> 새 API 엔드포인트를 추가할 때 일반적으로 어떤 파일들을 수정해야 해?
  기존 예시 하나를 찾아서 패턴을 보여줘.

> 이 프로젝트의 테스트 방식을 설명해줘.
  테스트를 어디에 어떻게 작성하는지 예시를 보여줘.

팀 워크플로우 표준화​

PR 프로세스 통합​

1. 작업 시작
   git checkout -b feat/123-새기능
   claude "이슈 #123 기반으로 기능 구현 시작해줘"

2. 개발 중
   claude "방금 구현한 부분 테스트 작성해줘"
   claude "코드 리뷰해줘 (팀 컨벤션 체크)"

3. PR 준비
   /commit  ← Skill로 커밋 메시지 자동 생성
   /review  ← Skill로 자체 리뷰 후 PR 오픈

4. 리뷰 대응
   claude "리뷰어가 [지적 내용] 지적했어. 어떻게 수정하면 좋아?"

정기 팀 세션​

주간 Claude Code 활용 공유:

  • 이번 주 가장 효과적이었던 프롬프트 공유
  • 실패 사례 분석 (왜 안 됐는지)
  • 새 Skills 제안 및 추가

팀 CLAUDE.md 업데이트 정례화:

# 월 1회, CLAUDE.md 리뷰 및 업데이트
git checkout -b chore/update-claude-md
# 팀 토론 후 업데이트
git commit -m "chore: CLAUDE.md 월간 업데이트"

역할별 활용 패턴​

주니어 개발자​

# 배움을 극대화하는 방식으로 활용
> 이 코드가 왜 이렇게 작동하는지 설명해줘.
  내가 직접 수정해볼 수 있도록 힌트만 줘.

> 내가 작성한 이 코드의 문제점을 찾아줘.
  어떻게 고쳐야 하는지는 설명해줘, 직접 고치지는 마.

시니어 개발자​

# 검토와 설계에 집중
> 이 아키텍처 설계의 장단점을 분석해줘.
  스케일 10배 성장 시 어떤 문제가 발생할까?

> 코드 리뷰 포인트를 잡아줘.
  특히 보안과 성능 관점에서.

테크 리드​

# 팀 전체 생산성 향상에 집중
> 이번 스프린트 작업들을 분석해서
  Claude Code로 자동화할 수 있는 반복 작업을 찾아줘.

> 새 팀원이 이 코드베이스를 이해하기 위한
  온보딩 문서를 작성해줘.

비용 관리 (팀 레벨)​

팀 API 비용 관리 방법:

1. 조직 계정 사용
   - 팀 전체 사용량을 한 계정으로 관리
   - 부서별 예산 배분 가능

2. 사용량 모니터링
   - Anthropic Console에서 팀 사용량 확인
   - 월간 예산 한도 설정

3. 고비용 작업 가이드라인
   - 대규모 코드베이스 전체 분석 → 미리 승인 받기
   - 자동화 배치 작업 → 예상 비용 계산 후 실행

다음 챕터: 코드 리뷰 워크플로우 →

최종 수정: 에