클로드 코드 사용법 총정리: CLAUDE.md·플랜 모드·서브 에이전트·MCP 23가지 팁

핵심 메시지

• 새 프로젝트에서 가장 먼저 할 일은 /init으로 CLAUDE.md를 만들고, 거기에 팀과 개인의 코딩 규칙을 직접 적어 넣는 것이다.
• 복잡한 작업일수록 곧바로 시키지 말고 플랜 모드로 계획을 먼저 검토한 뒤 승인하는 습관이 안전하다.
• 대화가 길어지면 기록을 통째로 지우기보다 요약해 저장하는 방식으로 맥락을 유지하는 편이 낫다.
• 역할을 나눈 서브 에이전트와 자주 쓰는 프롬프트를 묶은 커스텀 명령어가 반복 작업 시간을 줄여준다.
• 가장 중요한 건 완벽한 세팅이 아니라 ROI, 즉 실제로 시간을 벌었는지다.

쉽게 이해하기

영상은 기존 AI 코딩 도구의 아쉬움에서 출발한다. 자동 완성은 해주지만 프로젝트 전체의 큰 그림을 보지 못해, 조립과 에러 해결은 결국 개발자 몫으로 남는다는 것이다. 발표자는 클로드 코드가 프로젝트 전체를 이해하고 여러 파일을 동시에 수정하며 테스트까지 스스로 돌린다는 점에서 다르다고 설명하며, 최근 몇 달 사이 관련 검색이 세 배 이상 늘었다고 전한다.

기초 단계에서 다루는 것은 환경 통제다. 맥에서 npm 설치 중 권한 오류가 나면 명령어 앞에 sudo를 붙이면 해결된다. 요금제는 사용량을 가늠하기 어려운 초보라면 종량 과금 방식보다 구독 연동이 안전하다고 권한다. 그리고 새 프로젝트에서는 무엇을 만들어달라고 말하기 전에 /init을 먼저 쳐서, 클로드가 프로젝트 구조를 스캔해 만든 CLAUDE.md라는 운영 매뉴얼을 확보하라고 강조한다.

CLAUDE.md는 만들어두는 것만으로는 반쪽이라는 지적이 이어진다. 발표자는 주석과 커밋 메시지를 한글로 쓰라는 규칙, 특정 CSS 프레임워크에서는 유틸리티 클래스만 쓰라는 규칙을 직접 적어둔다고 말한다. 이렇게 해두지 않으면 매번 같은 지시를 반복하며 토큰과 시간을 흘리게 된다는 것이다.

통제권을 되찾는 방법도 짚는다. 엉뚱한 방향으로 가고 있으면 ESC로 즉시 중단하고, 이전 상태로 되돌리려면 ESC를 두 번 누른다. 원인이 내 코드인지 환경인지 모를 때는 /doctor로 설치 상태와 버전, 시스템 환경을 먼저 진단한다. 대화가 길어져 성능이 떨어질 때는 기록을 전부 지우는 대신 이전 내용을 요약해 저장하는 명령을 써서 맥락을 유지한다. 에러 화면은 텍스트를 복사하는 대신 캡처 이미지를 창에 끌어다 놓아도 된다.

중급 단계의 핵심은 계획과 분업이다. 시프트+탭으로 켜는 플랜 모드는 파일을 바로 고치지 않고 어떤 파일을 어떻게 수정할지 순서를 먼저 보여준다. 여기서 한 걸음 더 나아간 방법으로 '역면접'이 제시된다. 만들고 싶은 것을 설명하는 대신, 클로드에게 나에게 다섯 가지 질문을 해달라고 요청하는 식이다. 기술 스택과 예외 처리, 우려되는 실패 시나리오를 되묻는 과정에서 기획이 정리된다.

고급 단계는 맥락 인수인계와 병렬 작업으로 넘어간다. 대화를 정리해야 할 만큼 내용이 방대해지면 지금까지의 시도와 성공, 실패, 다음 할 일을 담은 인수인계 문서를 파일로 만들어두고 다음 세션에서 참조하게 한다. 터미널을 나눠 두 개의 클로드를 동시에 돌릴 수도 있지만, 두 요리사가 같은 냄비를 건드리면 안 되듯 같은 파일을 동시에 수정하게 해서는 안 된다는 단서가 붙는다.

주요 인사이트

• 커스텀 명령어는 프로젝트 폴더에 명령어용 마크다운 파일을 만들어두는 방식이다. 코드 분석이나 보안 취약점 리뷰처럼 매번 길게 치던 프롬프트를 슬래시 명령 하나로 줄일 수 있다.
• 서브 에이전트는 '데이터베이스 스키마 전문가', '시니어 코드 리뷰어'처럼 역할을 부여해 만든다. 한 명에게 전부 맡기는 것보다 역할에 최적화된 전문가에게 특정 업무만 맡길 때 결과물 품질이 좋아진다는 것이 발표자의 설명이다.
• 모델 선택도 비용 전략이다. 오타 수정이나 파일 검색 같은 단순 작업은 가장 빠르고 저렴한 하이쿠로 처리하고, 복잡한 설계나 디버깅에서만 손넷이나 오퍼스로 올리는 식으로 유연하게 오가라고 권한다.
• 의욕이 넘쳐 건드리지 말아야 할 파일까지 고치는 사고를 막으려면, 프롬프트에 @를 붙여 수정할 파일을 콕 집어 지정한다. 반대로 깃 상태 확인처럼 단순한 터미널 명령은 앞에 느낌표를 붙이면 해석 과정을 건너뛰어 더 빠르고 토큰도 아낀다.
• MCP는 두뇌에 외부 서비스를 연결하는 USB 포트에 비유된다. 슬랙이나 노션을 연동해 문서를 직접 읽게 하거나, 순차적 사고 계열 MCP를 붙여 복잡한 구조를 더 논리적으로 다루게 만들 수 있다.
• 궁극의 병렬 작업으로는 깃 워크트리가 제시된다. 브랜치별로 폴더를 아예 나눠 로그인 기능, 결제 기능, 버그 수정을 각각 다른 터미널에서 독립적으로 돌리면 코드가 꼬이지 않는다.

자주 묻는 질문

관련 AI 소식