AI 개발환경 사내 도입 (AX) 회고

오너클랜 재직 중 Claude / Codex 기반 AI 개발환경을 사내에 설계하고, 팀 전체에 확산시킨 경험이다. 단순히 AI 도구를 도입하는 것을 넘어, 팀이 일관되게 활용할 수 있는 체계를 구축하는 데 초점을 맞췄다.

배경

AI 코딩 도구(Claude, Copilot 등)가 빠르게 성숙하던 시점에, 개인적으로 Claude Code를 사용하면서 생산성 향상 가능성을 확인했다. 문제는 팀원마다 사용 방식이 달랐고, 공통 컨텍스트가 없어 같은 프로젝트에서도 AI가 다르게 동작했다는 점이다. 이를 표준화하기 위해 사내 AI 개발환경 구축을 시작했다.

도입 내용

프로젝트별 CLAUDE.md 체계 수립

각 프로젝트에 CLAUDE.md를 작성하여 AI가 해당 프로젝트를 이해할 수 있는 컨텍스트를 제공했다.

• 프로젝트 구조, 기술 스택, 코딩 컨벤션을 명세
• 주의사항(수정하면 안 되는 파일, 금지 패턴 등) 포함
• 팀 공유 저장소에서 버전 관리

팀 단위 공유 Claude 설정

개인 Claude 설정이 아닌, 팀이 공통으로 사용할 수 있는 설정 체계를 구축했다.

• 공용 settings.json 작성 및 공유
• 프로젝트 공통 슬래시 커맨드(skills) 정의
• 사내 Claude 환경을 회사 단위 라이선스로 통합

MCP 서버 연동

Claude가 사내 시스템(DB, 이슈 트래커, 문서 등)에 직접 접근할 수 있도록 MCP 서버를 구성했다.

• 사내 DB에 Claude가 직접 쿼리 가능
• 팀원이 추가 설정 없이 바로 활용할 수 있는 공유 MCP 설정 제공

Codex / Cursor 코드 자동완성 환경

IDE 레벨에서의 코드 자동완성 환경도 표준화했다.

• Cursor 기반 IDE 환경을 팀 표준으로 채택
• .cursorrules 공유로 팀원 간 일관된 AI 동작 확보

결과

개발 속도 향상

공통 컨텍스트(CLAUDE.md)가 생기면서 AI가 프로젝트를 처음부터 설명받지 않아도 올바른 방식으로 코드를 작성하게 됐다. 반복적인 보일러플레이트 코드 작성, 문서화 등의 작업 속도가 크게 향상됐다.

팀 전체 확산

공유 설정 체계가 구축되면서 비개발 직군(기획, 운영)까지 Claude를 업무에 활용하게 됐다. 문서 작성, 기획서 초안, 이메일 작성 등 비개발 업무 자동화 및 온보딩 신규 팀원의 프로젝트 컨텍스트 파악 속도가 향상됐다.

사내 Claude 환경 표준화

팀 공유 CLAUDE.md, settings.json, skills가 단일 저장소에서 관리되어 팀원 누구나 동일한 환경에서 시작할 수 있게 됐다.

핵심 교훈

• 컨텍스트 파일(CLAUDE.md)이 핵심이다: 도구보다 컨텍스트가 AI 응답 품질을 결정한다
• 표준화 없이 도입하면 혼란만 생긴다: 팀마다 다른 방식으로 사용하면 공유·협업이 어렵다
• 비개발 직군에게도 확산 가능하다: 진입 장벽을 낮추면 개발 외 업무에도 AI가 활용된다
• 설정을 코드처럼 관리하라: CLAUDE.md, settings.json을 버전 관리하면 점진적으로 개선할 수 있다