1. 클로드 코드(Claude Code) 소개 및 설치 [0]

thumbnail 클로드 코드는 AI 개발 시 예상치 못한 결과물을 방지하고 개발 계획을 AI와 일치시켜 결과물의 오차를 최소화하는 데 도움을 주는 도구다. [0]

1.1. 클로드 코드의 인기 이유 [5]

  1. 압도적인 코드 품질 [6]
    1. 20만 토큰(약 7천 건 분량)을 한 번에 기억하고 처리하여 전체 코드의 맥락을 완벽하게 파악한다. [7]
    2. 기존 스타일링과 패턴에 맞춰 일관성 있게 개발하며, 코드 제작 오류가 30% 적게 발생한다는 개발자 경험이 있다. [12]
    3. SW 벤치마크에서 72.5%를 달성하며 문제 해결 능력을 입증했다. [14]
  2. 터미널 기반 동작으로 인한 유연성 [15]
    1. 커서(Cursor)나 윈드서프(Windsurf)와 같은 IDE와 통합하여 사용할 수 있다. [17]
    2. 작은 작업은 커서 AI를 활용하고, 대규모 리팩토링이나 복잡한 기능 구현은 클로드 코드로 개발하는 조합으로 개발 속도와 코드 품질을 동시에 향상시킬 수 있다. [18]

1.2. macOS 설치 방법 [22]

  1. 사전 준비 사항 [23]
    1. 운영 체제 및 하드웨어 최소 요구 사항을 충족해야 한다. [23]
    2. Node.js가 설치되어 있어야 한다. 공식 문서에서 OS에 맞는 Node.js를 다운로드하여 설치한다. [24]
    3. 설치 확인은 터미널에서 node -v 및 npm -v 명령어로 할 수 있다. [26]
  2. 클로드 코드 설치 [28]
    1. Node.js 설치 후, 터미널에서 npm install -g claud 명령어를 사용하여 클로드 코드를 전역으로 설치한다. [28]
    2. 설치 중 오류 발생 시 sudo 명령어를 사용하지 않는다. 권한 문제 및 보안 위험이 있을 수 있다. [31]
    3. 오류 해결을 위해 에러 메시지와 함께 클로드나 ChatGPT 같은 AI 도구에 도움을 요청한다. [33]
    4. 설치 완료 확인은 터미널에서 claud doctor 명령어를 입력한다. [35]

1.3. Windows 설치 방법 [36]

  1. WSL 없이 설치 가능 (최신 버전) [38]
    1. 클로드 코드 1.0.51 버전 이상부터는 WSL 없이 Windows에서 직접 실행 가능하다. [39]
    2. 공식 문서의 한국어 버전에는 아직 이 내용이 반영되지 않았을 수 있으므로 영문 버전을 참고하는 것이 좋다. [40]
  2. 설치 절차 [44]
    1. Node.js를 먼저 다운로드하여 설치한다. [44]
    2. WSL 없이 설치하기 위해 Git을 먼저 설치한다. [47]
    3. Git Bash를 실행하고, npm install -g claud 명령어를 사용하여 클로드 코드를 설치한다. [51]
    4. 설치 완료 확인은 claud doctor 명령어를 사용한다. [53]
    5. 설치 과정 중 문제가 발생하면 고정 댓글을 참고한다. [54]

2. 클로드 코드 사용법 및 설정 [55]

thumbnail 클로드 코드는 프로젝트 폴더 내에서 실행하며, 테마 선택 및 계정 인증 후 초기 설정을 진행하여 사용한다. [57]

2.1. 초기 설정 및 기본 사용법 [55]

  1. 프로젝트 폴더 생성 및 클로드 코드 실행 [57]
    1. 작업할 프로젝트 폴더를 생성하고 해당 폴더로 이동한다. [57]
    2. 폴더 안에서 claud 명령어를 입력하여 클로드 코드를 실행한다. [60]
  2. 테마 및 계정 인증 [61]
    1. 원하는 테마(예: 다크 테마)를 선택한다. [61]
    2. 계정 인증은 클로드 계정 구독(월 정액제) 또는 엔트로픽 콘솔 계정 사용(사용한 만큼 지불) 중 선택한다. [65]
    3. 클로드 코드를 이용하려면 프로(Pro) 또는 맥스(Max) 플랜이 필요하며, 일반적으로 프로 플랜으로 충분하다. [69]
  3. 보안 주의 사항 및 터미널 최적화 [75]
    1. AI 생성 코드는 항상 검토해야 하며, 신뢰할 수 있는 코드만 사용해야 한다. [76]
    2. 터미널 최적화 설정을 통해 Shift + Enter로 여러 줄을 편하게 입력할 수 있다. [80]
    3. 최적화 설정은 추후 claud setup 명령어로 다시 할 수 있다. [83]
  4. 프로젝트 폴더 접근 권한 및 작업 화면 [85]
    1. 초기 설정 완료 후 프로젝트 폴더 접근 권한을 요청하면 확인 후 승인한다. [85]
    2. 작업 화면에서 프롬프트 입력 창에 질문이나 요청 사항을 입력하고 엔터를 누르면 클로드가 처리한다. [90]
    3. 처리 시간과 사용한 토큰 수가 표시되며, 결과물을 확인할 수 있다. [91]

