코딩

이 영상 하나만 보시면 됩니다. | 모든 Claude Code 세팅, 효과적인 워크플로우, 추천하는 서비스들 [개발동생]

capstone012 2025. 9. 5. 00:33
반응형
SMALL

Claude Code 사용 방법을 아래와 같이 보기 쉽게 정리했습니다. 그대로 보면서 따라 하시면 됩니다.


1. 기본 설정 및 프로젝트 초기화

  1. Claude Code 설치: 터미널에 다음 명령어를 입력하여 설치합니다.
  2. (설치 명령어는 영상에 나오지 않으므로, 공식 문서를 참고해야 합니다. 일반적으로 VS Code 확장 프로그램으로 설치합니다.)
    
  3. Claude Code 활성화: 프로젝트 폴더 내에서 터미널에 claude를 입력하여 활성화합니다.
  4. 프로젝트 초기화 (/init):
    • Claude Code가 프로젝트 구조를 분석하고 claude.md 파일을 자동으로 생성합니다.
    • 터미널에 /init을 입력하여 실행합니다.
    • 이 파일에 코딩 규칙, 아키텍처 패턴 등을 추가하면 Claude Code가 프로젝트를 더 잘 이해하게 됩니다.

2. MCP (Microsoft Claude Platform) 서버 연동

MCP 서버를 연동하면 Claude Code의 기능을 확장할 수 있습니다.

  • MCP 서버 추가:
    • 프로젝트 스코프: 프로젝트 루트 경로에 mcp.json 파일을 생성하고 MCP 서버 정보를 JSON 형식으로 추가합니다. 또는 claude mcp add 명령어로 추가할 수 있습니다.
  • 연동 상태 확인:
    • 터미널에 claude mcp list를 입력하여 현재 연결된 MCP 서버의 상태를 확인할 수 있습니다.

3. 효과적인 워크플로우

  • 모드 전환 (Shift + Tab):
    • Accept 모드: 코드를 바로 적용합니다.
    • Plan 모드: 먼저 작업 계획을 세운 후 실행합니다. 복잡한 작업에는 **Plan 모드**를 사용하는 것이 좋습니다.
  • Todo List 사용:
    • claude config 명령어를 통해 use_todo_list를 활성화하면 복잡한 작업을 여러 작은 작업으로 나누어 진행할 수 있습니다.
  • 출력 스타일 설정 (/output-style):
    • /output-style 명령어를 입력하면 Default, Verbose, Learn 세 가지 스타일을 선택할 수 있습니다.
    • **Learn 모드**는 코딩을 배우는 초보자에게 유용합니다.
  • 사용자 정의 출력 스타일:
    • /output-style new 명령어를 입력하고 원하는 스타일을 설명하면 사용자만의 스타일을 만들 수 있습니다.
    • 생성된 스타일은 .claude/output-styles 폴더에 저장됩니다.

4. 고급 기능: 서브 에이전트, 훅스

  • 서브 에이전트:
    • 각 분야에 특화된 에이전트를 만들어 병렬로 작업을 처리하게 할 수 있습니다.
    • .claude/agents 폴더에 마크다운 파일로 에이전트를 정의합니다.
    • /agent 명령어를 통해 에이전트를 관리하고 생성할 수 있습니다.
    • 호출 방법: @[에이전트 이름]과 함께 요청 내용을 입력합니다.
  • 훅스 (Hooks):
    • 특정 이벤트 발생 시 자동으로 셸 명령어를 실행하는 기능입니다.
    • 설정 파일: settings.json 파일에 hooks를 정의합니다.
    • 예시: claude 작업이 완료되었을 때 알림을 보내거나, 코드 포매터를 자동으로 실행할 수 있습니다.
    • 이벤트 종류: tool_called, tool_result, stop, start 등 여러 이벤트에 훅스를 등록할 수 있습니다.

5. 유용한 명령어 및 팁

  • 대화 기록 지우기:
    • 컨텍스트가 쌓여 성능이 저하되는 것을 막기 위해 /clear 명령어로 세션 기록을 초기화할 수 있습니다.
  • 대화 기록 불러오기:
    • /resume 명령어로 이전 대화 기록을 다시 불러올 수 있습니다.
  • 대화 기록 내보내기:
    • /export 명령어로 대화 기록을 클립보드나 파일로 저장할 수 있습니다.
  • 사용자 정의 명령어:
    • .claude/commands 폴더에 마크다운 파일로 반복적인 프롬프트나 규칙을 정의하여 커스텀 명령어를 만들 수 있습니다.
  • 내부 셸 명령어 실행:
    • Claude Code 대화창에서 **!**를 입력하면 bash 모드로 전환되어 셸 명령어를 직접 실행할 수 있습니다.

6. 보안 및 추천 서비스

  • bypass_permissions:
    • 모든 도구와 MCP에 대한 자율적 제어 권한을 부여하는 설정입니다.
    • 주의: 위험할 수 있으므로, devcontainer를 사용해 격리된 환경에서 활성화하는 것을 권장합니다.
  • 유용한 서비스:
    • CC Usage: npx cc 명령어로 Claude Code의 사용량(토큰, 비용)을 시각적으로 확인할 수 있습니다.
    • Super Claude: sc 명령어로 다양한 페르소나 및 유용한 커스텀 명령어를 활용할 수 있습니다.
    • Claude Code Templates: 웹사이트에서 필요한 설정(훅스, 명령어 등)을 선택해 스택에 추가하고 npx 명령어로 한 번에 설치할 수 있습니다.
반응형
LIST