[오픈대화] 클로드코드 입문 가이드 — 진짜 바이브코딩 해보기

이 글은 클로드코드를 처음 접하는 분들을 위해 작성되었습니다. 코딩 지식이 전혀 없어도 따라할 수 있습니다.

클로드코드란?

클로드코드(Claude Code)는 AI 회사 앤트로픽(Anthropic) 이 만든 코딩 도구입니다. 내 컴퓨터의 파일을 AI가 직접 읽고, 수정하고, 실행할 수 있는 네이티브 툴이에요.

GPT, 제미나이 같은 다른 AI도 코드를 작성할 수 있지만, 클로드코드는 다음이 다릅니다.

내 PC 파일을 직접 열고 수정함 (복사/붙여넣기 불필요)
코드를 만들고 직접 실행까지 함
배포(다른 사람이 쓸 수 있게 올리는 것)까지 한 번에 처리

코딩을 전혀 몰라도, 내가 만들고 싶은 것을 말로 설명하면 AI가 알아서 만들어줍니다. 이런 방식을 바이브코딩(Vibe Coding) 이라고 부릅니다.

구독 요금

클로드코드는 클로드(Claude) 구독으로 함께 사용합니다. 별도 결제 없음.

플랜	월 요금	추천 대상
Pro	약 3만원	처음 시작하는 분
Max	약 15만원	더 많이 더 빠르게 쓰고 싶은 분

API 방식(쓸 때마다 결제)도 있지만, 많이 쓰면 수십만원 나올 수 있어 구독이 유리합니다.

설치 방법

Mac

터미널을 열고 아래 한 줄만 실행하면 끝입니다.

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

터미널은 Cmd + Space → "터미널" 검색해서 열면 됩니다.

Windows

1단계. Git 설치

클로드코드가 내부적으로 Git을 사용하므로 먼저 설치해야 합니다.

👉 https://git-scm.com/downloads/win 에서 다운로드 후 설치

2단계. PowerShell 열기

윈도우 시작 버튼 옆 검색창에 PowerShell 검색 → 실행

3단계. 설치 명령어 실행

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

설치 완료 메시지가 나오면 끝입니다.

⚠️ 주의: 예전에 알려진 npm install -g @anthropic-ai/claude-code 방식은 현재 지원 종료됨. 위 방식으로만 설치하세요.

설치 후 실행

터미널(Mac) 또는 PowerShell(Windows)을 완전히 닫고 다시 열어서 입력:

claude

처음 실행하면 브라우저가 열리면서 로그인 화면이 나옵니다. 클로드 계정으로 로그인하면 완료.

Windows에서 claude가 안 될 때

방법 1. PowerShell 재시작 (가장 흔한 해결책)

방법 2. 아래 명령어로 PATH 새로고침 후 다시 시도:

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")

방법 3. 그래도 안 되면 → 클로드(claude)에게 직접 물어보기. 클로드가 해결 방법을 알려줍니다.

기본 설정

권한 설정 (매번 허용 클릭이 번거롭다면)

클로드코드는 파일을 만들거나 수정할 때마다 허용 여부를 물어봅니다. 매번 답하기 번거롭다면, 클로드에게 이렇게 말하세요:

"앞으로 모든 권한은 허용할 테니 bypass permissions on 모드로 변경해줘"

이후부터는 멈추지 않고 작업을 끝까지 마칩니다.

설정 후 클로드 시작 화면에 아래처럼 표시됩니다:

⚡ bypassPermissions: true

작업 완료 알림 설정

작업이 끝날 때 알림을 받고 싶다면 클로드에게 이렇게 말하세요:

"작업 끝나면 알림 줘"

이후 명령이 완료될 때마다 소리나 메시지로 알려줍니다.

프로젝트 폴더 구조 잡기

클로드코드는 내가 어느 폴더에서 실행하느냐가 중요합니다. 반드시 작업할 폴더 안에서 실행해야 합니다.

권장 폴더 구조

my/                     ← 내 작업 공간 (이름은 자유)
  ├── diary/            ← 일기 서비스 프로젝트
  ├── homepage/         ← 홈페이지 프로젝트
  └── portfolio/        ← 포트폴리오 프로젝트

서비스 하나 = 폴더 하나. 섞으면 나중에 유지보수가 힘들어집니다.

폴더에서 클로드 실행하는 법

Mac

Finder에서 작업 폴더로 이동 → 폴더를 우클릭 → "폴더에서 새로운 터미널 열기" → claude 입력

