Claude Code 사용법: 처음 세션에서 익힐 6가지 핵심
프로젝트 폴더에서 실행, 짧은 CLAUDE.md, 슬래시 명령, 플랜 모드, 컨텍스트 관리, 작은 커밋 여섯 가지를 공식 문서 기준으로 정리했습니다.
Claude Code 사용법의 핵심은 여섯 가지입니다. 프로젝트 폴더에서 실행하기, CLAUDE.md에 짧게 규칙 적기, 슬래시 명령 익히기, 플랜 모드로 먼저 계획하기, 컨텍스트를 짧게 유지하기, 작게 자주 커밋하기입니다. 이 여섯 가지면 첫 세션에서 실제 작업에 쓸 수 있습니다. 숙련에 걸리는 시간은 사람마다 다릅니다.
1. 프로젝트 폴더에서 열기
실행한 폴더가 작업 범위입니다. 항상 프로젝트 루트에서 시작합니다.
cd ~/my-project
claude
첫 대화는 수정보다 이해가 낫습니다.
이 프로젝트의 폴더 구조와 주요 진입점을 설명해 줘
특정 파일은 @ 뒤에 경로를 붙입니다. @src/app/page.tsx 이 파일의 역할이 뭐야처럼요. 폴더 전체를 매번 훑게 하면 느리고 비쌉니다.
종료는 Ctrl+C를 두 번입니다. 직전 대화는 claude --continue, 목록에서 고르려면 claude --resume입니다.
연습용 지시는 첫 세션 샘플 프롬프트를 그대로 쓸 수 있습니다. 허구 예시입니다.
2. CLAUDE.md에 규칙 적기
CLAUDE.md는 세션을 시작할 때 읽는 프로젝트 규칙 파일입니다. /init으로 초안을 만든 뒤, 아래만 남기는 편이 낫습니다.
- 빌드, 테스트, 실행 명령
- 도구가 못 잡는 코드 스타일
- 건드리면 안 되는 폴더
- 자주 틀리는 부분에 대한 지시
공식 비용 문서는 CLAUDE.md를 200줄 안쪽으로 두고, 특정 작업 절차는 Skills로 빼라고 합니다. 매 대화에 들어가는 고정 비용이기 때문입니다. 개인 취향은 ~/.claude/CLAUDE.md에 두면 모든 프로젝트에 적용됩니다.
규칙을 추가할 때는 파일을 직접 고치거나, 세션에서 /memory로 CLAUDE.md를 연 뒤 저장합니다. 메모리 문서 기준입니다. 프롬프트 맨 앞의 빠른 입력은 /(명령·스킬), !(셸), @(파일), :(이모지), 빈 칸에서 ?(도움말)입니다.
작은 예: 메모 정리 프로젝트
아래는 샘플입니다. 실제 팀 규칙이 아닙니다.
# 메모 정리
- 입력은 public/samples/meeting-notes-before.txt 만 사용한다
- 결과는 결정 사항 / 할 일 / 확인이 필요한 사실 세 섹션으로 나눈다
- 출처 없는 숫자는 외부에 쓰지 말라고 표시한다
- 결제·인증 코드를 만들지 않는다
이 규칙으로 정리한 기대 결과는 meeting-notes-after.md와 같은 골격입니다.
3. 꼭 알아야 할 슬래시 명령
/를 입력하면 목록이 나옵니다. 처음 세션에 필요한 것은 이 정도입니다.
| 명령 | 하는 일 |
|---|---|
/help | 명령 목록 |
/init | CLAUDE.md 초안 |
/clear | 대화 초기화 |
/compact | 대화를 요약해 컨텍스트 줄이기 |
/model | 모델 변경 |
/usage | 구독 한도와 세션 토큰 통계 |
/memory | CLAUDE.md와 자동 메모리 파일 열기 |
/permissions | 자동 허용할 도구 |
/mcp | MCP 서버 상태 |
/plugin | 플러그인 |
세션 비용 숫자는 /usage에 나옵니다. 구독자에게 이 달러는 청구서가 아닙니다. API 사용자는 Console Usage가 기준입니다.
반복 절차는 .claude/commands/이름.md도 동작하지만, 공식 문서는 새 작업은 .claude/skills/이름/SKILL.md를 쓰라고 합니다. 둘 다 /이름으로 호출됩니다.
4. 플랜 모드로 먼저 계획하기
터미널에서는 Shift+Tab으로 권한 모드를 순환합니다. Desktop Code 탭의 단축키는 다릅니다. CLI 습관을 Desktop에 그대로 적용하지 마십시오.
문서에 적힌 모드의 실무 의미는 이렇습니다.
- 기본(Manual): 파일 수정·명령 실행 전에 묻습니다.
- Accept edits: 파일 편집은 자동, 다른 명령은 묻습니다.
- 플랜: 읽고 계획만 세웁니다. 소스 수정은 하지 않습니다.
- Auto: 백그라운드 안전 검사와 함께 실행합니다. 모델·플랜 조건이 있습니다.
여러 파일을 건드리는 기능은 플랜으로 시작합니다. 작은 수정은 기본 모드로 바로 시킵니다.
5. 컨텍스트를 짧게 유지하기
대화가 길수록 매 요청에 전체 기록이 따라갑니다. 비용 문서의 1순위 습관은 작업이 끝나면 /clear입니다.
- 작업 하나가 끝나면
/clear - 한 작업이 길어지면
/compact - 큰 로그는 통째로 읽히지 않기
화면 하단 또는 /usage로 컨텍스트 사용량을 봅니다.
6. 작게 자주 커밋하기
되돌릴 수 있어야 과감합니다.
- 작업 전에 작업 트리를 깨끗하게 둡니다
- 작업 단위마다 커밋합니다
- 결과가 아니면
git restore로 되돌리고 지시를 바꿉니다
한 대화에서 여러 기능을 시키고 마지막에 한 번 커밋하면, 잘못된 부분을 고르기 어렵습니다.
잘 되는 지시와 안 되는 지시
| 잘 안 되는 지시 | 잘 되는 지시 |
|---|---|
| 로그인 기능 만들어 줘 | 이메일 로그인 API를 src/app/api/login/route.ts에 만들어 줘. 세션은 기존 lib/session.ts를 써 |
| 버그 고쳐 줘 | 결제 버튼을 누르면 콘솔에 이 오류가 나. 고치기 전에 원인부터 설명해 줘 |
| 코드 정리해 줘 | components/ 안에서 쓰이지 않는 컴포넌트 목록만 보여 줘 |
파일 경로, 기대 결과, 제약 조건을 같이 적습니다. 구조가 안 잡히면 프롬프트 빌더를 쓰십시오.
자주 묻는 질문
코딩을 모르는데 쓸 수 있나요?
가능합니다. 실행하고, 화면을 보고, 오류 메시지를 그대로 붙이는 습관이면 시작합니다. 용어가 낯설면 바이브 코딩이란부터 보십시오.
Cursor와 무엇이 다른가요?
Cursor는 편집기 안에서 코드를 보는 데 강하고, Claude Code는 터미널에서 작업 전체를 맡기는 데 강합니다. 둘을 같이 쓸 수는 있지만 필수는 아닙니다. 비교는 도구 글에 있습니다.
실수로 파일을 지우면요?
이미 git이 추적 중인 파일의 커밋되지 않은 변경은 git restore로 되돌릴 수 있습니다. 한 번도 커밋하지 않은 새 파일은 이 명령으로 복구되지 않습니다. git 없는 폴더에서는 위험한 작업 전에 플랜 모드로 확인하십시오.
다음 단계
- 설치 방법
- 가격과 요금제
- MCP, Skills, 서브에이전트
- 강의 안내는 홈과 수강료