Claude Code가 다른 AI와 다른 이유
채팅 AI(ChatGPT, Gemini 등)는 빈 채팅창에서 시작해요. 잘 쓰려면 사람이 매번 잘 시켜야 하고, 어제 됐던 것도 오늘 다시 설명해야 해요.
Claude Code는 달라요. 도구 자체가 구조를 담고 있어요. 한 번 정해둔 규칙은 매번 자동으로 적용되고, 반복 작업은 명령어 하나로 실행돼요. 쓰면 쓸수록 도구가 나한테 맞춰져요.
이 가이드는 그 구조가 뭔지, Claude Code한테 어떻게 요청하면 되는지를 알려드려요.
💡 시작 코스로 오셨다면: 오늘은 1번(규칙 파일)만 따라 해도 충분해요. 스킬과 메모리는 개념만 눈에 익혀두고, 필요해질 때 다시 오면 돼요.
1. 규칙 파일 (CLAUDE.md): "내 방식을 도구에 새기는 것"
이게 뭔가요?
채팅 AI한테 "한국어로 답해", "코드에 주석 달아줘"를 매번 말하고 있다면, 그걸 한 번만 적어두는 파일이에요.
CLAUDE.md라는 파일에 써두면, Claude Code가 매번 대화를 시작할 때 자동으로 읽어요. 채팅 AI처럼 "까먹는" 일이 없어요. 혹시 파일 안전 설정에서 ~/.claude/CLAUDE.md에 규칙을 적어봤다면, 바로 그 파일이에요.
어떻게 만들까요?
직접 파일을 만들 필요 없어요. 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 실행해줘"라고 넣어두면, 블로그 글 작성이 끝나면 자동으로 리뷰까지 이어져요. 이렇게 스킬을 연결하면 여러 단계의 작업이 명령어 하나로 끝나요.