Learning Guide · Claude Code
ONE PAGE GUIDE

클로드코드
학습 가이드

이 페이지는 Claude Code를 배우는 사람을 위한 한 페이지 가이드입니다. 처음 접했을 때 무엇부터 이해하고, 어떤 순서로 써보면 좋은지 빠르게 잡을 수 있게 정리했습니다.

먼저 기억하면 좋은 핵심

클로드코드를 볼 때 가장 먼저 잡을 관점

OT에서 먼저 잡아둘 4가지

처음 볼 때 이 네 가지를 먼저 이해하면 됩니다

포인트설명
1. 이 도구의 정체클로드코드는 설명만 해주는 도구가 아니라, 실제 폴더 안에서 같이 작업하는 에이전트형 도구입니다.
2. 오늘의 목표모든 기능을 외우는 것이 아니라, 어떤 순서로 써야 덜 헤매는지 감을 잡는 것이 먼저입니다.
3. 학습 방식바로 결과만 받기보다, 분석·계획·수정·검증 흐름을 한 번 따라가며 보는 게 중요합니다.
4. 남겨둘 것좋았던 프롬프트, 헷갈린 지점, 자주 틀린 부분을 자기만의 치트시트로 남기면 훨씬 빨라집니다.

클로드코드를 한 문장으로 이해하기

한 줄 정의

클로드코드는 코드에 대해 설명만 해주는 도구가 아니라, 실제 작업 환경 안에서 같이 움직이는 AI입니다.

쉽게 비유하면

일반 AI 채팅이 “방법을 알려주는 사람”이라면, 클로드코드는 같이 파일을 열고 손봐주는 조수에 더 가깝습니다.

비교

일반 AI 채팅과 무엇이 다른가

구분일반 AI 채팅클로드코드
코드 접근 방식코드를 붙여넣어야 함현재 폴더의 파일을 직접 읽을 수 있음
작업 범위설명 / 예시 중심설명 + 수정 + 실행 + 검증
맥락 유지대화 종료 시 약해짐프로젝트 문서와 파일 구조를 바탕으로 이어짐
확장성기본 채팅 중심MCP, Hooks, 서브에이전트로 확장 가능
처음 시작하는 순서

처음에는 이 순서가 가장 안정적입니다

  1. 클로드코드 설치와 로그인
  2. 작은 프로젝트 폴더 하나 열기
  3. “이 폴더가 어떤 프로젝트인지 설명해줘”부터 시작
  4. 바로 구현시키지 말고 분석과 계획을 먼저 시켜보기
npm install -g @anthropic-ai/claude-code claude
중요: 처음부터 거대한 프로젝트로 시작하지 말고, 파일 수가 적은 예제 프로젝트에서 흐름을 익히는 게 훨씬 좋습니다.
가장 중요한 작업 흐름

잘 되는 사람들의 공통 순서

단계무엇을 하나
1. 탐색관련 파일을 읽고 지금 구조를 설명하게 합니다.
2. 계획어떤 파일을 어떻게 바꿀지 먼저 설명하게 합니다.
3. 구현수정은 한 번에 크게 하지 말고 주요 단위별로 확인하면서 진행합니다.
4. 검증수정 후 테스트나 실행으로 확인하고 마지막에 변경 요약을 받습니다.
입문자용 습관: “바로 만들어줘”보다 “먼저 읽고 설명해줘”를 먼저 쓰는 것만으로도 결과 품질이 훨씬 좋아집니다.
CLAUDE.md

왜 중요한가

CLAUDE.md는 프로젝트의 성격, 규칙, 금지사항을 알려주는 문서입니다. 매번 다시 설명하지 않도록 프로젝트의 공통 맥락을 적어두는 곳이라고 보면 됩니다.

# 프로젝트 메모 ## 목적 - 이 프로젝트가 무엇을 하는지 한 줄로 설명 ## 스택 - 예: React / FastAPI / SQLite ## 규칙 - 함수명은 명확하게 - 테스트 먼저 확인 - 비밀키는 파일에 직접 쓰지 않기 ## 금지 사항 - 중요한 파일 삭제 전 확인 - 강제 푸시 금지
1주차 핵심

이번 주에 특히 잡아야 할 것

핵심왜 중요한가
작은 범위로 시작하기처음부터 큰 구현을 맡기면 실패 확률이 높습니다. 작은 작업으로 루프를 익히는 것이 먼저입니다.
읽기 → 계획 → 수정 순서 지키기바로 수정시키기보다 현재 구조를 먼저 읽히면 결과 품질이 훨씬 안정적입니다.
좋은 요청문 구조 익히기Claude Code 품질 차이는 모델보다도 요청 구조에서 크게 갈립니다.
내가 반복하는 일 하나 찾기1주차의 핵심은 완성품보다, 반복 가능한 작업을 Claude Code와 연결하는 감각을 잡는 것입니다.
Skills

Skills는 왜 중요할까

