1. 클로드 코드 설치 및 기본 세팅 [0]

thumbnail 클로드 코드 설치부터 프로젝트 개발에 필요한 기본 세팅까지 핵심 내용을 다룬다.

1.1. 클로드 코드 설치 방법 [0]

  1. 클로드 코드는 npm을 통해 설치할 수 있다. [1]
  2. Node.js가 설치되어 있지 않다면, 별도로 설치해야 한다. [2]
  3. Windows 사용자는 WSL(Windows Subsystem for Linux)을 먼저 설치해야 한다. [3]
    1. WSL 설치 후 Linux 터미널에서 Node.js를 설치한다. [5]
    2. Node.js 설치 후 npm 명령어로 클로드 코드를 설치한다. [6]

1.2. claude init 명령어를 활용한 프로젝트 분석 및 claude.md 자동 생성 [7]

  1. 프로젝트 폴더에서 claude init 명령어를 실행하면 claude.md 파일이 자동으로 생성된다. [7]
  2. claude init은 프로젝트 파일 구조, 기능, 사용 모델, 크레딧 소진 현황 등을 분석하여 claude.md 파일을 생성한다. [10]
  3. 생성된 claude.md 파일에는 다음과 같은 정보가 포함된다. [14]
    • 데이터베이스 명령어
    • AI가 작성한 스크립트
    • 사용 중인 모델 및 크레딧 정보
    • UI 스타일 및 언어 설정 (한국어 위주)
    • 사용 중인 데이터베이스 (예: SQLite3)

1.3. claude.md 파일에 사용자 정의 룰스 추가 [23]

  1. claude.md 파일 하단에 사용자 정의 룰스를 추가하여 AI의 동작 방식을 제어할 수 있다. [23]
  2. 룰스에는 아이콘 사용, 서버 재시작 방식, 특정 라이브러리 사용 등의 지시사항을 포함할 수 있다. [24]
  3. 이렇게 추가된 룰스는 클로드 코드에서 자체적으로 사용하는 룰스 역할을 겸한다. [27]
  4. claude init 명령어로 claude.md 파일을 생성한 후, 파일 하단에 직접 룰스를 추가하면 된다. [29]

2. 클로드 코드 모드 변경 및 권한 설정 [30]

thumbnail 클로드 코드의 다양한 모드와 AI에게 터미널 명령어 실행 권한을 부여하는 설정을 설명한다.

2.1. 모드 변경: 에디트 모드와 플랜 모드 [30]

  1. Shift + Tab을 눌러 에디트 모드와 플랜 모드를 전환할 수 있다. [30]
  2. 에디트 모드:
    • 노멀 모드: 파일 수정 시 사용자에게 허락을 구한다. [63]
    • 오토 엑셉트 에디트 모드: 권한이 허용된 명령어에 대해서는 사용자에게 묻지 않고 자동으로 실행한다. [31]
  3. 플랜 모드: 파일을 직접 수정하지 않고, AI가 먼저 실행 계획을 세운 후 사용자에게 질문하여 동의를 얻은 후 진행한다. [71]

2.2. 터미널 명령어 실행 권한 설정 (퍼미션) [31]

  1. 오토 엑셉트: AI가 터미널 명령어를 실행할 때 사용자에게 일일이 확인받지 않고 자동으로 허용하는 설정이다. [31]
  2. 퍼미션 설정:
    • AI가 실행할 수 있는 명령어 목록을 관리한다. [33]
    • 특정 명령어(예: bash, bundle install, curl)를 허용할 수 있다. [34]
    • 와일드카드 권한 부여: bash와 같은 와일드카드 권한을 부여하면 모든 bash 명령어를 허용하게 된다. [35]
    • 와일드카드 권한을 부여하면 이전에 개별적으로 허용했던 명령어들은 삭제해도 무방하다. [38]
  3. 와일드카드 권한 부여는 리스크를 감수해야 하는 설정이며, 사용 경험에 따라 판단하여 결정한다. [40]
  4. 비개발자나 AI의 동작을 완전히 신뢰하기 어렵다면, 개별 명령어 허용 방식을 사용하고 오토 엑셉트 모드를 켜는 것이 좋다. [43]
  5. 워크스페이스 레벨이 아닌 전 유저 레벨로 권한을 허용하면 어떤 프로젝트를 열더라도 동일하게 적용된다. [49]

3. 모델 변경 및 MCP 활용 [50]

thumbnail 클로드 코드에서 사용할 AI 모델을 선택하고, MCP를 활용하여 AI의 정보 탐색 능력을 확장하는 방법을 설명한다.

3.1. 모델 선택 [50]

  1. 모델 선택 메뉴에서 원하는 AI 모델을 고를 수 있다. [50]
  2. 사용 중인 요금제에 따라 선택 가능한 모델이 달라진다. (예: 맥스 요금제는 Sonnet, Opus 프로 요금제는 Opus 선택 가능) [51]

3.2. MCP (Model Context Provider) 활용 [52]

  1. MCP는 AI가 특정 문서나 정보를 참조하도록 설정하는 기능이다. [53]
  2. 예를 들어, Rails 프레임워크 관련 문서를 MCP로 설정하면, AI가 최신 문서를 직접 찾아 참조할 수 있다. [54]
  3. MCP 설정 방법:
    • 클로드 코드 설정 페이지에서 MCP 설정 방법을 확인할 수 있다. [56]
    • 로컬 서버 커넥션 방식이 원격 서버 커넥션보다 안정적이다. [57]
  4. MCP 설정 후 claude MCP list 명령어로 등록된 MCP 목록을 확인할 수 있다. [53]
  5. MCP를 다시 호출하면 해당 컨텍스트를 활용하여 답변을 생성한다. [60]

4. 터미널 프로그램 및 유용한 기능 [73]

thumbnail 기본 터미널 프로그램의 한계를 극복하고, 클로드 코드의 유용한 기능들을 활용하는 방법을 소개한다.

4.1. 터미널 프로그램 추천 [73]

  1. 기본 터미널 프로그램도 사용 가능하지만, 화면 분할 기능이 제한적이다. [73]
  2. iTerm2 추천:
    • 화면 분할 기능이 뛰어나 가로 및 세로 분할이 자유롭다. [76]
    • 서버 로그 확인, 파일 수정, 브라우저 확인 등 동시 작업 시 편리하다. [81]
  3. Oh My Zsh 활용:
    • 터미널의 시각적 표현과 기능을 향상시킨다. [77]
    • 코드 하이라이팅, 자동 완성 등 개발 편의성을 높인다. [78]

4.2. 이미지 첨부 및 분석 [85]

  1. 클로드 코드에서는 이미지를 첨부할 수 있다. [85]
  2. Finder에서 이미지를 드래그하여 붙여넣으면 첨부가 가능하다. [87]
  3. 첨부된 이미지를 AI가 분석하고 설명해 줄 수 있다. [88]

4.3. compact 명령어를 활용한 대화 요약 [92]

  1. compact 명령어는 대화 기록이 많아져 컨텍스트 양이 늘어났을 때 사용한다. [93]
  2. 이 명령어를 통해 지금까지의 대화 히스토리를 요약할 수 있다. [93]
  3. 클로드 코드는 컨텍스트가 쌓이면 자동으로 compact 작업을 수행하기도 한다. [96]
  4. compact 작업은 기존 대화 내용을 압축하여 최대한 활용하면서 이후 작업을 진행하게 한다. [97]
  5. 이는 챗을 새로 열어 히스토리를 모두 날리는 방식보다 효율적이다. [98]
  6. Ctrl + R 명령어로 작업 내역, 수정된 파일 등을 확인할 수 있다. [102]