클로드 코드 사용법 완벽 가이드
2026년 버전, 설치부터 첫 프로젝트까지

안녕하세요, 인프런입니다. 🛠️

지난 글에서 AI 코딩 도구 TOP 5를 비교해 드린 글에서 클로드 코드를 추천했던 것 기억하시죠? “클로드 코드는 어떻게 시작하나요?” 라는 질문을 정말 많이 받았어요. 그래서 입문자들이 처음 깔고 켜보는 30분 동안 부딪힌 지점들을 하나씩 풀어봤습니다.

이 글은 “AI한테 코드를 맡기는 게 처음”이신 분 기준으로 작성되었어요. 용어는 한 번씩 풀어 적고, 명령어는 쉽게 복사 붙여넣기가 가능하게 정리했으니... 여러분은 터미널 창 하나 띄워두시고 따라오시면 됩니다!

① 사전 준비! 계정·구독 선택

아쉽게도 클로드 코드는 무료 Claude.ai 계정으로는 사용할 수 없어요. 첫 장벽이 여기라서, 계정부터 짚고 넘어갑니다 ㅠㅠ...!

선택지는 세 갈래예요.

• Claude 구독 플랜 : Pro / Max / Team / Enterprise. 대부분의 개인·팀에게 가장 편한 선택.
  • (2026/4/22 업데이트) Claude Pro 요금제 신규 가입자는 클로드 코드를 사용할 수 없다는 제보가 이어지고 있어요. 때문에 클로드 코드를 이용하실 예정이라면, Enterprise 플랜 또는 Max 요금제를 권장드려요.
  • (2026/4/23 업데이트) Claude Code가 다시 Pro 요금제에서 원복되었습니다.
• Claude Console (API 키) : 선불 크레딧을 충전해 쓰는 방식. 자동화 파이프라인이나 CI/CD에 어울려요.
• 엔터프라이즈 클라우드 : Amazon Bedrock / Google Vertex AI / Microsoft Foundry. 회사 계정 통합용.

개인이 혼자 써볼 거라면 Pro, 하루에 3시간 이상 코딩을 할 정도로 사용량이 많다면 Max가 가장 적합할 거예요. Pro에서는 클로드의 가장 똑똑한 상위 모델인 Opus의 한도가 많이 제공되지 않아요. 그래서 Pro에서는 중간 모델인 Sonnet 위주로 간단한 바이브코딩을 하기에 적합해요. 2026년 4월 기준 플랜별 정리는 아래 표를 참고해주세요.

정확한 한도·최신 가격은 claude.com/pricing에서 확인해 주세요!

시스템 요구사항도 간단하게만 짚고 갈게요. 최신 맥·윈도우·주요 리눅스 배포판은 대부분 커버되지만, Windows에서 네이티브로 쓰시려면 Git for Windows가 먼저 깔려 있어야 합니다. WSL을 쓰시면 필요 없어요. RAM은 4GB 이상을 권장해요. 클로드 코드는 아래에서 간단 설치 요약을 적어두었지만, 설치부터 질문이 많기도 해요. 설치 자체를 아예 따로 블로그로 다룰 예정이니 참고해주세요! 

② 설치 요약 (3줄이면 끝!)

클로드 코드는 네이티브 바이너리 설치 방식이에요. 커맨드 한 줄이면 끝나고, 네이티브로 설치하면 백그라운드 자동 업데이트까지 받아갑니다.

macOS / Linux / WSL : 맥의 Apps에서 "터미널 (또는 Terminal)" 을 검색한 후, 나오는 창에서 붙여넣어주세요.

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell : Powershell의 경우, Windows 검색창에서 Powershell이라고 검색하면 나오는 창에서 입력해주시면 돼요.

irm https://claude.ai/install.ps1 | iex

