코딩 몰라도 OK! 클로드 코드 35가지 핵심 개념, 왕초보를 위한 완벽 설명!

Claude Code 완전 정복 가이드 (중학생 눈높이)

와, 요즘 Claude Code 기능이랑 튜토리얼이 매일 쏟아져 나와서 따라가기 벅차지? 특히 코딩 경험이 없으면 더 그럴 거야. 그래서 오늘은 처음부터 차근차근 Claude Code를 배우는 방법을 알려줄게. 총 35가지 개념을 4가지 파트로 나눠서, 쉬운 것부터 시작해서 나중에 고급 기능까지 다룰 거야. 이걸 다 보고 나면 Claude Code를 어떻게 써야 할지 확실히 알게 될 거야!

1. Claude.ai 웹앱 vs Claude Code: 뭐가 다를까?

• 핵심: 둘 다 똑똑한 AI 두뇌(모델)를 사용해.
• Claude Code의 특별함: Claude Code는 이 똑똑한 두뇌에 '몸'이랑 '손'이 달린 거야. 그래서 코드를 짜거나, 이메일을 확인하거나, 컴퓨터 작업을 대신 해줄 수 있어. 즉, Claude Code는 직접 일을 할 수 있다는 게 가장 큰 차이점이야.

2. Claude Code 설치하기: 생각보다 쉬워!

• 방법: 구글에 "Claude Code install"이라고 검색하면 공식 문서가 나와.
• 핵심: 터미널(명령 프롬프트 같은 거야)에 코드 한 줄 복사해서 붙여넣기만 하면 돼.
  • Mac, Linux, WSL 사용자: 이 코드를 복사해!
  • Windows PowerShell 사용자: 이 코드를 복사해!
• 터미널/PowerShell 찾는 법: 윈도우 검색창에 "PowerShell"이라고 치거나, 맥에서도 검색하면 돼.
• 설치 과정:
  1. 터미널 열고 코드 붙여넣고 실행.
  2. 설치 마법사가 시키는 대로 따라가.
  3. 로그인하고 구독 플랜 선택.
  4. 설치 끝나면 터미널에 "Claude"라고 치면 실행돼!

3. Claude Code 어디서 쓰지? (헷갈릴 수 있어!)

Claude Code는 여러 곳에서 쓸 수 있어.

• 터미널: 위에서 본 것처럼 명령어로 직접 쓰는 방식.
• Claude Code 데스크톱 앱: 좀 더 친절한 인터페이스를 가진 앱.
• Code Work: 이것도 비슷한 방식이야.
• VS Code (IDE): 코딩할 때 많이 쓰는 프로그램인데, 여기에 Claude Code를 같이 쓸 수 있어. 파일도 보고, 터미널도 쓰고.

결론: 처음에는 뭐가 제일 좋은지 헷갈릴 수 있는데, 결국 터미널에서 쓰는 게 제일 강력해. VS Code 같은 IDE 안에서 터미널을 쓰는 것도 좋은 방법이야.

초보자 팁: 처음에는 데스크톱 앱이나 Code Work처럼 쉬운 인터페이스로 시작해도 괜찮아. 대부분의 작업은 어디서든 할 수 있거든. 그래도 터미널 사용을 1~2주 정도 시도해보는 걸 추천해. 익숙해지면 더 강력한 기능을 쓸 수 있을 거야. 터미널은 생각보다 무섭지 않아. 그냥 명령어를 입력하는 창일 뿐이야.

VS Code 사용법:

1. 구글에 "VS Code" 검색해서 무료로 다운로드하고 설치.
2. VS Code 열고 "파일" > "폴더 열기" 선택.
3. 새 폴더 만들고 이름 정하기 (예: 35-test).
4. "터미널" > "새 터미널" 클릭.
5. 터미널에 "Claude" 입력해서 Claude Code 실행.

4. 권한 설정: Claude Code가 내 컴퓨터를 건드려도 될까?

• Shift + Tab 누르면 나오는 옵션: 이게 바로 권한 설정이야. Claude Code가 내 허락 없이 내 컴퓨터에 뭘 할 수 있는지 정하는 거야.
• 기본 설정 (빈칸): 파일을 수정하려면 항상 물어봐.
• "Accept Edits On" 켜기: 파일을 자동으로 수정해줘. 좀 더 빨라.
• "Bash Commands" (터미널 명령어) 실행 시: 프로그램을 다운로드하거나 컴퓨터 설정을 바꾸는 건 허락을 받아야 해.
• "Dangerously Skip Permissions" (위험하게 권한 건너뛰기): 파일을 편집하거나 삭제하거나 다운로드하는 걸 모두 허락하는 거야. 처음엔 무서울 수 있지만, 익숙해지면 엄청 편해. 대부분의 사람들이 결국 이 설정을 사용해. 그래도 처음에는 "Accept Edits On"으로 시작하는 게 좋아.

