[Claude Code #0] Claude Code 설치 및 실행하기 전과정

도경원's avatar
Sep 30, 2025
[Claude Code #0] Claude Code 설치 및 실행하기 전과정

1. 사전 준비

  • Node.js 18 이상 설치
    • node -v # 버전 확인
      없으면 Homebrew로 설치:
      brew install node@20 echo 'export PATH="/opt/homebrew/opt/node@20/bin:$PATH"' >> ~/.zshrc exec zsh
  • Git 설치 확인
    • git --version
  • Claude Pro 구독 계정 준비 (claude.ai)

2. Claude Code 설치

NPM 글로벌 설치(권장):
npm install -g @anthropic-ai/claude-code claude --version

3. 실행할 폴더 준비

Claude Code는 해당 디렉토리 내의 파일만 다루므로, 홈 디렉토리 전체는 피하는 게 안전하다.
실험용 프로젝트 폴더를 만들고 들어간다:
mkdir -p ~/study/claude-code-lab cd ~/study/claude-code-lab

4. Claude Code 실행

claude
처음 실행하면 아래 단계를 거친다:
  1. 로그인 선택1. Claude account with subscription (Pro 계정 로그인)
  1. 터미널 설정Yes, use recommended settings (줄바꿈, 벨 기능 활성화)
  1. 폴더 신뢰 여부 → 해당 프로젝트 폴더면 Yes, proceed

5. 첫 세션 시작

정상 실행되면 대시보드가 뜬다.
이제 명령어 입력으로 Claude Code와 상호작용 가능하다:
  • 도움말 확인:
    • > /help
  • 파일 구조 설명 요청:
    • > explain the folder structure
  • 새 파일 생성:
    • > add a hello world function in a new file hello.dart
  • Git 연동:
    • > what files have I changed? > commit my changes with message "chore: add hello world example"

6. 마무리 & 팁

  • 여러 줄 입력 → Option + Enter
  • /login → 계정 재로그인
  • /clear → 대화 초기화
  • /release-notes → 최신 업데이트 확인
  • 항상 프로젝트 단위 폴더에서 실행하는 게 안전
Share article

Gyeongwon's blog