Windows CMD — C:\만 보이면 CMD입니다.

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Homebrew와 같이 패키지 매니저가 익숙하시면 brew install --cask claude-code (macOS) 또는 winget install Anthropic.ClaudeCode (Windows)도 가능합니다. 단, 이 방식은 자동 업데이트가 안 되니 주기적으로 업그레이드 해주셔야 해요.

설치가 끝났으면 터미널에서 확인해 보세요.

claude --version
claude doctor

버전이 뜨면 설치가 성공된 거예요!

*터미널이 낯설다면 데스크톱 앱도 있긴 해요. claude.com/download에서 파일을 받아 더블클릭으로 설치하실 수 있고, VS Code / Cursor / JetBrains 확장으로 에디터 안에서 바로 쓰는 방법도 있습니다. 웹 버전(claude.ai/code)은 설치가 아예 필요 없는 버전이에요.

하지만 클로드 코드를 코딩 과정에서 함께 "비서" 처럼 사용해보려면, 위의 명령어로 터미널에 설치해서 사용하는 걸 권장드려요.

③ 첫 실행·온보딩 4단계

설치가 끝났다면 이제 실제로 켜볼 차례예요. 단계는 네 개뿐입니다.

Step 1. 작업할 폴더에서 claude 실행

빈 폴더여도 상관없어요. 실습용으로 하나 만들어서 들어가시면 됩니다.

mkdir my-first-claude
cd my-first-claude
claude

VScode, Antigravity 등에서는 열려있는 폴더에서 터미널을 켜시면, 그 폴더를 기준으로 클로드가 작동해요.

Step 2. 첫 로그인

처음 claude를 치면 브라우저가 자동으로 열립니다. 가입하신 클로드 계정으로 로그인하시면 끝이에요. 브라우저가 안 열리는 환경(SSH·원격 서버 등)이면 터미널에 뜨는 OAuth URL을 c 키로 복사해 브라우저에 붙여넣으시면 됩니다.

Step 3. 첫 대화 던져보기

커맨드를 하나하나 전부 외울 필요는 없어요. 그냥 사람한테 말하듯 적으시면 됩니다. 처음에는 이런 질문이 감을 잡기 좋아요.

지금 이 폴더에 뭐가 있는지 설명해줘.

코드를 고치는 요청을 하시면 클로드 코드는 파일을 수정하기 전에 항상 허락을 먼저 구해요. 내용을 확인하고 Yes를 눌러 주시면 됩니다.

Step 4. 권한 모드 알아두기

터미널 하단에 표시되는 권한 모드는 Shift + Tab을 누르면 순환됩니다.

• Normal (기본) 파일 수정 전 매번 허락을 구해요. 처음엔 이 모드가 안전합니다.
• ⏵⏵ accept edits on 편집은 자동 승인, 쉘 명령은 여전히 확인을 받아요.
• ⏸ plan mode on 읽기만 하고, 작업 전 계획을 세웁니다. 파일을 건드리지 않아요. 큰 변경 전에 기획 단에서 강력 추천하는 모드예요. 

종료하실 때는 exit 또는 Ctrl + D를 누르시면 됩니다! 현재 진행중인 작업 중단만 원하실 땐 Ctrl + C입니다.

*claude --dangerously-skip-permissions 라는, 허락을 묻지 않고 전부 클로드에게 위임하는 모드도 있지만, 보안 위험이 존재할 뿐 아니라 검토 없이 파일을 변경하는 건 위험한 상황이 발생할 수 있기에 추천하지 않아요. 

④ 핵심 명령어 치트시트

외울 필요는 없어요. 필요할 때 꺼내 보시면 됩니다. 터미널에서 치는 CLI 명령, 세션 안에서 치는 슬래시 커맨드, 그리고 키보드 단축키예요.

CLI : 터미널에서 claude와 함께 쓰는 명령

슬래시 커맨드 : 세션 안에서 /로 시작

키보드 단축키

⑤ 첫 프로젝트 따라하기 : 자기소개 원페이지

