클로드코드 사용법, 10단계로 정리한 초보자 가이드

클로드코드 사용법을 검색하다 보면 다들 엄청 잘 쓰는 것처럼 보이는데, 막상 직접 써보면 어느 순간 막히는 느낌이 들 때가 있습니다. 플러그인은 뭘 써야 하는지, MCP는 또 뭔지, 세팅은 어떻게 해야 하는지... 사실 이건 AI가 부족해서가 아니에요. 대부분 순서를 잘못 밟아서 생기는 문제입니다. 이 글에서는 처음부터 순서대로 쌓아 올리는 10단계 로드맵을 정리했습니다. 기초부터 컨텍스트 엔지니어링, 토큰 최적화, 하니스까지 단계별로 따라가면 왜 안 느는지 이유를 알게 되고, 지금 당장 다음에 뭘 해야 할지가 보입니다.

 

클로드코드란? 쓰기 전에 알아야 할 핵심 특성

Claude Code는 Anthropic이 만든 에이전트 코딩 도구입니다. 코드베이스를 읽고, 파일을 편집하고, 명령을 실행하고, 개발 도구와 통합하는 방식으로 동작합니다. 터미널에서 쓸 수도 있고, VS Code나 JetBrains 같은 IDE, 데스크톱 앱, 브라우저 환경에서도 연결됩니다. 공식 문서에 따르면 "각 환경은 동일한 기본 Claude Code 엔진에 연결되므로 CLAUDE.md 파일, 설정 및 MCP 서버가 모든 환경에서 작동"합니다.

 

그런데 이걸 잘 쓰려면 하나의 근본적인 특성을 먼저 이해해야 합니다. 바로 클로드코드가 치매 걸린 아인슈타인이라는 점입니다.

 

복잡한 코드 작성, 아키텍처 설계, 에러 디버깅은 정말 탁월합니다. 근데 기억을 못 해요. 오늘 대화한 내용을 내일 새 세션에서 열면 완전히 잊어버립니다. "이 방식은 절대 쓰지 마라"고 했던 지시도, 함께 고쳐놓은 버그도, 내 프로젝트 규칙도 새 대화를 여는 순간 다 사라집니다. 게다가 대화 중간에도 이 현상이 생기는 경우가 있습니다. 컨텍스트가 일정량 쌓이면 자동으로 대화를 강제 압축해버리거든요.

 

이 특성을 이해하고 어떻게 세팅하고 관리할 것인가, 그게 클로드코드를 잘 쓰는 사람과 못 쓰는 사람의 실질적인 차이입니다.

 

잘 하는 것	한계
복잡한 코드 작성 및 아키텍처 설계	세션 간 기억 없음 (매 세션마다 컨텍스트 재공급 필요)
에러 디버깅, 테스트 코드 작성	컨텍스트가 길어지면 품질 저하 (컨텍스트 부패 현상)
반복 리팩토링, Git 작업 (커밋, PR 생성)	모든 작업을 클로드코드로만 처리하려는 접근은 비효율
여러 파일에 걸친 대규모 변경

 

처음부터 플러그인 깔고 MCP 5개 연결하고 프레임워크 설치해서 시작하는 게 가장 흔한 실수입니다. 뭔가 세팅이 빵빵해 보이지만, 막상 이상한 게 생겼을 때 어디서 오류가 나는지 찾지 못해서 포기하게 됩니다. 이해 없이 도구만 쌓아 올린 결과입니다. 기초부터 쌓아야 나중에 무언가 이상해졌을 때 직접 고칠 수 있습니다.

 

클로드코드 설치 방법과 가격 플랜

설치는 생각보다 간단합니다. 공식 권장 방식은 Native Install로, 자동 업데이트까지 지원됩니다.

 

환경	설치 명령어
macOS / Linux / WSL	curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell	irm https://claude.ai/install.ps1 | iex
Homebrew / WinGet	지원하지만 자동 업데이트가 없어 공식은 Native Install 권장

 

클로드 코드 가격은 플랜에 따라 크게 달라집니다. 어떤 걸 선택해야 할지 고민될 수 있는데, 사실 8단계(내 소비 패턴 파악)를 거쳐보기 전까지는 플랜을 확정하기 어렵습니다. 일단 기준만 알아두세요.

 

