Claude Code 완벽 입문 가이드 2026 | 제로부터 실무 활용까지 7단계

“Claude Code라는 건 들어봤는데, 어디서부터 시작해야 할지 모르겠어요.”

처음 Claude Code를 써봤을 때 딱 그런 기분이었습니다. 터미널에 claude를 입력하면 뭔가 돌아가는 건 알겠는데, 평소 개발에 어떻게 녹여 써야 할지 전혀 감이 오지 않았죠.

이 글에서는 제가 제로에서 시작해 실무에서 쓸 수 있게 되기까지 했던 모든 것을 7단계로 정리해 설명합니다. “설치는 했는데 뭘 해야 할지 모르겠다”는 분들에게 특히 도움이 될 내용입니다.

---

Step 1: 설치와 초기 설정

설치

npm install -g @anthropic-ai/claude-code

Node.js 18 이상이 필요합니다. 설치 후 claude --version으로 버전을 확인하세요.

API 키 설정

Claude Code는 Anthropic의 API를 사용합니다. console.anthropic.com에서 계정을 만들고 API 키를 발급받으세요.

# 방법 1: 환경 변수 (권장)
export ANTHROPIC_API_KEY="sk-ant-api03-..."

# 방법 2: claude 명령 최초 실행 시 설정
claude
# → API 키 입력을 요청받습니다

첫 동작 확인

claude -p "Hello! Please introduce yourself."

이게 작동하면 설정 완료입니다.

---

Step 2: CLAUDE.md를 만들어 프로젝트를 알려주기

Claude Code는 프로젝트 루트의 CLAUDE.md를 자동으로 읽습니다. 여기에 프로젝트 정보를 써두면 매번 설명할 필요가 없습니다.

제가 처음에 작성한 CLAUDE.md는 이처럼 심플했습니다.

# 프로젝트명

## 기술 스택
- TypeScript + Node.js
- PostgreSQL (Prisma)
- React + Vite

## 자주 쓰는 명령어
- 개발 서버: npm run dev
- 테스트: npm test
- 빌드: npm run build

## 규칙
- 코멘트는 한국어로 작성
- 함수명은 영어 camelCase

이것만으로도 Claude Code는 “이 프로젝트는 TypeScript를 쓰고 테스트는 npm test로 돌린다”는 것을 이해합니다.

처음에 겪은 시행착오: CLAUDE.md 없이 시작했더니 매번 “이 프로젝트는 TypeScript입니다”라고 설명해야 했습니다. 처음 5분만 투자해서 써두면 그 이후의 모든 대화가 훨씬 편해집니다.

---

Step 3: 첫 “연습 태스크” 고르기

처음부터 복잡한 태스크에 도전하면 “생각보다 쓰기 어렵네”라는 느낌을 받기 쉽습니다. 처음에는 이 목록에서 골라 시작하는 것이 좋습니다.

입문 태스크 목록 (난이도 낮음)

# 1. 코드 설명 요청
claude -p "Read src/auth/login.ts and explain what this file does"

# 2. 코드 리뷰 요청
claude -p "Review the code in src/utils/date.ts and tell me what could be improved"

# 3. 테스트 작성 요청
claude -p "Write unit tests for the getUserById function in src/api/users.ts"

# 4. README 생성 요청
claude -p "Create a README.md for this project"

모두 “읽기만” 하거나 “새 파일을 추가만” 하는 태스크입니다. 기존 코드를 수정하는 태스크는 Claude Code에 익숙해진 후에 시도하는 것이 안심됩니다.

---

Step 4: 대화 모드와 원샷 모드 구분해서 쓰기

Claude Code에는 크게 두 가지 사용 방법이 있습니다.

대화 모드 (claude)

cd my-project
claude

터미널이 REPL(대화형 인터페이스)이 되어 여러 번 주고받을 수 있습니다. 코드를 작성하면서 “이런 의도로 수정해줘,” “역시 되돌려줘” 같은 시행착오에 적합합니다.

원샷 모드 (claude -p "...")

claude -p "List every place in src/api/ that still has a TODO comment"

한 번만 실행해서 결과를 반환합니다. 스크립트나 CI에서 호출할 때 사용합니다.

제 구분 기준: 복잡한 구현 작업은 대화 모드, 조사·확인·정형 작업은 원샷 모드.

---

Step 5: 권한 설정으로 안전하게 사용하기

Claude Code는 파일 조작과 명령 실행이 가능하기 때문에, 초반에 권한 설정을 해두면 안심됩니다.

.claude/settings.json을 만드세요.

