https://muonkmu.github.io/tags/claude-code/ Recent content in Claude code on MW Devlog Hugo -- gohugo.io en-us Sun, 12 Jul 2026 00:00:00 +0000 https://muonkmu.github.io/p/harness-engineering-claude-code-guide/ Sun, 12 Jul 2026 00:00:00 +0000 https://muonkmu.github.io/p/harness-engineering-claude-code-guide/ <p>클로드 코드 완벽가이드 책 요약</p> <h2 id="claude-code-동작방식">Claude code 동작방식</h2> <ol> <li>프로젝트 구조분석 : 기존 코드 베이스 탐색, 사용중인 프레임워크/라이브러리 파악, 코딩 스타일 패턴 학습</li> <li>작업계획 수리비 : 필요 컴포넌트 식별, 구현 순서 결정, 필요 종속성 파악</li> <li>실행 : 코드생성, 필요 패키지 설치 ,테스트 코드 작성 실행</li> <li>검증 및 개선 : 코드 테스트, 수정, 코딩 스타일/패턴 학습</li> </ol> <h2 id="자주-사용하는-단축키">자주 사용하는 단축키</h2> <ul> <li>ctrl + c : 현재 입력, 생성중인 아웃풋 중단</li> <li>ctrl + d : 세션 중단</li> <li>ctrl + l : 클로드 코드 대화는 유지, 사용자 대화창의 입력을 전부 삭제</li> <li>esc + esc : 직전 메세지로 회귀, 해당 메시지를 보내기 직전으로 클로드와 대화를 포크하는 효과</li> <li>shift + enter : /terminal-setup 명령어를 실행한 후 Shift+enter를 사용하여 줄바꿈</li> <li>#[메시지] : CLAUDE.md에 빠르게 기억해야할 요소 추가</li> </ul> <h2 id="명령어">/명령어</h2> <ul> <li>/model : 모델 리스트 (defult 옵션의 경우 사용량에 따라 중간에 모델을 바꿈)</li> <li>/compact : 콘텍스트 정리</li> <li>/config : 전반적인 설정 <ul> <li>Auto-compact : 컨텍스 다 차면 자동으로 compact 할지</li> <li>use todo list : 긴 작업 구현 시 작업 순서를 Todo 리스트로 만들고 사용자에게 보여줄지(true)</li> <li>verbose output : 출력결과를 길게보여줄지 (false)</li> <li>theme :테마</li> <li>notifications : 작업 종료 시 보여줄 알람 설정 (terminal bell / kitty 중 선택)</li> <li>Editor Mdoe : normal, vim 중 선택</li> <li>model : 사용할 모델 선택</li> </ul> </li> <li>/permissions : 수정 권한</li> <li>/memory : auto-meomry on/off 하가나 claude.md 선택, 수동 편집 실행</li> <li>/mcp : mcp관리</li> <li>/pr_commnents : pull request 코멘트 조회</li> <li>/review : pull request 리뷰</li> </ul> <h2 id="claudemd-파일">CLAUDE.md 파일</h2> <h3 id="claudemd-란-무엇인가">claude.md 란 무엇인가</h3> <ul> <li>프로젝트 폴더에 두는 마크다운 파일로, Claude는 세션이 시작될 때 이 파일을 컨텍스트에 자동으로 주입</li> <li>클로드는 이 파일을 읽어 아키텍쳐, 코딩규칙, 작업절차 등을 깊이 있게 파악</li> </ul> <h3 id="엔트로픽-추언-claudemd-내용">엔트로픽 추언 CLAUDE.md 내용</h3> <ul> <li>자주 사용하는 bash 명령어</li> <li>핵심 파일 및 유틸리티 함수</li> <li>코드 스타일 가이드 라인</li> <li>테스트 지침</li> <li>저장소 에티켓 (브랜치 이름, merge, rebase)</li> <li>개발자 환경 설정 (pyenv 사용, 작동하는 컴파일러 등)</li> <li>프로젝트에 특정한 예상치 못한 동작이나 경고</li> <li>클로드가 기억했으면 하는 기타 정보</li> <li>(저자) 일괄적으로 사용하고 싶은 라이브러리에 대한 정보</li> <li>(저자) 아키텍쳐에 대한 정보</li> </ul> <h3 id="claudemd-파일-종류-3가지">CLAUDE.md 파일 종류 3가지</h3> <ul> <li>프로젝트 메모리(./CLAUDE.md) : 프로젝트 루트에 위치하며 팀 전체에 적용할 규칙과 정보 <ul> <li>프로젝트 아키텍쳐</li> <li>코딩 표준</li> <li>워크플로 : 빌드, 테스트, 배포 지침</li> </ul> </li> <li>로컬 프로젝트 메모리 (./claude.local.md) : 개인적인 프로젝트 설정, .gitignore에 추가할 것 <ul> <li>샌드박스 url</li> <li>개인 API키 또는 테스트 데이터</li> <li>자신에게 유용한 맞춤형 명령어</li> </ul> </li> <li>사용자 메모리(~/.claude/CLAUDE.md) : 모든 프로젝트에 적용되는 전역 설정 <ul> <li>일반적인 코딩 스타일</li> <li>개인 도구를 위한 단축키</li> </ul> </li> </ul> <h3 id="claudemd-관리-노하우">CLAUDE.md 관리 노하우</h3> <ol> <li>클로드 코드쓰면서 바로 수정</li> </ol> <ul> <li>#키를 눌러 지시사항이 CLAUDE.md 파일에 자동으로 통합되게 하기</li> <li>&ldquo;IMPORTANT&rdquo;, &ldquo;YOU MUST&rdquo; 강조 표현을 사용하면 좋음</li> </ul> <ol start="2"> <li>클로드에게 주기적으로 관리하라고 하기</li> </ol> <ul> <li>주기적으로 클로드 코드에 현재까지 대화 내용을 기반으로 CLAUDE.md 파일에 추가할 만한 내용 추천 요청</li> </ul> <ol start="3"> <li>클로드 코드에게 파일 정리하라고 하기</li> </ol> <ul> <li>가끔 클로드 코드에게 CLAUDE.md 정리 요청(필요없는 내용 삭제, 과도한 내용 축소로 컨텍스트 절약)</li> </ul> <h3 id="필자-claudemd-vs-memorymd">(필자) CLAUDE.md vs MEMORY.md</h3> <table> <thead> <tr> <th style="text-align:left">MEMORY.md (Auto Memory)</th> <th></th> <th></th> </tr> </thead> <tbody> <tr> <td style="text-align:left"><strong>작성 주체</strong></td> <td style="text-align:left">**개발자(사람)**가 직접 작성 및 관리</td> <td style="text-align:left">**Claude(AI)**가 세션 중 자동 기록</td> </tr> <tr> <td style="text-align:left"><strong>내용 성격</strong></td> <td style="text-align:left">명시적 규칙, 코딩 컨벤션, 아키텍처 지침</td> <td style="text-align:left">작업 중 발견한 패턴, 디버깅 인사이트, 개인 선호도</td> </tr> <tr> <td style="text-align:left"><strong>팀 공유</strong></td> <td style="text-align:left"><strong>Git 커밋</strong>을 통해 팀원 전체와 공유 가능</td> <td style="text-align:left"><strong>로컬 전용</strong> 머신에만 저장 (팀 공유 불가)</td> </tr> <tr> <td style="text-align:left"><strong>로드 방식</strong></td> <td style="text-align:left">세션 시작 시 <strong>파일 전체</strong>를 무조건 로드</td> <td style="text-align:left">시작 시 **첫 200줄(또는 25KB)**만 인덱스로 로드</td> </tr> </tbody> </table> <p>활용 예시</p> <ol> <li>초기 세팅: 프로젝트 시작 시 /init 명령어를 실행하여 기본적인 CLAUDE.md 뼈대를 자동 생성하고 빌드/테스트 규칙을 명시합니다.</li> <li>개발 진행: 일상적인 트러블슈팅이나 개인적인 작업 스타일 기억은 기본 활성화된 Auto Memory(MEMORY.md)에 자연스럽게 쌓이도록 둡니다.</li> <li>규칙 동기화: Auto Memory에 쌓인 기억 중 **&ldquo;이것은 팀원 전체가 무조건 지켜야 하는 공통 규칙이다&rdquo;**라고 판단되는 항목이 생기면, 해당 내용을 복사하여 루트의 CLAUDE.md로 옮기고 Git에 커밋하여 팀과 공유합니다.</li> </ol> <h3 id="클로드는-어떻게-claudemd를-읽을까">클로드는 어떻게 CLAUDE.md를 읽을까?</h3> <ul> <li>현재 프로젝트 위치에서 루트 디렉토리까지 거슬러 올라가며 발견하는 모든 CLAUDE.md 파일을 읽음</li> <li>프로젝트 계층별로 (폴더 구조별로) CLAUDE.md를 만들어 관리하면 좋음</li> </ul> <h2 id="클로드코드-모드">클로드코드 모드</h2> <ul> <li>일반모드 : 기본 모드, 수정 사항을 개발자가 빠르게 받을 때</li> <li>자동 수정 모드 : 허락받지 않고 직접 코드 수정 (단순 반복 등)</li> <li>플래닝 모드 (계획 수립)</li> </ul> <h2 id="클로드-코드-생각과정-제어">클로드 코드 생각과정 제어</h2> <h3 id="cot-chani-of-thought">CoT (chani of thought)</h3> <ul> <li>사고의 사슬, 논리적 사고 과정이라는 프롬프팅 기법, AI가 최종 답변을 내놓기 전에 사고과정을 명시적으로 기술하도록 유도</li> <li>인간이 복잡한 문제를 풀 때 단계를 나누어 생각하는 과정과 유사</li> </ul> <h3 id="cot의-유도">CoT의 유도</h3> <ol> <li>&ldquo;생각해라&rdquo; 문구를 넣어 가능</li> </ol> <ul> <li>ex) &ldquo;REST API를 어떻게 설계 할 수 있는지 단계별로 생각하고 답변해줘&rdquo;</li> </ul> <ol start="2"> <li>사고와 답변을 XML 태그를 사용해서 구분하라고 지시</li> </ol> <ul> <li>ex) &ldquo;REST API를 구축하려면 어떻게 해야해? 생각 과정을 <!-- raw HTML omitted --> 태그에 입력해주고 생각한 과정을 분석하고 그를 기반으로 <!-- raw HTML omitted --> 태그에 답변을 입력해줘</li> </ul> <h3 id="확장된-사고">확장된 사고</h3> <ul> <li>CoT에서 한단계 발전된 모델로 이를 사용하면 응답을 생성하는데 더 많은 노력을 들임</li> <li>&ldquo;고민해라&rdquo; 말해서 사용 <ul> <li>ex) 이 프로젝트에 테스트 코드를 작성하려고 하는데 프로젝트를 분석하고 고민한 다음 테스트 코드를 작성해줘</li> </ul> </li> <li>단계 별로 확장가능 <ul> <li>고민해라(think)</li> <li>깊게 고민해라 (think hard)</li> <li>더 깊게 고민해라 (think harder)</li> <li>더욱 깊게 고민해라 (ultra think)</li> </ul> </li> </ul> <h2 id="커스텀-슬래시-커맨드">커스텀 슬래시 커맨드</h2> <h2 id="mcp">MCP</h2> <p>유용한 MCP 리스트</p> <ul> <li>Playwright, puppeteer : MCP로 브라우저 조종가능, e2e 테스트 및 크롤링 시 유용</li> <li>context7 : 각 종 개발 도구의 가장 최근 공식 문서를 가져옴</li> </ul> <h2 id="에이전트-병렬로-실행">에이전트 병렬로 실행</h2> <ul> <li>subagent 사용. teammate 사용을 확인할 것</li> </ul>