LeanX
클로드 코드 완전 정복
설치부터 CLAUDE.md와 실전 워크플로우, 스킬·서브에이전트·git worktree 병렬 개발·컨텍스트 엔지니어링·시간 기반 자동화까지 — 말로 개발하는 AI 코딩 에이전트를 입문부터 고급까지 완전 정복
클로드 코드란? 설치와 첫 실행
클로드 코드는 터미널에서 자연어로 개발을 시키는 Anthropic의 AI 코딩 에이전트로, 명령어 한 줄로 설치하고 로그인만 하면 바로 사용할 수 있습니다. 약 8분.
대화와 세션 — 이어하기, 초기화, 재개
세션은 클로드 코드와 나눈 하나의 대화 단위이며, claude --continue로 직전 대화를 잇고, /clear로 초기화하고, claude --resume으로 과거 대화를 골라 재개할 수 있습니다. 약 6분.
모델 선택과 사고 수준 — Opus, Sonnet, Haiku
클로드 코드는 성능이 높은 순서로 Opus, Sonnet, Haiku 모델을 제공하며, 복잡한 설계나 디버깅에는 Opus, 일상적인 코딩에는 Sonnet, 간단하고 빠른 작업에는 Haiku를 쓰는 것이 효율적입니다. 약 7분.
자율권과 안전 — 권한 승인과 plan 모드
클로드 코드는 파일 수정이나 명령 실행 전에 사용자 승인을 요구하며, Shift+Tab으로 자동 승인 모드와 계획만 세우는 plan 모드를 전환해 자율권의 수준을 조절할 수 있습니다. 약 8분.
컨텍스트 관리 — /compact와 짧은 세션의 힘
컨텍스트 윈도우는 클로드가 한 번에 기억할 수 있는 작업 기억의 한계이며, /compact로 대화를 요약해 공간을 확보하고 세션을 짧게 유지하는 것이 답변 품질을 지키는 핵심입니다. 약 7분.
CLAUDE.md — 프로젝트의 작업 기억 만들기
CLAUDE.md는 프로젝트 루트에 두는 지침 파일로, 클로드 코드가 세션을 시작할 때마다 자동으로 읽기 때문에 프로젝트 규칙과 명령어를 매번 반복 설명할 필요가 없어집니다. 약 9분.
첫 실전: 다운로드 폴더 정리하기
코딩 지식 없이도 클로드 코드로 다운로드 폴더의 파일을 종류별로 자동 분류할 수 있으며, 이 실습으로 계획 확인 후 실행하는 안전한 사용 습관을 익힐 수 있습니다. 약 10분.
코드베이스 탐색과 정확한 지시
클로드 코드는 프로젝트 파일을 스스로 탐색해 이해할 수 있으며, 파일 경로와 원하는 결과·조건을 구체적으로 지정할수록 정확한 결과를 얻을 수 있습니다. 약 8분.
버그 디버깅과 리팩토링
에러 메시지를 통째로 붙여넣고 재현→원인 분석→수정→검증의 루프를 돌리면 클로드 코드가 대부분의 버그를 스스로 해결하며, 리팩토링은 테스트로 안전망을 만든 뒤 작게 나눠 진행하는 것이 안전합니다. 약 10분.
MCP로 도구 연결하기 — Supabase·GitHub·n8n 붙이기
MCP(Model Context Protocol)는 클로드 코드에 외부 서비스를 직접 연결하는 표준 규격으로, settings.json을 손대지 않고 '이 MCP 설치·연결해 줘'라는 프롬프트나 claude mcp add 명령만으로 데이터베이스 조회·GitHub 이슈 생성·자동화 실행을 대화 한 줄로 처리할 수 있습니다. 약 8분.
서브에이전트와 커스텀 명령 — 위임·병렬·/명령어 만들기
클로드 코드는 복잡한 작업을 서브에이전트에 나눠 위임하고 병렬로 처리할 수 있으며, .claude/commands/ 폴더에 마크다운 파일을 만들면 자신만의 슬래시 명령어를 추가해 반복 작업을 한 번에 실행할 수 있습니다. 약 9분.
훅으로 자동화 — 편집 후 자동 포맷과 안전장치
훅(hook)은 클로드 코드가 특정 동작을 할 때 자동으로 실행되는 명령으로, settings.json의 hooks 항목에 등록하면 파일 수정 후 Prettier 자동 실행, 타입 오류 감지, 콘솔 로그 검사 같은 반복 작업을 사람 손 없이 처리할 수 있습니다. 약 8분.
스킬(Skills) — AI에게 주는 재사용 업무 매뉴얼
스킬은 반복 작업의 순서·형식·체크리스트를 SKILL.md 파일에 담아 둔 재사용 매뉴얼로, 평소엔 이름과 설명만 컨텍스트에 올라가고 실제 호출될 때만 본문이 로드되어 컨텍스트를 아끼면서 일관된 작업을 보장합니다. 약 9분.
서브에이전트 깊게 파기 — 내장·커스텀·에이전트 팀
서브에이전트는 메인 대화와 분리된 별도 컨텍스트에서 작업하고 요약만 돌려주어 메인 컨텍스트 오염을 막으며, /agents 명령으로 시스템 프롬프트·도구·모델을 지정한 나만의 전문 에이전트를 만들 수 있습니다. 약 10분.
충돌 없이 병렬 개발 — 멀티 인스턴스와 git worktree
여러 클로드 인스턴스가 같은 폴더를 고치면 파일 충돌이 나므로, git worktree로 브랜치마다 별도의 작업 폴더를 만들면 하나의 저장소를 공유하면서 독립된 기능을 동시에 개발할 수 있습니다. 약 9분.
세컨드 브레인과 /memory — 결정을 기억시키기
세컨드 브레인은 배운 패턴과 결정의 이유를 로컬 마크다운에 쌓아 두는 것이며, /memory로 저장한 메모리는 매 세션 자동 로드되고 CLAUDE.md는 규칙과 참조 경로만 담아 상세 문서는 필요할 때만 읽히게 하면 컨텍스트를 아낄 수 있습니다. 약 9분.
컨텍스트 엔지니어링 고급 — 오프로드·다이어그램·MCP 다이어트
품질은 컨텍스트 관리에서 갈리며, 대용량 데이터는 스크립트로 오프로드해 요약만 받고, 아키텍처는 Mermaid 다이어그램으로 압축 저장하고, 안 쓰는 MCP는 비활성화해 클로드의 책상에 지금 필요한 것만 올려 두는 것이 핵심입니다. 약 10분.
고수의 워크플로우 — 계획·검증·교차검증·WAT
고수는 계획 세션과 구현 세션을 분리해 신선한 컨텍스트에서 작게 구현하고, 클로드의 가정이 틀리면 Esc로 즉시 멈추며, 계획을 다른 AI에게 교차검증시키고, Workflow·Agent·Tools의 WAT 원칙으로 작업을 설계합니다. 약 10분.
파워유저 부스터 — !배시·되감기·음성·출력스타일·시간자동화
입력창의 ! 프리픽스로 배시를 즉석 실행하고, Esc로 중단·Esc Esc로 되감기하며, 이미지 붙여넣기·/voice 음성 입력·/output-style 출력 스타일·시간 기반 /loop 자동화까지 활용하면 클로드 코드 작업 속도를 크게 끌어올릴 수 있습니다. 약 9분.