이 장에서 배우는 것
•
팀 도입 3단계 (시범 → 공유 → 정착)
•
도입 시 흔한 저항과 현실적인 대응법
•
프로젝트 CLAUDE.md로 팀 규칙 공유하기
•
문서 기반 협업 (작성 → 편집 → 검토)
•
공유 스킬과 MCP 설정을 팀에 배포하는 방법
•
도입이 잘 안 되는 경우와 팀 온보딩 비용
Claude Code를 혼자 쓰는 것과 팀으로 쓰는 것은 다릅니다. 이 장에서는 팀 환경에서 Claude Code를 도입하고, 일관된 작업 방식을 만드는 방법을 다룹니다.
팀에 Claude Code 도입하기
팀 전체에 한꺼번에 도입하면 혼란이 생기기 쉽습니다. 단계적으로 접근하는 것이 현실적입니다.
1단계: 한두 명이 먼저 써본다
관심 있는 팀원 1~2명이 자기 업무에 먼저 적용합니다.
시작하기 좋은 작업:
•
회의록 정리
•
반복적인 문서 작성
•
데이터 파일 정리
1~2주 정도 써보면 "이건 쓸 만하다" 또는 "이 작업에는 맞지 않는다"는 판단이 생깁니다.
이 단계에서 흔히 빠지는 함정 먼저 써본 사람이 열정적으로 "모든 업무에 Claude Code를 쓰자"고 밀어붙이는 경우가 있습니다. 실제로는 업무 성격에 따라 효과가 크게 다릅니다. "어떤 작업에 효과가 있었고 어떤 작업에는 없었는지"를 솔직하게 정리하는 것이 다음 단계에 중요합니다.
2단계: 팀에 공유하고 확장한다
효과가 확인된 작업을 팀에 공유합니다. 이때 중요한 것은 "Claude Code를 써라"가 아니라 "이 작업이 이렇게 바뀌었다"를 보여주는 것입니다.
이 단계에서 할 일:
•
프로젝트 CLAUDE.md를 작성해서 팀 규칙을 정한다
•
효과가 좋았던 워크플로우를 공유 스킬로 만든다
•
각자 구독(Pro 또는 Max)을 설정한다
비용에 대해 미리 이야기하세요 Claude Code는 개인 구독 기반입니다. 팀원이 5명이면 월 $100~$1,000입니다. 회사에서 비용을 지원하는지, 개인이 부담하는지를 2단계 시작 전에 정해야 합니다.
3단계: 워크플로우를 정착시킨다
유지를 위한 습관:
•
월 1회 회고: "이번 달 어떤 작업에 썼고 효과가 어땠나" 공유
•
잘 되는 작업/안 되는 작업 구분: 무리해서 모든 작업에 쓰지 않기
•
사용하지 않는 팀원 팔로업: "어떤 부분이 어려운지" 듣고 개선
도입 시 흔한 저항과 대응
팀에 새 도구를 도입하면 저항이 생기기 마련입니다.
"배우는 데 시간이 걸린다"
사실입니다. 하지만 터미널에 익숙해지는 데는 하루, 기본 작업을 할 수 있게 되는 데는 일주일 정도면 충분합니다.
"기존 방식이 더 빠르다"
익숙한 방식이 당장은 빠를 수 있습니다. 반복 작업이 쌓일수록 Claude Code의 효율이 올라갑니다. 1장의 A/B/C 사례나 15장의 실전 사례를 보여주면 설득력이 생깁니다.
"보안이 걱정된다"
합리적인 우려입니다. 파트 3 부록의 보안 주의사항을 팀 가이드라인에 포함하고, 민감한 데이터 처리 규칙을 CLAUDE.md에 명시하면 됩니다.
도입이 잘 안 되는 경우
솔직히 말하면, 팀 도입이 실패하는 경우도 많습니다.
"한 사람만 아는 도구" 문제
처음 도입한 사람만 Claude Code를 잘 쓰고, 나머지 팀원은 "잘 모르겠으니까 그냥 예전 방식으로 할게요"가 됩니다. 그 한 사람이 퇴사하면 아무도 유지보수를 못 합니다.
최소 2명이 함께 세팅하고, 설정 이유를 주석으로 남기세요 "이 규칙은 영업팀 파일의 날짜 형식이 2024.01.15여서 추가했음" 같은 메모가 나중에 큰 도움이 됩니다.
업무 속도 갈등
Claude Code를 쓰는 팀원은 보고서를 1시간에 만들고, 안 쓰는 팀원은 3시간 걸립니다. 도구를 쓰는 것은 개인 선택이지, 의무가 되면 안 됩니다.
투자 대비 효과가 안 나오는 팀
문서 작업과 데이터 처리가 업무의 30% 이상인 팀에서 효과가 좋습니다. 대면 소통, 현장 방문 중심의 업무라면 도입 비용을 회수하기 어려울 수 있습니다.
도입 전에 "우리 팀에서 자동화할 수 있는 작업이 얼마나 되는가"를 먼저 따져보세요
프로젝트 CLAUDE.md로 팀 규칙 공유하기
9장에서 개인용 CLAUDE.md를 다뤘습니다. 팀으로 쓸 때는 프로젝트 폴더에 CLAUDE.md를 두어서 팀 전체가 같은 규칙을 따르게 합니다.
개인 설정과 팀 설정의 구분
구분 | 위치 | 적용 범위 |
개인 설정 | ~/.claude/CLAUDE.md | 나만 사용 |
프로젝트 설정 | 프로젝트 폴더의 CLAUDE.md | 팀 전체 |
Claude Code는 두 파일을 모두 읽습니다. 개인 설정과 프로젝트 설정이 겹치면 프로젝트 설정이 우선합니다.
팀용 CLAUDE.md 예시
# 마케팅 대시보드 프로젝트
## 프로젝트 소개
- 마케팅 팀의 주간/월간 성과를 보여주는 대시보드
## 작업 규칙
- 보고서는 한국어로 작성
- 날짜 형식: YYYY-MM-DD
- 파일명에 날짜를 포함 (예: 주간보고서-20250120.md)
## 폴더 구조
- /데이터: 원본 데이터 파일
- /보고서: 완성된 보고서
## 자주 쓰는 명령
- /weekly-report: 주간 보고서 생성
Plain Text
복사
팀용 CLAUDE.md 관리의 현실
git을 모른다면 두 가지 방법이 있습니다 방법 1: CLAUDE.md를 수정할 수 있는 사람을 한 명 정합니다. 팀원들이 "이 규칙을 추가해주세요"라고 요청하면 그 사람이 반영합니다. 방법 2: 노션 같은 공유 문서로 먼저 논의하고, 합의된 내용을 CLAUDE.md에 반영합니다.
어느 방법이든, CLAUDE.md가 현재 업무 상황과 맞지 않게 방치되면 효과가 없습니다. "분기별로 한 번은 이 파일이 현실과 맞는지 점검한다"는 규칙이 필요합니다.
문서 기반 협업
팀으로 문서를 작성할 때 Claude Code를 각 단계에 활용할 수 있습니다.
작성 → 편집 → 검토
작성자가 Claude Code로 초안을 만듭니다:
제품 사용 설명서 초안을 작성해줘.
대상: 일반 사용자
목차: 설치 방법, 기본 사용법, 자주 묻는 질문
Plain Text
복사
편집자가 초안을 받아서 Claude Code로 다듬습니다:
이 문서를 읽고 다듬어줘.
- 전문 용어를 쉬운 말로 바꿔줘
- 문장을 짧게 끊어줘
- 빠진 내용이 있으면 알려줘
Plain Text
복사
검토자가 최종 확인을 합니다:
이 문서의 오탈자를 찾아줘.
표현이 자연스러운지 확인하고, 어색한 부분을 표시해줘.
Plain Text
복사
단계마다 CLAUDE.md 설정이 달라서 톤이 섞일 수 있습니다 작성자가 "~습니다" 체로 쓰게 했는데 편집자의 CLAUDE.md에는 "~해요" 체가 기본으로 되어 있으면 톤이 섞입니다. 팀 프로젝트 CLAUDE.md에 문서 톤을 통일해두면 방지됩니다.
스펙 문서로 소통하기
팀원 간에 구두로 요청하면 오해가 생기기 쉽습니다.
요구사항.md 파일을 읽고, 이 스펙대로 보고서를 만들어줘.
Plain Text
복사
문서가 "단일 진실 소스(Single Source of Truth)"가 됩니다. 요구사항이 바뀌면 문서를 수정하고 다시 실행하세요.
팀 워크플로우 만들기
공유 스킬
프로젝트 폴더에 스킬을 두면 팀 전체가 공유하게 됩니다:
프로젝트 폴더/
├── .claude/
│ └── commands/
│ ├── weekly-report.md
│ └── meeting-notes.md
├── CLAUDE.md
└── (기타 프로젝트 파일)
Plain Text
복사
공유 스킬의 함정
팀원 A가 만든 스킬이 팀원 B의 환경에서 안 되는 경우가 있습니다.
흔한 원인:
•
스킬에서 참조하는 폴더 경로가 A의 로컬 경로(/Users/A/데이터/)로 하드코딩된 경우. 상대 경로(./데이터/)를 쓰세요.
•
A는 노션 MCP가 설치되어 있는데, B는 아직 설치하지 않은 경우.
스킬을 공유할 때는 다른 팀원 환경에서 한 번 테스트하세요
팀 MCP 설정 공유
--scope project 옵션을 쓰면 .mcp.json 파일이 프로젝트 루트에 생깁니다. 이 파일을 공유하면 팀원 모두가 같은 MCP 서버를 사용하게 됩니다.
API 키는 절대 .mcp.json에 넣지 마세요 API 키는 각 팀원의 로컬 환경에 개별적으로 설정해야 합니다.
팀 온보딩 비용
현실적인 온보딩 일정:
기간 | 목표 |
1주차 | 터미널 기초, Claude Code 설치, 간단한 작업 실습 |
2주차 | 팀 CLAUDE.md 이해, 공유 스킬 사용법 익히기 |
3~4주차 | 자기 업무에 적용, 안 되는 것 공유 |
한 사람이 완전히 자기 업무에 통합하는 데 약 한 달이 걸립니다 이 기간 동안은 기존 방식보다 오히려 느릴 수 있습니다. 관리자가 "왜 아직도 적응 못 했어?"라고 압박하지 않는 것이 중요합니다. 팀원이 5명이면, 한 사람이 1시간씩 가르쳐줘야 한다고 가정하면 한 달에 20시간입니다. 이 시간을 "도입 비용"으로 계산에 넣으세요.
직접 해보기
프로젝트 폴더에 CLAUDE.md를 만들고 팀 규칙 2~3개 작성하기
공유 명령어 폴더 만들기 (예: ".claude/commands/" 폴더 생성)
팀원과 공유 스킬 하나를 같이 만들어보기
정리
•
팀 도입은 한두 명의 시범 사용에서 시작해서, 효과가 검증된 작업부터 확대하는 것이 현실적입니다.
•
프로젝트 CLAUDE.md, 공유 스킬, .mcp.json을 공유하면 팀 전체가 일관된 방식으로 Claude Code를 사용할 수 있습니다.
•
문서를 중심에 두면 구두 전달에서 생기는 오해를 줄이고, Claude Code의 결과물도 일관됩니다.
•
팀 도입에는 비용(구독료 + 온보딩 시간)이 들고, 모든 팀에 적합한 것은 아닙니다. 도입 전에 자동화할 수 있는 업무 비중을 먼저 따져보세요.
파트 5를 마치며: 이 책에서 다룬 내용을 모두 살펴봤습니다. 처음에는 터미널이 낯설었을 텐데, 이제 파일 관리부터 외부 도구 연동, 팀 협업까지 Claude Code로 처리할 수 있게 됐습니다.