1. Claude Code 설정 및 워크플로우 최적화 [0]

thumbnail Claude Code를 20배 더 효과적으로 활용하기 위한 설치, 프로젝트별 맞춤 설정, 그리고 효율적인 워크플로우 구축 방법을 설명한다.

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

  1. Claude Code 설치 및 기본 활성화 [0]
    1. 최근 Claude Code로 전환하는 개발자가 늘고 있으며, 구독자 요청에 따라 영상에서 기본 설정부터 신규 기능까지 다룬다. [0]
    2. 설치는 간단하며, 터미널에 명령어를 복사하여 실행 후 claude 명령어로 활성화할 수 있다. [4]
  2. 프로젝트별 맞춤 설정: claude.md 파일 활용 [7]
    1. 특정 프로젝트에서 Claude Code를 활성화한 후, 프로젝트 분석 및 초기화 과정이 필요하다. [7]
    2. claude.md 파일을 생성하여 프로젝트 구조와 설명을 작성하면 된다. [8]
    3. init 슬래시 명령어를 사용하면 Claude Code가 자동으로 프로젝트 코드베이스를 분석하여 claude.md 파일을 생성해 준다. [9]
    4. init 명령어로 초기화하는 것을 추천하며, 생성된 claude.md 파일에는 프로젝트 오버뷰, 사용 프레임워크, 라우팅 방식, 기술 스택 등이 자동으로 포함된다. [11]
    5. 핵심 아키텍처, 패키지 관리 방식 등 프로젝트 전반의 정보가 claude.md 파일에 저장된다. [14]
    6. claude.md 파일에 자주 사용하는 명령어, 코딩 스타일, 네이밍 규칙 등을 추가할 수 있으며, 이 파일은 Claude Code의 시스템 프롬프트 최상단에 포함되어 Claude Code의 프로젝트 이해도를 높인다. [16]

2. Claude Code의 MCP 서버 연동 및 고급 기능 활용 [18]

thumbnail Claude Code에 MCP 서버를 연동하는 방법과 다양한 고급 기능들을 활용하여 개발 워크플로우를 더욱 효율적으로 만드는 방법을 소개한다.

2.1. MCP 서버 연동 및 활용 [18]

  1. MCP 서버 연동 방식 [18]
    1. Claude Code는 MCP 서버와 연동이 가능하며, MCP 관련 도서 '나만의 MCP 서버 만들기 with Cursor'를 소개한다. [19]
    2. MCP 서버는 로컬 스코프, 프로젝트 스코프, 유저 스코프 세 가지 방식으로 연동할 수 있다. [27]
    3. 프로젝트 스코프로 MCP 서버를 추가하는 방법은 claude mcp add 명령어를 사용하며, 프로젝트 루트 경로에 mcp.json 파일이 생성된다. [28]
    4. mcp.json 파일에 직접 JSON 구조의 MCP 서버 명령어를 넣거나, claude mcp add 명령어로 추가할 수 있다. [33]
    5. 연동된 MCP 서버의 상태는 claude mcp list 명령어로 확인할 수 있으며, 경로가 정확하지 않으면 실패로 표시된다. [34]
    6. MCP 서버 연동 후에는 Cursor에서 사용하던 방식과 동일하게 활용할 수 있다. [36]
  2. MCP 서버 성능 및 LLM 모델 영향 [37]
    1. Claude Code에서 mcp 슬래시 명령어로 연동된 MCP 서버를 확인할 수 있다. [37]
    2. 대규모 MCP 툴 환경에서 LLM 에이전트의 작업 수행 능력을 평가한 논문을 소개하며, Claude Sonnet 4 모델이 78.95%의 성공률로 가장 뛰어난 성능을 보였다. [38]
    3. Claude Sonnet 4 모델은 MCP 서버 연동 시 좋은 성능을 보여, Claude Code 활용 시 MCP 성능 향상을 기대할 수 있다. [41]

