클로드 코드 입문: 설치·플랜 모드·CLAUDE.md로 시작하는 AI 코딩 3단계

핵심 메시지

• 클로드 코드는 터미널과 VS Code에서 동작하며, 코드를 직접 쓰는 대신 사람이 요구사항과 방향을 지시하는 도구다.
• 막연한 한 줄 프롬프트 대신 우선순위 요구사항을 정리하고 '필요한 걸 질문해 달라'고 시키면 플랜 모드에서 훨씬 풍부한 설계 논의가 나온다.
• CLAUDE.md 파일에 기술 스택·구조·작업 방식을 적어두면 매 세션마다 자동으로 주입돼, 클로드가 프로젝트 규칙을 기억한다.
• 코드를 자주 커밋해 마지막으로 정상 동작하던 상태로 언제든 되돌릴 수 있게 하고, 작업은 브랜치에서 진행한다.
• 클로드가 만든 결과물도 동료 엔지니어의 코드처럼 검토하고, 마음에 안 들면 직접 고치기보다 프롬프트로 수정시킨다.

쉽게 이해하기

발표자는 Anthropic과 협업해 '바이브 엔지니어링'을 시작하기 전 알았으면 좋았을 세 가지를 정리한다. 설치는 맥의 bash 스크립트, 윈도우의 PowerShell 스크립트로 가능하며, 스크립트가 잘 안 되면 Node.js를 설치한 뒤 npm으로 설치하는 경로도 있다. 터미널만으로도 쓸 수 있지만 VS Code와 통합하면 더 강력하다.

첫 앱을 만들 때 막연한 한 줄 프롬프트는 기술 스택·저장 방식·아키텍처 같은 핵심을 놓친다. 대신 우선순위 요구사항을 글머리표로 적고 끝에 '요구사항·원칙·제약을 명확히 하도록 질문해 달라'를 붙인 뒤, shift+tab으로 플랜 모드에 들어간다. 플랜 모드에서는 코드를 자동으로 쓰지 않고 먼저 사람과 상의한다.

계획이 나오면 코드 작성 전에 검토한다. 예컨대 자바스크립트로 잡힌 계획을 타입스크립트로 바꾸라고 지시하는 식이다. 클로드는 존중하는 동료 엔지니어처럼 명확하고 단호하며 구체적으로 대하면 된다. 변경 승인은 하나씩 수동 승인하거나 자동 승인할 수 있는데, 익숙해지면 자동 승인이 편하다.

기존 코드베이스에 적용할 때는 /clear로 대화를 비운 뒤 CLAUDE.md를 활용한다. 이 파일은 ① 기술 스택·구조, ② 각 구성요소의 기능, ③ 클로드가 일하는 방식의 세 층으로 작성하고, 모든 지침을 한 번에 넣기보다 인덱스가 다른 마크다운을 가리키는 '점진적 공개'를 권한다. /init보다 무엇·왜·어떻게를 담은 프롬프트로 만드는 편이 충실하다.

큰 구조 변경에는 권한 확인을 건너뛰는 YOLO 모드(dangerously skip permissions)를 쓸 수 있는데, 빠르지만 위험하다. 탐색-계획-코딩-커밋 흐름을 따르고, '선택지 3개를 제시해 달라' 같은 프롬프트 엔지니어링을 더한다. 실제로 웹소켓 서버를 만들어 두 브라우저 간 실시간 동기화를 구현하고 직접 검증해 보인다.

주요 인사이트

• 플랜 모드는 코드를 건드리지 않고 설계만 하는 단계로, 동의하기 어려운 설계 결정을 미리 잡아낼 기회를 준다.
• 프롬프트 끝에 '요구사항을 명확히 하기 위해 질문해 달라'를 붙이는 것만으로 산출물의 품질이 크게 달라진다.
• /init 자동 생성보다, 무엇·왜·어떻게를 담은 프롬프트로 CLAUDE.md를 만드는 편이 더 충실하다.
• 버그를 발견해도 곧장 고치기보다 자주 커밋해, 회귀가 생겼을 때 정상 상태로 되돌릴 수 있게 해야 한다.
• ChatGPT 등에서 익힌 프롬프트 엔지니어링 기법은 코딩 에이전트에도 그대로 적용된다(예: 선택지 3개 요청).

자주 묻는 질문

관련 AI 소식