클로드 코드 사용법 총정리 — 플랜 모드·CLAUDE.md·스킬·MCP·서브에이전트·훅까지

핵심 메시지

• 클로드 코드는 파일 읽기·쓰기, 셸 명령 실행, 웹 접근 등 열 개 남짓한 도구를 쥔 AI 에이전트로, 코딩뿐 아니라 CSV 분석이나 문서 변환 같은 비개발 업무에도 쓰인다.
• 가장 중요한 기술은 컨텍스트 관리다. 대화가 길어질수록 성능이 떨어지므로 플랜 모드로 시작하고, 필요한 파일을 직접 태그하고, 곁길로 샜다면 대화를 되감아 정리한다.
• CLAUDE.md 파일은 세션이 바뀌어도 유지되는 영구 메모리 역할을 하며, /init 명령으로 자동 생성하고 갱신할 수 있다.
• 스킬·MCP·서브에이전트는 각각 지시문 묶음, 외부 앱 연결, 독립된 컨텍스트로의 업무 위임이라는 서로 다른 확장 방식이다.
• 훅은 도구 호출 전후에 자동 동작을 끼워 넣는 안전장치이고, 플러그인은 이 모든 확장을 하나로 묶어 배포하는 방법이다.

쉽게 이해하기

클로드 코드는 소프트웨어를 만들 수 있는 AI 에이전트다. 구성 요소는 두 가지로, 바탕이 되는 클로드 모델과 그 모델을 코딩 에이전트로 만들어 주는 도구 묶음이다. 파일을 읽고 쓰는 도구, 셸 명령을 실행하는 도구, 인터넷에 접근하는 도구에 더해 서브에이전트를 띄우고 작업 목록을 만드는 도구까지 열 개 남짓을 갖추고 있다. 도구 구성은 한 달에 한 번꼴로 바뀌기 때문에, 확실하지 않으면 클로드에게 직접 무슨 도구를 갖고 있는지 물어보라는 것이 영상의 조언이다.

쓰려면 최소 Claude Pro 구독이 필요하고, 설치는 명령어 한 줄이면 끝난다. 맥과 리눅스는 터미널에서, 윈도우는 파워셸에서 실행한 뒤 claude 를 입력하면 인터페이스가 뜬다. 터미널이 낯선 기획자나 디자이너에게는 문턱처럼 보이지만, 실제로는 영어나 한국어로 말을 걸기만 하면 되고 별도의 터미널 명령을 알 필요가 없다. 오히려 터미널은 커서, VS 코드, 주피터 노트북, 빔 등 어떤 개발 환경에도 들어 있기 때문에 가장 보편적인 접점이 된다.

기본 조작에서 눈여겨볼 것은 세 가지 모드다. 기본 채팅 모드는 무언가를 실행할 때마다 승인을 요구하고, 편집 허용 모드는 승인 없이 파일을 읽고 쓰게 한다. 그리고 플랜 모드에서는 클로드가 코드를 전혀 작성하지 않고 계획만 세운다. 세 모드는 시프트+탭으로 순환하며, 요청을 잘못 보냈다면 ESC 한 번으로 입력을 지우고 두 번 누르면 대화와 코드를 그 시점으로 되감을 수 있다.

영상이 가장 강조하는 개념은 컨텍스트 창이다. 시스템 메시지, 도구 정의, 사용자 요청, 클로드의 사고 과정, 도구 호출과 그 결과, 최종 응답이 모두 같은 창에 쌓인다. 대화가 길어지고 여러 주제를 오갈수록 창이 가득 차고, 언어 모델은 컨텍스트가 많아질수록 오히려 성능이 떨어진다는 알려진 한계가 있다. 그래서 /context 로 사용량을 확인하고, /clear 로 시스템 메시지와 도구, CLAUDE.md 만 남기고 대화를 지우거나, /compact 로 요약만 남기는 식의 관리가 필요하다. 컨텍스트가 84% 근처에 이르면 클로드 코드가 알아서 압축을 수행한다.

확장 방법은 네 층으로 나뉜다. 스킬은 이름과 설명이 담긴 SKILL.md 를 넣은 폴더로, 클로드는 설명만 먼저 읽어 관련 있다고 판단할 때만 본문을 읽는다. MCP는 깃허브, 지메일, 슬랙, 노션, 데이터베이스 같은 외부 애플리케이션에 연결하는 표준 방식이고, 서브에이전트는 자체 컨텍스트 창을 가진 별도 에이전트에게 조사나 계획 수립을 맡기는 장치다. 마지막으로 훅은 도구 호출 앞뒤에 자동 동작을 붙여 .env 파일 읽기를 차단하거나 파일 생성 후 린트를 돌리게 하고, 플러그인은 이 모든 것을 한 묶음으로 배포한다.

주요 인사이트

• 스킬이 설명만 먼저 읽고 본문은 필요할 때 읽는 구조라는 점은 그 자체로 컨텍스트 절약 설계다. 모든 스킬 본문을 미리 올려두면 관련 없는 정보가 클로드의 주의를 흐트러뜨린다.
• 서브에이전트의 핵심 가치도 성능이 아니라 컨텍스트 격리다. 조사 작업을 별도 창에서 처리하고 결과만 받아오면 본 에이전트의 창을 아끼면서 더 복잡한 작업을 끌고 갈 수 있다.
• 스킬과 MCP의 선택 기준은 명확하다. 직접 만들어 쓰는 맞춤 기능이면 가벼운 스킬, 인증이 필요한 서드파티 서비스 연결이면 오버헤드를 감수하고 MCP를 쓰는 쪽이 낫다.
• 훅은 강력한 도구 권한에 브레이크를 다는 장치다. 다만 발표자는 8~9개월을 써오면서 훅을 하나도 만들지 않았다고 밝힌다. 처음부터 전부 갖출 필요는 없고, 같은 일을 반복하게 될 때 자동화하면 된다는 뜻이다.
• 설정 파일처럼 사람이 손으로 쓰면 실수하기 쉬운 작업이야말로 클로드에게 맡기기 좋은 일이다. 영상의 시연도 훅 설정을 직접 쓰는 대신 클로드에게 만들게 했다.

자주 묻는 질문

관련 AI 소식