2.2. 슬래시 명령어 활용 [93]

  1. /init 명령어: 프로젝트 초기화 [97]
    1. 새 프로젝트에서 /init 명령어를 사용하면 claud.md 파일이 초기화된다. [97]
    2. 이 파일은 클로드가 프로젝트 전체 코드베이스를 분석하여 개발을 진행할 수 있도록 설명서 역할을 한다. [98]
    3. 코딩 스타일, 프로젝트 구조 등을 기록하고 프로젝트 진행 중 업데이트할 수 있다. [99]
    4. 터미널 명령어 실행 전 사용자 승인을 요청하며, 명령어별로 허용 여부를 설정할 수 있다. [100]
    5. claud.md 파일에는 프로젝트 개발을 위한 초기 룰이 설정된다. [110]
  2. IDE 통합 및 확장 프로그램 [115]
    1. VS Code와 같은 IDE와 통합하면 코드 읽기 및 편집이 편리하다. [115]
    2. 터미널에서 claud ide 명령어를 실행하고 통합할 IDE를 선택한다. [118]
    3. IDE와 통합하면 파일 생성, 수정, 특정 영역 선택 등을 실시간으로 확인하고 요청할 수 있다. [122]
    4. VS Code에서는 클로드 코드 확장 프로그램을 설치하여 IDE 우측 상단의 아이콘을 통해 클로드 코드 터미널을 실행하고 통합할 수 있다. [131]
  3. /model 명령어: 모델 선택 [135]
    1. Opus 4 모델: 최고 수준의 지능과 추론이 필요한 복잡한 작업에 사용한다. (예: 재고 복구 로직, 실시간 메시지 동기화) [137]
    2. Sonnet 4 모델: 일반적인 개발 작업에 사용한다. (예: 로그인 API, 게시판 기능) [139]
    3. Opus 4는 Sonnet 4보다 5배 비싸므로, 평상시에는 Sonnet 4를 사용하고 어려운 문제 발생 시 Opus 4를 활용하는 것이 비용 효율적이다. [141]
    4. 옵션:
      • 1번: 사용량의 최대 50%까지 Opus 4 사용, 이후 Sonnet 4 사용 [142]
      • 2번: Opus 4 사용 [143]
      • 3번: Sonnet 4 사용 [143]
  4. /status 명령어: 상태 확인 [145]
    1. 클로드 코드의 전체 상태를 한눈에 볼 수 있는 대시보드 역할을 한다. [146]
    2. 현재 작업 중인 프로젝트, 로그인 계정, 사용 중인 모델 정보 등을 확인할 수 있다. [148]
  5. /help 명령어: 명령어 목록 확인 [149]
    1. 클로드 코드에서 사용할 수 있는 다양한 슬래시 명령어 목록을 확인할 수 있다. [149]

2.3. 권한 관리 (Permissions) [150]

  1. 권한 시스템 이해 [151]
    1. 클로드가 무엇을 할 수 있고 없는지를 정하는 권한 시스템이다. [151]
    2. 3단계 권한 시스템: [154]
      • Read-only 작업: 파일 읽기, 검색 등 안전한 작업은 승인 없이 바로 수행 가능하다. [155]
      • Bash 커맨드: 터미널 명령어 실행은 위험할 수 있어 사용자의 승인이 필요하다. (예: 삭제 명령어) [156]
      • File Modification: 파일 수정 또는 생성은 중요한 파일을 실수로 망칠 수 있어 승인이 필요하다. [159]
  2. 권한 관리 명령어 및 설정 파일 [162]
    1. /permissions 명령어를 통해 현재 권한 상태를 확인하고 관리할 수 있다. [163]
    2. Allow 탭: 허용된 권한 목록을 보여준다. [165]
    3. Deny 탭: 금지된 규칙 목록을 보여준다. [166]
    4. 설정된 룰은 claud 디렉토리의 settings.json 파일에 저장된다. [168]
    5. 추가 설정 가능한 퍼미션 룰은 다른 프로젝트 폴더나 공유 문서 폴더 접근에 대한 옵션이다. [170]
    6. 설정 범위: [174]
      • User settings: 개인용 설정은 settings.json 파일에 저장한다. [174]
      • Project settings: 팀원과 공유할 설정은 프로젝트 디렉토리 내 .claud 디렉토리의 settings.json 파일에 저장한다. [175]