이제 실제로 눈에 보이는 결과물을 하나 만들어보실 차례예요. 주제는 자기소개 원페이지입니다. 추가 설치나 라이브러리 없이 index.html 한 파일로 끝나요. 파일이 생기면 더블클릭으로 바로 브라우저에서 열립니다.

앞에서 만든 my-first-claude 폴더 또는 여러분이 자유롭게 만든 폴더에서 클로드 세션을 켠 상태로, 아래 프롬프트를 그대로 복붙해 주세요.

초기 프롬프트 (복붙용)

제 자기소개 원페이지를 index.html 파일 하나로 만들어주세요.

포함할 섹션:
- 히어로: 김인프, 개발이 취미인 평범한 직장인
- About: 안녕하세요 김인프입니다. 나만의 웹을 만들고 싶어서 클로드 코드를 알게 되었어요. 헬스를 좋아해요.
- 경험/활동: 국내여행, 캠핑, 헬스
- 좋아하는 것: 골든리트리버, 스타트업의 열정, 예고없이 갑자기 여행 가기
- 연락처: (내 이메일), 01012345678

조건:
- 순수 HTML + 인라인 style 또는 <style> 태그만 사용
- 모바일에서도 깨지지 않는 반응형
- 파스텔톤 배경, 폰트는 시스템 기본 산세리프
- 저장 후 브라우저에서 더블클릭으로 바로 열 수 있어야 함

이 프롬프트를 복사 붙여넣기 해도 되고, 여러분의 내용으로 채우셔도 좋아요. 클로드 코드가 파일을 만들겠다고 물어보면 Yes를 엔터해주세요.

생성이 끝나면 index.html 파일을 더블클릭해 열어보세요. 4개 섹션이 깔끔하게 들어간 페이지가 브라우저에 뜰 거예요. 아래의 GIF를  확인해보세요.

이어서 대화하면서 개선하기 (Follow-up 3개)

한 번에 완벽한 결과물은 나오지 않습니다. 대화하면서 하나씩 고치는 것이 클로드 코드의 본질입니다!

① 분위기 튜닝

