클로드 코드 개발자 가이드: 요금제·모델·컨텍스트·스킬·MCP·서브에이전트

핵심 메시지

• 클로드 코드는 터미널(또는 VS Code 확장)에서 실제 파일을 읽고 쓰며 명령을 실행하는 에이전트형 코딩 도구로, 챗봇과 달리 내 코드베이스 안에서 동작한다.
• 구독에도 사용량 한도가 있어 모델(Opus·Fable·Sonnet·Haiku)과 추론 강도(effort)를 작업 난이도에 맞게 골라 토큰을 아껴야 한다.
• 컨텍스트는 클로드의 임시 기억으로, /context로 수시로 확인하고 기능 단위로 작업한 뒤 커밋·정리해 컨텍스트를 비우는 습관이 중요하다.
• 스킬은 한 번 가르치면 재사용되는 워크플로(skill.md), MCP는 외부 서비스 연동, 서브에이전트는 별도 컨텍스트로 탐색·검토를 맡기는 기능이다.
• AI가 코드를 대신 써도 '무엇이 일어나는지'는 직접 검토해 이해해야 하며, 그것이 바이브 코딩과의 차이다.

쉽게 이해하기

클로드 코드는 Anthropic의 에이전트형 코딩 도구로 터미널에서 돌아가지만 데스크톱 앱과 에디터 확장도 있다. 요금은 체험용 무료 티어 외에 월 20달러(연 결제 시 17달러)의 Pro, 사용량 5배의 100달러 Max, 20배의 200달러 Max가 있다. 데스크톱 앱은 챗·코워크·코드의 세 탭으로 나뉜다.

모델은 Opus·Fable·Sonnet·Haiku 중에서 고르며, GPT나 제미나이 같은 외부 모델은 쓸 수 없다. 모델마다 토큰 소모가 다르고 구독에도 한도가 있어 /usage로 사용량을 확인해야 한다. 세션은 약 5시간 단위이며, /effort로 낮음부터 ultra code까지 추론 강도를 조절해 토큰을 관리한다.

발표자는 단독 터미널보다 VS Code의 통합 터미널이나 확장에서 쓰기를 권한다. 내부 도구로는 bash·write·read·edit·grep·web fetch 등이 있고, 변경은 diff로 확인한다. 권한 모드는 자동 승인·플랜·auto로 전환되며, 설정·권한은 프로젝트/사용자/로컬 스코프로 나뉘어 /permissions로 allow·ask·deny를 지정한다.

한 파일에 몰린 코드를 ES 모듈로 분리하는 리팩터링을 시연한 뒤 컨텍스트를 설명한다. /context로 100만 토큰 중 사용량을 확인할 수 있는데, 너무 차면 판단이 흐려지므로 기능 단위로 작업하고 커밋한 뒤 비운다. 항상 유지할 내용은 CLAUDE.md에 두고, /init으로 초안을 만들거나 세션 로그를 저장·불러오기도 한다.

끝으로 스킬·MCP·서브에이전트를 다룬다. 스킬은 트리거 문구로 자연스럽게 불러오는 재사용 워크플로(skill.md)이고, MCP는 context7(문서)·Neon(DB)·Playwright(브라우저 자동화) 같은 외부 서비스를 연결한다. 서브에이전트는 자체 컨텍스트를 가진 별도 세션으로, 내장 explore나 커스텀 코드 리뷰어처럼 탐색·검토 결과의 요약만 메인 대화로 돌려준다.

주요 인사이트

• MCP를 많이 붙이면 컨텍스트를 크게 잡아먹으므로, 필요한 것만 연결하고 사용량을 항상 의식해야 한다.
• 서브에이전트는 자체 컨텍스트 창을 가져, 탐색·코드 리뷰 결과의 요약만 메인 대화로 돌려줘 컨텍스트 오염을 막는다.
• 설정·권한·스킬·MCP는 모두 프로젝트/사용자 스코프를 구분하므로, 팀 공유 여부에 따라 위치를 정해야 한다.
• 플랜 모드는 코드를 바꾸지 않고 여러 리팩터링 선택지를 제시받아 고른 뒤 실행할 수 있게 해준다.
• 스킬은 '/명령'처럼 엄격하지 않아, 트리거 문구만 자연스럽게 말해도 클로드가 알아서 불러온다.

자주 묻는 질문

관련 AI 소식