Epix / 업무·마케팅 운영
Claude Code 팀 도입 체크리스트 2026: 권한·비용 상한·감사 로그 설계
Claude Code를 팀 개발 흐름에 넣기 전에 계정과 권한을 나누고, 비용 상한과 변경 승인·감사 로그를 설계하는 실무 가이드입니다.
업데이트: 2026년 9월 28일
도입 순서: 팀 전체에 한 번에 열기보다 저장소별 권한, 실행 승인, 비용 상한, 롤백 기준을 먼저 정한 뒤 작은 파일럿에서 검증하세요. Claude Code는 터미널·IDE와 함께 쓰며 파일 변경이나 명령 실행 전에 권한을 요청하는 흐름을 제공하므로, 이 승인 지점을 조직의 리뷰 절차와 연결하는 것이 핵심입니다.
팀 도입 전에 분리할 네 가지 경계
| 경계 | 권장 기본값 | 기록할 증거 |
|---|---|---|
| 계정 | 개인 계정·조직 계정·API 콘솔을 분리 | 사용자·프로젝트·접속 방식 |
| 저장소 | 읽기부터 시작하고 쓰기는 리뷰 브랜치로 제한 | 변경 파일·커밋·PR 링크 |
| 명령 | 네트워크·삭제·배포 명령은 별도 승인 | 명령·승인자·실행 결과 |
| 비용 | 조직 상한과 사용자별 알림을 함께 설정 | 모델·토큰·재시도·월 누적 |
비용은 좌석과 작업 비용을 분리해 계산한다
Claude Code의 접근 경로와 요금 조건은 플랜 또는 Console 사용 방식에 따라 달라질 수 있습니다. 따라서 게시 시점 가격을 고정하기보다 공식 페이지에서 현재 플랜을 확인하고, 내부 예산표에는 다음 식을 사용하세요.
월 총비용 = 좌석·구독 비용 + API/추가 사용량 비용 + 사람 검수 시간 + 실패 복구 시간
검수 비용은 수정 분 × 분당 인건비, 복구 비용은 실패 건수 × 평균 복구 분 × 분당 인건비로 시작하면 됩니다. 샘플 20건에서 기준선보다 품질이 좋아졌는지와 총비용이 줄었는지를 함께 확인해야 단가가 낮다는 이유만으로 모델을 고르는 실수를 피할 수 있습니다.
Anthropic 공식 Claude Code 안내는 Pro·Max·Team·Enterprise 플랜과 Console 사용 경로를 구분하고, 로컬 터미널에서 작업하며 파일 변경·명령 실행 전에 권한을 요청한다고 설명합니다. 현재 플랜·사용량 제한은 Claude Code 공식 페이지와 관리자 화면에서 다시 확인하세요.
안전한 3단계 롤아웃
- 관찰 단계: 읽기 전용 저장소에서 코드 설명·테스트 초안만 실행하고, 입력 데이터에 비밀값이 없는지 확인합니다.
- 제한된 쓰기 단계: 보호 브랜치 밖에서 작은 변경만 허용하고, 테스트와 사람이 승인한 PR을 통과해야 병합합니다.
- 운영 단계: 사용자·저장소·명령별 로그와 비용을 주간 검토하고, 상한 초과 시 자동으로 승인 대기로 전환합니다.
감사 로그에 남길 최소 필드
- 요청자, 프로젝트, 브랜치, 세션 시작·종료 시각
- 사용한 모델 별칭과 도구·MCP 연결 여부
- 읽거나 바꾼 파일 목록과 테스트 결과
- 외부 명령·네트워크 요청·승인자
- 토큰·추가 사용량·실패·재시도·롤백 여부
실패 기준을 먼저 정하세요. 테스트 실패, 보호 파일 변경, 승인 없는 외부 명령, 비용 상한 초과 중 하나라도 발생하면 결과물을 배포하지 않고 마지막 정상 커밋으로 되돌립니다. AI가 만든 코드의 품질보다 복구 가능한 운영 절차가 먼저입니다.
도입 여부를 결정하는 파일럿 표
| 검증 항목 | 통과 기준 | 중단 기준 |
|---|---|---|
| 품질 | 기준선 대비 테스트 통과율과 리뷰 수정량을 기록 | 실패 유형이 반복되는데 원인·복구 절차가 없음 |
| 보안 | 비밀값·개인정보가 입력·출력·로그에 남지 않음 | 보호 파일 접근이나 승인 없는 외부 전송 |
| 비용 | 작업별 사용량과 검수 시간을 함께 기록 | 상한 초과 또는 재시도 폭증 |
| 운영 | 담당자·승인자·롤백 담당자가 정해짐 | 누가 중지·복구할지 불명확함 |
파일럿은 한 저장소와 한 업무 흐름에서 시작하고, 성공률만 보지 말고 실패를 복구하는 데 걸린 시간까지 기록합니다. 이 자료가 있어야 좌석 비용과 API 사용량을 실제 운영 비용으로 비교할 수 있습니다.
주간 운영 장부와 롤백 순서
- 주간 시작 전에 사용자·저장소·허용 명령·예산 상한을 기준표와 대조합니다.
- 작업이 끝나면 변경 파일, 테스트 결과, 토큰·재시도, 승인자를 한 행으로 기록합니다.
- 실패가 발생하면 새 작업을 멈추고 마지막 승인 커밋·작업본·환경 변수를 보존합니다.
- 복구 후 같은 입력으로 재현 테스트를 실행하고, 원인이 해결되기 전에는 운영 권한을 넓히지 않습니다.
구독 플랜과 API·Console 사용은 별도 비용 체계를 가질 수 있습니다. 비용 비교표에는 현재 공식 가격의 확인일과 적용 범위를 함께 적고, 가격이 바뀌면 출처·확인일을 먼저 갱신하세요.