Intercom의 15년 된 Rails 모놀리스에서 Claude Code로 코드 95% 생성하기

실용적 조언

대규모 코드베이스에 AI를 도입할 때는 아키텍처 드리프트를 방지하기 위한 자동화된 가드레일을 먼저 설계해야 한다.
AI 에이전트가 모든 것을 처리하게 두지 말고, 복잡한 논리나 결정이 필요한 지점에서는 수동으로 전환하는 기준을 세워야 한다.

섹션별 상세

Intercom은 15년 된 Ruby on Rails 모놀리스 환경에서 Claude Code를 도입하여 전체 코드의 95% 이상을 AI로 생성하고 있다. 엔지니어뿐만 아니라 사내의 다양한 팀이 코드 생성 과정에 참여하며 개발 문화 자체가 AI 중심으로 재편되었다. 실제 프로덕션 쿼리 실행부터 기능 구현까지 AI 에이전트가 깊숙이 관여하는 구조로 운영 중이다.

AI가 생성하는 코드의 양이 압도적으로 늘어남에 따라 코드 리뷰 방식과 프로덕션 운영 방식이 변화하고 있다. 단순히 코드를 작성하는 것을 넘어 AI가 아키텍처 방향성에서 벗어나지 않도록 제어하는 가드레일 구축이 핵심 과제로 부상했다. 특히 자동화된 프로세스 속에서 인간 개발자가 개입하여 '오토파일럿' 상태를 해제해야 하는 시점을 판단하는 능력이 중요해졌다.

용어 해설

AI 우선 개발(AI-First Development): — 소프트웨어 개발 생명주기 전반에 AI를 핵심 도구로 배치하는 전략이다. 단순한 코드 보조를 넘어 설계, 구현, 리뷰 단계에서 AI 에이전트가 주도적인 역할을 수행하며 생산성을 극대화하는 것을 목표로 한다.
모놀리스 아키텍처(Monolith): — 애플리케이션의 모든 기능이 하나의 거대한 코드베이스와 서비스 단위로 통합된 구조이다. 관리가 복잡해질 수 있으나 AI 에이전트가 전체 컨텍스트를 파악하여 코드를 생성할 때 일관성을 유지하기 유리한 측면이 있다.
가드레일(Guardrails): — AI 모델이 생성하는 결과물이 안전성, 보안, 코딩 컨벤션을 준수하도록 제한하는 통제 장치이다. 자동화된 코드 생성 과정에서 발생할 수 있는 오류나 아키텍처 이탈을 방지하여 시스템의 안정성을 유지하는 역할을 한다.

언급된 도구

Claude Code추천

AI 기반 자율 코딩 및 코드 생성 에이전트

Ruby on Rails중립

Intercom의 메인 웹 애플리케이션 프레임워크

언급된 리소스

DemoBrian Scanlan: Building AI-first at Intercom (YouTube)

문서Ruby on Rails Podcast Episode 19060786