Claude Code 입문: 시작하는 10단계 (2026)

매일 Claude Code를 쓰는 개발자 Jasmine이에요.

이 글은 딱 1년 남짓 전의 저 같은 사람을 위해 썼어요. 터미널을 여는 것만으로 덜컥 겁이 나고, 무엇을 입력해야 할지 전혀 모르겠고, AI를 돌릴 때마다 토큰 비용이 왕창 나가는 건 아닐까 걱정하던 사람이요. 좋은 소식은, Claude Code가 생각보다 훨씬 시작하기 쉽다는 거예요. 기초부터 이해하고 싶다면 Claude Code란 무엇인가(A-Z 설명)를 훑어보세요. "그냥 따라 하면 동작하게 해줘"라는 분은 아래 10단계로 바로 들어가세요.

시작하기 전에: 필요한 것

아래 몇 가지면 충분해요. 명령줄이 서툴러도 걱정 마세요. 각 단계에서 무엇을 입력할지 정확히 알려드려요.

준비 체크리스트(5분):

• 컴퓨터: Windows, macOS, Linux 중 무엇이든 동작해요.
• Node.js(LTS 버전): npm 설치 방식에 필요해요. node -v로 확인하고, 오류가 나면 먼저 Node.js LTS를 내려받아 설치하세요.
• Claude 계정: 월 20달러 Pro 플랜(초보자에게 가장 쉽고 저렴한 선택)이나 토큰 단위로 과금되는 API 키 중 하나예요.
• 실험할 프로젝트 폴더: 완전히 빈 폴더여도 괜찮아요.
• 약 30분과 "일단 해보자"는 마음가짐.

터미널을 잘할 필요는 없어요. 필요한 명령어는 딱 두 개예요. 폴더로 이동하는 cd와 거기서 Claude를 여는 claude. 나머지는 전부 평범한 말로 전하면 돼요.

1단계 - Claude Code 설치하기

가장 흔한 방법은 npm으로 설치하는 거예요. 터미널(Windows에서는 PowerShell이나 Terminal)을 열고 다음을 입력하세요:

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

이렇게 하면 Claude Code가 전역으로 설치돼서 어느 폴더에서든 claude를 호출할 수 있어요(공식 문서 기준). 끝나면 다음으로 확인하세요:

claude --version

OS별 참고:

• Windows: claude를 입력했을 때 "명령을 인식할 수 없습니다" 오류가 나면, 터미널을 닫았다가 다시 열어 PATH를 다시 읽어들이세요. PowerShell을 쓰는 게 가장 안전해요.
• macOS/Linux: 전역 설치에서 권한 오류가 나면 sudo는 피하세요. 대신 npm 전역 디렉터리를 다시 설정하거나 Node 버전 매니저를 쓰세요.

글을 읽기 편하게 하려고 자잘한 예외는 이 섹션에서 일부러 뺐어요. 막히면 각 플랫폼별 절차와 사람들이 가장 많이 겪는 오류를 고치는 법을 담은 Claude Code 설치 상세 가이드를 보세요.

2단계 - 로그인하고 인증하기

처음 열면 Claude Code가 인증을 요구해요. 두 가지 방법이 있어요:

초보자를 위한 제 조언: 월 20달러 Pro 플랜을 고르세요. 토큰을 일일이 신경 쓸 필요가 없고, 배우는 동안 "실수로" 큰돈을 쓸 일도 없으며, 고정 요금이라 예측하기 쉬워요. 작업이 커지면 API 키로 옮기면 돼요. 그냥 claude를 입력하고 로그인 방법을 고른 뒤 화면 안내를 따르면 돼요 — 수십 초면 끝나요.

3단계 - 첫 프로젝트를 열고 /init 실행하기

프로젝트 폴더로 이동해 Claude를 시작하세요:

cd path/to/your-project
claude

터미널에 채팅 화면이 나타나면 다음을 입력하세요:

/init

/init 명령은 Claude에게 프로젝트를 스캔해서 전체 개요(폴더 구조, 사용 기술, 규칙)를 담은 CLAUDE.md 파일을 만들게 해요. 이 파일은 이후 모든 세션에서 Claude가 "맥락을 이해"하는 데 도움이 돼요 — 8단계에서 다듬을 거예요.

4단계 - 기본 루프 이해하기