{
  "permissions": {
    "allow": [
      "Read(**)",
      "Glob(**)",
      "Grep(**)",
      "Bash(npm run *)",
      "Bash(git log*)",
      "Bash(git diff*)",
      "Bash(git status*)"
    ],
    "deny": [
      "Bash(rm -rf*)",
      "Bash(git push --force*)"
    ],
    "ask": [
      "Write(**)",
      "Edit(**)",
      "Bash(git commit*)",
      "Bash(git push*)"
    ]
  }
}

이 설정에서는:

• 자동으로 실행: 파일 읽기, 검색, 테스트 실행
• 매번 확인: 파일 쓰기, git 커밋·푸시
• 절대 금지: rm -rf와 git push --force

처음에는 많은 조작을 ask에 넣고, 익숙해지면 allow로 옮기는 것을 권장합니다.

---

Step 6: 효과적인 지시 방법 익히기

Claude Code를 쓰기 시작하면 바로 느끼는 것이 “지시 방법에 따라 결과가 꽤 달라진다”는 점입니다.

나쁜 예 vs. 좋은 예

# ❌ 너무 모호함
claude -p "로그인 기능 고쳐줘"

# ✅ 구체적이고 범위가 명확함
claude -p "
Fix the login function in src/api/auth.ts (around line 42):
- No handling when the password field is empty — should return a 400 error
- Error messages are English-only — return them in English and Korean too
Follow the existing error handling pattern in src/utils/errors.ts
"

세 가지 팁:

1. 파일명과 줄 번호를 명시하기 — 탐색 시간이 대폭 줄어듦
2. 기대하는 동작을 구체적으로 쓰기 — “잘 부탁해”는 통하지 않음
3. 제약을 전달하기 — “기존 패턴에 맞춰서,” “다른 파일은 건드리지 마”

---

Step 7: 매일의 워크플로우에 녹이기

여기까지 왔다면 매일 개발에 녹여봅시다. 제가 실제로 하는 일상 패턴입니다.

아침 확인 작업

# 어제 커밋 내용 요약
claude -p "Run git log --oneline -10 and give me a plain-English summary of what changed"

버그 수정 시

claude
# → "이 에러 로그를 보고 원인을 찾아줘"라고 붙여넣어 대화

PR 설명문 생성

claude -p "
Review the changes in git diff main...feature/add-search and write a GitHub PR description in markdown.
Include: purpose of the changes, implementation approach, and how to test it.
"

코드 리뷰 보조

claude -p "
Review the changed files in this PR:
$(git diff --name-only main...HEAD)

Prioritize flagging any security issues and performance concerns.
"

---

자주 겪는 “초반의 벽”과 해결책

벽 1: “뭔가 느리다”

Claude Code는 대화가 길어질수록 느려집니다. 30분~1시간마다 /compact 명령을 실행해 대화를 압축하세요.

# Claude Code의 REPL에서
/compact

벽 2: “불필요한 파일까지 읽으려 한다”

지시에 “다른 건 읽지 않아도 돼”라고 명시하는 것만으로 개선됩니다.

# 수정 전
"Fix the bug in src/"

# 수정 후
"Read only src/api/auth.ts and fix the bug there. You don't need to read any other files."

벽 3: “비용이 걱정된다”

기본은 고성능 Opus 모델을 사용하지만, 단순한 태스크는 Sonnet으로 충분합니다.

# 세션 중 모델 변경
/model claude-sonnet-4-6

---

정리: 첫 1주일에 할 일

Day 1:   설치 + CLAUDE.md 작성
Day 2-3: 입문 태스크 시도 (코드 설명, 리뷰)
Day 4-5: 권한 설정 적용 후 실제 파일 편집 시도
Day 6-7: 자신의 워크플로우에 녹이기

Claude Code는 쓰면 쓸수록 “이럴 때 쓰면 되겠구나”라는 감각이 쌓입니다. 첫 1주일은 “코드 설명 요청”과 “테스트 작성 요청”에서 시작해 점점 복잡한 태스크에 도전하는 것이 순탄합니다.

이 사이트(claudecode-lab.com)는 Claude Code로 자동 운영되며, 기사 생성·번역·배포를 매일 자동화하고 있습니다. 처음에는 “그런 게 정말 가능해?”라고 생각했지만, 지금은 Claude Code 없는 개발이 상상이 안 될 만큼 활용하고 있습니다. 꼭 한번 써보세요.

관련 글

• Claude Code 고속화 가이드
• Claude Code API 비용을 90% 절감하는 완전 가이드
• Claude Code 보안 베스트 프랙티스 완전 가이드
• CLAUDE.md 베스트 프랙티스