플랜	월 비용	적합한 사용자
Claude.com Pro	$20	가볍게 사용하는 입문자
Max 5x	$100	일반 개발자 (가성비 좋음)
Max 20x	$200	헤비 유저
API 크레딧	사용량 기반	Anthropic Console 통해 과금, 불규칙 사용자

 

처음엔 Pro로 시작해도 충분합니다. 아래 8단계에서 내 실제 소비량을 파악한 뒤 플랜을 조정하는 게 더 현명한 방법입니다.

 

 

기초 단계 (1~5단계): 올바른 순서로 시작하기

이 5단계가 클로드코드 사용법의 토대이면서 동시에 클로드코드 활용법을 제대로 배우는 단계입니다. 이 순서를 건너뛰면 나중에 고급 기능을 써도 왜 그렇게 동작하는지 이해하기 어렵고, 문제가 생겼을 때 직접 고치기도 힘들어집니다.

 

1단계: 플러그인 없이 기본 상태로 시작하기

클로드코드를 처음 켜면 까만 터미널 화면에 텍스트만 있습니다. 바로 플러그인 찾고 세팅 만지고 싶은 마음이 드는 게 당연한데, 딱 일주일만 참으세요.

 

이 기간에 봐야 할 것들이 있습니다. 파일을 어떤 순서로 읽는지, 복잡한 작업을 어떻게 쪼개서 처리하는지, 오류가 나면 어떻게 스스로 복구하려 하는지. 이걸 직접 눈으로 보지 않으면 나중에 플러그인이 어떤 부분을 보완해주는지도 모릅니다. 그냥 블랙박스가 되어버리는 거예요.

 

기본 상태로 써보다 보면 자연스럽게 이런 질문이 생깁니다. "왜 이건 고치고 저건 못 고치지?", "왜 대화가 길어지면 이상해지지?" 그 질문이 생기는 게 바로 성장입니다.

이 단계의 핵심: 이해 없이 도구만 쌓으면 문제 생겼을 때 고칠 수가 없습니다.

 

2단계: 튜토리얼 지옥에서 탈출하기

유튜브 보고, 블로그 읽고, 강의 듣고, 또 다른 영상 보고 5시간을 공부했는데 정작 내가 만든 건 아무것도 없는 상태, 다들 한 번쯤 겪어봤을 겁니다.

 

클로드코드는 이론으로 느는 도구가 아닙니다. 자전거를 책으로 100시간 공부해도 실제로 타보지 않으면 못 하는 것과 같아요. 지금 당장 만들 것 하나를 정하세요. 가계부 앱이든, 일정 정리 도구든, 자동화 스크립트든 아무거나 좋습니다.

 

완성도 50%짜리 앱 하나를 만들면서 배우는 게 완벽한 튜토리얼 10개를 보는 것보다 훨씬 빠르게 늡니다.

이 단계의 핵심: 넘어져봐야 느는 도구입니다. 일단 만드세요.

 

3단계: 스킬(Skills) 만들기로 반복 작업 자동화하기

어느 정도 써보면 자연스럽게 느끼게 됩니다. "나 이 작업 또 하는 거 아니야?" 배포할 때마다 클로드에게 똑같은 순서를 설명하고, 코드 리뷰할 때마다 같은 기준을 얘기하고, 커밋 메시지 쓸 때마다 같은 형식을 알려주고...

 

스킬(Skills)은 이런 반복 작업을 레시피처럼 저장해두는 커스텀 명령 시스템입니다. 볶음밥 만드는 법을 매번 검색하는 대신 내 레시피 노트에 적어두는 것과 같아요. 공식 문서에 따르면 스킬 생성 시 'name'과 'description'이 가장 중요한데, 클로드가 스킬을 트리거할지 말지를 이 두 값으로 결정하기 때문입니다.

 

스킬의 큰 장점은 토큰을 거의 소모하지 않는다는 점입니다. 호출할 때만 로드되기 때문에 스킬 10개를 설치해도 기본 소모가 거의 없습니다. 예를 들어 /review-pr, /deploy-staging 같은 스킬을 만들어두면 매번 설명을 반복하지 않아도 됩니다.

이 단계의 핵심: 두 번 이상 반복한 작업이 있으면 스킬로 만드세요.

 

4단계: MCP 연결로 클로드에게 팔다리 붙여주기

MCP(Model Context Protocol)는 AI 도구 통합을 위한 오픈 소스 표준입니다. 쉽게 말하면 클로드코드에 팔다리를 붙여주는 것입니다.

 

GitHub MCP를 연결하면 클로드가 직접 PR을 만들고 이슈를 달 수 있습니다. 브라우저 MCP를 연결하면 실제로 웹페이지를 열고 클릭하고 스크린샷을 찍을 수 있고요. DB MCP를 연결하면 데이터베이스에 직접 쿼리를 날릴 수 있습니다. 그 외에도 Slack, Notion, Jira, Google Drive, Figma 등 다양한 서비스와 연결할 수 있습니다.

 

중요한 건 3단계(스킬)를 먼저 익히고 나서 MCP로 넘어오는 것입니다. 스킬로 해결할 수 있는 작업을 MCP로 처리하면 불필요한 토큰 소모가 발생합니다. 이 이야기는 다음 단계에서 바로 이어집니다.

이 단계의 핵심: 클로드가 직접 외부 도구를 사용할 수 있게 연결하는 단계입니다. 필요한 팔다리만 붙이세요.

 

5단계: MCP 토큰 최적화로 성능 유지하기

MCP를 켜는 순간 대화 시작 전부터 비용이 발생합니다. MCP 서버들은 세션 시작할 때 "저 이런 기능들 있어요"라는 목록을 통째로 클로드 머릿속에 밀어 넣기 때문입니다. 대화 한 글자도 쓰기 전에 이미 소비가 되고 있는 겁니다.

 

실제로 커뮤니티에서 측정한 수치에 따르면, MCP 서버 5개를 켜두면 전체 컨텍스트 용량의 41%가 사라진다고 합니다. 대화도 시작하기 전에 절반 가까이 사라지는 셈입니다.

 

대응책은 두 가지입니다. 자주 쓰지 않는 기능은 MCP 대신 스킬로 만들어두면 호출할 때만 로드되니 기본 소모가 없습니다. 그리고 쓰지 않는 MCP는 끄세요. 단순하지만 가장 확실한 방법입니다.

이 단계의 핵심: 안 쓰는 MCP는 끄고, 자주 안 쓰는 기능은 스킬로 만드세요.

 

여기까지가 클로드코드 사용법의 기초입니다. 클로드코드가 어떻게 작동하는지 파악하고, 반복 작업은 스킬로 저장하고, MCP 비용은 어떻게 관리하는지. 이제부터가 진짜 실력 차이를 만드는 단계들입니다.

 

 

고수 단계 (6~10단계): 실력 차이를 만드는 핵심 설정

이 단계들은 클로드코드 활용법의 심화 구간입니다. 6단계를 이해하면 앞선 다섯 단계가 왜 필요했는지도 다시 보입니다.

 

6단계: 컨텍스트 엔지니어링과 CLAUDE.md 장기 메모리

10단계 전체에서 가장 중요한 단계입니다. 컨텍스트 엔지니어링은 클로드에게 상황에 딱 맞는 정보만 골라서 주는 기술, 즉 이 "치매 아인슈타인"에게 뭘 기억하게 할지, 뭘 잊게 할지를 설계하는 것입니다.

 

신입 직원이 들어왔을 때 매일 처음부터 설명하는 것과, 인수인계 문서 한 장을 잘 써두고 출근할 때마다 그걸 읽게 하는 것의 차이입니다. 클로드코드에서 그 인수인계 문서가 바로 CLAUDE.md 파일입니다.

 

프로젝트 루트에 이 파일을 만들어두면 클로드가 세션 시작 시 자동으로 읽습니다. 공식 문서에서는 파일당 200줄 이하를 목표로 할 것을 권장하고 있는데, "더 긴 파일은 더 많은 컨텍스트를 소비하고 준수를 줄인다"는 이유입니다. 규칙이 100개면 사람도 다 기억 못 하는 것처럼, 클로드도 마찬가지입니다.

 