2.2. Claude Code의 워크플로우 및 응답 스타일 설정 [42]

  1. 모드 전환 및 투두 리스트 활용 [42]
    1. Shift + Tab 키를 눌러 Accept 모드와 Plan 모드로 전환할 수 있다. [42]
    2. Plan 모드로 계획을 세우고, Accept Edit 모드로 실제 코드 변경을 진행하는 워크플로우를 추천한다. [44]
    3. config 슬래시 명령어로 기본 설정을 변경할 수 있으며, Use Todo List 옵션을 활성화하면 복잡한 작업 시 자체적으로 투두 리스트를 생성하여 관리한다. [45]
  2. 맞춤형 응답 스타일 설정 [47]
    1. Claude Code는 Default, Verbose, Learning 세 가지 기본 응답 스타일을 제공한다. [47]
      1. Default 모드: 코딩 작업을 효율적으로 완료하기 위한 간결한 응답 스타일이다. [49]
      2. Verbose 모드: Default 모드보다 부연 설명이 추가된 응답 스타일이다. [49]
      3. Learning 모드: 통찰력 제공, 협업 및 실습을 통해 사용자의 학습을 돕는 모드이다. [50]
    2. Learning 모드는 사용자가 특정 코드 구현에 대한 핸즈프리 연습을 할 수 있도록 작은 코드 조각을 작성하게 돕는다. [52]
    3. 개발이 익숙하지 않은 개발자는 Learning 모드를 활용하면 개발 학습에 큰 도움이 된다. [53]
    4. 사용자 지정 출력 스타일을 만들 수 있으며, output style new 명령어로 원하는 응답 스타일에 대한 설명을 입력하면 Claude Code가 자체적으로 인스트럭션을 생성한다. [54]
    5. 생성된 사용자 지정 출력 스타일은 .claude 경로의 output_style 디렉토리에 저장되며, 말투, 톤, 유머 스타일 등을 정의할 수 있다. [57]
    6. 사용자 지정 출력 스타일은 output style 슬래시 명령어로 선택하여 사용할 수 있으며, 기존 응답 스타일과 다르게 설정 가능하다. [62]
    7. 사용자 지정 출력 스타일은 유저 스코프뿐만 아니라 프로젝트별로도 설정할 수 있으며, 프로젝트 루트 경로의 .claude 폴더 내 output_style 폴더에 마크다운 파일로 추가하면 된다. [64]

2.3. 서브 에이전트 활용 및 병렬 처리 [66]

  1. 서브 에이전트 개념 및 생성 [66]
    1. 서브 에이전트는 각 분야에 특화된 여러 에이전트를 만들어 페르소나를 가지고 개발시키는 방식이다. [66]
    2. 서브 에이전트는 Claude Code의 에이전트를 병렬 처리할 수 있게 하여 개발 워크플로우를 최적화한다. [68]
    3. 서브 에이전트는 .claude 폴더 내 agent 폴더에 작업별 마크다운 파일을 생성하여 만든다. [71]
    4. agent 슬래시 명령어로 사용 가능한 에이전트를 확인하고, create new agent를 통해 프로젝트 또는 유저 단위로 에이전트를 추가할 수 있다. [72]
    5. Claude Code를 통해 에이전트 초안을 작성 요청하면, Claude Code가 기본적인 구조를 만들어주고 도구 및 모델 선택, 에이전트 색상 지정이 가능하다. [73]
    6. 생성된 서브 에이전트는 사용자의 스타일에 맞게 수정하여 활용할 수 있다. [78]
  2. 서브 에이전트 호출 및 병렬 처리 [79]
    1. 서브 에이전트는 이름과 함께 작업을 요청하여 호출하며, 예를 들어 특정 컴포넌트를 다른 컴포넌트로 대체하는 작업을 시킬 수 있다. [79]
    2. 서브 에이전트의 색상을 통해 동작을 시각적으로 확인할 수 있다. [83]
    3. 여러 개의 서브 에이전트를 병렬로 실행하면 작업 속도가 크게 향상된다. [84]
    4. 여러 서브 에이전트를 병렬로 실행하는 예시로, 각 에이전트가 다른 컴포넌트 마이그레이션을 담당하도록 요청할 수 있다. [86]
    5. 여러 서브 에이전트를 통해 한 번에 여러 작업을 시킬 수 있어 개발 속도를 높일 수 있다. [90]
    6. 각 서브 에이전트는 고유한 컨텍스트를 부여받아 컨텍스트 최적화가 잘 일어나므로, 단순 병렬 처리보다 효율적이다. [91]