5. Plan Mode: Claude Code가 똑똑하게 계획을 세우게 하자!

• Shift + Tab 두 번 누르면 나와.
• 기능: "웹사이트 만들어줘"라고 하면, 그냥 바로 만드는 게 아니라 어떻게 만들지 계획을 세우고 단계를 보여줘.
• 왜 중요할까? Plan Mode는 Claude Code한테 더 좋은 결과물을 얻게 해주는 최고의 방법이야. 내가 뭘 원하는지 더 자세히 물어보고, 내 생각을 정리하게 도와주거든.
• 사용법:
  1. "웹사이트 만들어줘"라고 말해.
  2. Claude Code가 "어떤 종류의 웹사이트야?"라고 물어봐.
  3. "랜딩 페이지"라고 대답해.
  4. "어떤 기술 스택 쓸까?" 물어보면, 잘 모르면 1번(기본값)을 선택해.
  5. "개인 프로젝트용이야"라고 목적을 말해줘.
  6. "제출" 누르면 계획이 시작돼.

6. 마인드셋: Claude Code를 동료처럼 생각하자!

• 핵심: Claude Code를 그냥 도구로 생각하지 말고, 함께 일하는 동료라고 생각해.
• 가장 중요한 것: Claude Code가 시키는 대로만 하지 말고, 질문하고 배우려고 노력해야 해.
  • 예시: "Next.js랑 Tailwind CSS 쓸래?"라고 그냥 말하지 말고, "Next.js랑 Tailwind CSS가 뭔지 설명해줘"라고 물어봐야 해.
• 왜? 이렇게 질문해야 네 실력이 늘어. 그냥 시키는 대로만 하면, 다른 사람도 똑같이 할 수 있어서 너만의 강점이 없어지잖아. Claude Code는 네가 질문할 때까지 무한히 기다려주는 친절한 선생님이야.

Plan Mode 결과물:

• Claude Code가 웹사이트를 만들기 전에 상세한 계획을 보여줄 거야.
• "Yes, bypass permissions" (권한 건너뛰고 실행)을 누르면 바로 만들어줘.
• "Yes, manually approve edits" (수정할 때마다 승인)를 누르면 하나씩 물어보고 진행해.
• "No, refine with ultra plan"은 나중에 배울 고급 기능이야.

7. claude.md 파일: Claude Code의 비밀 지령서

• Claude Code가 프로젝트를 만들 때 자동으로 생기는 파일이야.
• 역할: 이 프로젝트에서 Claude Code가 따라야 할 규칙이나 약속을 적어놓는 곳이야.
• 중요성: 여기에 뭘 적느냐에 따라 Claude Code가 네 프로젝트를 다르게 이해하고 작업할 거야. 처음에는 신경 안 써도 되지만, 나중에 프로젝트를 더 잘 만들고 싶을 때 유용해.

8. 컨텍스트 창 (Context Window): Claude Code의 기억력

• 확인 방법: /context라고 입력하면 돼.
• 토큰이란? Claude Code가 이해하는 말의 단위야. 단어 하나하나가 토큰이라고 생각하면 돼. (정확히는 조금 다르지만, 일단 이렇게 이해하자!)
• 컨텍스트 창 크기: Claude Code는 한 번에 100만 토큰까지 기억할 수 있어.
• 왜 중요할까?
  • 컨텍스트 창이 꽉 차면 대화가 끊길 수 있어.
  • 컨텍스트 로트 (Context Rot): 컨텍스트 창에 내용이 많아질수록 Claude Code의 성능이 떨어질 수 있어. 마치 오래된 기억처럼 흐릿해지는 거지.
• 해결책: /clear 명령어로 컨텍스트 창을 초기화할 수 있어.
  • 주의: 일반 챗봇과 달리 Claude Code는 프로젝트 폴더에 저장되기 때문에, 초기화해도 코드 내용을 기억하고 있어. 그래서 컨텍스트 창을 자주 초기화하는 게 좋아.

9. 상태 표시줄 (Status Line): 한눈에 보는 Claude Code 정보

• /status_line 명령어로 만들 수 있어.
• 기능: 현재 작업 중인 폴더 이름, 사용 중인 모델, 컨텍스트 창 사용량 등을 화면 하단에 계속 보여줘. /context를 매번 입력할 필요 없이 편하게 확인할 수 있지.

10. 되돌리기 (Rewind): 실수해도 괜찮아!

• /rewind 명령어를 사용하면 이전 대화나 코드 변경 사항으로 돌아갈 수 있어. 마치 게임에서 저장하고 불러오는 것과 비슷해.

