[바이브코딩] Claude Code 처음 시작 가이드 — 터미널 모르는 사람도 안전하게 쓰는 법

Claude Code를 처음 접하면 기능보다 먼저 시작 방식에서 막히기 쉽습니다. 데스크톱 앱을 열어야 하는지, 터미널을 사용해야 하는지, 어떤 폴더를 선택해야 하는지부터 판단해야 하기 때문입니다.

이 글은 코딩 경험이 적은 사용자가 설치, 로그인, 첫 작업까지 진행할 수 있도록 두 가지 시작 경로와 자주 발생하는 오류를 정리합니다. 작업 전에는 공식 문서의 최신 안내와 화면을 함께 확인하세요.

이 글에서 해결할 문제

"Claude Code 사용법"을 검색하면 나오는 글들이 대부분 개발자 기준이에요. npm install, "Node.js 설치 먼저"... 첫 줄부터 막히죠. 이 글은 그 불편을 없애기 위해 썼습니다.

• 터미널이 뭔지, 어떻게 여는지 모르는 분
• 설치 후 "claude: command not found" 오류가 뜨는 분
• 로그인 과정에서 브라우저가 안 열리는 분
• 어떤 요금제를 써야 할지 모르는 분

설치부터 첫 번째 대화까지 필요한 순서를 한 번에 확인할 수 있도록 구성했습니다. 설치 시간은 운영체제와 로그인 상태에 따라 달라질 수 있습니다.

누가 읽으면 좋을까?

• ✅ 코딩 경험 없는 직장인·학생
• ✅ AI 도구에 관심 있지만 터미널이 낯선 분
• ✅ Claude 일반 채팅은 써봤는데 Claude Code가 궁금한 분
• ✅ 설치 실패 후 재도전하는 분
• ❌ 이미 Claude Code를 업무에 쓰고 있는 개발자 (고급 설정 편을 참고하세요)

전제 지식: 파일 다운로드·복사-붙여넣기 정도만 할 수 있으면 됩니다.

목차

1. 이 글에서 해결할 문제
2. 누가 읽으면 좋을까?
3. 핵심 용어 정리
4. 처음 시작할 때 확인할 작업 예시
5. 설치 방법 — 두 가지 선택지
6. 자주 막히는 문제와 해결법
7. 나에게 맞는 방법 고르기
8. 시작 전 준비 목록
9. 자주 묻는 질문
10. 참고자료

핵심 용어 정리

• 터미널(Terminal) — 텍스트 명령어로 컴퓨터에 지시하는 창. macOS는 "터미널", Windows는 "PowerShell" 또는 "CMD"입니다.
• Claude Code — Anthropic이 만든 AI 코딩 어시스턴트. 터미널 또는 데스크톱 앱에서 자연어(한국어 포함)로 지시하면 코드 작성·수정·실행을 도와줍니다.
• 네이티브 설치(Native Install) — Node.js 등 별도 도구 없이 설치하는 방식. Anthropic이 2025년부터 공식 권장하는 방법입니다.
• CLAUDE.md — Claude Code가 매 세션마다 자동으로 읽는 메모 파일. 프로젝트 설명, 주의사항 등을 써두면 매번 다시 설명할 필요가 없어요.
• Pro / Max 플랜 — Claude Code 사용에는 유료 구독이 필요합니다. Anthropic 공식 요금 기준 Pro는 $20/월, Max는 $100/월부터 시작합니다. 처음엔 Pro로 시작해서 사용량을 보고 Max로 올리는 게 일반적이에요.

처음 시작할 때 확인할 작업 예시

Anthropic 공식 문서에 따르면, Pro 플랜은 월 $20로 시작하며 한국 기준 약 2만 7,000원대입니다. Anthropic이 2025년에 발표했듯 네이티브 설치에는 자동 업데이트가 포함됩니다. Claude Code는 승인한 작업 범위에서 파일을 변경할 수 있으므로, 처음에는 작은 작업으로 시작하고 변경 내용을 직접 확인하는 편이 안전합니다.

• 폴더 안 파일 목록과 역할 설명 요청
• README 문서 요약 또는 번역
• CSV 파일에서 필요한 열만 추출하는 스크립트 생성

