클로드 코드 완전 정복 강의: 로컬 모델·슬래시 명령·스펙 기반 개발·MCP 서버까지

핵심 메시지

• 이 강의는 에이전트 시대의 코딩 방식으로 클로드 코드를 처음부터 끝까지 다루는 장편 완주 강의다.
• CLAUDE.md 파일은 매 세션 새로 시작하는 "콜드 스타트" 문제를 해결해, 프로젝트 맥락을 세션마다 다시 읽어 들이게 한다.
• init·memory·permissions·context·compact·plan·review·security review·rewind·resume 등 다양한 슬래시 명령으로 작업을 제어한다.
• 무작정 맡기는 "바이브 코딩" 대신, 먼저 스펙을 작성하고 그에 따라 개발하는 스펙 기반 개발로 통제권을 유지한다.
• 프런트엔드와 백엔드를 각각 만들어 깃 브랜치·워크트리로 연결·병합하고, 보안과 MCP 서버 연동까지 실전 흐름을 보여준다.

쉽게 이해하기

강사는 지금이 에이전트 시대이며 코딩 방식도 달라지고 있다고 설명하며 시작한다. 모든 것을 직접 타이핑하는 전통적 방식이나 챗봇에 문제를 던져 코드를 받아 오는 방식을 넘어, 클로드 코드 같은 에이전트를 활용하는 흐름을 다룬다. 강의는 클로드 코드의 개념부터 실제 애플리케이션을 완성하기까지를 한 편에 담은 장편 구성이다.

비용을 줄이는 방법으로 Ollama를 이용한 로컬 모델 연결을 다룬다. 소네트·오퍼스 같은 유료 모델 대신 로컬 오픈소스 모델을 돌려 클로드 코드에 연결하면 요금 없이 쓸 수 있지만 속도는 느려진다는 절충을 설명한다. 이어 CLAUDE.md의 역할을 짚는다. 세션마다 프로젝트를 처음부터 다시 파악하는 콜드 스타트 문제를, 클로드가 세션 시작 시 CLAUDE.md를 먼저 읽어 맥락을 불러오는 방식으로 해결한다.

강의는 클로드 코드의 슬래시 명령을 폭넓게 소개한다. init, memory, permissions, context, compact, plan과 effort(추론 강도) 조절, usage, diff, review, security review 같은 코드·보안 리뷰 명령, 그리고 변경을 되돌리는 rewind(이스케이프 두 번과 동일)와 이전 작업을 이어 가는 resume 등을 실제 화면과 함께 설명한다.

핵심 방법론으로 스펙 기반 개발을 강조한다. 모든 것을 그냥 맡겨 버리는 바이브 코딩은 출력물이 나올 수는 있어도 통제가 어렵기 때문에, 먼저 스펙을 작성하고 그에 맞춰 개발해 통제권을 유지하라는 것이다. 실습에서는 스펙을 준비한 뒤 프런트엔드와 백엔드를 각각 만들고, 깃 메인 브랜치와 별도 브랜치·워크트리를 활용해 둘을 연결한 다음 커밋하고 메인에 병합하는 과정을 보여준다.

후반부에서는 보안과 확장을 다룬다. "JWT로 앱을 보안 처리하라"는 한 줄 프롬프트로 끝내면 그것 역시 바이브 코딩이므로, 애플리케이션을 어떻게 보호할지 스펙을 먼저 작성해 진행한다. 또한 GitHub MCP 서버를 추가하고, 액세스 토큰을 노출하지 않도록 별도 터미널에서 설정한 뒤 세션을 재시작해 연결을 확인하며, 해당 MCP 서버가 제공하는 도구를 점검하는 방법까지 시연한다.

주요 인사이트

• CLAUDE.md는 단순한 설정 파일이 아니라, 세션이 바뀔 때마다 반복되는 맥락 유실(콜드 스타트)을 막는 프로젝트 메모리 역할을 한다.
• 바이브 코딩과 스펙 기반 개발의 차이가 강의를 관통하는 핵심이다. 통제권을 유지하려면 기능이든 보안이든 먼저 스펙으로 정의하는 습관이 중요하다.
• 프런트엔드와 백엔드를 분리해 만들고 깃 브랜치·워크트리로 병합하는 과정은, 에이전트가 만든 코드를 안전하게 통합하는 실전 워크플로를 보여준다.
• MCP 서버를 추가할 때는 액세스 토큰을 도구에 노출하지 않도록 별도 터미널에서 설정하고, 추가 후에는 세션을 재시작해야 연결이 반영된다.

자주 묻는 질문

관련 AI 소식