11. 모델 변경 (/model): Claude Code의 똑똑함 레벨 조절

• /model 명령어로 Opus, Sonnet, Haiku 등 다양한 Claude Code 모델을 선택할 수 있어.
• 어떤 모델을 써야 할까? 네가 가입한 플랜에 따라 달라져.
  • Pro 플랜: Sonnet 모델을 주로 사용.
  • Max 5x 플랜: Opus 모델도 자주 사용 가능.
  • 20x 플랜: Opus 모델을 마음껏 사용 가능.
  • Haiku 모델: 아주 빠르고 저렴하지만, 특별한 경우에만 사용해.
• "Effort" 설정: Claude Code가 얼마나 깊이 생각할지 조절하는 건데, 높을수록 토큰을 많이 써.

12. Git: 코드 버전 관리의 필수템!

• 기능: Claude Code의 "되돌리기" 기능과 비슷하지만, 코드 자체를 저장하는 데 더 특화되어 있어.
• 사용법: "Git commit"이라고 말하면 코드를 저장해줘.
• 왜 중요할까? 나중에 GitHub 같은 곳에 코드를 올릴 때 꼭 필요해. Git으로 코드를 저장해두면 실수로 코드를 날릴 걱정을 덜 수 있어.

---

3. 툴킷: Claude Code를 더 강력하게 만드는 도구들

13. 스킬 (Skills): Claude Code에게 특별한 능력을 부여!

• 개념: 스킬은 Claude Code에게 특정 작업을 특정 방식으로 하도록 지시하는 텍스트 프롬프트야.
• 예시: "프론트엔드 디자인 스킬"은 Claude Code에게 더 멋진 웹사이트 디자인을 만들도록 지시하는 거야.
• 사용법:
  1. /plugin 명령어로 플러그인 마켓플레이스 열기.
  2. "front-end design skill" 검색해서 설치.
  3. 설치 후 "프론트엔드 디자인 스킬 써줘"라고 말하거나, /front_design처럼 명령어 입력.
• 중요: 스킬은 사용자 레벨 (모든 프로젝트에서 사용 가능)과 프로젝트 레벨 (특정 프로젝트에서만 사용 가능)로 나눌 수 있어.

14. 스킬 크리에이터 스킬 (Skill Creator Skill): 나만의 스킬 만들기!

• 기능: 반복적인 작업을 스킬로 만들 수 있게 도와줘.
• 장점: 만든 스킬이 얼마나 효과적인지 측정해주고, 기존 스킬을 개선하는 데도 도움을 줘.
• 사용법: 플러그인 마켓플레이스에서 "skill creator skill" 검색해서 설치.

15. MCP와 CLI 도구: 외부 프로그램과 연동하기

• MCP (Multi-Cloud Platform): Claude Code를 다른 프로그램(예: Notion, Figma)과 연결해주는 도구.
  • 사용법: Claude Code 문서에서 필요한 MCP 도구의 명령어를 복사해서 터미널에 붙여넣거나, "Notion MCP 설정해줘"라고 Claude Code에게 요청.
  • 주의: 계정 정보(API 키 등)가 필요할 수 있어. Claude Code가 친절하게 안내해줄 거야.
• CLI (Command Line Interface): 터미널에서 직접 실행되는 프로그램. MCP보다 빠르고 효율적이야.
  • 예시: Playwright CLI (웹 브라우저 자동화)
  • 사용법: MCP와 비슷하게 Claude Code에게 설정 요청.
  • 권장: CLI가 있다면 MCP보다 CLI를 사용하는 게 좋아.

팁: 처음에는 CLI와 MCP가 있다는 것만 알아두고, 필요할 때 Claude Code에게 물어보는 게 좋아. 너무 많은 도구를 한꺼번에 설치하면 오히려 복잡해질 수 있어.

16. Few-Shot Prompting: 예시를 보여주며 똑똑하게 만들기

• 개념: Claude Code에게 원하는 결과물을 보여주기 위해 여러 개의 예시를 함께 제공하는 거야.
• 예시: 웹사이트 디자인을 개선하고 싶을 때, 원하는 디자인의 스크린샷이나 실제 코드를 보여주는 거지.
• 효과: Claude Code가 네 의도를 더 정확하게 파악하고 원하는 결과물을 만들어줘.

17. 적대적 프롬프트 & 코드 검토 (Adversarial Prompting & Code Review): 꼼꼼하게 확인하기

• 적대적 코드 검토: Claude Code가 만든 코드를 다른 AI(예: Codex 플러그인)나 또 다른 Claude Code 세션에게 "이 코드에 뭐가 문제야?"라고 꼼꼼하게 물어보는 거야.
• 왜 필요할까? AI는 자기 코드를 좋게 평가하는 경향이 있어. 그래서 다른 시각으로 검토하는 게 중요해. 특히 코딩 경험이 적다면 필수야!

---

4. 파워 유저 섹션: 더 깊이 파고들기!

이 섹션부터는 좀 더 고급 기능들이야. 처음부터 다 알 필요는 없지만, 이런 기능들이 있다는 걸 알아두면 나중에 큰 도움이 될 거야.

18. 사용자 정의 명령어 & 스킬 (Custom Commands & Skills)

• /로 시작하는 명령어 외에, 나만의 명령어와 스킬을 만들 수 있어.
• 예시: 유튜브 영상 검색 워크플로우를 "yt-pipeline"이라는 나만의 스킬로 만들 수 있어.
• 활용: 여러 단계를 거치는 복잡한 작업을 자동화하거나, 자주 사용하는 스킬들을 묶어서 하나의 명령어로 만들 수 있어.

19. 훅 (Hooks): 특정 시점에 자동으로 실행되는 기능

• 개념: 특정 명령어가 실행되기 전이나 후에 자동으로 실행되는 기능이야.
• 예시: Claude Code가 명령을 끝낼 때마다 소리가 나게 하는 훅을 만들 수 있어.
• 장점: 작업 완료 알림을 받거나, 특정 작업을 자동으로 실행시켜 생산성을 높일 수 있어.

20. 서브 에이전트 & 에이전트 팀 (Sub-Agents & Agent Teams)

• 서브 에이전트: Claude Code가 스스로 특정 작업을 위해 임시로 만드는 또 다른 Claude Code 인스턴스야. (예: 웹 검색만 하는 에이전트)
• 에이전트 팀: 여러 서브 에이전트가 서로 협력해서 더 복잡한 작업을 수행하는 거야. 마치 팀원들이 함께 일하는 것처럼.
• 주의: 에이전트 팀은 더 많은 토큰을 사용하고, 아직 실험적인 기능이야. 설정을 따로 켜줘야 해.

21. 여러 세션 & Git Worktrees: 동시에 여러 작업하기

• 여러 세션: 여러 개의 터미널 창을 열어서 동시에 여러 작업을 할 수 있어.
• Git Worktrees: 여러 세션에서 작업할 때 파일 충돌을 방지하고 각자 독립적인 작업 공간을 만들어주는 기능이야. 마치 각자 책상에서 일하는 것처럼.

22. 프레임워크 (Frameworks): Claude Code를 더 체계적으로 사용하기

• GSD, Bmad 같은 프레임워크들은 Claude Code를 더 효율적으로 사용하도록 도와주는 도구들이야.
• 주의: 이런 프레임워크들은 Claude Code의 기본 기능에 익숙해진 후에 사용하는 것이 좋아.

23. 트리거 & 예약 작업 (Triggers & Scheduled Tasks): 자동화의 끝판왕

• 트리거: 특정 이벤트가 발생했을 때 자동으로 실행되는 기능 (훅과 비슷).
• 예약 작업: 정해진 시간에 Claude Code가 작업을 수행하도록 설정하는 거야.
  • Loop 명령어: 현재 열려있는 터미널에서 주기적으로 작업을 반복할 때 사용. (최대 7일)
  • Claude Code 데스크톱 앱: 좀 더 강력한 예약 작업 기능을 제공해. 컴퓨터가 꺼져있어도 실행될 수 있어.

24. 울트라 플랜 (Ultra Plan): 클라우드에서 더 똑똑하게 계획 세우기

• 기능: Plan Mode와 비슷하지만, 클라우드에서 작동하며 더 강력한 AI 에이전트들이 협력해서 계획을 세워줘.
• 장점: 더 나은 인터페이스와 피드백 기능을 제공해.

25. 원격 제어 (Remote Control): 휴대폰으로 Claude Code 사용하기

• Claude Code 모바일 앱을 사용해서 휴대폰으로도 Claude Code 세션을 제어할 수 있어. 마치 내 컴퓨터 터미널을 휴대폰으로 스트리밍하는 것처럼.

26. 새로운 도구 찾기: GitHub 활용하기

• GitHub Trending: 최신 Claude Code 관련 도구나 라이브러리를 찾는 데 아주 유용해.
• Claude Code에게 요청: Claude Code에게 매일 최신 AI 관련 GitHub 저장소를 찾아달라고 요청할 수도 있어.

---

이것으로 Claude Code의 기본적인 개념부터 고급 기능까지 쭉 살펴봤어. 처음에는 좀 어렵게 느껴질 수 있지만, 하나씩 따라 하다 보면 금방 익숙해질 거야. Claude Code는 정말 강력한 도구니까, 꾸준히 배우고 활용해서 멋진 결과물들을 만들어내길 바라!