Claude Code가 다른 AI와 다른 이유
채팅 AI(ChatGPT, Gemini 등)는 빈 채팅창에서 시작해요. 잘 쓰려면 사람이 매번 잘 시켜야 하고, 어제 됐던 것도 오늘 다시 설명해야 해요.
Claude Code는 달라요. 도구 자체가 구조를 담고 있어요. 한 번 정해둔 규칙은 매번 자동으로 적용되고, 반복 작업은 명령어 하나로 실행돼요. 쓰면 쓸수록 도구가 나한테 맞춰져요.
이 가이드는 그 구조가 뭔지, Claude Code한테 어떻게 요청하면 되는지를 알려드려요.
1. 규칙 파일 (CLAUDE.md): "내 방식을 도구에 새기는 것"
이게 뭔가요?
채팅 AI한테 "한국어로 답해", "코드에 주석 달아줘"를 매번 말하고 있다면, 그걸 한 번만 적어두는 파일이에요.
CLAUDE.md라는 파일에 써두면, Claude Code가 매번 대화를 시작할 때 자동으로 읽어요. 채팅 AI처럼 "까먹는" 일이 없어요.
어떻게 만들까요?
직접 파일을 만들 필요 없어요. Claude Code한테 이렇게 말하면 돼요.
"나한테 맞는 CLAUDE.md 규칙 파일 만들어줘."
그러면 Claude Code가 알아서 파일을 만들어줘요. 예를 들면 이런 규칙들을 넣을 수 있어요:
- 파일을 수정하기 전에 항상 먼저 확인받아
- 에러가 나면 원인부터 설명하고, 그 다음에 고쳐줘
- 내가 모르는 개념이 나오면 비유로 쉽게 설명해줘
이런 규칙을 한 번 써두면 Claude Code가 매번 알아서 따라요. "아까 말했잖아"를 할 필요가 없어요.
이게 어디에 적용되나요?
| 위치 | 효과 |
|---|---|
~/.claude/CLAUDE.md | 모든 프로젝트에 적용 (내 전체 규칙) |
프로젝트 폴더의 CLAUDE.md | 해당 프로젝트에만 적용 |
처음에는 전체 규칙부터 시작하면 좋아요. Claude Code한테 이렇게 말해보세요.
"내 글로벌 CLAUDE.md를 만들어줘. 모든 프로젝트에서 한국어로 답하게."
💡 CLAUDE.md는 짧게 유지하세요. CLAUDE.md는 200줄 이하로 큰 규칙만 넣는 게 좋아요. Claude Code는 매 대화 시작할 때 이 파일을 읽는데, 대화가 길어지면 처음에 읽은 내용을 점점 잊을 수 있어요. 핵심만 짧고 명확하게 쓸수록 잘 지켜요.
💡 세부 규칙은 별도 파일로 분리하세요. 예를 들어 블로그 글 쓸 때 나만의 톤, 구조, 주의사항이 있다면 그건
blog-rules.md같은 별도 파일로 만들어두고, CLAUDE.md에는 연결만 해두는 거예요.
# CLAUDE.md (큰 규칙만)
- 항상 한국어로 답해
- 세부 규칙은 아래 파일 참고
@blog-rules.md
@code-review-rules.md
이렇게 하면 CLAUDE.md는 목차처럼 깔끔하게 유지되고, 세부 내용은 필요할 때만 읽혀요. Claude Code한테 "블로그 글 쓸 때 내가 지키는 규칙들을 별도 파일로 정리해줘"라고 요청하면 알아서 만들어줘요.
2. 스킬 (Skills): "반복 작업을 명령어 하나로"
이게 뭔가요?
같은 작업을 매번 길게 설명하는 대신, 한 번 만들어두면 이름만 치면 실행돼요. 예를 들어 매번 "이 파일 읽고, 요약해서, 마크다운으로 저장해줘"라고 말하는 대신 /summarize이라고 한 번 치면 끝이에요.
어떻게 만들까요?
직접 코드를 짤 필요 없어요. Claude Code한테 이렇게 요청하면 돼요.
"파일을 읽고 3줄로 요약해서 저장하는 스킬 만들어줘. /summarize로 실행되게."
그러면 Claude Code가 스킬 파일을 만들어줘요. 그 다음부터는 /summarize 보고서.md 이렇게만 치면 자동으로 실행돼요.
채팅 AI와 뭐가 다른가요?
채팅 AI는 매번 "이렇게 해줘"를 사람이 직접 말해야 해요. 사람이 잘 시키면 잘 되고, 못 시키면 안 돼요. 스킬은 잘 시키는 방법을 파일로 저장해두는 거예요. 한 번 만들면 누가 실행해도 같은 퀄리티가 나와요.
💡 결과가 마음에 안 들면 스킬을 고치세요. 스킬을 실행했는데 결과가 아쉬우면, 매번 다시 설명할 필요 없어요. "방금 /summarize 결과가 너무 길었어. 3줄 이내로 나오게 스킬 수정해줘"라고 하면 스킬 파일 자체가 업데이트돼요. 다음부터는 수정된 방식으로 실행돼요. 사람이 매번 잘 시키는 게 아니라, 스킬이 점점 좋아지는 거예요.
💡 스킬 안에서 다른 스킬을 부를 수도 있어요. 예를 들어
/write-blog스킬 안에서 "글 다 쓰면 /review 실행해줘"라고 넣어두면, 블로그 글 작성이 끝나면 자동으로 리뷰까지 이어져요. 이렇게 스킬을 연결하면 여러 단계의 작업이 명령어 하나로 끝나요.
3. 자동 기억 (Memory): "어제 한 일을 오늘도 안다"
이게 뭔가요?
Claude Code는 작업하면서 유용한 정보를 자동으로 기억해요. 프로젝트 구조, 자주 하는 패턴, 이전에 내린 결정 등. 채팅 AI는 대화를 닫으면 전부 잊어요. Claude Code는 다음에 다시 열어도 기억하고 있어요.
어떻게 기억시키나요?
그냥 말하면 돼요.
"나는 블로그 글 쓸 때 ~해요 체를 쓴다는 거 기억해줘"
"이 프로젝트에서 파일 삭제할 때는 항상 나한테 먼저 확인받아. 기억해줘"
다음 대화에서도 이 내용을 알고 있어요.
💡 정말 중요한 건 CLAUDE.md에 넣으세요. 메모리는 편리하지만 대화가 길어지거나 시간이 지나면 흐려질 수 있어요. "이건 절대 까먹으면 안 돼"라는 규칙은 메모리가 아니라 CLAUDE.md에 직접 써두는 게 확실해요. 메모리는 "알면 좋은 것", CLAUDE.md는 "반드시 지킬 것"으로 구분하면 돼요.
💡 Claude Code가 뭘 기억하고 있는지 확인할 수 있어요. "지금 나에 대해 기억하고 있는 거 보여줘"라고 물어보면 저장된 메모리를 보여줘요. 잘못 기억한 게 있으면 "그건 틀렸어, 삭제해줘"라고 하면 돼요.
4. 전체 그림: 구조가 쌓이는 방식
채팅 AI:
[빈 채팅창] → 사람이 매번 설명 → 결과
Claude Code:
[CLAUDE.md] → 규칙이 자동 적용
[Skills] → 반복 작업이 명령어 하나로
[Memory] → 경험이 자동으로 쌓임
↓
사람은 "뭘 할지"만 말하면 됨
핵심은 이거예요. 채팅 AI는 매번 처음부터 시작하고, Claude Code는 쌓인 구조 위에서 시작해요.
5. 지금 바로 해볼 것
Step 1: 규칙이 쌓이는 구조 만들기
Claude Code를 열고 이렇게 말해보세요.
"CLAUDE.md 만들어줘. 내가 작업하다가 '이건 항상 이렇게 해줘'라고 말하면 그걸 CLAUDE.md에 규칙으로 추가해줘."
처음에는 규칙이 거의 없어요. 그게 정상이에요. 함께 작업하면서 "이건 이렇게 해줘", "아까처럼 하지 말고 이렇게"라고 말할 때마다 규칙이 하나씩 쌓여요. 일주일만 써보면 나만의 규칙이 자연스럽게 만들어져 있어요. 이게 구조가 쌓인다는 거예요.
Step 2: 반복 작업을 스킬로 만들기
같은 말을 두 번 이상 하고 있다면,
"내가 매번 [이런 작업]을 하는데, 이걸 /명령어 하나로 실행할 수 있게 스킬 만들어줘"
Claude Code가 스킬 파일을 만들어주면, 다음부터는 명령어 하나로 끝이에요. 규칙은 CLAUDE.md에 쌓이고, 작업은 스킬에 쌓여요.
한 줄 정리
| 채팅 AI | Claude Code |
|---|---|
| 매번 설명해야 함 | 규칙 파일에 한 번만 써두면 됨 |
| 매번 시켜야 함 | 스킬로 명령어 하나면 됨 |
| 매번 잊어버림 | 자동으로 기억함 |
| 사람이 구조를 만들어야 함 | 도구가 구조를 담고 있음 |
AI 도구의 난이도는 성능이 결정하는 게 아니에요. 구조가 있느냐가 결정해요.
함께 보면 좋은 자료
Claude Code 공식 문서(한국어)에서 더 자세한 내용을 확인할 수 있어요.
- 지침 및 메모리 (CLAUDE.md): 규칙 파일과 자동 기억의 모든 것
- Skills로 확장하기: 스킬을 만들고 활용하는 방법
- 모범 사례: Claude Code를 잘 쓰기 위한 패턴
- 빠른 시작: 설치부터 첫 작업까지