'폴더에서 새로운 터미널 열기'가 안 보이면: 시스템 설정 → 키보드 → 단축키 → 서비스에서 활성화하거나, 터미널에서 cd 경로 로 직접 이동해도 됩니다.

Windows

탐색기에서 작업 폴더로 이동 → 폴더 안 빈 공간 우클릭 → "터미널에서 열기" → claude 입력

핵심 개념: 컨텍스트(Context)

클로드코드를 잘 쓰려면 이 개념이 가장 중요합니다.

AI는 기억하지 않습니다

AI는 이전 대화를 "기억"하는 게 아닙니다. 매번 대화할 때마다 지금까지의 대화 전체를 통째로 다시 보내는 구조입니다.

1번째 대화: 내 말만 전송
2번째 대화: 1번째 대화 전체 + 내 말 전송
3번째 대화: 1~2번째 대화 전체 + 내 말 전송
...

이걸 컨텍스트(Context) 라고 합니다. 컨텍스트가 가득 차면 사용량도 많이 소모되고, 클로드가 혼란스러워지기 시작합니다.

해결책: PRD 문서 만들기

PRD(Product Requirements Document) 는 내 프로젝트 현황을 기록한 문서입니다.

지금까지 만든 기능
현재 해결해야 할 문제
앞으로 만들 기능

이 문서를 만들어두고, 새 세션을 시작할 때 클로드에게 이렇게 말하면 됩니다:

"PRD.md 파일 읽고 현재 상황 파악해줘"

그러면 처음부터 다시 설명하지 않아도 됩니다.

세션(Session)과 resume 기능

클로드코드에서 한 번의 작업 단위를 세션(Session) 이라고 합니다. 터미널을 닫으면 세션이 끝납니다. 하지만 실수로 닫았을 때 복구할 수 있습니다.

claude --resume <세션ID>

세션 ID는 클로드에게 "세션 ID 알려줘"라고 하면 알려줍니다.

단, 컨텍스트가 많이 쌓인 상태의 세션은 복구보다 PRD 문서로 새 세션을 여는 게 더 효율적입니다.

노코드 툴 vs 클로드코드

아임웹, 윅스 같은 노코드 툴과 클로드코드, 어떤 게 나을까요?

	노코드 툴 (아임웹 등)	클로드코드
초기 진입	쉬움	약간의 학습 필요
커스터마이징	제한적	거의 무제한
장기 성장성	한계 있음	계속 발전 가능
비용	월 구독료 지속	클로드 구독 1개
내 파일 소유	플랫폼 종속	내 PC에 원본 보관

처음에는 노코드 툴이 쉬워 보이지만, 마음대로 만들고 싶은 게 생기면 결국 한계에 부딪힙니다. 클로드코드는 진입 장벽이 있지만 한 번 익히면 원하는 무엇이든 만들 수 있습니다.

이것만 기억하세요

설치: Mac은 curl -fsSL https://claude.ai/install.sh | bash / Windows는 PowerShell에서 irm https://claude.ai/install.ps1 | iex
실행: 서비스 폴더에서 터미널 열기 → claude
설정: bypass permissions on, 작업 완료 알림 켜기
폴더: 서비스 하나당 폴더 하나
컨텍스트: PRD 문서로 현황 관리, 자주 새 세션 시작

대화 참여 코멘트 한줄

문어 · Windows · 기획자 (육아휴직 중)

"아기 재우고 틈틈이 혼자 유튜브 보면서 영어 일기 웹을 만들고 있었는데, 7일 만에 구글 로그인 연동까지 됐어요. 그동안 PRD 문서를 만들어서 쓰고 있었는데 오늘 그게 맞는 방법이었다는 걸 확인받았고, 매번 엔터를 눌러야 하는 게 불편했는데 bypass permissions 설정으로 한 번에 해결됐어요. 코딩을 몰라도 꾸준히 하면 된다는 걸 느끼고 있습니다."

춤고 · Windows · 콘텐츠 마케터

"클로드 구독이랑 클로드코드가 따로인 줄 알았는데 같이 쓸 수 있다는 걸 오늘 처음 알았어요. 설치하다가 오류가 났는데 클로드한테 직접 물어보니까 바로 해결됐고, 폴더에서 터미널 열기로 진입하는 것도 생각보다 어렵지 않았어요. 마케팅은 할 수 있는데 구축이 막막했는데, 이제 방향이 좀 보이는 것 같습니다."