Claude-Code:초보자를 위한 Claude Code 설치 방법과 1타 크롤링 예제

로

Claude Code 설치 방법부터 EasyCrawler 프로젝트 실전 적용까지! 초보자도 따라할 수 있는 AI 코딩 도구 활용 가이드를 단계별로 정리했습니다.

1. Claude Code란 무엇인가?

Claude Code는 Anthropic의 AI 기반 개발 도우미로, 터미널에서 자연어로 코드 요청을 하고 실제 파일을 생성하거나 수정할 수 있게 해주는 CLI 도구입니다.

파일 생성 및 수정
폴더 구조 자동 구성
명령어 기반 API
단계별 개발 수행
List itemCursor 등 다른 툴과 연동 가능List item

2. 설치 전 준비 사항

  • Node.js 18 이상
  • npm 또는 yarn
  • 터미널 접근 가능 (Windows, macOS, Linux 모두 가능)
  • Anthropic API 키 또는 Claude Pro 구독 계정

3. Claude Code 설치 및 실행

bash# 일회성 실행
npx @anthropic-ai/claude-code

# 또는 전역 설치
npm install -g @anthropic-ai/claude-code

실행하면 로그인 옵션을 선택하라는 화면이 뜹니다.

4. 로그인 옵션 및 주의 사항

bashSelect login method:
  1. Claude account with subscription  ✅ Claude Pro/Max 구독자
  2. Anthropic Console account         ✅ API 키 사용자
  • Claude Pro 구독 중이라면 1번 선택
  • API 키를 가지고 있다면 2번 선택
  • 가끔 쓰는 사용자라면 2번이 유리
  • 자주 쓰고 비용 예측이 중요하다면 1번 추천

5. EasyCrawler 프로젝트 개요

Claude Code를 이용해 아래와 같은 실제 프로젝트를 진행:

🕷️ 프로젝트명: EasyCrawler
💡 목적: 초보자도 쉽게 웹 크롤링할 수 있는 도구 제작
⚙️ 기술 스택: FastAPI, Selenium, BeautifulSoup, Chrome Extension, Excel 출력

기획서 구성:

  • 전체 기능 정의 40개
  • 기술 구조 및 UI 와이어프레임
  • 개발 일정 10주
  • Task별 작업 지침서 (6단계 + 테스트)

6. Claude Code에 기획서 전달 방법

✅ 첫 입력 예시:

bash복사편집Hey Claude Code! I'm planning to develop "EasyCrawler" - a web scraping tool for beginners.

[기획서 전체 복사해서 붙여넣기]

This is the complete project specification. Please review it carefully and let me know:
1. Do you understand the overall project goals?
2. Any questions about the technical architecture?
3. Are you ready to receive step-by-step implementation tasks?

DON'T start coding yet - I have detailed task breakdowns to provide next.

⚠️ 기획서 먼저! Task는 나중에 단계별 전달해야 Claude가 맥락을 올바르게 이해합니다.

EasyCrawler프로젝트기획서다운로드

7. 테스트 앱 개발 의도

크롤링 초보자가 쉽게 사용 할 수 있는앱

핵심 기능

  1. 크롤링 난이도 확인
  2. 크롤링 요소 선택
  3. 크롤링 템플릿화
  4. 크롤링 데이터 엑셀 익스포트

일단 여기까지가 핵심 기능 요청

8. 단계별 개발 요청 전략

  1. 기획서 전체 전달
  2. Claude Code가 이해했는지 확인
  3. Task 0 (환경 설정)부터 순서대로 전달
  4. 각 Task 완료 후 테스트 → 다음 단계 진행
EasyCrawler Task별 작업 지침서 _ Claude _ Claude다운로드

9. Claude Code 실전 사용 예: EasyCrawler Task 지시

예시 – 환경 설정 요청

plaintext복사편집Phase 1: Project Setup

Create the following folder structure:
easycrawler/
├── extension/
├── backend/
├── data/
└── docs/

And generate requirements.txt with:
fastapi, selenium, beautifulsoup4, pandas, openpyxl, ...

Also create .gitignore and README.md

10. Claude Code + Cursor 협업 워크플로우

역할 구분Claude CodeCursor
프로젝트 초기✅❌
기능 구현✅❌
실시간 편집❌✅
버그 수정✅✅
디버깅/테스트❌✅

Claude Code에서 구조 잡고, Cursor에서 수정 및 테스트하는 게 가장 효율적입니다.

11. 자주 발생하는 인증 에러 해결법

🚨 에러: OAuth error: Request failed with status code 400

원인: OAuth 인증 버그
해결법:

  1. Claude Pro → 옵션 1번
  2. API 키 사용 → 옵션 2번 + 키 직접 입력
  3. 환경 변수 설정:
bash복사편집export ANTHROPIC_API_KEY="your-api-key-here"
  1. 최신 버전으로 업데이트:
bash복사편집npx @anthropic-ai/claude-code@latest

12. 마무리 및 추천 워크플로우

Claude Code 올바른 사용 순서:

  1. 기획서 전체 전달
  2. 이해 여부 확인
  3. Task 0부터 차례대로 요청
  4. 각 Task 마다 Claude에게 지시 + 테스트 + 다음 단계 진행

🔁 반복하면서 프로젝트 전체를 AI와 함께 개발할 수 있습니다!

13. 마무리

Claude Code는 단순한 AI 코딩 도구가 아니라, 프로젝트 매니저이자 개발자입니다.
기획과 명확한 지시만 있다면, 당신의 아이디어를 실제 코드로 바꿔주는 강력한 동반자가 되어줄 것입니다.

14. 작업 영상

15. UI

Claude-Code-UI
Claude-Code-UI
Claude-Code-UI
Claude-Code-UI

참고 : Windows에서 WSL + Ubuntu 설치하기 (2025년 최신 기준)

① PowerShell(관리자 권한) 실행

powershell복사편집wsl --install
  • 처음 실행 시 WSL 기능이 자동으로 설치되고, Ubuntu도 함께 설치됩니다.
  • 설치가 완료되면 재부팅하라는 메시지가 나타날 수 있습니다. 재부팅 후 다음 단계로 진행하세요.

② Ubuntu 실행 및 계정 설정

  • 시작 메뉴에서 Ubuntu를 검색해 실행
  • 사용자명(username)과 비밀번호(password) 입력하여 리눅스 계정 설정

③ Ubuntu 패키지 업데이트

bash복사편집sudo apt update && sudo apt upgrade -y

④ Node.js 및 npm 설치 (Claude Code 실행 전 필수)

bash복사편집sudo apt install nodejs npm -y

버전 확인:

bash복사편집node -v
npm -v

Node.js는 18 이상이어야 하며, 낮을 경우 다음 명령어로 nvm으로 설치하세요:

bash복사편집curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 18
nvm use 18

⑤ Claude Code 설치 시작

bash복사편집npx @anthropic-ai/claude-code

이제 Ubuntu 내에서 Claude Code를 실행할 준비가 완료되었습니다!
다음 단계부터는 본격적으로 EasyCrawler 프로젝트를 시작합니다. 🕷️

댓글 남기기