GUIDE · 클로드 코드
깔다 접은 사람을 위한 클로드 코드 입문 — 기초부터 스킬·커맨드·MCP까지
읽는 데 8분2026-09-03 공개
하루 6시간 만에AI 기초부터 나만의
서비스까지 완성
챗지피티는 매일 쓰는데 클로드 코드는 깔다가 접은 사람이 많습니다. 설치가 어려워서가 아니라 무엇이 다른지, 무엇부터 시켜야 하는지가 안 보여서입니다. 이 자료는 챗봇과의 차이에서 시작해 커맨드·스킬·하네스·MCP까지 여덟 단계로 정리했습니다. PDF 20면으로도 받을 수 있습니다.
챗봇과 무엇이 다른가
챗봇은 질문에 답을 씁니다. 그 답을 파일에 옮기는 것은 사람이 합니다. 클로드 코드는 폴더를 열고 파일을 직접 고치고 저장까지 합니다.
| 챗봇 | 클로드 코드 | |
|---|---|---|
| 파일 | 사람이 옮깁니다 | 직접 고칩니다 |
| 범위 | 올린 파일만 봅니다 | 폴더 전체를 봅니다 |
| 결과 | 대화창에 남습니다 | 디스크에 파일로 남습니다 |
한국어로 "이 폴더 정리해줘"라고 쓰면 됩니다. 명령어를 외우지 않습니다. 무엇을 시킬지만 정하면 됩니다.
여덟 단계로 정리했습니다
STEP 01 기초 — 챗봇이 아니라 직접 일하는 AI · 읽고, 계획하고, 해냅니다. 돌아오는 것이 설명이 아니라 바뀐 파일입니다.
STEP 02 어디까지 되나 — 실제로 돌아가는 결과물 · 랜딩페이지, 발표자료, 배포된 서비스, 정해진 시각에 만들어지는 리포트.
STEP 03 사용법의 핵심 — 코딩이 아니라 명확한 요청 · 왜·누가·무엇을·어떻게 네 조각만 적으면 결과가 달라집니다.
STEP 04 커맨드 — 나만의 단축 지시어 · 폴더에 파일 한 장을 두면 그 이름이 명령이 됩니다.
STEP 05 스킬 — AI 에게 주는 업무 매뉴얼 · description 을 채우면 부르지 않아도 상황에 맞을 때 꺼내 씁니다. 2단계 로딩이라 많이 만들어도 느려지지 않습니다.
STEP 06 하네스 — 스킬과 커맨드를 엮은 자동화 · 여러 개를 이어 붙이면 한 번의 요청으로 여러 단계가 진행됩니다.
STEP 07 실전 예시 — 전체 흐름을 스킬 하나로 · 아이디어 한 줄에서 발행까지. 사람이 손대는 곳은 가운데 한 번뿐입니다.
STEP 08 MCP — 바깥 도구를 끼우다 · 깃허브, 데이터베이스, 모니터링 도구, 디자인 도구에 직접 연결합니다.
요청은 이렇게 적습니다
가장 많이 막히는 곳이 기술이 아니라 설명입니다. 네 조각만 채우면 됩니다.
**왜** 매달 정산이 번거로워서. **누가** 나 혼자. **무엇을** 영수증 폴더를 읽어 월별 합계를 내는 표. **어떻게** 파일을 넣으면 금액과 날짜가 자동으로 채워지게.
처음 걱정하는 세 가지
| 결과가 매번 조금씩 다릅니다 | "이 부분만 이렇게 바꿔줘"로 다듬으면 됩니다 |
| 에러가 납니다 | 그 메시지를 그대로 붙여넣으면 읽고 고칩니다 |
| 한참 멈춰 있습니다 | 몇 분씩 걸리는 작업이 있습니다 |
PDF 로 받기
같은 내용을 20면 PDF 로 정리했습니다. 단계마다 그림이 들어가 있어 순서대로 따라가기 좋습니다.
내려받기 — 클로드 코드 시작하기 — PDF 20면
설치 방법과 공식 문서 주소도 함께 들어 있습니다.
이 자료를 만든 기준
명령과 경로는 공식 문서에서 직접 확인한 것만 담았습니다. 기억으로 쓰면 없는 옵션을 지어내기 때문입니다.
한 가지는 자료마다 다르게 적혀 있어 따로 확인했습니다. 커맨드가 스킬로 통합됐습니다. .claude/commands/deploy.md 와 .claude/skills/deploy/SKILL.md 가 둘 다 /deploy 를 만듭니다. 예전 자료는 이 둘을 나눠 설명하는데, 지금은 한 갈래이고 description 을 채웠느냐로 갈립니다.