클로드 코드를 처음 켰다면 무엇부터 봐야 할까?

클로드 코드는 설치가 어려운 도구가 아닙니다. 터미널에 명령 한 줄이면 켜지고, 첫 질문에도 곧잘 답합니다. 그런데 막상 며칠 써 보면 코딩과는 상관없는 곳에서 막힙니다. 사용량이 갑자기 끊기고, 매번 뜨는 허용 창을 누르느라 손이 바쁘고, 어제 설명한 프로젝트 규칙을 오늘 또 설명하고 있는 자신을 발견합니다.

이 지점들은 요령이 아니라 구조를 알면 대부분 사라집니다. 사용량 제한은 5시간 단위와 주 단위가 따로 돌아간다는 것을 알면 작업을 몰아 쓰는 방식이 달라지고, CLAUDE.md에 규칙을 적어 두면 같은 설명을 반복하지 않아도 됩니다. 권한 설정을 한 번 손봐 두면 허용 버튼 자체가 사라지고, MCP 서버를 붙이면 검색이나 브라우저 조작처럼 원래는 못 하던 일까지 맡길 수 있습니다.

이 블로그의 AI 도구 실무 분류는 그 순서대로 세 갈래를 두었습니다. 처음 일주일에 부딪히는 기초, 바깥 기능을 붙이는 MCP·플러그인·스킬, 그리고 반복을 없애는 자동화와 운영입니다. 지금 막힌 지점이 어느 쪽인지 아신다면 해당 갈래로 바로 건너뛰셔도 됩니다.

클로드 코드 기초 — 첫 주에 부딪히는 것들

클로드 코드는 터미널에서 돌아가는 코딩 에이전트지만, 처음 막히는 지점은 코딩이 아니라 제도 쪽입니다. 웹·데스크탑·코워크와 무엇이 다른지, 내 요금제는 어디까지 포함인지, 5시간 리밋과 주간 리밋은 어떻게 다른지 같은 질문이 먼저 옵니다. 여기에 프로젝트 규칙을 CLAUDE.md에 적어 두는 습관과, 컨텍스트가 가득 차기 전에 /compact와 /clear로 정리하는 습관까지 익히면 기본기는 갖춰집니다. 특히 하네스라는 말은 처음 들으면 낯설지만, 모델과 도구를 구분해서 생각하게 해 주기 때문에 문제가 생겼을 때 어느 쪽 탓인지 가릴 수 있게 됩니다.

MCP·플러그인·스킬 — 바깥 기능을 붙이는 법

클로드 코드의 진짜 차이는 바깥 도구를 붙였을 때 납니다. MCP 서버는 검색·브라우저·깃허브 같은 외부 기능을 연결하는 규격이고, 스킬은 특정 작업의 절차서이며, 플러그인은 이 둘을 묶어 배포하는 단위입니다. 셋의 역할이 겹쳐 보여서 무엇부터 만들지 헤매기 쉽고, 설치한 스킬이 목록에 안 보이는 문제도 대개는 사용자 범위와 프로젝트 범위를 헷갈린 탓입니다. MCP는 설정 파일이 세 군데로 나뉘어 있어 어디에 적었는지에 따라 적용 범위가 달라지는데, 이것만 정리해도 설치 실패의 절반은 줄어듭니다. 이 갈래는 개념 구분부터 개별 서버 설치법, 안 될 때 확인할 순서까지 다룹니다.

자동화·운영 — 같은 일을 두 번 시켰다면

같은 작업을 두 번 이상 시켰다면 자동화할 때가 된 것입니다. 훅은 정해진 시점마다 원하는 동작을 자동으로 끼워 넣고, 슬래시 명령은 자주 쓰는 긴 지시를 이름 하나로 줄이며, 권한 설정은 매번 뜨는 허용 창을 없앱니다. 여기서 자주 나오는 오해가 훅과 스케줄러를 섞어 쓰는 것인데, 세션 안에서 벌어지는 일은 훅이 맡고 맥이 꺼져 있어도 돌아야 하는 일은 launchd 같은 바깥 스케줄러가 맡습니다. 작업이 커지면 서브에이전트를 여러 개 띄우게 되는데, 그때부터는 무엇이 돌고 있는지 들여다보는 방법도 알아야 합니다. 이 갈래는 반복을 줄이는 설정부터 여러 세션을 굴리는 운영까지를 묶어 두었습니다.

어떤 순서로 읽으면 좋을까

설치 직후라면 사용량이 왜 갑자기 막히는지부터 확인하고, 반복 설명과 허용 창을 없앤 다음, 바깥 기능을 붙이는 순서를 권합니다. 아래 네 편이면 첫 주의 답답함은 대부분 없어집니다.

클로드 코드는 켜자마자 잘 쓰게 되는 도구라기보다, 설정을 조금씩 쌓을수록 손에 붙는 도구에 가깝습니다. 기초에서 시작해 필요한 확장을 하나씩 붙이고 반복을 자동화하는 순서를 지키면, 어느 순간 도구를 다루는 시간보다 일하는 시간이 길어집니다. 설정을 하나 바꿀 때마다 그 이유를 CLAUDE.md에 한 줄씩 남겨 두면, 몇 달 뒤 같은 문제를 다시 만났을 때 처음부터 찾아볼 일이 없습니다.

이 갈래에서 이어 읽기