Claude Code 사용법 실전 후기
비개발자 도전기
터미널이 뭔지도 몰랐던 사람이 Claude Code를 써본 솔직한 기록
📋 이 글에서 알 수 있는 것
- Claude Code가 Cursor·v0와 어떻게 다른지
- 2026년 기준 가장 쉬운 설치 방법 (터미널 초보도 가능)
- 비개발자가 실제로 써보면서 막혔던 포인트와 해결법
- 요금 구조 — 무료 플랜 없음, 실제 비용이 얼마나 나오는지
- 어떤 사람에게 맞고, 어떤 사람은 Cursor가 더 나은지
Claude Code란 무엇인가
Claude Code는 Anthropic이 만든 터미널 기반 AI 코딩 에이전트입니다. 쉽게 말하면 CLI(Command Line Interface) 도구입니다. 마우스로 클릭하는 프로그램이 아니라, 검은 화면에 명령어를 입력하는 방식으로 동작합니다.
Cursor가 "AI가 탑재된 코드 에디터"라면, Claude Code는 "터미널에서 직접 대화하는 AI 코딩 에이전트"입니다. 화려한 UI 대신 순수하게 AI의 능력에 집중한 형태입니다.
⚡ Claude Code의 핵심 특징
- 터미널 기반: 설치 후 터미널에서
claude라고 입력하면 바로 대화 시작 - 파일 시스템 접근: 코드베이스 전체를 읽고, 파일을 생성·수정·삭제까지 처리
- 자율 실행: "이 기능 추가해줘"라고 하면 관련 파일을 스스로 찾아 수정
- Anthropic Claude 직접 연결: Claude.ai와 동일한 모델을 터미널에서 사용
- 데스크톱 앱 지원 (2025년 추가): 터미널이 불편하다면 GUI 앱으로도 사용 가능
바이브코딩 완전 입문 가이드: Cursor vs Claude vs v0 vs Replit도 함께 읽어보세요.
설치 방법 — 2026년엔 생각보다 쉽다
솔직히 말하면 1년 전만 해도 Claude Code 설치는 비개발자에게 꽤 험난한 과정이었습니다. Node.js를 먼저 설치해야 하고, PATH 설정 오류가 자주 났습니다. 그런데 2026년 현재는 많이 달라졌습니다. 네이티브 설치 방법이 생겨서 Node.js 없이도 설치가 가능해졌습니다.
설치 방법은 크게 두 가지입니다. 처음이라면 아래 순서대로 따라오세요.
방법 선택 — 데스크톱 앱 vs CLI
터미널이 정말 낯설다면 데스크톱 앱을 먼저 써보세요. claude.ai/download에서 Mac / Windows용 앱을 받으면 Claude Code가 내장되어 있어 Node.js나 터미널 없이도 사용할 수 있습니다. 터미널 방식이 괜찮다면 아래 CLI 설치를 진행합니다.
CLI 네이티브 설치 (Mac / Linux)
터미널을 열고 아래 명령어를 복사해 붙여넣은 뒤 Enter를 누릅니다.
curl -fsSL https://claude.ai/install.sh | bash
1분 이내에 설치가 완료됩니다. Node.js가 없어도 됩니다.
CLI 네이티브 설치 (Windows)
PowerShell을 열고 아래 명령어를 실행합니다.
winget install Anthropic.ClaudeCode
또는 WinGet이 없다면 PowerShell에서 irm https://claude.ai/install.ps1 | iex를 실행합니다. Windows는 Git for Windows도 함께 설치되어 있어야 합니다.
로그인 및 첫 실행
터미널에 claude를 입력하면 브라우저가 열리면서 Anthropic 계정 로그인 화면이 나옵니다. 로그인을 완료하면 터미널에서 바로 Claude와 대화를 시작할 수 있습니다.
Claude Code는 Claude.ai Pro, Max, Team, Enterprise 플랜 또는 Anthropic API 크레딧이 있어야 사용할 수 있습니다. 무료 Claude.ai 계정으로는 접근이 되지 않습니다. 비용 구조는 PART 05에서 자세히 다룹니다.
첫 실행 — 터미널 앞에서 멈춘 순간
설치를 마치고 claude를 입력했습니다. 로그인까지는 순조로웠습니다. 그런데 막상 빈 프롬프트 앞에 서니 무슨 말을 해야 할지 막막했습니다. Claude.ai 웹사이트처럼 친절한 안내도 없고, 그냥 커서만 깜빡이고 있었습니다.
첫 번째 시도는 이랬습니다.
😅 첫 번째 시도 — 실패
프롬프트: "간단한 할 일 앱 만들어줘"
→ Claude Code가 열심히 뭔가를 만들기 시작했습니다. 파일 여러 개가 생성되고, 뭔가 패키지를 설치하고… 10분 뒤에 보니 폴더 안에 파일이 20개쯤 생겨있었습니다. 실행 방법을 몰라서 그냥 멍하니 바라봤습니다.
이게 Claude Code 입문자가 자주 겪는 패턴입니다. AI는 빠르게 결과물을 만들어내는데, 그 결과물을 어떻게 실행하고 확인하는지를 모르면 아무 소용이 없습니다. 그래서 Claude Code를 잘 쓰려면 두 가지를 미리 알아두어야 합니다.
첫째, 작업 시작 전
/init 명령어를 먼저 입력하세요. 프로젝트 구조를 분석해 CLAUDE.md 파일을 생성하고, 이후 대화의 컨텍스트가 훨씬 정확해집니다.둘째, 결과물을 어떻게 실행할지도 함께 물어보세요. "간단한 할 일 앱 만들어줘. 만들고 나서 어떻게 실행하는지도 알려줘."처럼 요청하면 실행 방법까지 안내해줍니다.
✅ 두 번째 시도 — 성공
프롬프트: "간단한 HTML 할 일 앱 만들어줘. 별도 설치 없이 브라우저에서 바로 열 수 있게 파일 하나로 만들어줘."
→ index.html 파일 하나가 생성됐고, 더블클릭하니 바로 브라우저에서 열렸습니다. 비개발자가 Claude Code를 처음 쓸 때는 이렇게 "파일 하나, 브라우저에서 바로" 조건을 붙이는 게 핵심입니다.
실제로 써보니 — 잘 되는 것과 안 되는 것
며칠 동안 Claude Code를 실제로 써보면서 느낀 점을 솔직하게 정리했습니다.
👍 잘 되는 것
- 기존 파일 수정·리팩토링
- 여러 파일에 걸친 변경 작업
- 코드 설명과 버그 원인 파악
- Git 커밋 메시지 작성
- 프로젝트 전체 구조 파악 후 답변
- 긴 작업을 자율적으로 처리
👎 어려운 것
- 결과물을 바로 시각적으로 확인하기 어려움
- Node.js / Python 환경 설정 필요한 결과물
- 터미널 오류 메시지 해석
- 중간에 작업이 멈추면 재개 방법 모호
- API 비용 예측 어려움
결론적으로 Claude Code는 이미 만들어진 프로젝트를 수정·개선하거나, 복잡한 다중 파일 작업을 처리할 때 특히 강력합니다. 반면 처음부터 결과물을 만들고 바로 눈으로 확인하고 싶은 비개발자에게는 Cursor나 v0가 더 편합니다.
Cursor 사용법 초보 가이드 A to Z를 먼저 읽어보세요.
요금 구조 솔직 정리
Claude Code는 무료로 쓸 수 없습니다. 이 점을 모르고 설치부터 했다가 막히는 경우가 많아서 먼저 짚고 넘어갑니다. 사용 방식은 두 가지입니다.
| 방식 | 요금 구조 | 적합한 경우 |
|---|---|---|
| Claude.ai 구독 (Pro/Max) | 월 정액 ($20~$100+) | 매일 쓰는 헤비 유저 |
| Anthropic API 과금 | 사용량 기반 (토큰당 과금) | 가끔 쓰는 라이트 유저 |
| 무료 Claude.ai 플랜 | 사용 불가 | - |
* 2026년 4월 기준. 요금은 변동될 수 있으므로 claude.ai 공식 요금 페이지에서 확인하세요.
API 과금 방식으로 쓴다면 실제 비용이 얼마나 나올까요? 한 번의 집중 작업 세션(약 30~60분)에 API 호출이 여러 번 발생하며, 대략 $0.50~$2.00 수준이 나오는 경우가 많습니다(작업 복잡도에 따라 크게 달라집니다). 가끔 써보는 입문 단계라면 API 방식이 오히려 저렴할 수 있습니다.
API 크레딧을 소액($5~$10) 충전해두고 가볍게 써보는 방식을 권장합니다. 한 달 정도 써보고 사용 패턴을 파악한 뒤 구독 플랜으로 전환할지 결정하는 게 비용 측면에서 안전합니다.
결론 — 누구에게 맞는 툴인가
Claude Code를 며칠 써보고 내린 솔직한 결론입니다.
이미 Cursor를 써본 적 있고, 더 자율적인 에이전트를 원하는 분
→ Cursor에서 Composer·Agent를 쓰다가 "더 자율적으로 알아서 처리해줬으면"이라는 생각이 들었다면 Claude Code가 맞습니다. 컨텍스트 파악 능력이 특히 뛰어납니다.
기존 프로젝트 코드를 수정·개선하는 작업이 많은 분
→ 새로 만드는 것보다 있는 코드를 고치거나 기능을 추가하는 작업에서 Claude Code의 파일 시스템 접근 능력이 빛납니다.
바이브코딩 완전 처음이고, 결과물을 바로 눈으로 보고 싶은 분
→ Cursor 또는 v0부터 시작하세요. 시각적 피드백이 있어야 학습 속도가 빠릅니다. Claude Code는 그다음 단계로 와도 늦지 않습니다.
비용 부담 없이 무료로 입문하고 싶은 분
→ Cursor 무료 플랜이나 v0 무료 플랜부터 시작하는 게 낫습니다. Claude Code는 반드시 유료 계정이 필요합니다.
자주 묻는 질문
Claude Code와 Claude.ai 웹사이트는 다른 건가요?
네, 다릅니다. Claude.ai는 브라우저에서 채팅하는 서비스이고, Claude Code는 터미널(또는 데스크톱 앱)에서 실행하는 코딩 에이전트입니다. 같은 Claude 모델을 사용하지만 Claude Code는 파일 시스템에 직접 접근해 코드를 실제로 수정할 수 있다는 차이가 있습니다.
터미널을 한 번도 써본 적 없는데 Claude Code를 쓸 수 있을까요?
데스크톱 앱을 쓰면 터미널 없이도 사용할 수 있습니다. 다만 Claude Code의 장점은 터미널과 조합했을 때 더 잘 발휘됩니다. 완전 처음이라면 Cursor나 v0로 바이브코딩에 먼저 익숙해진 뒤 Claude Code에 도전하는 순서를 추천합니다.
Claude Code를 쓰다가 AI가 파일을 잘못 수정하면 어떻게 되나요?
Claude Code는 변경 전에 확인을 요청하는 일반 모드가 기본값입니다. 각 변경 사항을 수락하거나 거부할 수 있습니다. 큰 작업 전에는 Git으로 커밋을 해두거나, 파일을 별도 폴더에 백업해두는 습관이 안전합니다. "변경할 때마다 Git 커밋도 같이 해줘"라고 요청하면 자동으로 처리해줍니다.
Cursor와 Claude Code를 함께 쓸 수 있나요?
네, 가능합니다. 두 툴은 경쟁 관계가 아니라 상호보완적으로 쓸 수 있습니다. 예를 들어 Cursor에서 UI를 빠르게 만들고, 복잡한 로직 수정이나 리팩토링이 필요할 때 Claude Code를 쓰는 방식으로 조합하는 사람들도 많습니다.
Claude Code는 한국어를 지원하나요?
네, 한국어로 요청해도 한국어로 잘 답해줍니다. 코드 안의 주석이나 변수명은 영어로 나오는 경우가 많지만, "주석은 한국어로 써줘"라고 요청하면 한국어 주석도 작성해줍니다.
Claude Code는 강력한 툴이지만, 바이브코딩의 첫 번째 툴로 권장하지는 않습니다.
Cursor나 v0로 "AI와 함께 뭔가를 만드는" 경험을 먼저 쌓은 뒤,
"더 자율적인 에이전트가 필요하다"는 시점에 Claude Code를 꺼내면 훨씬 잘 활용할 수 있습니다.
VibeLab이었습니다.