CLAUDE.md 작성 원칙

• 200줄 이하 목표 (공식 문서 기준)
• /init으로 자동 생성된 것보다 직접 작성이 효과적
• 클로드가 잘 인지하지 못하는 부분 위주로 기입
• 포함 내용: 프로젝트 코딩 표준, 아키텍처 결정 사항, 선호 라이브러리
• 마크다운 헤더와 글머리 기호로 구조화 권장

 

다음은 간단한 CLAUDE.md 예시입니다.

 

## 프로젝트 개요
- 이름: My App (Next.js + TypeScript)
- 주요 기능: 사용자 인증, 게시글 CRUD

## 코딩 표준
- 컴포넌트는 함수형으로만 작성
- 상태 관리: Zustand 사용 (Redux 금지)
- CSS: Tailwind CSS (inline style 금지)

## 자주 쓰는 명령어
- 개발 서버: npm run dev
- 빌드: npm run build

## 절대 하면 안 되는 것
- any 타입 사용 금지
- console.log 커밋 금지

 

컨텍스트 컴팩션(Compaction)이란?

클로드와의 대화가 길어지면 어느 순간 무언가 이상해지는 경험을 할 수 있습니다. 예를 들어 "이건 이렇게 하지 마라"고 했던 지시를 어기기 시작하거나, 이미 수정했던 버그가 다시 나타나거나, 같은 파일을 몇 번이고 반복해서 읽으려고 합니다. 이게 바로 컨텍스트 컴팩션입니다.

 

대화가 약 75% 정도 쌓이면 클로드가 자동으로 이전 대화를 강제 압축합니다. 말하자면 긴 대화를 짧게 요약해버리는 건데, 이 과정에서 중요한 지시들이 손실되는 겁니다. 75% 수준에서 품질이 떨어지기 시작하고 90%에 가까워지면 버그와 일관성 문제가 눈에 띄게 증가합니다.

 

컴팩션이 발동되면 이런 일이 생깁니다. 이전에 지시를 100% 따르던 클로드가 그 지시를 위반하기 시작하고, 이미 고쳐달라고 했던 버그가 다시 나타나며, 어떤 파일을 읽고 있었는지 잊어버려서 다시 읽기 시작합니다. CLAUDE.md는 컴팩션이 발동돼도 자동으로 다시 읽히기 때문에, 이 파일이 진짜 장기 메모리 역할을 합니다.

 

컴팩션 대처법

• CLAUDE.md를 짧고 핵심적으로 유지하기
• 관련 없는 새 작업 시작 시 무조건 /clear 사용
• 한 세션에 하나의 작업만 하는 습관 (복잡한 작업은 .md로 진행 상황 정리 후 /clear, 새 세션에서 이어서 작업)

 

유용한 내장 명령어를 정리하면 다음과 같습니다.

 

명령어	기능
/clear	대화 이력 완전 초기화
/compact	대화 압축 (수동 실행 시 보존 내용 명시 가능: /compact keep only coding patterns)
/context	현재 컨텍스트 사용량 시각화
/cost	현재 세션 토큰 소비량 확인
/model	모델 전환

 

7단계: 토큰 절약 방법론으로 비용 아끼기

컨텍스트 엔지니어링을 이해했다면, 이제 실제로 토큰을 아끼는 방법을 익혀야 합니다.

 

먼저 필요한 파일만 제공하세요. 로그인 기능을 고치는데 전체 프로젝트를 다 읽힐 필요는 없습니다. 로그인 관련 파일만 주면 토큰이 절약되고 컴팩션도 늦게 옵니다.

 

모델 선택도 중요합니다. 클로드에는 여러 모델이 있는데, 복잡한 아키텍처 설계에는 Opus(오퍼스)가 유리하지만 코드 수정이나 일반 작업은 Sonnet(소넷)이 훨씬 빠르고 저렴합니다. 작업 난이도에 맞는 모델을 고르는 것만으로도 비용이 크게 달라집니다.

 

