1. Claude Code 설치 및 기본 설정 [0]

thumbnail Claude Code를 로컬 환경에 설치하고 개발 프로젝트에 적용하는 방법을 설명한다.

1.1. Claude Code 설치 및 초기 설정 [0]

  1. Claude Code 설치 [0]
    1. Node.js 18 이상 버전이 설치되어 있어야 한다. [2]
    2. 터미널에서 제공된 npm 명령어를 복사하여 실행한다. [1]
  2. 프로젝트 디렉토리 설정 및 실행 [4]
    1. 설치 후 프로젝트 디렉토리로 이동한다. [4]
    2. 터미널에 claude를 입력하여 Claude Code를 실행한다. [6]
  3. 터미널 스타일 및 로그인 설정 [8]
    1. 터미널 스타일은 단순함을 위해 다크 모드를 선택한다. [8]
    2. 로그인 방식 선택 시, 월 20달러의 Pro 플랜을 구독하는 Claude Code 계정을 선택한다. [9]
  4. Claude Code 접근 권한 설정 [12]
    1. 인증 후 터미널 설정을 진행한다. [12]
    2. 권장 설정을 사용하기 위해 'yes'를 선택한다. [13]
    3. 프로젝트 폴더 내 파일 읽기 권한을 허용한다. [14]
    4. 설정 완료 후 터미널에서 Claude Code를 공식적으로 사용할 수 있다. [16]

1.2. Visual Studio Code 연동 및 프로젝트 초기화 [17]

  1. Visual Studio Code 내 Claude Code 실행 [17]
    1. VS Code 내 터미널을 열고 claude를 입력하여 실행한다. [18]
  2. 프로젝트 초기화 (/init 명령어) [21]
    1. 새로운 코드베이스의 경우, /init 명령어로 프로젝트를 초기화해야 한다. [22]
    2. 이 명령어는 Claude가 프로젝트 내 모든 파일을 읽어 코드베이스를 분석하고 초기화한다. [24]
    3. 초기화 과정은 프로젝트 구조 탐색, README 분석, 메인 애플리케이션 아키텍처 분석 등을 포함한다. [26]
    4. 분석 후 claude.md 파일이 생성된다. [27]
    5. claude.md 파일은 새로운 채팅 세션에서 시스템 메시지, 지침, 메모 등으로 활용되어 프로젝트에 대한 AI의 이해도를 높인다. [33]
      1. 이 파일에는 핵심 명령어, 데이터베이스, 아키텍처, 기술 스택, 데이터베이스 스키마, 인증, 앱 구조, 상태 관리 등 프로젝트에 대한 상세 정보가 포함된다. [36]

2. Claude Code 활용 기능 [41]

thumbnail Claude Code의 다양한 기능을 활용하여 개발 생산성을 높이는 방법을 설명한다.

2.1. 기본 기능 활용 [41]

  1. AI 모델 확인 및 변경 (/mod) [43]
    1. /mod 명령어로 현재 사용 중인 AI 모델을 확인할 수 있다. [43]
    2. Pro 플랜 사용자는 sonnet 4 모델을 사용하며, 다른 플랜에서는 모델 변경이 가능하다. [44]
  2. 파일 참조 방법 [46]
    1. 파일을 드래그하여 채팅 입력창에 붙여넣어 파일 경로를 참조할 수 있다. [47]
    2. @ 기호를 사용하여 파일 경로를 더 쉽게 참조할 수 있다. [49]
      1. 특정 디렉토리 내 파일이나 하위 디렉토리의 파일도 참조 가능하다. [50]
  3. 이미지 및 클립보드 활용 [52]
    1. 스크린샷을 찍어 드래그하거나 이미지를 복사하여 붙여넣을 수 있다. [52]
    2. 이미지에 대한 질문을 하면 Claude가 해당 이미지를 분석하여 답변한다. [53]
  4. 코드 선택 및 설명 요청 [57]
    1. 코드의 특정 부분을 선택하여 해당 코드에 대한 설명을 요청할 수 있다. [58]