Skills는 Claude Code에게 특정 상황에서 어떤 방식으로 일해야 하는지 알려주는 작업 가이드입니다. 좋은 Skill이 있으면 막연한 요청보다 훨씬 안정적으로 같은 흐름을 재현할 수 있습니다.

1주차 관점: 처음부터 완벽한 Skill을 만드는 게 아니라, 내가 자주 하는 일 하나를 골라 "이럴 때 이런 순서로 답해줘" 수준의 초안을 만드는 것만으로도 충분합니다.
확장 기능

MCP · Hooks · Skills · 서브에이전트 차이

기능한 줄 설명언제 먼저 보면 좋은가
Skills특정 작업을 더 잘하게 만드는 작업 가이드반복되는 요청을 자주 하게 될 때
MCP외부 도구와 연결되는 확장 통로GitHub, 브라우저, DB 같은 외부 연결이 필요할 때
Hooks작업 전후 자동 후처리를 붙이는 장치테스트, 포맷, 검증을 자동화하고 싶을 때
서브에이전트조사·요약·검토처럼 일을 나눠 맡기는 보조 에이전트한 번에 처리할 일이 복잡해졌을 때

추천 순서: 기본 사용 → CLAUDE.md → Skills → MCP 한 개 → Hooks

스킬집

같이 보여주면 좋은 Skill 관점

발표 직후에는 “그래서 뭘 만들 수 있느냐”보다, 이런 종류의 Skill을 만들 수 있다는 감을 주는 게 더 중요합니다.

설명 팁: Skill은 거창한 제품이 아니라, "내가 자주 하는 일을 더 일관되게 시키는 작은 작업 규칙"이라고 설명하면 이해가 빠릅니다.
1주차 실습 루프

발표 직후 바로 해보면 좋은 최소 루프

  1. 작은 폴더 하나를 연다
  2. "이 폴더가 어떤 프로젝트인지 설명해줘"라고 시킨다
  3. "지금 수정하지 말고, 먼저 어떤 순서로 손보면 좋을지 계획해줘"라고 한다
  4. 작은 수정 하나만 시킨다
  5. 마지막에 "왜 이렇게 바꿨는지 요약해줘"라고 묻는다
핵심: 1주차에 중요한 건 대단한 결과물이 아니라, 이 한 바퀴를 직접 돌려보는 것입니다.
체감하기 쉬운 활용 예

이런 작업에서 바로 도움이 됩니다

많이 하는 실수

처음에 자주 막히는 이유

입문자용 프롬프트 예시

바로 복사해서 써볼 수 있는 요청문

프로젝트 구조 이해

이 폴더 구조를 읽고 어떤 프로젝트인지 설명해줘. 관련 파일들을 먼저 읽고, 지금은 수정하지 말고 이해한 내용만 정리해줘.

버그 원인 찾기

아래 에러가 나. 바로 수정하지 말고 원인부터 설명해줘. 관련 파일 읽고 어떤 부분이 문제인지 알려줘. [에러 메시지 붙여넣기]

새 기능 계획 확인

[원하는 기능]을 추가하고 싶어. 현재 구조를 읽고, 어떤 파일을 어떻게 바꾸면 좋을지 계획 먼저 설명해줘. 코드 수정은 내가 확인한 뒤 시작해줘.

Skill 초안 만들기

내가 자주 하는 일은 "[반복 작업]"이야. 이 작업을 도와주는 Skill 초안을 만들어줘. 아래 형식으로 써줘. 1) 언제 쓰는지 2) 잘해야 하는 것 3) 답변 형식 4) 하면 안 되는 것

발표 직후 시연용

이 폴더를 먼저 읽고, 어떤 프로젝트인지 5줄로 설명해줘. 그 다음 지금 가장 먼저 해야 할 일 3가지를 우선순위대로 말해줘. 지금은 수정하지 말고 분석과 계획만 해줘.
FAQ

수강생이 많이 묻는 질문

질문답변
무엇부터 연습하면 좋을까요?작은 프로젝트에서 구조 파악 → 계획 확인 → 간단한 수정 → 실행 확인 순서를 한 번 완주해보는 게 가장 좋습니다.
언제 MCP나 Hooks로 넘어가면 될까요?기본 흐름이 익숙해지고 반복되는 작업이 보일 때가 좋습니다.
비개발자인데 따라갈 수 있을까요?네. 폴더를 읽고 설명하게 하기 → 계획 받기 → 작은 수정 시키기, 이 세 가지만 익혀도 충분히 시작할 수 있습니다.
실습 중 어디서 가장 많이 막히나요?대부분은 지시가 너무 넓거나, 현재 폴더 맥락을 충분히 읽히지 않은 상태에서 시작해서 막힙니다.
결과가 이상하면 처음부터 다시 시켜야 하나요?그럴 필요 없습니다. 기대와 다른 부분, 유지할 것, 바꾸고 싶은 것을 짧게 피드백하면 됩니다.