Claude Code 사용법: 처음 30분에 익힐 6가지 핵심

Claude Code 사용법의 핵심은 여섯 가지입니다. 프로젝트 폴더에서 실행하기, CLAUDE.md에 규칙 적기, 슬래시 명령 익히기, 플랜 모드로 먼저 계획하기, 컨텍스트를 짧게 유지하기, 작게 자주 커밋하기입니다. 이 여섯 가지만 익히면 처음 30분 안에 실제 작업에 쓸 수 있습니다.

1. 프로젝트 폴더에서 열기

Claude Code는 실행한 폴더를 작업 범위로 삼습니다. 그래서 항상 프로젝트 루트에서 시작합니다.

cd ~/my-project
claude

첫 대화는 코드를 고치는 요청보다 이해를 확인하는 질문이 좋습니다.

이 프로젝트의 폴더 구조와 주요 진입점을 설명해 줘

특정 파일을 보게 하려면 @ 뒤에 경로를 씁니다. @src/app/page.tsx 이 파일의 역할이 뭐야처럼 쓰면 그 파일을 읽고 답합니다. 폴더 전체를 매번 훑게 하는 것보다 파일을 지정하는 편이 빠르고 정확합니다.

작업이 끝나면 Ctrl+C를 두 번 눌러 종료합니다. 직전 대화로 돌아오려면 claude --continue, 목록에서 고르려면 claude --resume을 씁니다.

2. CLAUDE.md에 규칙 적기

CLAUDE.md는 Claude Code가 세션을 시작할 때마다 자동으로 읽는 파일입니다. 프로젝트의 규칙과 맥락을 여기에 적어 두면 매번 설명할 필요가 없습니다.

처음에는 /init으로 만듭니다. 프로젝트를 분석해 초안을 써 줍니다. 그다음 저는 아래 항목만 남기고 다듬습니다.

빌드, 테스트, 실행 명령
코드 스타일 중 도구가 잡아 주지 않는 것
건드리면 안 되는 폴더나 파일
자주 틀리는 부분에 대한 지시

길게 쓰지 않는 것이 중요합니다. CLAUDE.md는 매 대화의 컨텍스트에 들어가므로 길수록 비용이 늘고 집중도는 떨어집니다. 저는 50줄 안쪽을 기준으로 잡습니다.

대화 중에 새 규칙이 생기면 #으로 시작하는 메시지를 보내면 됩니다. Claude가 CLAUDE.md에 기록할지 물어봅니다. 개인 취향은 프로젝트 파일이 아니라 ~/.claude/CLAUDE.md에 적으면 모든 프로젝트에 적용됩니다.

3. 꼭 알아야 할 슬래시 명령

대화창에서 /를 입력하면 명령 목록이 나옵니다. 처음 30분에 필요한 것은 이 정도입니다.

명령	하는 일
`/help`	명령 목록과 설명
`/init`	CLAUDE.md 초안 생성
`/clear`	대화 기록 초기화
`/compact`	대화를 요약해 컨텍스트 줄이기
`/model`	사용할 모델 변경
`/cost`	현재 세션의 토큰 사용량과 비용
`/usage`	구독 플랜의 사용량 한도 확인
`/permissions`	자동 허용할 도구 관리
`/review`	변경 사항 코드 리뷰
`/resume`	이전 대화 이어 가기

자주 반복하는 지시는 직접 명령으로 만들 수 있습니다. .claude/commands/ 폴더에 마크다운 파일을 두면 파일 이름이 명령이 됩니다. 예를 들어 .claude/commands/test.md를 만들면 /test로 호출합니다.

4. 플랜 모드로 먼저 계획하기

Claude Code에는 권한 모드가 있습니다. Shift+Tab을 누를 때마다 바뀝니다.

기본 모드: 파일 수정이나 명령 실행 전에 매번 허가를 묻습니다.
자동 수락 모드: 파일 편집은 묻지 않고 진행합니다.
플랜 모드: 파일을 읽고 계획만 세웁니다. 아무것도 수정하지 않습니다.

기능 하나를 새로 만들거나 여러 파일을 건드리는 작업은 플랜 모드로 시작합니다. 계획을 읽고 방향이 맞으면 그때 실행 모드로 바꿉니다. 이 습관 하나로 잘못된 방향으로 크게 수정하는 일이 눈에 띄게 줄었습니다.

작은 수정은 바로 기본 모드에서 시킵니다. 모든 작업에 계획을 세우면 오히려 느려집니다.

5. 컨텍스트를 짧게 유지하기

Claude Code는 대화 전체를 기억한 채로 답합니다. 대화가 길어질수록 답이 느려지고, 앞부분의 무관한 내용에 끌려갑니다. 비용도 늘어납니다.

제가 지키는 규칙은 세 가지입니다.

작업 하나가 끝나면 /clear로 비웁니다. 다음 작업은 새 대화에서 시작합니다.
한 작업이 길어져 컨텍스트가 차면 /compact로 요약합니다. 요약에 남길 내용을 함께 적을 수 있습니다.
큰 로그 파일이나 데이터 파일을 통째로 읽히지 않습니다. 필요한 부분만 잘라서 보여 줍니다.

화면 하단에 컨텍스트 사용량이 표시됩니다. 절반을 넘기면 정리할 시점으로 봅니다.

6. 작게 자주 커밋하기

Claude Code가 고친 내용은 되돌릴 수 있어야 합니다. 그 안전장치가 git입니다.

작업을 시키기 전에 작업 트리를 깨끗하게 둡니다. 그래야 git diff로 Claude가 바꾼 것만 볼 수 있습니다.
작업 단위마다 커밋합니다. "커밋해 줘"라고 하면 변경 내용을 읽고 메시지까지 씁니다.
결과가 마음에 들지 않으면 git checkout .으로 되돌리고 지시를 바꿔 다시 시킵니다.

한 대화에서 여러 기능을 한꺼번에 시키고 마지막에 한 번 커밋하는 방식은 권하지 않습니다. 중간에 잘못된 부분을 골라내기 어렵습니다.

잘 되는 지시와 안 되는 지시

같은 도구인데 결과 차이가 크게 나는 이유는 대부분 지시 방식입니다.

잘 안 되는 지시	잘 되는 지시
로그인 기능 만들어 줘	이메일과 비밀번호로 로그인하는 API를 `src/app/api/login/route.ts`에 만들어 줘. 세션은 기존 `lib/session.ts`를 써
버그 고쳐 줘	결제 버튼을 누르면 콘솔에 아래 오류가 나. 원인을 찾고, 고치기 전에 먼저 설명해 줘
코드 정리해 줘	`components/` 안에서 쓰이지 않는 컴포넌트를 찾아 목록만 보여 줘

파일 경로, 기대 결과, 제약 조건을 함께 적으면 대부분 한 번에 됩니다. 지시문 작성이 익숙하지 않으면 프롬프트 빌더로 구조를 잡아 보는 것도 방법입니다.

자주 묻는 질문

코딩을 모르는데 Claude Code를 쓸 수 있나요?

가능합니다. 다만 결과를 확인하는 방법은 알아야 합니다. 실행해 보고, 화면을 보고, 오류 메시지를 그대로 붙여 넣는 습관이면 충분합니다. 용어가 낯설면 바이브 코딩이란 무엇인가부터 읽는 것을 권합니다.

Claude Code와 Cursor 중 무엇을 써야 하나요?

목적이 다릅니다. Cursor는 편집기 안에서 코드를 쓰는 데 강하고, Claude Code는 터미널에서 작업 전체를 맡기는 데 강합니다. 저는 둘을 같이 씁니다. 도구별 비교는 2026년 바이브 코딩 도구 정리에 있습니다.

실수로 파일을 지우면 어떻게 하나요?

git으로 관리 중이면 git checkout이나 git restore로 되돌립니다. 그래서 커밋 습관이 중요합니다. git 없이 쓰는 폴더에서는 위험한 작업 전에 플랜 모드로 확인하십시오.

한 번에 얼마나 큰 작업을 시킬 수 있나요?

한 대화에 한 기능이 기준입니다. 파일 다섯 개 안쪽, 변경 몇백 줄 안쪽이면 안정적입니다. 그보다 크면 단계로 나누고, 단계마다 커밋합니다.

다음 단계

아직 설치 전이라면 Claude Code 설치 방법을 먼저 보십시오.
사용량이 걱정되면 Claude Code 가격과 요금제 정리와 비용 계산기를 확인하십시오.
기본이 익숙해지면 MCP, Skills, 서브에이전트로 확장하기로 넘어가십시오.
실제 제품을 만드는 과정을 처음부터 배우고 싶다면 AI Creator Lab 강의와 수강료 안내를 확인하십시오.