클로드 코드 완전 입문 가이드 설치부터 제작까지

Claude Code · 설치 가이드 · 입문자 필독

클로드 코드 완전 입문
설치부터 첫 앱 제작까지
비개발자도 따라하는 실전 가이드

터미널 기초 · 설치 오류 해결 · 토큰 절약법 · 운세 웹 앱 제작까지

📌 이 글의 핵심 요약

• 클로드 코드는 터미널에서 실행되는 AI 코딩 에이전트로, 파일을 직접 읽고·수정·생성합니다.
• 사용하려면 프로 플랜 이상($20/월) 구독이 필요합니다. 맥스 플랜 $200이 $100보다 사용량 4배로 가성비 좋습니다.
• 설치 오류 중 가장 흔한 건 'command not found' — 환경 변수 PATH 설정으로 해결합니다.
• 프로 플랜이라면 기본 모델을 Opus → Sonnet으로 변경해 토큰을 아끼세요.
• 프롬프트 한 줄로 오늘의 운세 웹 앱을 5분 만에 완성할 수 있습니다.

📋 목차

1. 클로드 코드란?
2. 결제 플랜 비교 — 프로 vs 맥스
3. 터미널이 뭐예요? GUI vs CLI 쉽게 이해하기
4. 설치 방법 — Mac / Windows
5. 설치 오류 해결법 2가지
6. VS Code·Cursor 내장 터미널에서 사용하기
7. 토큰 절약 — 기본 모델 Sonnet으로 변경
8. 실습: 프롬프트 1줄로 운세 웹 만들기
9. 정리표

---

🤖

클로드 코드란?

단순 코드 추천이 아닌 — 파일을 직접 읽고 수정하는 AI 동료

클로드 코드는 터미널에서 실행되는 AI 코딩 에이전트입니다. 단순히 코드를 추천하거나 응답만 하는 게 아니라, 프로젝트 디렉터리의 파일을 직접 읽고·수정하고·생성하며 명령어까지 실행합니다. AI 동료가 내 컴퓨터에서 직접 작업하는 개념입니다.

개발자뿐 아니라 마케터, 기획자, 데이터 분석가도 업무 자동화에 바로 활용할 수 있습니다.

📁 파일 읽기·수정·생성 ⚙️ 명령어 실행 🎨 디자인 자동화 📊 데이터 분석 📄 문서·PPT 자동화

---

💳

결제 플랜 비교 — 프로 vs 맥스

클로드 코드를 쓰려면 프로 플랜 이상이 필요합니다

플랜	월 요금	클로드 코드	사용량	추천 대상
무료	$0	❌ 불가	-	채팅 기능만 사용
프로	$20	✅ 가능	기준	처음 입문하는 분
맥스 100	$100	✅ 가능	5배	-
맥스 200	$200	✅ 가능	20배	업무에 매일 활용하는 분

💡

맥스 플랜 선택 팁: $100 플랜 대비 $200 플랜은 가격이 2배지만 사용량은 4배입니다. $100 플랜 사용을 고민 중이라면 $200 플랜이 실제 체감 면에서 훨씬 유리합니다. 처음에는 프로 플랜으로 시작 후 업그레이드를 권장합니다.

---

💻

터미널이 뭐예요? GUI vs CLI 쉽게 이해하기

검정 화면이 두렵다면 — 이것만 알면 됩니다

🖱️ GUI 방식

그래픽 유저 인터페이스. 키보드와 마우스로 화면을 클릭해서 컴퓨터를 조작하는 방식. 우리가 평소에 쓰는 방식입니다.

⌨️ CLI 방식

커맨드라인 인터페이스. 명령어를 입력해서 컴퓨터를 조작하는 방식. 터미널이 바로 이 CLI 방식으로 대화하는 도구입니다.

예를 들어 새 폴더를 만들 때 GUI는 마우스 우클릭 → 새 폴더. CLI(터미널)에서는 명령어 한 줄로 동일한 작업을 합니다. 클로드 코드는 이 터미널에서 실행되는 도구입니다.

😊

터미널 명령어가 많을 것 같아 걱정되시나요? 실제로 자주 쓰는 명령어는 10개도 안 됩니다. 폴더 생성, 폴더 이동 등 간단한 것들뿐이며, 자주 쓰다 보면 자연스럽게 익혀집니다.