2.4. 퍼미션 모드 활용 [178]

  1. 퍼미션 모드 개요 [179]
    1. 클로드 코드가 컴퓨터에서 수행할 수 있는 작업 범위를 크게 네 가지 모드로 나눈다. [180]
    2. Default 모드: 처음 하는 일은 물어보고, 같은 종류의 일은 그다음부터 알아서 처리한다. (기본 모드) [181]
  2. Accept-edit 모드 [184]
    1. 파일 수정이나 생성과 같은 파일 모디피케이션 작업을 자동으로 승인한다. [184]
    2. 개발 시 파일 수정 및 생성 작업이 빈번하므로 유용하다. [185]
  3. Flat 모드: 개발 계획 일치 [187]
    1. 별 다섯 개를 줄 정도로 매우 유용한 기능이다. [188]
    2. AI에게 개발을 요청할 때 사용자의 머릿속 결과물과 AI의 진행 결과물이 다를 수 있는 문제를 해결한다. [192]
    3. 활성화 방법: Shift + Tab을 두 번 눌러 활성화한다. [196]
    4. 작동 방식:
      • 할 일(예: 할 일 관리 웹 개발)을 요청하면, 클로드는 다른 파일을 수정하거나 생성하지 않고 오로지 분석만 하여 계획을 세운다. [197]
      • 사용자는 계획을 하나하나 확인하며 자신의 생각과 일치하는지 검토한다. [199]
      • 계획이 맞으면 개발을 진행하고, 다르면 계획 모드를 다시 선택하여 세부 사항을 조정한다. [200]
    5. 핵심: 클로드 코드로 바로 개발을 진행하는 것이 아니라, Flat 모드를 통해 계획을 수립한 후 개발을 진행하는 것이 중요하다. [203]
  4. Bypass 모드 [204]
    1. 파일 권한, Bash 명령어, 시스템 작업 등 모든 권한을 부여한다. [204]
    2. 프로덕션 환경에서는 사용을 지양하고, 격리된 환경에서 조심스럽게 사용해야 한다. [205]
  5. 모드 전환 및 기본 설정 [207]
    1. Shift + Tab을 사용하여 Accept-edit, Flat, Default 모드로 전환할 수 있다. [207]
    2. settings.json 파일에서 default_mode 옵션으로 시작 시 기본 모드를 설정할 수 있다. [208]
    3. 개인적으로는 Flat 모드를 주로 사용하며, Bash 명령어는 대부분 허용하는 편이다. [209]

2.5. 추가 팁 및 마무리 [212]

  1. 개발 시 계획 수립의 중요성 강조 [212]
    1. 개발을 진행할 때 최대한 계획을 수립하고 개발하는 것이 중요하다. [212]
  2. 클로드 코드 종료 및 재실행 [214]
    1. Flat 모드로 설정한 후 Ctrl + C로 클로드 코드를 종료하고 다시 실행하면 Flat 모드로 시작된다. [214]
  3. 클로드 코드 시작 방법 [216]
    1. 새 프로젝트나 기존 프로젝트에서 /init 명령어로 클로드 코드를 시작한다. [216]
    2. 개발 설명서를 claud.md 파일에 기재한다. [218]
  4. 코드 재사용 및 규칙 추가 [219]
    1. 개발 중 클로드 코드가 마음에 들지 않거나 중복 코드를 작성할 경우, 규칙을 클로드 코드에 계속 추가한다. [219]
  5. 향후 강의 및 참고 자료 안내 [223]
    1. 클로드 코드와 커서 AI를 활용한 실무 개발 강의를 준비 중이며, 팁은 유튜브에 공유할 예정이다. [223]
    2. 커서 툴이나 MCP에 대한 자세한 내용은 이전 영상을 참고한다. [225]
    3. 웹 개발 입문, React, Vue, Next.js 강의를 참고할 수 있다. [226]
  6. 구독, 좋아요, 알림 설정 요청 [227]
    1. 영상이 도움이 되었다면 구독, 좋아요, 알림 설정을 부탁한다. [227]