그리고 세션 분할 전략으로, 개인 기술 블로그(madplay.github.io)에서 정리한 것처럼 "한 PR당 한 세션"이 효율적입니다. 버그 수정, 기능 추가, 리팩토링 등 작업 유형별로 새 세션을 시작하면 불필요한 컨텍스트 누적을 방지할 수 있습니다.

이 단계의 핵심: 필요한 파일만, 적합한 모델로, MCP 대신 CLI와 스킬을 활용하세요.

 

8단계: 내 소비 패턴 파악하기

6단계와 7단계에서 최적화 기법을 다 익혔다면, 이제 실제로 적용하면서 내 소비 패턴을 파악해야 합니다.

 

복잡한 작업 하나를 정해서 처음부터 끝까지 돌려보세요. 스킬도 써보고, 컨텍스트 관리도 해보고, 최적화 기법을 전부 적용해서 진짜 어려운 작업을 완주해봅니다. /cost 명령어로 세션 토큰 소비량을 중간중간 확인하면서요.

 

한 달 식비를 얼마나 쓰는지 모르면 어떻게 절약합니까? 내가 얼마나 쓰는지 먼저 알아야 줄일 수 있습니다. 이 정도 규모 프로젝트면 대략 이만큼 쓰겠구나 하는 감각이 생기면, 플랜 선택도 현명하게 할 수 있습니다. 내 실제 소모량도 모른 채 플랜을 선택하면 너무 많이 사거나, 너무 적게 사거나 하게 됩니다.

이 단계의 핵심: 내 작업 패턴을 숫자로 파악해야 플랜 선택이 현명해집니다.

 

9단계: Max 플랜 고배율로 클로드의 진짜 능력 확인하기

8단계로 소비 패턴을 파악했다면, 이번엔 제한 없이 한번 제대로 써보는 단계입니다.

 

Max 플랜 구조는 Pro 위에 두 가지가 있습니다. 5배짜리 Max 5x($100/월)와 20배짜리 Max 20x($200/월)입니다. 예산이 충분하다면, 엄청 복잡한 프로젝트 하나를 처음부터 끝까지 클로드코드로만 진행해보세요.

 

차를 처음 샀을 때 주차장에서만 타다가 고속도로를 한 번도 안 타본 상태로 성능을 다 안다고 할 수 없는 것처럼, 클로드코드도 안전한 범위에서만 쓰다 보면 그 모습밖에 못 봅니다. 직접 밟아봐야 어디까지 가는지 알 수 있어요.

 

이 경험이 중요한 또 다른 이유가 있습니다. "아, 이건 클로드코드로 하면 안 되는 거구나"를 직접 알게 됩니다. 모든 걸 클로드코드로 하려는 집착에서 벗어나게 되고, 뭘 맡기고 뭘 직접 해야 하는지 감각이 명확해집니다.

이 단계의 핵심: 진짜 능력을 직접 확인하고, 클로드코드가 적합하지 않은 작업도 구별하세요.

 

10단계: 나에게 맞는 하니스(Harness) 찾기

하니스는 생소한 단어일 수 있습니다. 등산할 때 몸에 묶는 안전줄이 하니스인데, 클로드코드에서는 클로드가 내 방식대로 일관되게, 실수 없이 일하도록 잡아주는 구조를 의미합니다.

 

그냥 클로드코드는 자유롭게 뭐든 합니다. 그게 단점이 되기도 해요. 내가 원하는 방식이 있는데 다른 방식으로 처리하거나, 세션마다 다르게 행동하거나 할 때 하니스가 그걸 막아줍니다. Oh My Claude Code, Claude Code Superpowers(CCSP) 등 커뮤니티에서 개발된 다양한 도구들이 있습니다.

 

이걸 마지막인 10단계에 배치한 이유가 있습니다. 1~9단계 경험 없이 처음부터 하니스를 쓰면 기능이 너무 많아서 뭘 왜 쓰는지 모른 채로 도구만 쓰게 됩니다. 충분히 기초를 쌓고 나서 써야 진짜 효과가 납니다.

이 단계의 핵심: 기초를 충분히 쌓은 뒤에 써야 하니스의 진가를 알 수 있습니다.

 

 

자주 묻는 질문

 

Q. 클로드코드, 코딩 모르는 사람도 쓸 수 있나요?

완전한 비개발자에게는 진입 장벽이 있습니다. 파일 구조, 기본 터미널 명령어 정도의 개념은 있어야 합니다. 다만 이 10단계를 차례로 따르면 비개발자도 진입 장벽을 크게 낮출 수 있습니다. 2단계처럼 실전 프로젝트를 직접 만들어보면서 배우는 방식이 특히 효과적입니다.

Q. 무료로 쓸 수 있나요? 어떤 플랜이 좋나요?

Claude.com Pro($20/월)로 기본 사용이 가능합니다. 일상적인 개발 작업은 Max 5x($100/월)가 가성비 면에서 좋다는 평이 많습니다. 단, 본격적으로 사용하기 전에 8단계(소비 패턴 파악)를 먼저 거쳐보는 게 좋습니다. 내 실제 소모량을 모른 채 플랜을 정하면 낭비하거나 부족하게 됩니다.

Q. MCP를 꼭 써야 하나요?

필수는 아닙니다. 먼저 기본 상태(1단계)에서 충분히 써보고, 반복 작업이 생기면 스킬(3단계)부터 시작하는 게 맞습니다. MCP는 4~5단계에서 도입하는 것이 적절한 순서입니다. 처음부터 MCP부터 연결하는 건 5단계에서 언급한 토큰 낭비로 이어질 수 있습니다.

Q. CLAUDE.md는 어떻게 작성하나요?

/init으로 자동 생성도 가능하지만 직접 작성이 더 효과적입니다. 프로젝트 코딩 표준, 아키텍처 결정 사항, 선호 라이브러리를 200줄 이하로 정리하세요. 공식 문서(code.claude.com)에 따르면 "CLAUDE.md 파일의 모든 줄은 실제 작업 내용과 주의를 끌기 위해 경쟁합니다." 너무 길면 정작 중요한 지시가 묻혀버립니다.

Q. 컨텍스트 컴팩션이 발생하면 어떻게 해야 하나요?

/clear로 이력을 초기화한 뒤 새 세션에서 CLAUDE.md와 진행 상황 .md 파일을 읽히고 이어서 작업하면 됩니다. 예방하는 가장 좋은 방법은 한 세션에 하나의 작업만 하는 원칙을 지키는 것입니다.

 

 

마무리: 클로드코드 사용법, 순서가 전부다

10단계를 한 번에 다 적용하려 할 필요는 없습니다. 지금 자신이 어느 단계에 있는지 파악하고, 다음 단계 하나만 실천해보세요. 성급하게 올라가면 기초가 없어서 흔들립니다.

 

10단계 핵심 요약

1. 플러그인 없이 기본 상태로 시작하기 (일주일간 직접 관찰)
2. 튜토리얼 지옥 탈출, 실전 프로젝트 1개 만들기
3. 반복 작업을 스킬로 저장하기
4. MCP 연결로 필요한 팔다리 붙이기
5. MCP 토큰 최적화 (안 쓰는 MCP 끄기, 스킬로 대체)
6. 컨텍스트 엔지니어링: CLAUDE.md 작성 + /clear 습관화
7. 토큰 절약 방법론 (필요한 파일만, 적합한 모델 선택)
8. 내 소비 패턴 파악 (/cost 활용)
9. Max 플랜으로 진짜 능력 확인하기
10. 나에게 맞는 하니스(Harness) 찾기

 

결국 클로드코드는 치매 걸린 아인슈타인입니다. 천재인데 기억을 못 합니다. 이 특성에 맞게 어떻게 세팅하고 관리할 것인가, 그게 클로드코드 사용법의 전부입니다. 10단계가 많아 보여도, 하나씩 밟아가다 보면 어느 순간 자연스럽게 쓰고 있는 자신을 발견하게 됩니다.

 

클로드코드 설치 방법 상세 가이드, CLAUDE.md 작성법 심화 편도 준비 중입니다. 시리즈로 이어지니 참고해두세요.