---

📦

설치 방법 — Mac / Windows

네이티브 설치 방법을 권장합니다 — 자동 업데이트 지원

공식 문서(code.claude.com)에서 빠른 시작 메뉴로 진입하면 설치 가이드를 확인할 수 있습니다. 자동 업데이트가 지원되는 네이티브 설치 방법을 권장합니다.

🍎 Mac 설치

터미널을 열고 공식 문서의 명령어를 복사해 붙여넣기 → 엔터

claude --version # 버전 확인으로 설치 성공 여부 확인

🪟 Windows 설치

• 1
  PowerShell로 설치 (권장)CMD보다 PowerShell 방식으로 설치하는 것을 권장합니다. 공식 문서의 Windows용 명령어를 복사해 PowerShell에 붙여넣기 → 엔터.
• 2
  Git도 함께 설치Git 설치 시 Git Bash(터미널)도 함께 설치됩니다. Git Bash는 Windows에서 Mac과 동일한 명령어를 쓸 수 있게 해줘서 클로드 코드를 더 매끄럽게 사용할 수 있습니다.

ℹ️

설치 명령어 입력 후 진행 표시 없이 멈춘 것 같아도 설치가 진행 중일 가능성이 큽니다. 네트워크 환경에 따라 시간이 걸릴 수 있으니 5분 정도 기다려 보세요.

---

🔧

설치 오류 해결법 2가지

가장 자주 발생하는 오류와 해결책

❶ 'command not found' 오류 — 환경 변수 PATH 설정

클로드 코드는 정상 설치됐지만 터미널이 claude 명령어를 어디서 찾아야 할지 모르는 상태입니다. 클로드 코드가 설치된 경로를 환경 변수(PATH)에 등록하면 해결됩니다.

환경 변수란 터미널이 명령어를 찾을 때 뒤져보는 폴더 목록입니다.

Windows 환경 변수 설정

• 1
  클로드 코드 설치 경로 복사C드라이브 → 빈 디렉터리까지의 경로를 복사합니다.
• 2
  제어판 → 시스템 → 고급 시스템 설정환경 변수 버튼 클릭
• 3
  시스템 변수에서 Path 선택 → 편집새로 만들기 클릭 → 복사한 경로 붙여넣기 → 확인
• 4
  터미널 재시작claude --version 입력 시 버전 정보가 나오면 성공

Mac 환경 변수 설정

Mac에서는 더 간단합니다. 오류 발생 시 터미널 화면에 해결용 명령어가 바로 표시됩니다. 해당 명령어를 복사해 터미널에 붙여넣기 → 터미널 재시작하면 끝입니다.

❷ 오류 메시지가 이해가 안 된다면

✅

오류가 발생한 터미널 화면을 그대로 캡처 → ChatGPT, Gemini, 클로드 채팅 등 편한 AI에 "이 오류 해결해줘"라고 붙여넣기하면 단계별 해결 방법을 받을 수 있습니다.

---

🖥️

VS Code·Cursor 내장 터미널에서 사용하기

작업 파일을 눈으로 바로 확인하면서 클로드 코드 실행

클로드 코드가 생성한 HTML·코드 파일을 터미널에서만 보면 불편합니다. VS Code나 Cursor 같은 코드 편집기를 설치하면 내장 터미널에서 클로드 코드를 실행하면서 생성된 파일을 바로 열어볼 수 있습니다.

클로드 코드는 터미널 기반이라 VS Code, Cursor, 안티그래비티, IntelliJ 등 내장 터미널이 있는 어떤 편집기에서도 동일하게 동작합니다. 자신에게 편한 도구를 선택하면 됩니다.

VS Code (권장) Cursor 안티그래비티 IntelliJ

💡

Cursor 같은 AI 코딩 도구를 사용할 때도 Cursor의 에이전트 기능 대신 내장 터미널에서 클로드 코드를 실행하면 클로드 코드의 강력한 스펙을 그대로 누릴 수 있습니다.

작업 디렉터리 이동 후 실행하기

클로드 코드는 실행한 디렉터리를 기준으로 파일을 읽고 생성합니다. 반드시 작업할 폴더로 이동한 뒤에 실행해야 합니다.

