안녕하세요. 전직 공무원 출신으로 IT 업계에 취업한 엔지니어입니다.
취업 초기에는 'AI 구동 개발(AI駆動開発)'이라는 단어에 동경심을 느꼈지만, 실제로 Claude Code와 같은 AI 에이전트를 사용하기 시작하자 기대했던 결과가 나오지 않아 고민했습니다. 하지만 매일의 시행착오와 실무 활용을 거치면서, **'AI를 단순한 채팅 도구로만 보는 것이 아니라 개발 파트너로서 다루는 설계'**가 필수적임을 깨달았습니다.
본 기사에서는 제가 실무에서 배운 Claude Code 활용 지식을 '7가지 패턴'으로 정리했습니다. 프롬프트 설계부터 MCP 서버 설정, 세션 관리까지, 초보자가 어려워하기 쉬운 포인트를 피하면서 구체적인 절차를 설명합니다.
제가 일상적인 개발 사이클 속에서 돌리고 있는 것은 다음 7가지 패턴입니다.
- 가이드라인 유지보수 (AI에게 주는 지시서를 항상 업데이트)
- MCP 서버를 통한 기능 확장 (필요한 도구만 연결)
- 스킬 시스템 도입 (프로젝트 고유의 규칙을 AI에게 학습시키기)
- 세션 관리 (병렬 작업 시 충돌 방지)
- Daily Triage 루프 (매일의 태스크 정리 자동화)
- 외부 베스트 프랙티스 통합 (공식 문서 등을 요약하게 하기)
- 설정 파일과 훅 활용 (AI의 과도한 작동을 코드로 방지하기)
처음부터 모든 것을 도입할 필요는 없습니다. 우선 '가이드라인 정비'와 'MCP 서버 설정' 정도부터 시작하는 것이 좋습니다.
여기서는 특히 중요한 두 가지 포인트를 깊이 있게 설명하겠습니다.
Claude Code를 활용할 때, MCP(Model Context Protocol) 서버 설정은 매우 강력합니다. 하지만 초보자는 '공식으로 제공된 MCP 서버를 모두 활성화'하기 쉽습니다.
실무에서는 '정말로 지금의 태스크에 필요한가?'를 기준으로 취사선택하는 것이 중요합니다. 예를 들어, GitHub MCP 서버는 편리하지만, 로컬 파일 조작이 주된 태스크라면 비활성화해 두는 것이 AI의 컨텍스트가 흐트러지지 않고 정밀한 코드 생성이 가능하게 합니다.
AI에게 '프로젝트 고유의 규칙'을 학습시키기 위해 저는 스킬 시스템이라는 개념을 도입했습니다. 이것은 프롬프트를 그때그때 입력하는 것이 아니라, 특정 조건에서 발동하는 플러그인 같은 것입니다.
하지만 AI에 맡겨두기만 하면 불필요한 파일이 생성되거나 오래된 규칙이 남아있게 됩니다 (소위 '기술적 부채 축적'). 그래서 저는 주기적으로 프로젝트 내부를 스캔하여 오래된 가이드라인이나 필요 없는 중간 결과물을 감지하는 스크립트를 Python으로 작성하여 관리하고 있습니다.
아래는 지정한 디렉토리 내에서 '일정 기간 업데이트되지 않은 문서'를 목록화하고 재검토를 촉구하는 간단한 Python 스크립트의 예시입니다.
import os
from datetime import datetime, timedelta
def find_stale_guides(target_dir: str, days: int = 14) -> list[str]:
...
이처럼 'AI가 생성한 것을 인간이 체크하는' 것뿐만 아니라, '시스템적으로 오래된 것을 감지하는' 장치를 만들면서 AI 구동 개발의 품질을 장기적으로 유지할 수 있습니다.
설정이 완료되면, 실제 개발 사이클에 통합하기만 하면 됩니다.
실무에서 가장 효과를 발휘하고 있는 것이 'Daily Triage 메타 루프'라는 개발 기법입니다. 이것은 아침 작업 시작 시 AI에게 '어제 변경 이력'이나 '미해결 과제'를 정리하게 하고, 오늘 해야 할 태스크를 제안받는 접근 방식입니다.
이때, 병렬로 여러 세션(작업 화면)을 띄우면 AI들 간의 판단이 충돌할 수 있습니다. 예를 들어, 같은 설정 파일을 다른 세션에서 동시에 업데이트하려고 하면 오류의 원인이 됩니다.
따라서 세션을 전환할 때는 'new-session' 개념을 도입하여 이전 세션의 컨텍스트(문맥)를 한 번 리셋하는 습관을 들이는 것이 중요합니다.
전직 공무원이었던 저에게 Claude Code를 활용한 AI 구동 개발은 '마법 지팡이'에서 '신뢰할 수 있는 파트너'로 바뀌었습니다.
중요한 것은, AI를 완벽한 존재로 다루는 것이 아니라, '지시가 모호하면 수정이 필요하다', '방치하면 부채가 쌓인다'라는 전제 하에, 인간이 관리하는 시스템(스킬 시스템이나 Python 스크립트 기반 감시)을 세트로 갖추는 것입니다.
처음에는 MCP 서버 설정이나 스킬 시스템 구축에 시간이 걸릴 수 있지만, 일단 구조를 만들어 놓으면 압도적인 속도로 개발할 수 있게 됩니다. 이 글이 앞으로 AI 구동 개발에 도전하는 분들의 참고가 되기를 바랍니다!
본 기사는 개인 Zenn에서도 공개하고 있습니다.
