About 잔재미코딩 자료모음 문의하기 커뮤니티
📺 본 자료는 "처음하는 바이브코딩 (Part2)" 강의 초반부 자료입니다 — 강의에서 영상과 함께 자세히 설명됩니다
💬 피드백은 문의하기로 알려주시면 최대한 빠르게 개선하겠습니다 · 수시 업데이트 예정
잔재미코딩 처음하는 클로드코드 Part2 × 시작하기 가이드 (Windows · Mac)
설치 후, 작업 폴더 만들기부터 첫 실행 · 편의 설정까지
처음하는 클로드코드 Part2 · 비주얼 가이드

이것만 극복하면
실전 시작

복잡해 보이지만, 두 번만 따라하면 금방 익숙해집니다
작업 폴더 만들기부터 첫 실행 · 편의 설정까지 단계별로

핵심은 ① 폴더 만들기 → ② cd로 이동 → ③ claude 실행 , 끝
설치 후 첫 사용 가이드
QUICK START

핵심은 딱 3단계

이게 전부입니다
아래 설명은 이 3단계를 제대로 하기 위한 기본 개념과 준비 방법

1

작업 폴더 만들기

작업 하나마다 폴더 하나씩 (또는 기존 폴더 선택)

2

그 폴더에서 claude 실행

터미널로 폴더에 이동 후 claude 입력

3

요청 시작

클로드코드에게 카톡처럼 가볍게 부탁

왜 폴더가 핵심일까요?

클로드코드는 폴더를 "프로젝트" 단위로 인식합니다

CORE CONCEPT

"폴더 = 프로젝트" 단위로 일합니다

작업 하나마다 폴더 하나씩
그 폴더가 곧 프로젝트입니다

예시 — 작업별로 폴더 분리

claude-basic
연습용 폴더
report-april
4월 보고서 폴더
insta-cards
카드뉴스 폴더

관련 파일은 그 폴더 안에 모여 있고, 클로드코드는 그 폴더 안의 파일만 봅니다.

왜 작업마다 폴더를 나누나요?

클로드코드는 실행 폴더 안의 파일 전부를 한 프로젝트로 봅니다. 다른 작업이 섞이면:

• 사용량 · 처리 시간 증가 — 엉뚱한 파일까지 참고

• 실수 유발 — 맥락이 섞여 이상한 답변 ("그 파일 고쳐줘" → 어떤 파일?)

왕초보를 위한 IT 용어 6개

알아두면 덜 헤맵니다

권한 permission

폴더마다 "누가 건드려도 되는지"를 정해놓은 것. 시스템 폴더는 관리자만 가능 → 사용자 폴더 안에서 작업하세요

맥락 context

지금 하는 작업의 배경·흐름. 클로드코드는 폴더 안 파일 + 대화를 맥락으로 삼아 답합니다

토큰 token

AI가 글을 다룰 때 쓰는 단위. 한 번에 처리할 수 있는 토큰·맥락의 양에 한계가 있어서 파일·대화가 길면 답이 흐려집니다

경로 PATH

파일·폴더의 주소. 윈도우는 \로 구분(C:\Users\내이름), 맥은 /로 구분(/Users/내이름)

서브 폴더 sub folder

현재 폴더 안에 있는 폴더. 예) /Users/내이름/ 안의 claude-basic → 서브 폴더

폴더 이름 규칙

영어 소문자 + - 또는 _만. 한글·공백·특수문자는 NO (내 프로젝트, 4월보고서!! X)

이제 실제 작업 흐름을
따라해 봅시다

폴더 만들기 → 경로 복사 → cd 이동 → claude 실행

WORKFLOW

작업별 claude 실행하기

폴더 만들기 → 그 폴더로 이동 → claude 실행
Windows · Mac 공통 흐름

STEP 01

작업 폴더 만들기

어디에? → 사용자 폴더 바로 아래

  • 윈도우: C:\Users\내이름\claude-basic
  • 맥: /Users/내이름/claude-basic

만드는 방법

  • 윈도우: 파일 탐색기 → C:\Users\내이름 이동 → 빈 곳 우클릭 → 새로 만들기 → 폴더 → 이름 claude-basic
  • 맥: Finder → 사이드바에서 본인 아이디 폴더 클릭 → 빈 곳 우클릭 → 새로운 폴더 → 이름 claude-basic

