Claude Code 시작하기가 막막하신가요? Claude Code는 터미널에서 AI와 대화하면서 코딩하는 도구입니다. “내가 원하는 것을 말하면 AI가 알아서 만들어주는” 경험에 가장 가까운 바이브코딩 도구입니다. 이 글에서는 설치부터 첫 프로젝트 생성까지 비전공자도 따라할 수 있도록 단계별로 안내합니다.
• AI에게 최대한 맡기고 싶은 바이브코딩 입문자
• Cursor는 써봤는데 Claude Code가 궁금한 분
• 터미널에서 AI로 코딩하는 방법을 알고 싶은 분
📖 목차
🤖 Claude Code란 무엇이고 다른 도구와 어떻게 다른가
Claude Code는 터미널에서 실행하는 AI 코딩 도구입니다. Cursor처럼 별도 에디터를 설치하는 것이 아니라, 터미널 창에서 AI와 대화하면서 코딩하는 방식입니다. 파일 생성, 코드 작성, 프로젝트 구조 설계, 에러 수정까지 모두 대화로 요청할 수 있습니다.
Cursor 같은 에디터 도구는 코드를 보면서 AI의 도움을 받는 반면, Claude Code는 AI가 주도적으로 프로젝트 전체를 관리합니다. 파일을 직접 만들고, 수정하고, 터미널 명령어까지 실행합니다. 비전공자 입장에서는 “원하는 것을 말하면 AI가 구현해주는” 느낌에 더 가깝습니다.
📋 설치 전 준비 사항
Claude Code를 사용하려면 세 가지가 필요합니다. 하나라도 빠지면 설치나 실행에서 막히기 때문에 먼저 확인하세요.
💻 시스템 요구 사항
| 항목 | 요구 사항 |
|---|---|
| OS | Windows 10 이상, macOS 12 이상, Linux |
| Node.js | 18 버전 이상 (설치 자체에 필요) |
| RAM | 4GB 이상 |
| 인터넷 | AI 요청 시 항상 필요 |
📌 Node.js 설치 확인
Claude Code는 Node.js 기반으로 동작하기 때문에 반드시 먼저 설치돼 있어야 합니다. 터미널을 열고 아래 명령어를 입력하세요.
node --versionv18.0.0 이상의 버전 번호가 출력되면 준비 완료입니다. 숫자가 안 나오거나 18 미만이면 Node.js 설치 가이드를 참고하세요.
🔑 인증 방법 선택
Claude Code를 사용하는 방법은 두 가지입니다.
| 방법 | 월 비용 | 특징 |
|---|---|---|
| Anthropic API 키 | 사용한 만큼 (입문 $1~$5) | 세밀한 비용 관리, 한도 설정 가능 |
| Claude Max 구독 | $100~$200 | 로그인으로 바로 사용, 사용량 한도 내 무제한 |
입문자에게는 API 키 방식을 추천합니다. 적게 사용하면 비용이 거의 발생하지 않고, 사용량을 직접 확인할 수 있기 때문입니다.
🔑 Anthropic API 키 발급받기
📌 계정 만들기
- 브라우저에서 console.anthropic.com에 접속합니다.
- “Sign Up”을 클릭하고 이메일 또는 Google 계정으로 가입합니다.
- 이메일 인증을 완료합니다.
📌 API 키 생성하기
- 로그인 후 좌측 메뉴에서 “API Keys”를 클릭합니다.
- “Create Key” 버튼을 클릭합니다.
- 키 이름을 입력합니다 (예: “claude-code-local”).
- 생성된 키를 복사합니다. 이 키는 한 번만 표시되므로 안전한 곳에 저장하세요.
API 키는
sk-ant-로 시작하는 긴 문자열입니다. 다른 사람과 공유하거나 코드에 직접 넣으면 안 됩니다. 키가 유출되면 다른 사람이 내 비용으로 API를 사용할 수 있습니다.
📌 결제 수단 등록 및 한도 설정
API를 사용하려면 결제 수단이 필요합니다. 좌측 메뉴의 “Billing”에서 신용카드를 등록하세요. 사용량 한도(Spending Limit)를 $5~$10으로 설정해두면 예상치 못한 과금을 방지할 수 있습니다.
📥 Claude Code 설치하기
터미널을 열고 아래 명령어를 입력합니다. -g 옵션은 시스템 전체에서 사용할 수 있도록 전역으로 설치한다는 뜻입니다.
npm install -g @anthropic-ai/claude-code설치가 끝나면 아래 명령어로 확인합니다.
claude --version버전 번호가 출력되면 설치 성공입니다. “command not found” 에러가 나타나면 터미널을 닫았다가 다시 열어보세요.
macOS에서
npm install -g 실행 시 권한 에러가 발생하면 앞에 sudo를 붙여서 실행합니다.sudo npm install -g @anthropic-ai/claude-code비밀번호 입력 중 화면에 아무것도 표시되지 않는 것이 정상입니다.
🔧 API 키 설정하기
설치한 Claude Code에 API 키를 연결해야 합니다.
📌 임시 설정 (터미널 닫으면 사라짐)
Windows (PowerShell):
$env:ANTHROPIC_API_KEY = "sk-ant-여기에-키를-붙여넣으세요"macOS / Linux:
export ANTHROPIC_API_KEY="sk-ant-여기에-키를-붙여넣으세요"
📌 영구 설정 (추천)
매번 입력하기 번거로우니 영구 설정을 권장합니다.
macOS / Linux (zsh 기준):
echo 'export ANTHROPIC_API_KEY="sk-ant-여기에-키를-붙여넣으세요"' >> ~/.zshrc
source ~/.zshrcbash를 사용한다면 ~/.zshrc 대신 ~/.bashrc를 사용하세요.
Windows (PowerShell):
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-여기에-키를-붙여넣으세요", "User")설정 후 터미널을 닫았다가 다시 열면 적용됩니다.
API 키 없이도 사용할 수 있습니다. 터미널에서
claude를 입력하면 로그인 화면이 나타나고, 브라우저에서 Claude 계정으로 로그인하면 됩니다.
🚀 Claude Code 첫 실행
프로젝트를 만들 폴더로 이동한 뒤 claude를 입력합니다.
# Windows
cd C:\Users\사용자이름\Documents
mkdir my-claude-project
cd my-claude-project
# macOS
cd ~/Documents
mkdir my-claude-project
cd my-claude-projectclaudeClaude Code가 시작되면 > 프롬프트가 나타납니다. 여기에 한국어 또는 영어로 원하는 것을 입력하면 됩니다.
📌 인터페이스 이해하기
| 요소 | 설명 |
|---|---|
> 프롬프트 |
사용자가 요청을 입력하는 곳 |
| Claude 응답 | AI의 답변과 실행 계획 |
| 도구 사용 알림 | 파일 읽기/수정 시 표시 |
| 권한 요청 | 파일 수정/명령 실행 전 사용자 확인 |
Claude가 파일을 수정하거나 터미널 명령어를 실행하기 전에 항상 확인을 요청합니다. “y”를 입력하면 허용, “n”을 입력하면 거부합니다.
📁 첫 프로젝트 만들기 — AI에게 전부 맡기기
📌 Next.js 프로젝트 생성 요청
Claude Code 프롬프트에 아래처럼 입력합니다.
이 폴더에 Next.js 프로젝트를 만들어줘. TypeScript를 사용하고,
App Router로 만들어줘. 간단한 자기소개 페이지도 함께 만들어줘.
이름은 "홍길동", 한 줄 소개는 "바이브코딩을 시작한 비전공자",
좋아하는 것은 "커피, 고양이, 여행"으로 해줘.Claude가 실행 계획을 보여주고, 승인하면 자동으로 진행합니다.
npx create-next-app명령어 실행- 프로젝트 파일 구조 생성
app/page.tsx를 자기소개 페이지로 수정- 스타일 파일 수정
각 단계마다 Claude가 무엇을 하려는지 설명하고 권한을 요청합니다. 내용을 읽고 “y”를 눌러 승인하세요.
📌 개발 서버 실행
프로젝트 생성이 완료되면 Claude에게 “개발 서버를 실행해줘”라고 요청하거나, 직접 실행합니다.
npm run dev브라우저에서 http://localhost:3000을 열면 AI가 만든 자기소개 페이지가 보입니다. 코드를 한 줄도 직접 쓰지 않고 웹 페이지를 만든 것입니다.
📌 추가 수정 요청해보기
페이지를 더 꾸미고 싶다면 계속 대화하면 됩니다.
배경색을 연한 파란색으로 바꾸고, 프로필 사진 자리를 동그란
플레이스홀더로 추가해줘. 반응형으로 만들어서 모바일에서도
보기 좋게 해줘.Claude가 파일을 수정하고, 브라우저를 새로고침하면 변경 사항을 바로 확인할 수 있습니다. 이것이 Claude Code의 바이브코딩 루프입니다 — 말로 요청 → AI가 구현 → 결과 확인 → 다시 요청.
✅ 설치 확인 점검 목록
| 항목 | 확인 방법 | 정상 신호 |
|---|---|---|
| Node.js | node --version |
v18 이상 출력 |
| Claude Code 설치 | claude --version |
버전 번호 출력 |
| API 키 설정 | claude 실행 |
에러 없이 프롬프트 표시 |
| 프로젝트 생성 | Claude에게 요청 | 파일이 생성됨 |
| 개발 서버 | npm run dev |
localhost:3000 접속 가능 |
⚠️ 자주 발생하는 문제와 해결
🚫 “command not found: claude” 에러
Node.js의 전역 패키지 경로가 시스템 PATH에 없는 경우입니다. 아래 명령어로 전역 패키지 경로를 확인하세요.
npm config get prefix출력된 경로의 bin 폴더(Windows는 루트 폴더)가 PATH에 포함돼 있어야 합니다. PATH 설정이 어렵다면 npx로 실행하는 방법도 있습니다.
npx @anthropic-ai/claude-code
🚫 “Invalid API key” 에러
API 키가 잘못 입력됐거나 환경 변수가 설정되지 않은 경우입니다. 아래 명령어로 확인하세요.
macOS / Linux:
echo $ANTHROPIC_API_KEYWindows (PowerShell):
echo $env:ANTHROPIC_API_KEY아무것도 출력되지 않으면 환경 변수가 설정되지 않은 것입니다. 키를 복사할 때 앞뒤 공백이 포함되지 않았는지도 확인하세요.
🚫 Claude가 파일을 수정하지 않을 때
Claude Code는 보안을 위해 파일 수정 전에 반드시 사용자 확인을 요청합니다. 권한 요청이 나타나면 “y”를 입력해야 합니다. 아무 일도 일어나지 않는다면 프롬프트를 더 구체적으로 작성해보세요.
🚫 API 비용이 걱정될 때
Anthropic 콘솔의 “Billing” 페이지에서 사용량 한도를 설정하세요. 한도에 도달하면 API가 자동으로 중단됩니다. 일반적인 바이브코딩 입문 단계에서는 월 $5 이내로 사용하는 경우가 많습니다.
💡 Claude Code를 더 잘 쓰는 실전 팁
📌 한 번에 하나씩 요청하기
“웹사이트 전체를 만들어줘”보다 “먼저 메인 페이지 레이아웃을 만들어줘”처럼 단계별로 요청하면 결과가 더 정확합니다. 한 단계가 끝나면 결과를 확인하고 다음 단계를 요청하세요.
📌 CLAUDE.md 파일 활용하기
프로젝트 루트에 CLAUDE.md 파일을 만들고, 프로젝트 규칙이나 선호하는 코딩 스타일을 적어두면 Claude가 참고해서 일관된 코드를 생성합니다. “한국어 주석 사용”, “함수형 컴포넌트만 사용” 같은 규칙을 적어두면 효과적입니다.
📌 /help와 /cost 명령어 활용하기
/help를 입력하면 사용 가능한 명령어 목록을 볼 수 있습니다. /clear로 대화를 초기화하고, /cost로 현재 세션의 API 비용을 확인할 수 있습니다.
📌 Cursor와 함께 사용하기
Claude Code로 프로젝트 뼈대를 만들고 큰 기능을 구현한 뒤, Cursor에서 세부 코드를 수정하는 방식이 가장 효율적입니다. 두 도구는 같은 프로젝트 폴더를 공유하므로 자유롭게 오갈 수 있습니다.
Claude Code 말고 Cursor·Copilot이랑 뭐가 다른지 궁금하면, AI 코딩 도구 비교 2026에서 한눈에 비교 해보세요.
⚠️ 면책 고지
여기까지 따라오셨다면 Claude Code 설치부터 첫 프로젝트까지 모두 완료한 것입니다. 읽어주셔서 감사합니다.
❓ FAQ
질문을 누르면 답변이 펼쳐집니다.
Q. Claude Code는 무료인가요?
Claude Code 자체는 무료로 설치할 수 있지만, AI 기능을 사용하려면 Anthropic API 비용(종량제) 또는 Claude Max 구독($100~$200/월)이 필요합니다. API 종량제로 시작하면 월 $1~$5 수준에서 입문이 가능합니다.
Q. Cursor와 Claude Code 중 뭘 먼저 써야 하나요?
터미널이 익숙하지 않다면 Cursor를 먼저 추천합니다. 터미널 기본 사용법을 알고 있다면 Claude Code부터 시작해도 좋습니다. 궁극적으로는 둘 다 함께 사용하는 것이 가장 효율적입니다.
Q. Node.js 없이 Claude Code를 설치할 수 있나요?
아닙니다. Claude Code는 npm으로 설치하는 Node.js 기반 도구이므로 Node.js가 반드시 필요합니다. Node.js 18 버전 이상을 먼저 설치하세요.
Q. API 키가 유출되면 어떻게 하나요?
즉시 Anthropic 콘솔에서 해당 키를 비활성화(삭제)하고 새 키를 발급받으세요. 유출된 키로 다른 사람이 API를 사용하면 과금이 발생할 수 있으므로 빠르게 대응해야 합니다.
Q. Claude Code에서 한국어로 요청해도 되나요?
네, 한국어로 자연스럽게 요청하면 됩니다. Claude는 한국어를 잘 이해하고, 한국어로 설명도 해줍니다. 다만 코드의 변수명과 주석은 영어가 관례이므로 필요에 따라 지정하세요.
Q. Claude Code가 실수로 중요한 파일을 삭제할 수 있나요?
Claude Code는 파일 수정이나 삭제 전에 반드시 사용자 확인(“y/n”)을 요청합니다. 확인 없이 파일을 삭제하지 않으므로 권한 요청을 주의 깊게 읽으면 안전합니다. Git을 함께 사용하면 언제든 이전 상태로 되돌릴 수 있어 더 안심입니다.
Q. Claude Code는 인터넷 없이도 사용 가능한가요?
아닙니다. Claude Code는 AI 요청을 서버로 보내서 처리하므로 인터넷 연결이 항상 필요합니다. 오프라인 환경에서는 사용할 수 없습니다.
Q. API 사용량을 어떻게 확인하나요?
Claude Code에서 /cost 명령어를 입력하면 현재 세션의 비용을 확인할 수 있습니다. 전체 사용량은 Anthropic 콘솔의 “Usage” 페이지에서 확인 가능합니다.
Q. Windows에서 PowerShell과 cmd 중 뭘 써야 하나요?
PowerShell을 추천합니다. cmd에서도 동작하지만, 환경 변수 설정 방법이 다르고 PowerShell이 더 현대적인 기능을 제공합니다.
Q. Claude Code를 업데이트하려면 어떻게 하나요?
npm update -g @anthropic-ai/claude-code 명령어로 최신 버전으로 업데이트할 수 있습니다. 주기적으로 업데이트하면 새로운 기능과 버그 수정을 받을 수 있습니다.
🔗 관련 글
- Claude Design 사용법+완전 정복 — 비전공자도 30분 만에 프로토타입
- Cursor 설치 방법과 첫 프로젝트 만들기
- 바이브코딩 시작 전 개발환경 세팅 완벽 가이드
- Node.js 설치부터 바이브코딩 시작까지 3단계
- 터미널 처음 사용하는 비전공자를 위한 가이드
- 바이브코딩에 Git이 필요한 이유 + 5분 설치 가이드
📚 참고 자료
IT 기획 10년차 / 비전공자를 위한 바이브코딩 블로그 운영 / vibe-start.com 제작
Building VibeStart — the fastest path for non-devs into AI coding. Launching on Product Hunt 2026-05-26.
