CLAUDE.md와 스킬로 같은 말 두 번 하지 않기¶
Claude Code에게 같은 말을 또 하고 있다면 CLAUDE.md와 스킬을 쓸 때입니다. 꼭 지켜야 하는 규칙은 CLAUDE.md에, 특정 업무의 순서는 스킬에 적어 둡니다.
영상으로 보려면 클로드 코드 사용법 3강을 확인하세요.
기준 시점
2026년 11월 화면 기준입니다. Claude Code 화면은 자주 바뀌고, 결과물은 사람마다 다르게 나옵니다.
시작 전에 확인할 것¶
- Claude Code 설치와 첫 설정을 마쳐 주세요.
- 연습할 폴더를 하나 정해 주세요. 2강에서 만든 폴더가 있으면 그 폴더를 써도 됩니다.
먼저 알아 둘 것 : 에이전트가 일하는 방식¶
Claude Code는 에이전트입니다. 요청을 받으면 아래 순서로 일합니다.

- 내가 요청합니다. 예 : "챕터 만들어 줘"
- Claude가 할 일을 판단합니다.
- 도구가 필요하면 도구를 실행합니다. 도구는 파일 읽기, 수정, 실행, 웹 검색 같은 것입니다.
- 도구의 결과를 받아 다시 판단합니다.
- 판단이 끝나면 결과를 보여 줍니다.
CLAUDE.md와 스킬은 이 순서 중 정해진 시점에 읽힙니다.

| 무엇을 | 언제 읽나요 |
|---|---|
| CLAUDE.md | 대화를 시작할 때마다 전부 읽습니다 |
| 스킬 목록(이름과 설명) | 대화를 시작할 때 같이 읽습니다 |
| 스킬 상세 내용 | 그 스킬이 필요하다고 판단했을 때만 읽습니다 |
이 그림을 기억해 두면 어디에 무엇을 적을지 정하기 쉽습니다.
회사에 새로 온 신입 사원에게 일을 알려 주는 상황과 같습니다.
| 신입 사원에게 | Claude Code에서는 | 필요한 경우 |
|---|---|---|
| 업무 수칙 | CLAUDE.md | 무슨 일을 하든 지켜야 할 때 |
| 업무 매뉴얼 | 스킬 | 해당 업무를 진행할 때 |
| 말로 하기 | 대화에서 하는 요청 | 필요할 때마다 |
1. CLAUDE.md 만들기¶
CLAUDE.md는 직접 쓰지 않아도 됩니다. Claude Code에게 말로 요청하면 됩니다.
연습할 폴더에서 Claude Code를 열고 아래 내용을 보내 주세요.
# 인사
- 대화의 첫 답변은 "출근 완료했습니다! 지금은 ○○시 ○○분입니다."로 시작
- 시각은 date 명령으로 확인해서 넣기
위 내용 지금 폴더의 CLAUDE.md에 추가해줘
폴더에 CLAUDE.md 파일이 없으면 Claude Code가 새로 만듭니다. 파일을 열면 방금 보낸 내용이 들어 있습니다.
2. 새 대화에서 확인하기¶
CLAUDE.md는 대화를 시작할 때 읽습니다. 그래서 바뀐 내용은 새 대화부터 적용됩니다.
새 대화를 열고 인사를 보내 주세요.
첫 답변이 아래처럼 시작하면 적용된 것입니다.

앞으로 Claude Code와 일하다가 같은 말을 두 번 하게 되면 아래처럼 말해 주세요.
3. CLAUDE.md에 넣으면 좋은 지침¶
인사는 연습용입니다. 실제로는 프로젝트에서 반복해서 지켜야 하는 것을 적습니다. 아래에서 필요한 것을 골라 보내 주세요.
| 지침 | CLAUDE.md에 적을 내용 |
|---|---|
| 1. 실행한 동작 쉽게 설명하기 | 방금 실행한 내용을 쉽게 설명하고 왜 했는지 설명해줘. 전문용어는 풀어서 말해 |
| 2. 원본 보호와 파일 저장 규칙 | 원본 파일은 수정하지 말고 output/ 폴더에 저장. 파일명은 YYYYMMDD_내용.확장자 |
| 3. 폴더 경로 | raw/: 받은 원본 데이터, docs/: 회의록, templates/: 보고서 양식 |
| 4. 큰 작업은 계획 먼저 | 파일 3개 이상 바꾸거나 10분 넘게 걸릴 작업은 계획을 먼저 보여주고 승인받을 것 |
| 5. 사내 용어집 | MAU: 월 활성 사용자(활성 정의 : 차량 호출), "본부장 보고"는 1페이지 이내로 작성 |
| 6. 작업 기록 | 클로드 코드와 대화한 내용을 항상 history.md에 저장해줘 |
카일 기준으로 1번, 3번, 6번은 누구나 편하게 쓸 수 있습니다. 2번, 4번, 5번은 지금 상황에 맞게 고쳐서 넣어 주세요. 5번의 용어와 정의는 예시입니다.
예를 들어 1번은 아래처럼 보냅니다.
4. 글로벌과 프로젝트 나누기¶
CLAUDE.md는 두 곳에 둘 수 있습니다. 둘 다 있으면 글로벌을 먼저 읽고 프로젝트를 읽습니다.
| 글로벌(전역, 내 컴퓨터 전체) | 프로젝트(특정 폴더) | |
|---|---|---|
| 위치 | ~/.claude/CLAUDE.md (~ : 내 사용자 폴더) |
작업 폴더의 CLAUDE.md |
| 적용 | 내 컴퓨터의 어느 폴더에서 열든 적용 | 그 폴더에서 Claude Code를 실행할 때 적용 |
| 예 | "한국어로 짧게 답해줘" | "카일 캐릭터는 하늘색 후드로 표시해" |
| 추가 요청 | 글로벌 CLAUDE.md에 추가해줘 |
지금 폴더 CLAUDE.md에 추가해줘 |
글로벌에 모두 넣지 마세요
CLAUDE.md는 대화를 시작할 때마다 전부 읽습니다. 내용이 많으면 Claude Code가 기억할 수 있는 양(컨텍스트)이 줄어듭니다. 카일 기준으로 글로벌에는 꼭 필요한 것만 넣고, 나머지는 프로젝트 CLAUDE.md에 넣습니다.
다른 AI 도구도 같이 쓴다면
Codex 같은 다른 AI 도구는 같은 역할의 파일을 AGENTS.md라는 이름으로 씁니다. 여러 에이전트를 같이 쓴다면 규칙을 AGENTS.md에 저장해 주세요.
5. 스킬 만들기¶
스킬은 특정 업무의 순서와 고려 사항을 적어 둔 업무 매뉴얼입니다. 스킬도 말로 만듭니다.
실제 업무에서는 이 순서를 추천합니다.
- 작업을 Claude Code에게 지시하면서 끝까지 한 번 해 봅니다.
- 끝나면 아래처럼 말합니다.
연습으로는 여행 일정 스킬을 만들어 봅니다. 아래 내용을 보내 주세요.
---
name: trip-plan
description: "여행 일정표를 만든다. '일정 짜줘', '여행 계획' 같은 요청에 사용."
---
# 여행 일정 만들기
1. 여행지, 날짜, 인원을 확인한다.
2. 날짜별로 이동 경로와 숙소를 표로 정리한다.
3. 결과를 itinerary.md로 저장한다.
여행 계획 짜는 프로젝트 스킬 만들어 줘
이렇게 자세히 쓰지 않아도 됩니다. 아래처럼 보내도 만들어 줍니다.
만들고 나면 작업 폴더의 .claude/skills/trip-plan/ 안에 SKILL.md 파일이 생깁니다. 스킬 하나가 폴더 하나입니다.
SKILL.md 맨 위의 name과 description은 Claude Code가 항상 읽는 부분입니다. 그 아래가 스킬을 쓸 때만 읽는 상세 내용입니다.
6. 스킬 사용하기¶
새 대화를 열고 아래처럼 보내 주세요. / 뒤에 스킬 이름을 쓰면 그 스킬을 바로 실행합니다.
스킬에 적힌 순서대로 날짜 같은 정보를 먼저 묻고, 답하면 일정표를 만듭니다.

스킬 이름을 부르지 않고 일정 짜줘처럼 말해도 됩니다. 설명(description)에 적힌 말과 맞으면 Claude Code가 판단해서 스킬을 씁니다.
설치된 스킬은 두 가지 방법으로 확인합니다.
- 입력 칸에
/를 입력하면 목록이 나옵니다. 지금 설치된 스킬 뭐가 있는지 말해줘라고 물어봅니다.
스킬도 CLAUDE.md처럼 두 곳에 둘 수 있습니다.
| 글로벌(내 컴퓨터 전체) | 프로젝트(특정 폴더) | |
|---|---|---|
| 위치 | ~/.claude/skills/ |
작업 폴더의 .claude/skills/ |
| 적용 | 어느 폴더에서 열든 쓸 수 있음 | 그 폴더에서 열었을 때만 쓸 수 있음 |
| 만들 때 | 글로벌 스킬로 만들어줘 |
이 프로젝트 스킬로 만들어줘 |
스킬도 한 번 만들고 끝나지 않습니다. 써 보면서 마음에 들지 않는 부분은 고쳐 달라고 말해 주세요.
스킬을 나누고 찾기¶
내 스킬 나누기
- 스킬 폴더를 GitHub 레포에 올립니다. 예 : zzsza/kyleschool-skills
- 내 컴퓨터에 설치해서 동작하는지 확인합니다.
- 사람들에게 공개합니다.
받는 사람은 레포 주소를 주고 이 스킬 설치해 줘라고 말하면 됩니다. 2강에서 스킬을 설치한 방법과 같습니다.
다른 사람의 스킬 찾기
- 원하는 것과 함께
Skill github라고 검색합니다. /find-skill을 사용해서 찾습니다.
찾은 스킬은 꼭 써 보고 내 스타일에 맞게 고쳐 주세요. 쓰지 않는 스킬은 지우는 것이 좋습니다.
규칙과 스킬이 많아지면¶
| 증상 | 해결 |
|---|---|
| CLAUDE.md가 길어짐 | 200줄 아래 권장 (Claude Code 공식 문서) |
| SKILL.md가 길어짐 | 500줄 아래 권장 (agentskills.io 규격) |
| 서로 부딪히는 규칙 | 하나로 정리 |
| 한 번만 쓴 요청 | 스킬로 만들지 않음. 2회 이상 반복될 때만 |
직접 점검하기 번거로우면 아래 명령어를 입력해 주세요. 설치 상태, 설정 파일, 스킬, CLAUDE.md를 점검하고 고칠 곳을 알려 줍니다.
정리¶
- Claude Code와 대화하다가 반복해서 말하는 지침이 있으면
CLAUDE.md에 추가해줘 - 2번 이상 반복되는 일이 있으면
스킬로 만들어 줘 - CLAUDE.md와 스킬은 한 번 만들고 끝나지 않습니다. 계속 고치고, 안 쓰는 것은 정리해 주세요.
만든 스킬이 있으면 유튜브 댓글로 알려 주세요. 궁금하면 질문해주세요!