피해야 할 위치

• 바탕화면 — 나중에 경로 찾기 어렵고, 터미널 이동 불편

• C:\Program Files, C:\Windows, /System 같은 시스템 폴더 — 권한 문제로 파일 생성 막힘

권한(permission)이란?

컴퓨터는 폴더마다 "누가 건드려도 되는지"를 정해놓습니다 — 이게 권한입니다

시스템 폴더는 관리자만 건드릴 수 있어서 거기서 클로드코드 실행하면 파일 생성이 막힙니다

사용자 폴더 안은 본인 권한이라 자유롭게 사용 가능합니다

STEP 02

폴더 경로 복사하기

폴더는 마우스로 만들었지만, 클로드코드는 터미널에서 그 폴더로 이동해서 실행해야 합니다. 먼저 경로 복사:

  • 윈도우 (파일 탐색기): 만든 claude-basic 폴더 열기 → 상단 주소창 클릭 → 전체 경로 선택됨 → Ctrl+C로 복사
  • 맥 (Finder): 만든 claude-basic 폴더 선택 → Option(⌥) 키 누른 채 우클릭 → "'claude-basic' 경로 복사" 클릭
STEP 03

터미널에서 그 폴더로 이동

터미널에서 쓰는 명령은 딱 하나 — cd 경로 (해당 폴더로 이동):

명령 의미 예시
cd 경로 해당 폴더로 이동 cd /Users/내이름/claude-basic

이동해 보기 (STEP 2에서 복사한 경로 붙여넣기)

  • 윈도우 (PowerShell): cd 입력 → 복사한 경로 붙여넣기 → Enter
    → 프롬프트가 C:\Users\내이름\claude-basic>로 바뀌면 성공
  • 맥 (iTerm2): cd 입력 → 복사한 경로 붙여넣기 → Enter
    → 프롬프트가 claude-basic로 바뀌면 성공
STEP 04

claude 실행

이제 준비 완료. 터미널에 입력:

claude

입력하면 클로드코드가 시작됩니다.

여기까지 되면

이제 프로젝트별로 클로드코드 실행이 가능합니다 — 작업이 바뀌면 다른 폴더에서 같은 흐름을 반복하면 됩니다

조금 더 편하게 쓰려면

Shift+Enter 여러 줄 입력 — 챗GPT 웹과 동일한 경험

WHY VSCODE / iTerm2

왜 코드 에디터가 필요할까요?

여기까지 하면 클로드코드는 바로 쓸 수 있습니다
다만 조금 더 편하게 쓰려면 아래 설치 작업을 권장합니다

핵심 — 클로드코드는 Enter = 즉시 전송

  • 기본 제공 방법: 줄 끝에 \ 입력 후 Enter → 매우 불편
  • 권장 방법: Shift+Enter로 여러 줄 입력 (챗GPT 웹과 동일)
  • Shift+Enter 사용에는 별도 프로그램 필요 → 가장 쉬운 게 VSCode (유명한 코드 에디터)

VSCode를 쓰는 이유 2가지

① Shift+Enter 여러 줄 입력 가능 (한 번만 설정하면 됨)

② 클로드코드가 만든 파일을 왼쪽 탐색기에서 바로 확인 (코드 수정 목적이 아닌 확인 용도)

Cursor는 어떤가요?

Cursor도 VSCode와 같은 코드 에디터지만, 수시로 UI가 바뀌어 처음에 당황할 수 있습니다 — VSCode 설치를 권장합니다

Shift+Enter가 부담스럽다면

메모장에서 요청사항 작성 → Ctrl+A → Ctrl+C → 터미널에 Ctrl+V → Enter로 전송

맥 사용자는

iTerm2, Ghostty, Warp 등이 기본으로 Shift+Enter를 지원합니다 → VSCode 없이 터미널만으로도 충분

Windows VSCode 5단계

설치 → 폴더 열기 → 터미널 → 패널 이동 → /terminal-setup

WINDOWS · VSCODE

윈도우 VSCode 설정

Shift+Enter 활성화를 위한
한 번만 하면 되는 설정입니다