전체 배경을 민트 그린 계열 (#E6F4EA 같은 톤)으로 바꾸고,
히어로의 제목은 더 굵은 산세리프로 크게 강조해주세요.
모서리는 살짝 둥글게 라운드 처리를 넣어주세요.

② 기능 추가 — 다크모드 토글

우측 상단에 다크모드 토글 버튼을 추가해주세요.
- 버튼을 누르면 배경·글자색이 반전됩니다
- 토글 상태는 localStorage에 저장해 새로고침해도 유지되어야 합니다
- 버튼 자체는 이모지 하나(🌙 / ☀️)로 표현해주세요

③ 범위 제한 — 인쇄용 PDF 스타일

브라우저의 '인쇄' 기능으로 PDF 저장할 때만 적용되는 스타일을 추가해주세요.
- @media print 블록 안에서만 변경
- 다크모드 토글 버튼은 숨기기
- A4 한 장에 깔끔하게 담기도록 여백/폰트 크기 조정
- 기존 화면용 스타일은 절대 영향 받지 않아야 합니다

여기까지 따라오셨다면, 클로드 코드가 그냥 자동완성 도구가 아니라 ‘함께 빌드하는 파트너’라는 감각이 왔을 거예요. 그럼 이 감각을 더 잘 활용하려면 어떤 프롬프트를 써야 할지, 다음 섹션에서 이어서 정리해 드릴게요.

⑥ 프롬프트 잘 쓰는 법 5가지

“AI는 프롬프트 잘 쓰는 사람이 이긴다”는 말, 들어보셨죠? 앞 섹션의 Follow-up 3개가 이 원칙들을 이미 간단히 실습한 거예요. 각각을 설명으로 풀어드리면 이렇습니다.

1. 구체적으로 말하기 : 맥락·현상·기대

모호한 요청은 모호한 결과를 부릅니다. 무엇이, 어디서, 언제, 왜를 한 문장에 넣어보세요.

• ❌ “갑자기 버그가 뜨는데 버그 고쳐줘”
• ✅ “로그인 페이지에서 비밀번호를 틀리게 입력하면 빈 화면이 뜨는 버그가 있어요. 에러 메시지가 뜨도록 고쳐주세요.”

2. 단계로 쪼개기

복잡한 작업은 한 덩어리로 던지지 마시고 번호를 매겨 주세요.

• “1. 회원 프로필 DB 테이블을 만들고 / 2. 조회·수정 API를 추가하고 / 3. 화면에서 그걸 편집할 수 있게 해주세요.”

“회원 가입 기능 전부 만들어줘” 보다 훨씬 안정적이고, 원하는 결과가 나올 거예요.

만약 어떻게 쪼개야 할지 모르겠다면, Shift+Tab으로 Plan mode를 선택해서 회원 가입 기능에 필요한 구체적인 단계들을 기획해보세요.

3. 파일·폴더는 @로 콕 집기

세션 안에서 @를 치면 파일·폴더를 자동완성으로 참조할 수 있어요.

• “@src/auth.js의 로그인 로직을 async/await로 바꿔주세요.”
• “@src/components 구조를 설명해 주세요.” (폴더면 구조만 알려줘요.)

4. 검증 기준 명시

“이렇게 됐다면 완료”를 프롬프트에 명시해두면, 결과물의 품질이 달라져요!

• “저장 후 브라우저에서 바로 열려야 해요.”
• “기존 테스트가 깨지면 안 돼요.”
• “새로고침해도 다크모드 설정이 유지돼야 해요.” (앞 실습 Follow-up ② 참고)

5. 영향 범위 명시 (scope 제한)

“여기만 건드리고, 나머지는 손대지 말기”를 명시하면 의도치 않은 부작용이 줄어들어요.

• “이 함수 안에서만 변경하고, 다른 파일은 건드리지 마세요”
• “@media print 블록 안에서만 추가해주세요. 기존 화면용 스타일은 그대로 유지해주세요” (앞 실습 Follow-up ③)

보너스 팁 : 큰 변경 전에는 Shift + Tab 두 번 눌러 Plan Mode로 들어가세요. 클로드 코드가 파일을 건드리지 않고 계획만 먼저 제시하기 때문에, 먼저 실행하고 고치는 것보다 토큰을 덜 쓰게 되어요. 승인하면 실행하고, 마음에 안 들면 “이런 이런 부분은 다시 생각해줘”로 수정해주세요.

그리고 반복되는 맥락(“이 프로젝트는 2-space 들여쓰기”, “빌드는 npm run build 명령어 사용” 등)은 프로젝트 루트에 CLAUDE.md를 만들어 넣어두시면 매 세션마다 자동으로 읽어들이기 때문에, 반복해서 명령 텍스트를 할 필요가 없게 됩니다. /init 명령을 써서 CLAUDE.md를 자동 생성할 수도 있습니다.

⑦ 자주 하는 실수 & 해결법

처음 쓰실 때 항상 막히는 지점을 모아보았어요. 순서대로 한 번 훑어보시고, 실제로 부딪혔을 때 다시 돌아오시면 됩니다.

모르는 문제를 만나셨다면 claude doctor부터 실행해주세요. 설치·설정·검색 기능·플러그인 오류를 한 번에 진단해줍니다.

클로드 코드를 “자동완성 도구”로만 보면 재미의 절반도 느끼기 어려워요. 함께 계획을 세우고, 대화로 수정하고, 프로젝트의 규칙을 CLAUDE.md에 적어두며 쌓아가는 파트너로 써보실 때 진가가 드러나거든요. 클로드 코드의 기초를 이해하셨다면... 다음은 여러분이 만들고 싶은 자유로운 것들을 만들어볼 차례입니다!

👇 클로드 코드, 입문부터 실전까지 책임지는 강의 👇

설치하셨다면, 이제 프로젝트까지 만들어봐요!