어떤 지시를 내리기 전에, 이 루프를 파악하면 Claude Code가 어떻게 작동하는지 80%를 이해한 거예요. 이렇게 반복돼요:

1. 당신이 프롬프트를 줘요 — 원하는 걸 평범한 말로 말하세요.
2. Claude가 저장소를 읽어요 — 관련 파일을 열어 맥락을 이해해요.
3. Claude가 변경을 제안해요 — 어떤 파일을 편집하거나 만들지 보여줘요.
4. 당신이 승인해요(퍼미션) — Claude는 파일을 쓰거나 명령을 실행하기 전에 물어봐요. 당신은 수락하거나 거절해요.
5. Claude가 파일을 편집하고 테스트를 실행해요 — 그리고 결과를 알려줘요.
6. 원하는 대로 될 때까지 반복해요.

퍼미션에 대해: 기본적으로 Claude는 영향이 있는 작업 전에 항상 먼저 물어봐요 — 이게 초보자를 위한 "안전 브레이크"예요. 잘 읽고 나서 승인하세요. 익숙해지기 전에 "전부 자동 수락"을 켜는 건 서두르지 마세요(글 끝의 5가지 흔한 실수 중 하나예요). 읽고, 이해하고, 그다음 승인하기 습관을 지키세요.

많은 초보자를 안심시키는 점이 바로 이거예요: Claude는 몰래 파일을 지우거나 위험한 명령을 뒤에서 실행하지 않아요. 파일을 쓰거나, 테스트를 돌리거나, 터미널 명령을 부를 때마다 무엇을 하려는지 정확히 보이고, 당신은 거절할 수 있어요. 다시 말해 운전대를 잡은 건 언제나 당신이에요 — Claude는 제안만 하고 허락됐을 때만 실행해요. 이 루프를 이해하면 남은 단계는 모두 그 변형일 뿐이에요.

5단계 - 첫 프롬프트를 제대로 쓰기

결과의 품질은 지시를 어떻게 표현하느냐에 곧바로 좌우돼요. 초보자의 황금률은 작게, 구체적으로, 한 번에 하나씩이에요. "웹사이트 전체를 만들어"라고 한 문장으로 Claude에게 시키지 마세요 — 잘게 나누세요.

좋은 프롬프트에는 항상 맥락(어느 파일, 어느 줄), 명확한 목표, 그리고 범위의 한정이 있어요. 구체적일수록 Claude가 추측할 여지가 줄고, 다시 할 일도 줄어요.

6단계 - 만들기 전에 Plan Mode 쓰기

조금이라도 복잡한 거라면 Claude를 곧바로 코드로 뛰어들게 하지 마세요. 먼저 계획을 세우게 하세요. 제 좌우명은 계획을 1분 읽으면 엉뚱한 방향으로 10분 만드는 걸 아낀다예요 — 게다가 다시 만들 일이 없으니 토큰도 아껴요.

7단계 - 첫 실전 프로젝트(실제 결과물까지)

이제 재미있는 부분이에요: 실제로 눈으로 볼 수 있는 걸 만들어요. 누구나 따라 할 수 있도록 아주 가벼운 미니 프로젝트를 골랐어요 — 정적 HTML 랜딩 페이지 만들기예요. 이미 프로젝트가 있다면 같은 과정을 "작은 버그 고치기"에도 적용할 수 있어요.

하는 법: 빈 폴더에서 터미널을 열고 claude를 입력한 뒤, 구체적인 프롬프트를 주세요(5단계의 규칙을 기억하세요):

Create an index.html file: a static landing page for a coffee shop called "Sunny".
Include: a header with the shop name, one slogan, a "Menu" section listing 3 items with prices,
and a footer with the address. Use clean inline CSS with basic responsiveness.
No JavaScript needed yet.

Claude는 index.html 생성을 제안하고 파일 쓰기 권한을 물어요. 당신이 승인하면 돼요. 파일이 만들어지면 브라우저에서 열어(index.html을 더블클릭하거나 브라우저 탭으로 끌어다 놓아) 실제로 렌더링된 결과를 확인하세요.