중요: Claude Code는 파일을 직접 수정하고 명령을 실행할 수 있습니다. 처음에는 변경 범위가 작은 폴더를 열고, 실행 전 확인 내용을 읽는 습관을 들이세요.

첫 작업은 "이 폴더 안에 뭐가 있어?"처럼 읽기 중심의 요청으로 시작하는 편이 안전합니다. 파일을 수정하거나 삭제하는 작업으로 넘어가기 전에는 도구가 제안한 변경 범위와 실행 명령을 직접 확인하세요.

설치 방법 — 두 가지 선택지

방법 A: 데스크톱 앱 (터미널 없이 — 초보자 강추)

Anthropic 공식 터미널 가이드에서도 안내하듯, 데스크톱 앱을 쓰면 터미널 없이 바로 시작할 수 있습니다.

1. 앱 다운로드: claude.ai에 로그인 → "Claude Code" 메뉴 → macOS 또는 Windows용 파일 다운로드
2. 설치: macOS는 .dmg 파일 열기 → 앱을 Applications 폴더로 드래그 / Windows는 .exe 더블클릭
3. 앱 실행 후 로그인: 브라우저가 열리며 Claude 계정 인증 요청. 로그인 후 앱으로 돌아오면 준비 완료.
4. 작업 폴더 선택: "Open Folder"로 작업할 폴더를 열고 대화 시작

방법 B: 터미널 설치 (명령어 한 줄 — 더 강력)

터미널이 처음이어도 복사-붙여넣기만 할 수 있으면 됩니다.

macOS 기준

1. Spotlight(Cmd + Space) → "터미널" 검색 → 엔터로 터미널 열기
2. 아래 줄 복사 후 터미널에 붙여넣기(Cmd + V) → 엔터:

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

   "Claude Code successfully installed!" 메시지가 나오면 성공.
3. 터미널을 닫고 다시 열기 (PATH 갱신)
4. claude 입력 → 브라우저 인증 → 완료

Windows 기준

1. Windows 키 → "PowerShell" 검색 → 엔터
2. 아래 줄 붙여넣기(Ctrl + V 또는 마우스 우클릭) → 엔터:

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

3. PowerShell 재시작 → claude 입력 → 로그인

📌 Homebrew 사용 중이면: brew install --cask claude-code
WinGet 사용 중이면: winget install Anthropic.ClaudeCode

첫 번째 대화 시작하기

설치와 로그인이 완료됐으면, 이런 것들을 한국어로 바로 물어볼 수 있어요:

• "이 폴더에 있는 파일들 전체 설명해줘"
• "README.md 파일을 한국어로 요약해줘"
• "엑셀 파일에서 중복값 제거하는 스크립트 만들어줘"

권한 설정과 실행 모드에 따라 확인 과정이 달라질 수 있습니다. 실행 전에는 제안된 명령과 변경 파일을 직접 확인하세요.

자주 막히는 문제와 해결법

❌ "claude: command not found"

원인: 터미널을 재시작하지 않아서 PATH가 갱신되지 않음
해결: 터미널 창을 닫고 새로 열기. 그래도 안 되면:

source ~/.zshrc    # macOS
source ~/.bashrc   # Linux

❌ 브라우저가 열리지 않아 로그인 불가

원인: 기본 브라우저 설정 문제
해결: 터미널에 나오는 URL을 복사해 브라우저 주소창에 직접 붙여넣기

❌ Windows에서 "실행 정책이 실행을 허용하지 않습니다"

원인: PowerShell 스크립트 실행 차단
해결: PowerShell을 관리자로 실행 후 아래 입력 → Y → 엔터 → 재시도

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

❌ "구독이 필요합니다" 메시지

원인: Claude Free 플랜은 Claude Code 미지원
해결: claude.ai에서 Pro 플랜($20/월) 이상으로 업그레이드

❌ 설치 후 버전이 너무 낮거나 옛날 npm 버전

원인: npm으로 설치한 구 버전이 남아 있는 경우
해결: claude install로 네이티브 버전으로 전환

나에게 맞는 방법 고르기 — 선택 기준