2.4. 훅스 기능 활용 [93]

  1. 훅스 기능 소개 및 설정 [93]
    1. 훅스는 특정 이벤트에 자동으로 실행되는 쉘 명령어를 등록하는 기능이다. [93]
    2. Claude Code 동작 중 다양한 시점에 원하는 작업을 자동으로 실행하게 할 수 있다. [94]
    3. 작업 완료 시 알림, 코드 포메터 자동 실행, 에러 발생 시 로깅 등 다양한 활용이 가능하다. [95]
    4. 훅스는 유저 세팅, 프로젝트 세팅, 로컬 프로젝트 세팅 세 가지 경로에 등록할 수 있다. [100]
    5. 로컬 프로젝트 세팅 기준으로, settings.json 파일에 hooks를 정의하고 이벤트와 구현 사항을 작성한다. [101]
    6. 예시로, 작업 중단 시 "요청하신 작업이 완료되었습니다"라는 오디오를 재생하는 훅을 설정할 수 있다. [104]
  2. 훅스 기능 활용 예시 [107]
    1. 작업 완료 시 오디오 재생 훅이 정상적으로 작동하는 것을 확인할 수 있다. [107]
    2. 도구 호출 완료 후 동작하는 훅으로, 확장자별 적절한 포메터를 자동으로 실행하도록 설정할 수 있다. [108]
      1. JavaScript, CSS, HTML은 Prettier로, Python은 Black formatter로, Go, Rust, PHP 등은 각 언어에 맞는 포메터로 자동 포매팅한다. [110]
    3. 파일 생성 도구 사용 후, 변경 사항을 로컬에서 스테이징으로 올리는 git add 명령어를 실행하는 훅을 설정할 수 있다. [111]
    4. HTML 파일 생성 요청 후, git add 훅이 정상적으로 작동하여 변경 사항이 스테이징으로 올라가는 것을 확인할 수 있다. [114]
    5. 디버깅 로그에서 두 가지 훅(코드 포매팅, git add)이 호출된 것을 확인할 수 있다. [119]
    6. claude.md 파일은 LLM이 규칙을 수행하도록 정의하는 반면, 훅스는 특정 상황에서 무조건 발생하는 커맨드나 쉘 명령어를 조합하여 LLM 응답과 별개로 동작 수행을 보장한다. [121]

2.5. 슬래시 명령어 활용 및 사용자 정의 [122]

  1. 기본 슬래시 명령어 활용 [122]
    1. Claude Code에는 에이전트 관리, 대화 기록 지우기 등 다양한 기본 슬래시 명령어가 있다. [123]
    2. 대화 기록을 계속 쌓으면 컨텍스트가 차올라 LLM 성능이 저하되므로, clear 명령어로 세션을 초기화하여 새로운 기능 개발을 진행하는 것이 좋다. [125]
    3. clear 명령어로 컨텍스트를 초기화한 후에도, resume 명령어를 통해 이전 대화 내역을 불러올 수 있다. [130]
    4. Claude Code에서 작업한 세션 대화 내역을 export 명령어를 통해 클립보드나 파일로 내보내 Cursor 등 다른 도구에서 이어서 작업할 수 있다. [134]
  2. 사용자 정의 슬래시 명령어 생성 [137]
    1. 기본 슬래시 명령어 외에 사용자 정의 슬래시 명령어를 만들 수 있다. [137]
    2. 프로젝트 루트 경로의 .claude 폴더 내 commands 폴더에 마크다운 파일을 생성하여 사용자 정의 명령어를 만든다. [139]
    3. 예시로, 코드 성능 및 버그 최적화를 제안하는 optimize.md 명령어를 생성할 수 있다. [141]
    4. 반복적으로 사용되는 프롬프트나 팀원 간 규칙을 정할 때 사용자 정의 슬래시 명령어를 활용하면 유용하다. [144]

2.6. Bash 명령어 실행 및 권한 관리 [146]

  1. Bash 명령어 실행 및 장점 [146]
    1. Claude Code 내부에서 Bash 명령어를 실행할 수 있으며, 느낌표(!)를 입력하여 Bash 모드로 전환한다. [147]
    2. Bash 명령어 실행 시 진행 상황과 결과를 컨텍스트로 가져갈 수 있어, 에러 메시지 분석 및 해결 과정에 활용할 수 있다. [149]
    3. 기본적으로 사용자 허락을 받은 명령어만 실행 가능하지만, settings.json 파일에서 허락 없이 수행할 명령어들을 정의할 수 있다. [150]
  2. 권한 관리 및 개발 컨테이너 활용 [152]
    1. Claude Code에게 모든 자율성을 부여하고 싶을 때는 bypass_permissions 옵션을 활성화한다. [152]
    2. bypass_permissions 모드는 모든 도구와 MCP를 자율적으로 조정하므로 주의해서 사용해야 한다. [155]
    3. bypass_permissions 모드 활용 시, 개발 컨테이너를 활성화하여 신뢰할 수 있는 환경에서 개발하는 것을 추천한다. [157]

3. Claude Code 개발 환경 및 유용한 서비스 [158]

thumbnail Claude Code의 안전한 개발 환경 구축을 위한 개발 컨테이너 설정 방법과 함께, 사용량 추적 및 커스텀 명령어 활용에 유용한 서비스들을 소개한다.

3.1. 개발 컨테이너 설정 및 활용 [158]

  1. 개발 컨테이너 소개 및 설정 파일 [158]
    1. 개발 컨테이너는 Claude Code를 신뢰할 수 있는 환경에서 개발할 수 있도록 Docker 컨테이너 기반으로 구축된 환경이다. [159]
    2. Dev Container 설정에는 Dockerfile, devcontainer.json, firewall 세 가지 설정 파일이 제공된다. [160]
    3. 해당 설정 파일들을 다운로드하여 프로젝트 루트 경로에 devcontainer 폴더를 생성하고 넣어준다. [161]
  2. 개발 컨테이너 활성화 및 사용 [163]
    1. VS Code 익스텐션 마켓플레이스에서 Dev Container 익스텐션을 설치한다. [163]
    2. 프로젝트 루트 경로에 devcontainer 폴더를 설정한 후, Command Palette (Ctrl+Shift+P)에서 "Open in Container"를 검색하여 활성화한다. [166]
    3. 개발 컨테이너로 열린 편집기는 "Container: Claude Code Sandbox"로 표시되며, Docker 컨테이너 내부에서 개발을 진행한다. [168]
    4. 도커 파일은 Node.js 20 기반 프로젝트 환경과 필수 개발 도구를 포함하며, 맞춤형 방화벽 설정으로 허용된 서비스에만 네트워크 접근을 허용한다. [171]
    5. bypass_permissions 모드를 활성화할 때는 개발 컨테이너를 활용하는 것이 안전하며, 내부 방화벽 설정으로 인해 어느 정도 안정적으로 활용할 수 있다. [173]

3.2. 유용한 Claude Code 서비스 소개 [176]

  1. CC Usage 서비스 [176]
    1. CC Usage는 Claude Code 사용량을 확인할 수 있는 서비스이다. [177]
    2. npx cc 명령어를 사용하여 일별 인풋/아웃풋 토큰 활용량, 캐시 생성, 총 토큰 사용량, 예상 비용 등을 시각적으로 확인할 수 있다. [180]
  2. SuperClaude 서비스 [182]
    1. SuperClaude는 로컬에 설치하여 유용한 커스텀 슬래시 명령어들을 활용할 수 있게 해준다. [182]
    2. 개발 관련 명령어 분석, 코드 개선, 다양한 유틸리티 등을 슬래시 명령어로 제공한다. [183]
    3. 아키텍트, 프론트엔드, 백엔드, 분석가 등 작업에 특화된 페르소나로 자동 전환하여 Claude Code 성능을 높인다. [184]
  3. Claude Code Templates 서비스 [186]
    1. Claude Code Templates는 atemplate.com에서 확인할 수 있으며, 슬래시 명령어, 세팅값, 훅 기능, MCP 템플릿 등을 활용할 수 있다. [187]
    2. SuperClaude와 달리 원하는 슬래시 명령어, 커맨드 등을 선택하여 장바구니에 담아 필요한 것만 설치할 수 있다. [190]
    3. 훅, 파일 프로텍션, 커맨드 등을 선택하여 스택에 추가하고, 전체를 한 번에 설치하는 명령어를 실행한다. [191]
    4. 설치 시 스코프를 선택하면 프로젝트별로 빠르게 컴포넌트들이 설치된다. [196]
    5. 설치된 훅과 커맨드는 프로젝트 스코프 및 settings.json 파일에서 확인할 수 있다. [198]

4. 결론 및 추가 정보 [199]

  1. 마무리 및 향후 계획 [199]
    1. 소개된 서비스들을 활용하여 Claude Code 성능을 높이고 개별 환경에 맞게 커스터마이징하는 과정을 진행해 볼 것을 권장한다. [199]
    2. 영상에서는 Claude Code 설정, 워크플로우 구축, 병렬 처리, 유용한 서비스들을 소개했다. [200]
    3. 궁금한 점은 댓글로 남기고, 다음 영상에서 더 유용한 정보로 돌아올 것을 예고한다. [201]