솔직한 점검: 첫 시도는 대개 뼈대는 잘 잡지만 취향에 안 맞을 수 있어요 — 이를테면 색이 너무 연하거나 간격이 딱 맞지 않거나요. 낙담하지 말고 계속 말하세요: "Menu 섹션 배경을 크림색으로 하고, 각 항목의 모서리를 둥글게 하고, 사이 간격을 더 넓혀 주세요." 이게 바로 4단계의 루프예요. Claude가 정말 잘하는 건 빠르게 뼈대를 세우고 짧은 요청에 맞춰 조정하는 것이고, 당신이 적극적으로 나서야 하는 건 자신의 미적 감각을 말로 풀고 브라우저에서 결과를 확인하는 거예요. 몇 번 주고받으면 HTML을 단 한 줄도 손으로 쓰지 않고 완성된 페이지를 얻어요.

8단계 - 프로젝트용 CLAUDE.md 만들기

CLAUDE.md는 Claude가 항상 기억했으면 하는 것을 적어 두는, 프로젝트 루트의 텍스트 파일이에요: 이 프로젝트가 무엇인지, 어떤 기술을 쓰는지, 코드 스타일은 어떤지, 테스트/실행 명령은 무엇인지 등이요. 새 세션마다 Claude는 이 파일을 먼저 읽어서, 당신이 처음부터 되풀이해 설명하지 않아도 돼요.

초보자일수록 CLAUDE.md를 일찍 두는 게 좋아요. Claude가 "맥락을 잃고" 잘못 추측하는 걸 크게 줄여주거든요. 최소한의 CLAUDE.md는 이렇게 생겼어요:

# Project: Sunny coffee shop landing page

## Tech
- Static HTML/CSS, no framework, no build step.

## Conventions
- Keep CSS inline in index.html for simplicity.
- Write display content in English.

## Common tasks
- Adjust layout, colors, menu content.

3단계의 /init으로 이미 초안이 있어요 — 이제 그걸 열어 실제에 맞게 편집하기만 하면 돼요. CLAUDE.md를 제대로 쓰는 법(구조, 팁, 더 큰 프로젝트를 위한 예시)은 프로젝트에 든든한 CLAUDE.md 작성 가이드를 보세요.

9단계 - 필수 단축키와 슬래시 명령어 익히기

전부 외울 필요는 없어요. 일상 사용엔 핵심 명령어 6개 정도만 알면 충분해요:

작은 팁: 앞 작업과 무관한 일을 시작할 때마다 /clear를 쓰세요 — 초보자에게 가장 효과적인 토큰 절약 습관이에요. 더 자세한 표는 Claude Code 단축키·명령어 완전 치트시트를 보세요. 익숙해지면 반복되는 워크플로를 매번 다시 입력하지 않도록 미리 만들어진 skill과 슬래시 명령어를 추가할 수도 있어요 — 그게 바로 10단계 내용이에요.

10단계 - 미리 만들어진 skill과 subagent로 속도 높이기

프로젝트 몇 개를 매끄럽게 해내다 보면 많은 걸 반복하고 있다는 걸 알게 돼요: 같은 종류의 코드 리뷰 프롬프트, 같은 백엔드 뼈대 잡기 과정, 같은 테스트 작성 방식. 바로 여기서 skill과 subagent가 빛을 발해요 — 매번 다시 설명하는 대신 Claude가 따르도록 "미리 포장된 워크플로"인 셈이에요.

초보자가 모든 걸 직접 만들 필요는 전혀 없어요. 코딩용과 마케팅용 모두를 위한 다양한 skill과 에이전트를 묶은 키트가 있어요 — 예를 들면 Claude Code용 AgentKit 키트(상세 리뷰)예요. 초보자에게 저는 이걸 첫날부터 필요한 게 아니라 익숙해진 뒤의 업그레이드로 봐요: 먼저 위 9단계를 탄탄히 하세요. 같은 워크플로를 다시 입력하느라 시간을 잃고 있다고 느껴지면, AgentKit을 한번 써보고(링크로 20% 할인) 미리 만들어진 skill/subagent 시스템이 얼마나 수고를 덜어주는지 확인해 보세요. 정말 필요해지기 전에 서둘러 사지는 마세요 — 그게 솔직한 규칙이에요.

초보자가 흔히 하는 5가지 실수(그리고 피하는 법)

이건 초보자에게서 가장 많이 보는 실수예요. 이것만 피해도 눈에 띄게 빨라져요:

• 1. 너무 큰 작업을 맡기기. "앱 전체를 만들어줘"는 Claude가 추측하며 헤매게 만들어요. 피하는 법: 잘게 나눠 프롬프트 하나에 명확한 한 가지만(5단계 참고).
• 2. Plan Mode 건너뛰기. 곧장 코드로 뛰어들면 엉뚱한 방향으로 가기 쉽고 다시 하게 만들어 시간과 토큰을 둘 다 낭비해요. 피하는 법: 파일 하나를 넘겨 건드리는 건 먼저 계획을 요청(6단계).
• 3. 읽지 않고 전부 자동 수락하기. 자동 수락을 켜고 Claude가 아무렇게나 편집하게 두는 것. 피하는 법: 최소한 정말 익숙해질 때까지는 퍼미션에서 읽고-이해하고-그다음 승인하는 습관을 지키기.
• 4. /clear를 안 쓰기. 모든 작업을 한 세션에 몰아넣으면 맥락이 희석되고 답이 약해지며 토큰 사용이 늘어요. 피하는 법: 작업을 바꿀 때마다 /clear 실행.
• 5. CLAUDE.md 없음. 이 파일이 없으면 Claude는 매 세션 당신의 프로젝트를 다시 추측해야 해요. 피하는 법: CLAUDE.md를 일찍 만들고 시간을 두고 업데이트하기(8단계).

자주 묻는 질문(FAQ)

Claude Code는 무료인가요?

제한된 체험 등급이 있지만, 꾸준히 쓰려면 Claude 플랜(개인에겐 월 20달러 Pro가 인기)이나 API 키를 통한 토큰 단위 과금이 필요해요. 초보자에겐 요금이 고정이라 비용을 예측하기 쉬운 Pro 플랜이 가장 편해요.

먼저 코딩을 알아야 하나요?

시작하는 데 필수는 아니에요 — 평범한 말로 지시하면 Claude가 코드를 써요. 하지만 기초(코드 읽기, 내 프로젝트에 무엇이 들었는지 이해하기)를 알면 더 좋은 프롬프트를 쓰고 결과도 확인할 수 있어요. 많이 배울수록 Claude Code를 더 효과적으로 쓰게 돼요.

Windows에서 되나요?

네. Claude Code는 Windows, macOS, Linux에서 동작해요. Windows에서는 PowerShell이나 Terminal을 쓰세요. claude를 입력해도 인식이 안 되면 터미널을 닫았다가 다시 열어 PATH를 다시 읽어들이세요.

토큰/비용은 얼마나 드나요?

월 20달러 Pro 플랜이면 비용이 고정이라 배우는 동안 개별 토큰을 걱정할 필요가 없어요. API 키에서는 토큰 양에 따라 지불해요(예: Sonnet 5는 100만 토큰당 대략 입력 $2, 출력 $10). 작업을 바꿀 때 /clear를 쓰고 Plan Mode를 켜면 토큰 사용이 눈에 띄게 줄어요.

ChatGPT나 Claude 채팅과 어떻게 다른가요?

일반 채팅은 텍스트로만 답하고 코드는 직접 복사해 오가야 해요. Claude Code는 터미널 안에서 바로 돌아가며, 당신의 프로젝트를 직접 읽고, (허락을 받은 뒤) 파일을 편집하고 명령을 실행해요. 한마디로 채팅은 답해 주는 조수, Claude Code는 실제 코드베이스를 다루는 동료예요.

Claude Code를 익히는 데 얼마나 걸리나요?

첫 프로젝트를 돌리는 것만이면 위 10단계처럼 약 30분이면 돼요. 능숙해지는 것(좋은 프롬프트, 맥락 관리, skill/subagent 활용)은 보통 며칠의 연습이 필요해요. 실제 프로젝트를 자꾸 만들다 보면 금방 익숙해져요.

맺음말과 다음 단계

이 10단계를 마친 당신은 제로에서 첫 동작하는 프로젝트까지 왔어요 — 설치, 인증, 루프 이해, 좋은 프롬프트 작성, 그리고 흔한 실수 피하기까지요. 더 나아가기에 든든한 토대예요. 제가 권하는 다음 단계: 빠르게 참고하도록 명령어·단축키 완전 치트시트를 북마크하고, 든든한 CLAUDE.md 작성법을 읽어 두고, 기초를 깊이 이해하고 싶다면 Claude Code란 무엇인가(A-Z 설명)로 돌아가 보세요.