구분	데스크톱 앱	터미널 방식
터미널 필요 여부	❌ 불필요	✅ 필요
설치 난이도	⭐ 쉬움 (클릭 몇 번)	⭐⭐ 명령어 1~2줄
기능 범위	일반 작업에 충분	셸 실행 등 고급 기능 포함
추천 대상	비개발자, 처음 시작하는 분	더 많은 기능 원하는 분
자동 업데이트	✅ 앱 자동 업데이트	✅ 빌트인 자동 업데이트

요금제 선택 기준

플랜	가격	Claude Code 사용	추천 대상
Free	무료	❌	일반 Claude 채팅 전용
Pro	$20/월	✅ (사용 한도 있음)	입문자, 가끔 사용
Max	$100/월~	✅ (높은 한도)	매일 집중 사용하는 분
API	사용량 과금	✅	개발자, 자동화 파이프라인

※ 위 요금은 Anthropic 공식 가격 기준입니다. Claude Code는 현재 macOS·Windows 데스크톱, 웹, VS Code, JetBrains 확장 등 5가지 방식으로 사용할 수 있습니다.

터미널이 낯설다면 데스크톱 앱에서 시작하고, 여러 파일을 다루거나 반복 작업이 필요해질 때 터미널 방식을 검토할 수 있습니다. 선택 전에는 각 방식에서 제공하는 권한과 기능 범위를 공식 문서에서 확인하세요.

지금 바로 할 수 있는 것 — 시작 전 준비 목록

• ☐ Claude 계정 확인: claude.ai에 로그인 가능한 계정이 있다
• ☐ 플랜 확인: Pro 이상 구독 중이다 (Free이면 업그레이드 필요)
• ☐ 설치 방법 선택: 데스크톱 앱 / 터미널 중 하나를 골랐다
• ☐ 설치 완료: 앱 설치 또는 터미널 명령어 실행이 끝났다
• ☐ 로그인 완료: 첫 실행 후 브라우저 인증을 마쳤다
• ☐ 첫 대화 시도: "이 폴더 뭐가 있어?" 한 마디 해봤다
• ☐ 작업 폴더 연결: 작업하고 싶은 폴더를 열었다

자주 묻는 질문 (FAQ)

Q. Claude Code는 유료인가요?

네, 현재 Pro($20/월) 이상의 구독이 필요합니다. Free 플랜으로는 일반 Claude 채팅만 가능해요. 기업 계정(Team/Enterprise)이나 API 키로도 사용할 수 있습니다.

Q. 한국어로 질문해도 되나요?

물론입니다! 한국어를 포함한 다국어를 지원해요. "이 파일 내용을 한국어로 요약해줘" 같은 자연스러운 지시가 잘 작동합니다.

Q. 코딩을 전혀 몰라도 쓸 수 있나요?

자연어로 작업을 요청할 수 있지만, 생성된 코드와 실행 명령을 검토할 책임은 사용자에게 있습니다. 처음에는 작은 단위의 읽기 작업부터 시작하고 변경 전 백업을 남기세요.

Q. 내 파일이 Anthropic 서버에 업로드되나요?

작업 중인 파일 내용이 Anthropic 서버로 전송됩니다. 개인정보나 기업 기밀이 담긴 파일은 신중하게 다루세요. 민감한 프로젝트엔 Anthropic 개인정보처리방침을 검토하는 게 좋아요.

Q. 설치 후 업데이트는 어떻게 하나요?

네이티브 설치 버전은 실행 시 자동 업데이트됩니다. 수동으로 버전을 확인하려면 claude --version을 실행하세요. 데스크톱 앱도 자동 업데이트를 지원합니다.

Q. VS Code나 다른 에디터와 함께 쓸 수 있나요?

네! Claude Code는 VS Code와 JetBrains IDE용 확장 프로그램도 제공합니다. 에디터 마켓플레이스에서 "Claude Code"를 검색해서 설치하면 에디터 안에서 바로 사용할 수 있어요.

참고자료

• Claude Code 공식 빠른 시작 가이드 (한국어) — Anthropic
• 새로운 사용자를 위한 터미널 가이드 (한국어) — Anthropic
• Claude Code 설치부터 첫 프로젝트까지 가이드 (Windows/Mac) — talknthings, 2026-02-24
• 클로드 코드 첫 설치부터 사용까지 (2026 가이드) — 박실로 노무사 AI 블로그, 2026-02-23
• Claude Code Tutorial for Beginners (No Coding Required) — MasteringAI, 2025-11-22