2.2. Claude Code 실행 방식 및 커스텀 명령어 [62]

  1. Claude Code 실행 방식 [62]
    1. 터미널에서 claude 명령어로 실행할 수 있다. [62]
    2. Command + Escape 단축키를 사용하거나 Claude 아이콘을 클릭하여 코드 에디터 내에서 바로 Claude Code 세션을 시작할 수 있다. [63]
  2. 커스텀 명령어 생성 및 활용 [67]
    1. / 명령어로 사용 가능한 기본 명령어 목록을 확인할 수 있다. [68]
    2. 개발 프로세스에 맞춰 커스텀 명령어를 생성하여 반복적인 작업을 자동화할 수 있다. [69]
      1. 예시: React 컴포넌트의 유닛 테스트 작성을 위한 커스텀 명령어 생성 [70]
        1. 이 명령어는 Happy Path, Edge Case, Error Handling 등을 포함하는 테스트를 생성한다. [75]
        2. 명령어 생성 과정은 프로젝트 테스트 설정 분석, 테스트 파일 패턴 검색, 설정 파일 및 패키지 확인 등을 포함한다. [78]
        3. 생성된 명령어는 파일 참조, 선택된 코드 등 필요한 인자를 받을 수 있다. [82]
    3. 생성된 커스텀 명령어를 사용하여 특정 컴포넌트의 유닛 테스트를 자동으로 생성한다. [87]
      1. Claude는 컴포넌트 코드, package.json, Jest 설정을 분석하여 테스트 스위트를 생성한다. [94]
      2. 생성된 테스트 코드는 React Testing Library를 사용하며, Happy Path, Edge Case, Accessibility 등을 포함한다. [97]
      3. 테스트 실행 중 발생하는 TypeScript/JSX 설정 오류, jsdom 누락, 공백 처리 오류 등을 자동으로 수정하고 테스트를 통과시킨다. [106]

2.3. 멀티 에이전트 기능 활용 [120]

  1. 멀티 에이전트 개념 [120]
    1. 여러 개의 코딩 에이전트를 동시에 실행하여 작업을 수행할 수 있다. [120]
  2. UI 디자인 변형 생성 [122]
    1. UI 디자인 변형 커스텀 명령어는 React 컴포넌트의 다양한 디자인 버전을 생성한다. [122]
    2. 이 기능은 멀티 에이전트를 사용하여 병렬로 여러 디자인 변형을 생성한다. [127]
      1. 예시: 간단한 데이팅 앱의 네비게이션 바 디자인 변형 생성 [131]
        1. top navbar 컴포넌트를 대상으로 Glass, Corporate, Compact, Outline, Gradient 등 5가지 디자인 변형을 생성한다. [147]
        2. 생성된 디자인 파일은 navbar 폴더에 저장된다. [151]
        3. 생성된 디자인 중 하나를 선택하여 실제 앱에 적용하고 결과를 확인할 수 있다. [153]
  3. 버전 관리의 중요성 [170]
    1. Claude Code가 생성한 각 버전은 Git과 같은 버전 관리 시스템을 사용하여 커밋하고 관리하는 것이 중요하다. [170]
    2. 상세한 커밋 메시지를 작성하여 변경 사항을 기록하고, 만족스러운 버전을 브랜치에 추가한다. [171]

2.4. YOLO 모드 (권한 우회) [176]

  1. YOLO 모드 설명 [176]
    1. YOLO 모드는 파일 수정 시 권한 확인 절차를 생략하여 작업을 빠르게 진행할 수 있게 한다. [178]
    2. claude dangerously skip permissions 명령어를 사용하여 YOLO 모드를 활성화한다. [181]
  2. YOLO 모드 사용 시 주의사항 [182]
    1. YOLO 모드 사용 시에는 반드시 버전 관리를 철저히 해야 한다. [182]
    2. 예상치 못한 변경이 발생했을 경우, 이전 버전으로 되돌려 작업을 재개할 수 있다. [182]
    3. YOLO 모드 활성화 시, 하단에 "bypassing permissions" 메시지가 표시된다. [185]