cd my-workspace # 작업 폴더로 이동

claude # 클로드 코드 실행

ℹ️

처음 실행 시 해당 디렉터리를 기준으로 할지 확인하는 화면이 나옵니다. Yes를 누르면 이후에는 다시 묻지 않습니다. 로그인이 필요한 경우 다크 모드 선택 → 구독 플랜 선택(1번) → 승인 순으로 진행하면 됩니다.

---

🪙

토큰 절약 — 기본 모델 Sonnet으로 변경

프로 플랜이라면 필수 설정

클로드 코드의 기본 모델은 가장 고성능인 Opus로 설정되어 있어 토큰이 빠르게 소진됩니다. 일상적인 작업은 Sonnet으로도 충분히 잘 처리되므로, 프로 플랜 사용자라면 Sonnet으로 변경하는 것을 권장합니다.

설정 파일로 기본 모델 고정하기

# 작업 폴더 안에 .claude/settings.json 파일 생성

{"model": "claude-sonnet-4-6"}

이렇게 설정하면 클로드 코드를 재시작해도 Sonnet이 기본 모델로 유지됩니다. 또는 클로드 코드 실행 중 /model 명령어로 방향키를 눌러 바로 변경할 수도 있습니다.

⚡

플랫 모드(Plan Mode)도 토큰을 아낍니다: Shift+Tab을 두 번 눌러 플랫 모드를 활성화하면 구현 전에 계획을 먼저 세웁니다. 계획 단계에서 충분히 수정한 뒤 구현하면 불필요한 수정으로 인한 토큰 낭비를 줄일 수 있습니다.

---

🎯

실습: 프롬프트 1줄로 오늘의 운세 웹 만들기

탐색 → 계획 → 구현의 검증된 워크플로우

클로드 코드로 개발할 때는 "바로 만들어줘"가 아니라 탐색 → 계획 → 구현 순서를 따르는 것이 중요합니다. 계획 없이 바로 구현하면 수정 과정에서 토큰 소모가 훨씬 많아집니다.

실습 순서

• 1
  플랫 모드 활성화Shift+Tab을 2번 눌러 Plan Mode 활성화. 구현 전 계획을 먼저 세우는 모드입니다.
• 2
  프롬프트 입력"오늘의 운세를 뽑아주는 웹 페이지를 만들어줘. 계획해줘." 입력 → 엔터
• 3
  계획 검토클로드가 프로젝트를 탐색하고 구현 계획을 작성합니다. 꼼꼼히 읽고 수정이 필요하면 "이 부분 수정해줘"로 요청합니다.
• 4
  오토 모드로 실행계획이 마음에 들면 1번(오토 모드)으로 진행. 파일을 만들 때마다 허락받지 않고 자동으로 진행합니다.
• 5
  완성된 파일 확인VS Code에서 생성된 HTML 파일을 열어 결과를 바로 확인합니다.

✨

디자인 관련 프롬프트를 별도로 입력하지 않아도 클로드 모델 업데이트 이후 디자인이 자동으로 멋지게 완성됩니다. 프롬프트 한 방으로 완성된 운세 웹 앱을 확인해보세요.

---

📋 클로드 코드 입문 정리표

항목	내용
설치 전 조건	프로 플랜($20/월) 이상 구독 필요
공식 문서	code.claude.com → 빠른 시작
설치 방법	Mac: 터미널 명령어 / Windows: PowerShell + Git
오류 해결	command not found → 환경 변수 PATH에 설치 경로 등록
편집기 연동	VS Code·Cursor 내장 터미널에서 동일하게 실행
토큰 절약	.claude/settings.json에서 기본 모델을 Sonnet으로 변경
작업 워크플로우	플랫 모드(계획) → 검토·수정 → 오토 모드(구현)
권장 맥스 플랜	$100보다 $200이 사용량 4배로 가성비 우수

🚀 클로드 코드, 오늘 바로 시작해보세요

개발자가 아니어도 괜찮습니다.
마케터, 기획자, 데이터 분석가도 업무 자동화에 바로 활용할 수 있습니다.
프로 플랜 구독 후 오늘 설치해서 첫 앱을 만들어보세요.

👉 클로드 코드 시작하기

본 포스팅은 영상 내용을 바탕으로 재구성하여 작성되었습니다.