STEP 01

VSCode 설치

  1. 웹브라우저에서 접속
https://code.visualstudio.com

또는 바로 이동 — code.visualstudio.com

  1. "Download for Windows" 클릭 → 설치 파일 다운로드
  2. 다운로드된 파일 더블클릭 → 설치 진행
  3. 설치 옵션은 모두 기본값(Next)으로 진행
STEP 02

작업 폴더 열기

클로드코드는 현재 열린 폴더 안에서 파일을 만들고 작업합니다.

  1. VSCode 실행
  2. 상단 메뉴 File → Open Folder 클릭
  3. C:\Users\내이름\claude-basic 선택
  4. 폴더 선택 클릭
STEP 03

Terminal 열기

  1. 상단 메뉴 Terminal → New Terminal 클릭
  2. 화면 하단에 터미널 창이 열립니다
STEP 04

Terminal 패널 오른쪽으로 이동

화면을 넓게 쓰기 위해 터미널을 오른쪽으로 옮깁니다.

  1. 터미널 탭 영역에서 마우스 우클릭
  2. "Move Panel to Right" 클릭

또는 상단 메뉴 View → Appearance → Panel Position → Right

STEP 05

클로드코드 실행 & Shift+Enter 활성화

claude

로그인 완료 후, Shift+Enter 활성화를 위해 클로드코드 안에서 딱 한 번만 실행:

/terminal-setup
  • 완료 후 VSCode의 터미널 패널 닫고 다시 열기 → claude 재실행
  • 이후부터 VSCode 터미널 안에서만 Shift+Enter로 여러 줄 입력 가능

주의 — VSCode 터미널 안에서만 동작

/terminal-setup은 VSCode 터미널 환경에만 적용됩니다

별도로 띄운 Windows PowerShell · 명령프롬프트(cmd)에서는 Shift+Enter가 안 됩니다

따라서 앞으로 claude는 VSCode를 열어서 그 안의 터미널로 실행하세요

처음 실행 시 "스크립트를 실행할 수 없습니다" 에러가 나면

Windows 사용자(Cursor / VS Code 터미널)는 터미널이 기본적으로 PowerShell로 열리며, 처음 claude를 실행할 때 "이 시스템에서 스크립트를 실행할 수 없으므로..." 같은 오류가 발생할 수 있습니다.

이 경우 아래 명령어를 복사해서 터미널에 붙여넣고 실행하세요:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

실행 후 확인 메시지가 나오면 "예(Y)"를 입력하세요. 이후부터 claude 명령어가 정상 작동합니다.

Mac iTerm2 4단계

기본으로 Shift+Enter 지원 — 별도 설정 불필요

macOS · iTerm2

맥 iTerm2 시작

iTerm2는 Shift+Enter를 기본 지원합니다
별도 설정 없이 바로 사용 가능

STEP 01

iTerm2 실행

  1. Finder → 응용 프로그램 → iTerm 더블클릭
  2. 또는 Spotlight (⌘ + Space) → iterm 입력 → Enter

iTerm2가 없다면

다음 사이트에서 무료 다운로드 — iterm2.com

STEP 02

작업 폴더로 이동

사용자 폴더 바로 아래에 있는 claude-basic 폴더로 이동:

cd claude-basic
STEP 03

클로드코드 실행

claude
STEP 04

Shift+Enter 확인

  • iTerm2, Ghostty, Warp 등 → Shift+Enter 기본 지원, 별도 설정 불필요
  • 맥 기본 Terminal.app → Shift+Enter 미지원 → iTerm2 이상 사용 권장

개발자들은 iTerm2 외에도 Ghostty, Warp 등 다양한 터미널을 사용합니다

혹시 Shift+Enter가 안 된다면

클로드코드 안에서 한 번만 실행:

/terminal-setup

완료 후 터미널 닫고 다시 열기 → claude 재실행

COMMON

공통 사용 팁

Windows · Mac
알아두면 즉시 효율이 올라가는 키 동작

동작 방법
요청 전송 Enter
여러 줄 입력 Shift + Enter
클로드코드 종료 /exit

처음하는 클로드코드 Part2 · 시작하기 비주얼 가이드

Windows VSCode · macOS iTerm2 기준