문제는 그다음입니다. 어떤 개발자는 개인 계정으로 로그인하고, 어떤 팀은 회사 규정에 없는 외부 도구(MCP 서버)를 연결하고, 한 달 뒤 청구서는 누가 얼마를 썼는지 설명할 수 없는 상태가 됩니다.
이 글은 Anthropic이 파트너사에 배포하는 「Claude Code 배포 체크리스트」(Partner Toolkit v4.0, 2026년 9월)를 바탕으로, 코코아소프트가 고객사 도입 현장에서 실제로 밟는 순서를 정리한 것입니다. 구조는 단순합니다. 설치 전에 회사가 정할 결정 4가지, 첫 주에 설정할 항목 5가지, 그리고 4주 롤아웃 3단계. 앞의 4가지는 개발자가 아니라 플랫폼·보안·계정 담당 팀이 정해야 하고, 단 한 명이 설치하기 전에 끝나 있어야 합니다. 그래서 저희는 킥오프 첫날(Day One)에 그 세 팀을 반드시 같은 자리에 앉힙니다.
설치 전에 회사가 정할 4가지
이 네 가지는 나중에 바꾸려면 개발자 전원의 노트북을 다시 건드려야 합니다. 먼저 정하고, 문서로 남기고, 테스트 장비 한 대에서 확인한 뒤 시작합니다.
1. 모델 트래픽을 어디로 보낼 것인가
Claude Code는 다섯 경로 중 하나로 모델을 호출합니다. Claude Enterprise/Team 플랜, Anthropic Console(API 키), Amazon Bedrock, Google Cloud, Microsoft Foundry. 대부분의 기업은 Enterprise 또는 Team 플랜이 답입니다. 관리자 콘솔의 사용 분석 대시보드와 중앙 정책 관리를 제공하는 유일한 경로이기 때문입니다. 이미 클라우드 계약이 있거나 데이터 주권 요건이 있다면 Bedrock·Google Cloud·Foundry가 후보가 됩니다.
끝난 기준: 경로가 문서로 정해져 있고, 누가 비용을 내며 사용량을 어떻게 보고할지까지 적혀 있다.
2. 사람들이 어떻게 로그인할 것인가
Enterprise/Team이라면 관리자 콘솔에서 초대하고 회사 계정으로 로그인합니다. 여기서 중요한 건 관리 설정(managed settings)으로 조직을 고정해서, 누구도 개인 계정이나 어디서 나온 지 모를 API 키로 실행할 수 없게 만드는 것입니다. 이게 빠지면 회사 코드가 개인 계정을 타고 나갑니다. Console 경로라면 Claude Code 역할로 멤버를 초대하고, 클라우드 경로라면 회사의 기존 IAM으로 자격 증명을 발급합니다.
끝난 기준: 개인 계정으로는 실행이 막히는 것을 테스트 장비에서 확인했다.
3. 정책을 노트북까지 어떻게 배포할 것인가
두 가지 방법이 있습니다. 관리자 콘솔에서 서버가 내려보내는 설정, 또는 회사의 기기 관리 도구(MDM)로 배포하는 관리 설정 파일. macOS·Windows·Linux 각각 경로가 다릅니다. 어떤 방법을 고르든 한 대에서 먼저 해보고, 진단 명령으로 정책이 실제로 적용됐는지 눈으로 봅니다.
끝난 기준: 테스트 장비에서 진단 명령을 실행했을 때 정책이 적용된 것으로 나온다.
4. 트래픽이 회사 네트워크를 어떻게 나갈 것인가
네트워크팀이 도메인 허용 목록을 받고, 직접 연결·사내 프록시·내부 LLM 게이트웨이 중 무엇을 쓸지 정합니다. 사설 인증서나 mTLS를 쓰는 회사라면 이 단계에서 미리 찾아두어야 합니다. 저희 경험상 금융·공공 고객사에서 가장 자주 멈추는 지점이 여기입니다.
끝난 기준: 테스트 장비가 회사 네트워크 안에서 실제로 연결된다.
첫 주에 설정할 5가지
네 가지 결정이 끝나면 이제 개발자가 실제로 쓰는 환경을 만듭니다. 파일럿이 시작되는 첫 주 안에 다섯 항목을 마무리합니다.
5. 권한 정책 — 가장 중요합니다. 비밀키 파일, 그리고 회사가 지정한 파괴적 git·셸 명령을 차단 목록에 넣습니다. 권한 확인을 건너뛰는 모드(bypass permissions)는 전사 비활성화하고, 기본 권한 모드를 하나 정합니다. 이 정책 파일은 버전 관리에 넣고, 고객사 쪽 담당자 이름을 박습니다. 담당자 없는 정책은 석 달 안에 죽습니다.
6. MCP와 도구 거버넌스 — MCP는 Claude Code가 외부 도구(Jira, DB, 사내 API 등)에 연결되는 표준입니다. 개발자가 알아서 추가하게 둘지, 승인 목록만 허용할지 정합니다. 승인된 서버는 중앙에서 배포하고 파일럿 저장소에 커밋합니다. 보안팀에 반드시 전할 한 마디: Anthropic은 서드파티 MCP 서버를 감사하지 않습니다. 회사의 평소 외부 소프트웨어 검토 절차를 그대로 적용해야 합니다.
7. 텔레메트리 — 사용 데이터를 회사 자체 모니터링 도구에서 보고 싶다면 OpenTelemetry 내보내기를 켜고 회사 수집기로 보냅니다. 단, 프롬프트·응답·도구 세부 내용 로깅은 개인정보 담당자의 서면 동의 없이는 꺼둡니다. 부서별 비용 배분이 필요하면 코스트센터 속성도 이때 설정합니다. 이런 게 필요 없다면 관리자 콘솔의 Claude Code 분석 대시보드가 기본값인데, 이것도 누군가 켜야 켜집니다.
8. 비용 통제 — 트래픽이 가는 곳에 지출 한도를 겁니다. Enterprise/Team은 조직·그룹·멤버 단위, Console은 워크스페이스 단위, 클라우드는 제공사 예산으로. 그리고 매주 지출 보고서를 읽을 사람을 정합니다. 파일럿 그룹의 지출을 기준선으로 잡은 뒤에 확대해야, 전사 확대 시 비용을 예측할 수 있습니다.
9. 저장소 준비 — 파일럿 저장소마다 프로젝트 메모리 파일(CLAUDE.md)을 만듭니다. 자동 생성한 뒤 짧게 다듬는 게 요령입니다. 전사 공통 표준이 있다면 조직 단위 파일도 하나 둡니다. 프로젝트 설정과 MCP 구성은 저장소에 커밋합니다. 가장 중요한 건 개발 리더와 합의하는 것입니다. 어떤 저장소가 파일럿에 들어가고, 어떤 저장소는 절대 건드리지 않는지.
4주 롤아웃: 파일럿 → 확대 → 이관
환경이 준비되면 개발자를 한꺼번에 풀지 않습니다. 4주를 세 단계로 나눕니다.
파일럿 (1주차) — 2~3개 팀에서 개발자 10~30명. 회사 표준 설치 방법으로 깔고, 회사 계정으로 로그인하고, 첫 과제는 정해줍니다. 코드베이스에 대한 질문, 작은 수정, 그리고 큰 작업 전에 플랜 모드 사용. 이때 파일럿 인원의 Day-0 기준선(현재 작업 소요 시간)을 반드시 재둡니다. 이걸 빼먹으면 90일 뒤 성과를 증명할 방법이 없습니다.
확대 (2~3주차) — 도입 계획에 정한 순서대로 나머지 팀을 합류시키고, 팀마다 챔피언을 한 명씩 정합니다. 파일럿에서 배운 것으로 권한 정책과 프로젝트 메모리 파일을 고칩니다. 그리고 매일 분석 대시보드를 봅니다. 설치만 하고 멈춘 팀이 있는지 찾기 위해서입니다.
이관 (4주차) — 정책 파일, MCP 목록, 지출 보고서, 프로젝트 메모리 규칙. 이 네 가지를 고객사가 직접 소유하고, 각각 관리자 이름이 박혀 있어야 합니다. Claude Code 사용 수치는 4주차 보고에 들어갑니다.
파트너사가 빠지는 순간 고객사가 혼자 운영할 수 있는지가 이관의 기준입니다. 코코아소프트는 이 네 가지 소유권 이전을 확인해야 프로젝트를 끝냅니다.
한 장으로 보는 12항목 체크리스트
# | 단계 | 항목 | "끝났다"의 기준 | 담당 |
|---|---|---|---|---|
1 | 설치 전 | 모델 트래픽 경로 | 경로·비용 주체·보고 방식이 문서화됨 | 플랫폼팀 |
2 | 설치 전 | 로그인 방식 | 개인 계정·임의 API 키 실행이 막힘 | 계정팀 |
3 | 설치 전 | 정책 배포 방식 | 테스트 장비 진단 명령에 정책 적용 표시 | 보안팀 |
4 | 설치 전 | 네트워크 경로 | 도메인 허용 목록 적용, 테스트 장비 연결 성공 | 네트워크팀 |
5 | 1주차 | 권한 정책 | 차단 목록 있고, bypass 비활성화, 버전 관리 + 담당자 | 보안팀 |
6 | 1주차 | MCP 거버넌스 | 허용 방식 결정, 승인 서버 중앙 배포 | 보안팀·개발리더 |
7 | 1주차 | 텔레메트리 | 세션 수가 대시보드 또는 자체 수집기에 보임 | 플랫폼팀 |
8 | 1주차 | 비용 통제 | 지출 한도 설정, 주간 보고서 담당자 지정 | 재무·플랫폼팀 |
9 | 1주차 | 저장소 준비 | 파일럿 저장소마다 CLAUDE.md, 포함/제외 저장소 합의 | 개발리더 |
10 | 1주차 | 파일럿 | 10~30명 설치·로그인, 첫 과제 안내, Day-0 기준선 측정 | 코코아·개발리더 |
11 | 2~3주차 | 확대 | 팀별 챔피언 지정, 정책·메모리 파일 개정, 매일 대시보드 확인 | 코코아·챔피언 |
12 | 4주차 | 이관 | 정책·MCP 목록·지출 보고서·메모리 규칙에 각각 고객사 관리자 지정 | 고객사 |
체크리스트는 공개입니다. 순서가 노하우입니다
위 12항목은 모두 Anthropic 공식 문서에 있는 내용입니다. 숨길 게 없습니다. 차이는 어떤 순서로, 누구를 언제 부르고, 각 항목에서 "끝났다"를 무엇으로 판단하느냐에서 납니다. 그리고 10번 항목의 Day-0 기준선을 어떻게 재서 90일 뒤 재무팀이 믿는 숫자로 만드느냐에서 납니다.
코코아소프트는 Claude Partner Network 파트너로서 이 체크리스트를 고객사 환경에 맞춰 실행합니다. 다음 세 가지 중 필요한 것을 골라 주세요.
도입 성과 측정 플레이북 받기 — Day-0 기준선을 재는 방법과 양식, 90일 보고서 구성까지 (이메일 등록 후 다운로드)
Claude 도입 성과 계산기 — 우리 팀 업무를 넣으면 예상 절감 시간과 금액이 나옵니다
도입 상담 신청 — 위 4가지 사전 결정을 저희가 같이 정리해 드립니다. 문의: ax@cocoasoft.co.kr / 02-6229-5100
출처: Anthropic Partner Toolkit v4.0 「Claude Code deployment checklist for partners」(2026년 9월). 세부 설정 방법은 Anthropic 공식 문서(docs.claude.com)가 기준입니다.