🚀 Claude Code 5분 만에 시작하기

AI와 함께 터미널에서 코딩하는 새로운 경험!

들어가며 👋

안녕하세요!

혹시 VS Code나 Cursor에서 AI 어시스턴트 써보셨나요? 이제는 터미널에서 직접 클로드와 대화하면서 코딩할 수 있습니다! 😎

오늘은 Anthropic에서 만든 Claude Code를 5분 만에 설치하고 바로 사용하는 방법을 알려드릴게요.

진짜 5분이면 충분합니다! ⏱️

🎯 Claude Code가 뭔가요?

한 줄 요약

터미널에서 클로드와 대화하며 코드를 작성하고, 파일을 읽고, 디버깅하는 CLI 도구입니다.

무엇을 할 수 있나요?

✅ 코드 작성 및 수정
✅ 파일 읽기 및 분석
✅ 버그 찾기 및 디버깅
✅ 리팩토링 제안
✅ Git 커밋 메시지 작성
✅ 테스트 코드 생성

왜 좋은가요?


기존 방식:

IDE → AI 플러그인 → 코드 복사/붙여넣기 → 답변 확인 → 다시 붙여넣기

  

Claude Code:

터미널에서 "이 버그 고쳐줘" → 끝!

훨씬 자연스럽고 빠르죠? 🚀

🛠️ 설치 준비물

시작하기 전에 이것만 확인하세요!

필수 요구사항

터미널 또는 명령 프롬프트 (Mac/Linux/Windows)
인터넷 연결
Claude.ai 계정 (없으면 무료로 만들기!)

권장 환경

운영체제: macOS 10.15+, Ubuntu 20.04+, Windows 10+
메모리: 4GB 이상
Node.js: 18 이상 (npm 설치 시 필요)

💡 꿀팁: Windows 사용자는 WSL이나 Git Bash 사용을 추천합니다!

📦 설치하기

방법 1: NPM으로 설치 (추천) ⭐

Node.js 18 이상이 있다면 가장 쉬운 방법입니다!

 
npm install -g @anthropic-ai/claude-code

실행:

 
claude

⚠️ 주의: sudo 없이 설치하세요! 권한 문제가 생길 수 있어요.

방법 2: Homebrew (macOS/Linux)

 
brew install --cask claude-code

방법 3: 원클릭 설치 스크립트

macOS / Linux / WSL:

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

Windows PowerShell:

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

Windows CMD:

 
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

설치 확인 ✅

터미널에서 다음 명령어를 입력해보세요:

 
claude --version

버전이 표시되면 설치 성공! 🎉

🔐 로그인하기

1단계: Claude Code 실행

프로젝트 폴더로 이동 후:

 
cd /path/to/your/project
 
claude

2단계: 계정 선택

두 가지 옵션이 있습니다:

옵션 1: Claude.ai (추천) 🌟

Pro/Max 플랜 구독자
웹 인터페이스와 통합 사용
월 $20 (Pro) 또는 $200 (Max)

옵션 2: Claude Console

API 키 사용
선불로 크레딧 충전
사용한 만큼만 지불

💡 처음 사용자라면? Claude.ai 무료 체험으로 시작해보세요!

3단계: 인증 완료

브라우저가 자동으로 열리고 로그인 화면이 표시됩니다.

로그인하면 터미널로 돌아와서... 끝! 🎊

인증 정보는 로컬에 안전하게 저장되어 다음부터는 바로 사용할 수 있어요.

🎮 첫 사용해보기

Hello Claude! 👋

터미널에 claude를 입력하면 환영 화면이 나타납니다:


╔═══════════════════════════════════════╗

║ Welcome to Claude Code! ║

║ Type your message or /help ║

╚═══════════════════════════════════════╝

간단한 질문 해보기

 
You: 이 디렉토리에 어떤 파일들이 있어?

Claude가 디렉토리를 탐색하고 알려줍니다! 😊

코드 작성 요청하기

 
You: Python으로 피보나치 수열을 계산하는 함수 만들어줘

Claude가 코드를 작성하고, 파일로 저장할지 물어봅니다!

파일 수정 요청하기

 
You: app.js에서 API 호출하는 부분 비동기로 바꿔줘

Claude가 파일을 읽고, 분석하고, 수정해줍니다! ✨

💡 유용한 팁

Tip 1: 대화 이력 확인

 
/history

이전 대화 목록을 볼 수 있어요.

Tip 2: 도움말 보기

 
/help

모든 명령어와 기능을 확인할 수 있습니다.

Tip 3: 컨텍스트 제공하기

Claude에게 구체적으로 설명할수록 더 정확한 답변을 받을 수 있어요!

Bad:


버그 고쳐줘

Good:


login.js에서 로그인 버튼 클릭하면 404 에러가 나는데,

API 엔드포인트를 확인하고 고쳐줘

Tip 4: 멀티스텝 작업

한 번에 여러 작업을 요청할 수 있어요:


1. src 폴더 구조 분석해줘

2. 중복 코드 찾아줘

3. 리팩토링 제안해줘

4. 테스트 코드 작성해줘

Claude가 단계별로 처리합니다! 🎯

⚠️ 주의사항

1. 민감한 정보 조심

.env 파일이나 API 키를 Claude에게 직접 보여주지 마세요!

2. 코드 검토는 필수

AI가 만든 코드라도 반드시 검토하세요. 완벽하지 않을 수 있어요.

3. 인터넷 연결 필요

Claude Code는 온라인으로 동작합니다. 오프라인에서는 사용 불가!

4. 비용 확인

Pro 플랜의 경우 무제한 사용이지만, Console API는 사용량에 따라 과금되니 주의하세요!

🚀 다음 단계

설치와 첫 사용을 마쳤다면, 이제 뭘 해볼까요?

실전 활용 아이디어

기존 프로젝트 분석


이 프로젝트의 구조를 분석하고 설명해줘

버그 찾기


테스트가 실패하는 이유를 찾아줘

리팩토링


이 함수를 더 깔끔하게 리팩토링해줘

문서화


README.md를 작성해줘

테스트 작성


이 컴포넌트의 단위 테스트를 작성해줘

더 알아보기 📚

정리하며 📝

Claude Code를 설치하고 시작하는 방법을 알아봤습니다!

핵심 요약:

설치: npm install -g @anthropic-ai/claude-code
실행: claude 명령어
로그인: Claude.ai 또는 Console 계정
사용: 자연스럽게 대화하며 코딩!

이제 여러분도 AI 페어 프로그래밍을 경험해보세요! 🎉

마무리 🎊

처음에는 어색할 수 있지만, 몇 번 사용하다 보면 터미널에서 클로드와 대화하는 게 너무 자연스러워질 거예요.

저는 이제 Claude Code 없이는 코딩을 못하겠더라고요... 😅

여러분은 어떤 경험을 하게 될지 정말 궁금하네요!

질문이나 피드백은 댓글로 남겨주세요! 😊

참고 자료: