, 바이브코딩의 꿈을 현실로 만드는 -- 아키텍처
Claude Code CLI는 Plan Mode를 통한 Planner 역할, 서브에이전트와 Agent Team을 활용한 Coder 역할, 직접적 파일 편집과 터미널 명령 실행을 수행하는 Executor 역할을 자연어 프롬프트 하나로 통합하여 조율합니다. 이를 통해 개발자는 코딩 세부사항을 명시하지 않아도 되는 진정한 바이브코딩 환경을 경험할 수 있으며, 탐색에서 구현, 검증에 이르기까지 전체 개발 워크플로우를 단일 자연어 인터페이스로 자율적으로 수행합니다.
이 글의 핵심 주장과 근거
자연어로 구현하는 코드, Claude Code CLI의 본질적 혁신
Claude Code CLI는 Anthropic이 공식적으로 제공하는 터미널 기반의 에이전트틱 코딩 도구로, 단순한 코드 자동 완성이나 보조 도구를 넘어선 자율적 실행 주체입니다. 사용자가 자연어로 구현하고자 하는 바를 설명하기만 하면 Claude Code가 전체 코드베이스를 깊이 이해하고 탐색하며, 어떤 방식으로 접근할지 구체적인 계획을 수립합니다. 이후 계획에 따라 여러 파일에 걸쳐 코드를 작성하고 수정하며, 필요한 경우 터미널 명령을 직접 실행하여 빌드나 테스트를 수행한 뒤 결과가 제대로 작동하는지 검증합니다. 이러한 자율성은 전통적인 IDE 플러그인이나 코드 보조 도구가 개발자의 지시를 기다리는 수동적 존재였다면, Claude Code는 개발자의 의도를 해석하고 스스로 판단하여 행동하는 능동적 파트너의 역할을 수행함을 의미합니다.
Planner-Coder-Executor, 바이브코딩을 가능하게 하는 3중 아키텍처
Claude Code가 구현하는 Planner-Coder-Executor 아키텍처는 바이브코딩의 핵심 원리를 체계적으로 실현합니다. 먼저 Plan Mode는 순수한 Planner로서 작동하며, 코드 변경을 전혀 하지 않은 채 파일들을 읽고 분석하여 디렉토리 구조, 데이터 모델, API 설계, 모듈 의존성 등 구체적인 구현 계획을 수립합니다. 이 단계에서 생성된 설계 문서를 바탕으로 개발자는 구현 전 최종 검토를 거칠 수 있으며, 승인 시에만 다음 단계로 진행됩니다. Coder 역할은 서브에이전트와 Agent Team 기능을 통해 수행되는데, 메인 세션과 격리된 컨텍스트에서 여러 에이전트가 병렬로 작업하며 복잡한 태스크를 분산 처리합니다. 리더 에이전트는 하위 태스크를 할당하고 각 서브에이전트의 결과를 수집하여 통합하는 Fan-Out/Fan-In 패턴을 구현함으로써 대규모 프로젝트에서도 일관성 있는 코드 생성이 가능합니다. 마지막으로 Executor는 직접적인 파일 편집과 터미널 명령 실행을 담당하며, 생성된 코드가 실제로 작동하는지 검증합니다.
CLAUDE.md와 MCP, 프로젝트 일관성과 외부 연동을 위한 양축
Claude Code는 프로젝트 전반에 걸친 일관성을 유지하기 위해 CLAUDE.md 파일을 활용합니다. 이 마크다운 파일을 프로젝트 루트에 배치하면 Claude Code가 모든 세션 시작 시 자동으로 읽으며, 코딩 표준, 아키텍처 결정 사항, 선호하는 라이브러리, 빌드 및 테스트 명령어, 워크플로우 규칙 등을 공유 컨텍스트로 제공합니다. 서브에이전트 역시 자체 오토 메모리를 통해 격리된 작업 환경에서도 학습 결과를 유지하므로, 분산 실행 상황에서도 프로젝트의 코딩 철학과 표준을 일관되게 따릅니다. 또한 Model Context Protocol(MCP)은 Claude Code가 외부 데이터 소스와 자율적으로 연동할 수 있는 개방형 표준 프로토콜입니다. 이를 통해 Claude Code는 Google Drive에 저장된 설계 문서를 직접 읽거나, Jira 티켓을 갱신하며 진행 상황을 보고하거나, Slack의 대화 데이터를 분석하여 맥락을 파악하는 등 개발 외적인 업무까지 자동화할 수 있습니다.
터미널에서 IDE까지, 어디서든 이어지는 동일한 코딩 엔진
Claude Code는 터미널 CLI, VS Code 확장, 데스크톱 앱, 웹 브라우저, JetBrains 플러그인, Slack 연동 등 다양한 환경에서 동일한 백엔드 엔진을 공유하며 작동합니다. 각 인터페이스는 표면적으로 다른 형태를 띠지만 실제로는 모두 같은 Claude Code 엔진에 연결되어 있어, CLAUDE.md 파일과 설정, MCP 서버가 모든 플랫폼에서 일관되게 적용됩니다. 사용자는 터미널에서 작업을 시작하다가 필요시 VS Code로 전환하거나, Slack에서 간단한 지시를 내린 후 다시 데스크톱 앱으로 돌아와 세부 작업을 이어갈 수 있습니다. 이러한 크로스 플랫폼 통합은 개발자가 특정 환경에 종속되지 않고 가장 편리한 인터페이스를 선택하며 작업 흐름을 유지할 수 있게 하며, 에이전트 코딩의 유연성을 극대화합니다. > 이 주제의 전체 맥락 방향성은 **바이브코딩에서 오픈클로까지** 원본 글에 세밀하게 정리되어 있습니다. 더 깊게 탐구하고 싶다면 관련 내부 대표 문서(Pillar/Entity)를 참조하세요.