Claude 코드 프롬프트: 바로 사용할 수 있는 25가지 프롬프트와 나만의 프롬프트 작성법

만료된 쿠폰을 사용하는 고객은 결제 시 500 오류가 발생합니다. @src/checkout/coupons.ts 파일과 해당 테스트를 검토하세요. 예상되는 동작은 주문이 생성되지 않고 '쿠폰이 유효하지 않습니다'라는 메시지가 표시되는 것입니다. 오류를 재현하는 실패하는 테스트를 작성한 다음, 유효한 쿠폰에 대한 동작을 변경하지 않고 오류를 수정하세요. [checkout test 명령어]를 실행하고 수정 전후의 결과를 보여주세요. 오류를 재현할 수 없는 경우, 구현을 변경하기 전에 확인한 내용을 보고해 주세요.

[예약 양식 경로]에 날짜 선택기를 추가하세요. @src/components/TimeSelect.tsx에 명시된 컴포넌트 및 유효성 검사 규칙을 따르세요. 사용자는 [허용된 날짜]를 선택할 수 있어야 하며, [사용 불가능한 날짜]는 비활성화된 상태로 유지되어야 합니다. 라이브러리는 추가하지 마세요. [컴포넌트 테스트 명령어]와 [타입 검사 명령어]를 실행하고, 해당 검사에서 다루지 않는 기준이 있다면 보고하세요.

@src/reports/export.py 파일을 입력값, 출력 형식, 오류 처리 방식을 유지한 채 더 작은 기능들로 분할하세요. 편집 전에 [export test 명령어]를 실행하고 기존에 발생한 오류가 있으면 보고하세요. 리팩토링 후 테스트를 다시 실행하고 두 결과를 모두 보여주세요. 공개 인터페이스나 관련 없는 파일은 변경하지 마세요.

“Claude는 Claude Chrome 확장 프로그램을 사용하여 제가 claude.ai/코드에 적용하는 모든 변경 사항을 테스트합니다. 브라우저를 열고 UI를 테스트한 뒤, 코드가 제대로 작동하고 사용자 경험이 만족스러워질 때까지 반복합니다. ”

이 저장소의 README, 프로젝트 구성, 최상위 디렉터리 구조를 검토하십시오. 다음 사항을 설명하는 데 필요한 경우에만 참조 자료를 활용하십시오: 애플리케이션의 기능, 주요 진입점 및 핵심 구성 요소, 테스트가 위치한 곳, 테스트 실행을 위해 저장소에서 정의된 명령어. 설명을 뒷받침하는 파일 경로를 인용하십시오. 문서화된 동작과 본인의 추론을 구분하고, 판단할 수 없는 사항은 표시해 두십시오. 비밀 정보나 환경 설정 파일을 읽거나, 설치된 의존성을 조사하거나, 파일을 변경해서는 안 됩니다. 마지막으로 제가 가장 먼저 읽어야 할 세 가지 파일과 그 이유를 제시하십시오.

[파일, 기능 또는 클래스]의 Git 이력을 검토하며, [동작 또는 설계 관련 질문]에 중점을 둡니다. 해당 동작을 도입하거나 실질적으로 변경한 커밋을 파악하십시오. 관련 커밋마다 해시 값을 제시하고, 변경 사항을 요약하며, 커밋 메시지나 연결된 관련 토론에 기록된 근거를 설명하십시오. 추론된 이유는 ‘추론’이라고 명시하십시오. 이력에서 결정 사유가 설명되지 않는 경우, 그 사실을 명시하십시오. 파일이나 Git 이력을 수정하지 마십시오.

[사용자 동작 또는 시스템 이벤트]가 발생했을 때 [알려진 경로, 핸들러 또는 폴더]에서 시작하여 어떤 일이 일어나는지 추적하십시오. 유효성 검사, 비즈니스 로직, 데이터베이스 쓰기 또는 외부 요청을 거쳐 관련 호출을 추적하십시오. 실행 순서대로 파일과 기능을 목록으로 작성하고, 가능한 경우 해당 줄 번호를 명시하십시오. 주요 오류 경로를 설명하고 해당 흐름을 다루는 기존 테스트를 파악하십시오. 코드를 통해 확인할 수 없는 연결은 표시해 두십시오. 흐름을 실행하거나, 외부 서비스를 호출하거나, 파일을 편집하지 마십시오.

[저장소 영역]에서 [기능]을 구현할 방법을 계획하십시오. 예상되는 동작은 [요구사항]이며, 다음 영역은 변경되어서는 안 됩니다: [제약 조건]. 관련 코드와 기존 테스트를 검토하십시오. 변경이 필요한 파일, 구현 순서, 호환성 또는 데이터 마이그레이션 관련 위험 요소를 파악하십시오. 각 요구사항을 제안된 테스트나 기타 검증 단계에 매핑하십시오. 해결되지 않은 질문과 가정은 별도로 목록으로 나열하십시오. 아직 기능을 구현하지 마십시오. 검토를 위해 플랜을 제출해 주십시오.

[사용자 및 사용 사례]를 위해 [간략한 설명]을 구축하고자 합니다. 먼저 [관련 파일 또는 요구사항]을 읽은 후, AskUserQuestion을 사용하여 구현에 중대한 영향을 미칠 수 있는 결정 사항을 명확히 하십시오. 경계 사례, 데이터 처리, 권한, 예상되는 UI 동작, 그리고 상충되는 요소들에 집중하십시오. 제공된 맥락에서 이미 답이 나온 질문은 하지 마십시오. 키 결정 사항이 해결되면, 요구사항, 승인 기준, 제약 조건 및 범위 외 항목을 포함하는 사양 초안을 작성하십시오. 남아 있는 가정은 모두 표시해 두십시오. [사양 경로]에 저장하기 전에 사양 초안을 저에게 보여주십시오. 또한 승인 없이 기존 파일을 덮어쓰지 마십시오.

[기능, 컴포넌트 또는 인터페이스]를 [현재 동작]에서 [제안된 동작]으로 변경할 경우의 영향을 평가하십시오. [저장소 또는 디렉터리 범위] 내에서 해당 정의, 직접 호출자, 임포트 및 관련 테스트를 검색하십시오. 변경이 필요할 것으로 예상되는 파일을 목록으로 작성하고, 가능한 경우 파일 및 줄 번호를 참조하여 각 파일이 어떻게 영향을 받을 수 있는지 설명하십시오. 동적으로 해결되는 호출, 외부 소비자, 또는 확인할 수 없는 기타 의존성을 표시하십시오. 구현 전에 해결해야 할 호환성 문제를 파악하십시오. 파일을 수정하지 말고, 영향 평가 결과를 제출한 후 제 검토를 기다리십시오.

[파일 또는 페이지]에 [기능]을 다음과 같은 동작으로 추가하십시오: [수락 기준]. [기존 구현]을 검토하고, 데이터 가져오기, 오류 처리, 구성 요소 구성에 있어 해당 관례를 따르십시오. 프로젝트에 이미 설치된 라이브러리만 사용하십시오. 변경 사항은 [범위] 내에서만 유지하고 [기존 동작 또는 공개 인터페이스]를 보존하십시오. 수용 기준에 대한 테스트를 추가하거나 업데이트하십시오. [테스트 명령어]와 [타입 검사 또는 린트 명령어]를 실행한 후, 변경된 파일, 결과 및 완료하지 못한 검사를 보고하십시오. 기존 패턴이 요구 사항과 충돌하는 경우, 진행하기 전에 해당 충돌에 대해 설명하십시오.

[요구 사항]을 충족하도록 [파일]에 [기능 이름]을 구현하십시오. [정상 사례], [경계 사례], [잘못된 입력 시 동작]을 모두 다루십시오. 먼저 [관련 테스트 명령어]를 실행하고 기존에 실패한 항목이 있으면 보고하십시오. 요청된 동작에 대한 테스트를 작성한 후, 구현 전에 테스트를 실행하십시오. 새로운 테스트가 예상된 이유로 실패하는지 확인하십시오. 기능을 구현하고 테스트를 다시 실행하십시오. 테스트를 통과시키기 위해 어설션을 약화시키거나, 테스트를 건너뛰거나, 예상 동작을 변경해서는 안 됩니다. 요구 사항이 기존 테스트와 상충될 경우, 작업을 중단하고 상충되는 점을 설명하십시오. 변경 전후의 결과를 보여주십시오.

프로젝트의 기존 컴포넌트와 스타일을 사용하여 [컴포넌트 또는 페이지]에 첨부 파일로 제공된 디자인을 구현하십시오. [필수 동작]을 유지하고 [범위] 외부의 변경은 피하십시오. [구성된 브라우저 또는 스크린샷 도구]를 사용하여 [테스트 데이터 및 UI 상태]가 적용된 [로컬 경로]를 [뷰포트 크기]로 캡처하십시오. 도구나 애플리케이션을 사용할 수 없는 경우, 시각적 확인을 했다고 주장하기보다는 필요한 사항을 보고하십시오. 캡처한 내용을 참조 자료와 비교할 때 [레이아웃, 스페이스, 타이포그래피 또는 기타 승인 기준]에 중점을 두십시오. 최대 [번호]까지 수정 작업을 수행한 후, 남아 있는 차이점을 보고하십시오. 참조 이미지를 수정하지 마십시오. [관련 컴포넌트 테스트]와 [타입 체크 또는 빌드 명령어]를 실행하십시오. 요약본에 캡처한 스크린샷과 실제 검사 결과를 포함시키십시오.

사용자가 [트리거 또는 입력] 시 [증상]을 경험합니다. 예상되는 동작은 [예상 결과]입니다. 먼저 [폴더, 기능 또는 흐름]과 관련 테스트를 검토하십시오. 보고된 동작을 재현하는 실패하는 테스트를 작성하십시오. 재현할 수 없는 경우, 구현을 변경하기 전에 무엇을 확인했는지, 어떤 정보가 부족한지 설명하십시오. 재현에 성공하면 [반드시 유지되어야 하는 동작]을 변경하지 않고 원인을 수정하십시오. 새로운 테스트와 [관련 테스트 명령어]를 실행하십시오. 수정 전의 실패 결과, 수정 후의 결과, 그리고 남아 있는 실패 사항을 모두 표시하십시오.

[빌드 명령어]가 [로컬 또는 CI 환경]에서 다음과 같은 출력([정제된 오류 로그])과 함께 실패합니다. 관련 코드와 구성을 검토하여 원인을 파악하십시오. 로컬에서 오류가 재현되지 않는 경우, 환경이나 의존성 차이를 확인하십시오. 원인을 해결할 수 있는 최소한의 변경만 적용하십시오. 단순히 빌드가 통과되도록 하기 위해 검사를 비활성화하거나, 오류를 억제하거나, 테스트를 건너뛰거나, 컴파일러 설정을 완화해서는 안 됩니다. 변경 후 빌드를 다시 실행하십시오. [번호]번의 수정 시도 후에도 여전히 실패한다면, 작업을 중단하고 시도한 내용, 현재 오류, 다음 진단 단계를 보고하십시오. 원인을 요약하고 실제 빌드 결과를 포함하십시오.

수정안을 제안하기 전에 버그의 범위를 좁히는 데 도움을 주세요. 관찰된 현상: [무슨 일이 일어나는지] 예상된 현상: [무슨 일이 일어나야 하는지] 발생 시점: [조건 또는 빈도] 시도해 본 방법: [단계 및 결과] 가능한 원인들을 가장 잘 구분할 수 있는 질문을 골라 한 번에 한 가지 질문만 하세요. 제공된 정보로 이미 답이 나온 질문은 반복하지 마세요. 충분한 증거가 확보되면, 가장 유력한 설명, 여전히 불확실한 점, 그리고 이를 확인하거나 배제할 수 있는 최소한의 테스트를 요약하세요. 아직 파일을 편집하지 마세요.

서브에이전트를 사용하여 [승인된 플랜 또는 요구사항 파일]과 비교하여 [베이스와 비교한 diff 또는 브랜치]를 검토하십시오. 요구사항이 누락되었거나 모호한 경우, 완전성 평가에 앞서 이를 보고하십시오. 각 요구 사항이 구현되었는지, 관련 경계 사례에 대한 테스트가 있는지, 변경 사항이 합의된 범위를 벗어나지 않는지 확인하십시오. 필요한 경우 주변 코드를 검토하여 diff를 파악하십시오. 정확성 문제와 충족되지 않은 요구 사항에 대해서는 파일 및 줄 번호 참조, 그 영향, 그리고 각 발견 사항을 뒷받침하는 증거를 함께 보고하십시오. 확인된 문제와 미해결 사항을 구분하십시오. 할당량을 채우기 위해 발견 사항을 임의로 만들거나 관련 없는 스타일 선호 사항을 포함하지 마십시오. 파일을 편집하지 마십시오.

[파일 또는 diff]를 검토하여 인젝션 위험, 누락된 권한 확인, 노출된 비밀 정보, 사용자 입력의 안전하지 않은 처리 여부를 확인하십시오. 발견 사항을 보고하기 전에 관련 호출자와 유효성 검사 로직을 면밀히 검토하십시오. 각 문제에 대해 영향을 받는 파일과 줄 번호, 문제가 트리거되기 위한 조건, 예상되는 영향, 그리고 권장 수정 사항을 파악하십시오. 확인된 취약 경로와 추가 테스트가 필요한 우려 사항을 구분하십시오. 보고서에 비밀값을 재현하거나, 파일을 수정하거나, 실제 서비스 환경에서 테스트를 수행하지 마십시오. 검토한 영역과 범위에서 제외된 부분을 명확히 명시하십시오.

[수락 기준]에 따라 완료된 변경 사항을 어떻게 검증했는지 요약하십시오. 각 기준에 대해 수행한 검사, 해당되는 경우 정확한 명령어, 그리고 관찰된 결과를 목록으로 나열하십시오. 기밀 정보와 민감한 데이터는 가린 상태로 관련 출력을 포함하십시오. 기존에 존재하던 오류는 별도로 명시하십시오. 통과한 검사, 실패한 검사, 실행되지 않은 검사를 명확히 구분하십시오. 건너뛴 검사나 검증 범위의 한도에 대해서는 설명하십시오. 일부 기준이 확인되지 않은 경우, 변경 사항 전체가 검증된 것으로 기술하지 마십시오.

[파일 또는 모듈]을 [대형 기능 분할이나 중첩된 콜백 제거와 같은 구체적인 목표]에 맞춰 리팩토링하십시오. 공개 인터페이스, 반환 값, 오류 처리 방식 및 부수 효과를 유지하십시오. 편집 전에 [관련 테스트 명령어]를 실행하여 기준선을 설정하십시오. 테스트가 실패할 경우, 진행하기 전에 실패 사항을 보고하십시오. 기존 테스트가 다루지 않는 동작을 파악하고, 필요한 곳에 집중적인 테스트를 추가하십시오. 관련 없는 변경 사항이나 새로운 의존성을 추가하지 않고 리팩토링을 수행하십시오. 구현을 맞추기 위해 기존 어설션을 약화시키지 마십시오. 테스트와 [타입 체크 또는 린트 명령어]를 다시 실행하십시오. 변경 전후의 결과를 제시하고, 구조적 변경 사항을 요약하며, 검증할 수 없었던 동작이 있다면 이를 표시하십시오.

생성된 파일과 벤더 파일을 제외하고, [디렉터리 범위] 내에서 [구형 API 또는 라이브러리]의 사용처를 찾으십시오. 영향을 받는 파일과 마이그레이션 과정에서 변경될 수 있는 공유 구성 또는 의존성을 목록으로 작성하십시오. [마이그레이션 가이드 또는 기존 예시]를 활용하여 [신규 API 또는 버전]으로의 시범 마이그레이션을 진행할 대표적인 파일 3개를 제안하십시오. 해당 파일을 선택한 이유를 설명하고, 필요한 동작 변경 사항을 표시하십시오. 편집하기 전에 제 승인을 기다려 주십시오. 승인 후에는 시범 파일과 명시적으로 승인된 공유 의존성만 마이그레이션하십시오. [관련 테스트]와 [빌드 또는 타입 체크 명령어]를 실행하십시오. 마이그레이션을 다른 파일로 확장하지 마십시오. 차이점(diff), 테스트 결과, 호환성 문제, 그리고 마이그레이션 방식에 필요한 변경 사항을 보고하십시오. 나머지 파일을 진행하기 전에 검토를 위해 중단하십시오.

[기능 또는 수정 사항]에 대한 현재 브랜치, Git 상태, diff를 검토하세요. 이 변경 사항에 해당하는 파일을 식별하고, 관련이 없거나 추적되지 않는 파일은 별도로 목록으로 나열하세요. 최근 10개의 커밋 형식을 따르는 커밋 메시지를 초안으로 작성하세요. 변경된 내용, 변경 이유, 실제로 실행된 테스트, 남아 있는 제한 사항 등을 포함하는 풀 리퀘스트 설명을 준비하세요. 무엇이든 스테이징하거나 게시하기 전에 제안된 파일 목록, 커밋 메시지, PR 설명을 보여주세요. 제 승인을 기다려 주세요. 승인 후에는 합의된 파일만 스테이징하고, [기능 브랜치]에 커밋한 뒤 [원격 저장소]로 푸시하고, [기본 브랜치]를 대상으로 풀 리퀘스트를 생성하세요. 기존 커밋을 수정하거나, 강제 푸시하거나, 병합하지 마세요. 커밋 해시와 PR 링크를 회신해 주세요.

[모듈]을 대상으로 [프로젝트에 합류하는 백엔드 엔지니어와 같은 독자]를 위한 README 섹션을 작성하세요. 필수 전제 조건, 설정 방법, 가장 자주 사용할 세 가지 명령어, 그리고 코드나 기존 문서에서 지원하는 일반적인 오류 사항을 포함시키세요. [패키지 스크립트, Makefile, CLI 도움말 또는 CI 구성]을 참조하여 명령어 이름과 옵션을 확인하세요. 확인할 수 없는 항목은 표시해 두세요. 가능한 경우 [테스트 환경]에서 안전한 로컬 명령어를 테스트하십시오. 의존성을 설치하거나, 파일을 삭제하거나, 데이터를 마이그레이션하거나, 배포하거나, 외부 서비스에 액세스하는 명령어를 실행하기 전에 그 영향을 설명하고 승인을 요청하십시오. 성공적으로 실행한 명령어와 구성이나 문서만 대조하여 확인한 명령어를 명확히 구분하십시오. [문서 경로]를 편집하기 전에 제안된 README 섹션을 보여주고, 관련 없는 콘텐츠는 그대로 유지하십시오.

저장소의 현재 구조, 스크립트 및 관례에 따라 [CLAUDE.md 파일 경로]를 검토하십시오. 아직 파일을 편집하지 마십시오. 구식 지침, 중복 내용, 모순된 내용, 그리고 코드에서 신뢰할 수 있게 추론할 수 있는 규칙을 파악하십시오. 단순히 파일 길이를 줄이기 위해 지침을 삭제하기보다는, 제거를 제안하는 각 항목에 대해 그 이유를 설명하십시오. 누락된 빌드 또는 테스트 명령어는 프로젝트 스크립트, Makefile, CI 구성 또는 기존 문서에서 확인할 수 있는 경우에만 제안하십시오. 추가하는 내용마다 출처를 명시하십시오. 중요한 프로젝트 제약 조건을 유지하는 수정안(diff)을 제출하십시오. 스킬이나 경로 범위 규칙에 더 잘 어울리는 작업별 지침은 표시해 두고, 승인을 받은 후에 변경 사항을 적용하십시오.

[파일 패턴]에 대한 편집(Edit) 또는 작성(Write) 변경 후 [기존 포맷터 명령어]를 실행하는 Claude Code 명령어 후크를 제안하십시오. 먼저 claude/settings.json의 기존 설정과 포맷터 설정을 검토하십시오. 설치된 Claude Code 버전에 적합한 PostToolUse 설정을 사용하십시오. 영향을 받는 파일만 형식하고, 경로를 안전하게 처리하며, [생성된 파일이나 기타 제외된 경로]는 제외하십시오. 의존성을 설치하거나 기존 훅을 대체하지 마십시오. 제안된 설정의 차이점을 표시하고, 포맷터 오류가 어떻게 보고될지 설명하십시오. 적용하기 전에 승인을 기다리십시오. 승인 후, 프로젝트 내의 임시 파일을 사용하여 테스트하고 결과를 보고하십시오. 쉘 명령어를 통해 이루어진 변경 사항을 포함하여, 어떤 편집 경로를 처리하고 어떤 경로는 처리하지 않는지 명시하십시오.

[tool] –help 및 [작업]과 관련된 하위 명령어의 도움말을 확인하십시오. tool이 없는 경우 설치하지 말고, 대신 해당 필수 구성 요소를 보고하십시오. 작업을 완료하는 데 필요한 정확한 명령어를 제안하십시오. 명령어의 입력값, 출력값, 그리고 파일을 작성하는지, 원격 리소스를 변경하는지, 또는 자격 증명을 사용하는지 여부를 설명하십시오. tool에 드라이런(dry-run) 옵션이 문서화되어 있다면 이를 포함하십시오. 누락된 구성이나 권한이 있으면 표시하고, 리소스 이름이나 대상 위치를 추측하기보다는 명확한 설명을 요청하십시오. 작업 명령어를 실행하기 전에 승인을 기다리십시오. 승인 후에는 합의된 명령어만 실행하고, 오류나 완료되지 않은 단계를 포함하여 실제 결과를 보고하십시오.

[invoice ID 또는 일치하는 키]를 사용하여 [invoices.csv]와 [결제.csv]를 비교하십시오. 소스 파일을 수정하지 마십시오. 다음 규칙을 적용하십시오: [통화 및 반올림 허용 오차], [부분 결제 배분], [환불, 크레딧 및 초과 납부 처리]. 규칙이 누락되었거나 일치 여부가 모호한 경우, 결제를 자동으로 할당하지 말고 표시해 두십시오. 소스 행 ID를 유지하십시오. 각 청구서에 대해 청구 금액, 적용된 결제 내역 및 잔액을 표시하십시오. 중복 ID, 일치하지 않는 청구서, 일치하지 않는 결제 내역, 허용 오차 범위를 벗어난 잔액을 보고하십시오. 청구서 및 결제 합계를 별도로 조정하십시오. 각 원본 행을 중복 계산 없이 반영하십시오. 결제가 여러 청구서에 분할된 경우, 각 할당 내역을 표시하고 할당 총액이 결제 금액을 초과하지 않는지 확인하십시오. 결과를 [새로운 출력 경로]에 기록하고 검토가 필요한 예외 사항을 요약하십시오.

[시간대]와 [날짜 열]을 사용하여 [시작 날짜 및 시간(포함)]부터 [종료 날짜 및 시간(제외)]까지의 [export.csv]를 요약하는 스크립트를 작성하십시오. 레코드를 [범주 규칙]에 따라 그룹화하고 [필수 메트릭]을 계산하십시오. [규칙]에 따라 중복 ID와 누락된 값을 처리하십시오. 입력 파일을 수정하지 마십시오. [정확한 입력 파일]에서 스크립트를 실행하십시오. 포함된 행 수와 제외된 행 수, 카테고리 합계, 분류할 수 없었던 레코드를 보고하십시오. [세 가지 카테고리]에 대한 결과를 [참조 파일]에 있는 독립적으로 확인된 집계 수와 비교하십시오. 해당 집계 수를 확인할 수 없는 경우, 독립적인 검증이 아직 완료되지 않았다고 명시하십시오. 불일치 사항을 표시하고 보고서를 [새로운 출력 경로]에 저장하십시오.

[지정된 파일 또는 폴더]를 읽고, [대상 독자]를 위해 [질문 또는 주제]를 다루는 [문서 유형 및 분량]의 초안을 작성하십시오. 사실에 근거한 각 주장은 가능한 경우 파일명과 페이지, 섹션 또는 줄 번호를 인용하여 지원하십시오. 직접 인용과 의역은 명확히 구분하고, 제안서나 구식 문서를 확정된 최신 결정으로 간주하지 마십시오. 상충되는 출처, 누락된 정보, 확인할 수 없는 주장은 별도로 표시하십시오. 추측으로 빈 부분을 채우거나 원본 파일을 편집하지 마십시오. 참고 문헌과 검토자가 확인해야 할 미해결 질문 목록을 포함하여 초안을 제출하십시오.

템플릿을 적용하려면, 템플릿 내의 자리 표시자를 프로젝트의 세부 정보로 대체하고, 변경을 적용하기 전에 Claude가 수행해야 할 작업을 결정하세요. 다음 단계를 따라 요청을 준비하고 결과를 검토하세요.

작고 명확하게 정의된 변경 사항의 경우, Claude에게 직접 구현해 달라고 요청할 수 있습니다. 익숙하지 않은 코드, 여러 파일에 걸친 변경 사항, 또는 명확히 정의되지 않은 요구 사항의 경우에는 먼저 플랜을 세우는 것부터 시작하세요.

'플랜(Plan)' 모드가 나타날 때까지 Shift+Tab을 누르거나, claude --permission-mode plan 명령어로 Claude Code를 실행하세요. 이 모드에서 Claude는 소스 코드를 편집하지 않고도 파일을 검사하고 읽기 전용 명령어를 실행할 수 있습니다. 구현을 승인하기 전에 제안된 파일, 의존성 및 테스트를 검토하세요. Ctrl+G를 눌러 에디터에서 제안된 플랜을 열어보세요.

Claude가 작업을 이해하는 데 필요한 증거 자료(파일 참조, 정제된 오류 로그, 스크린샷 또는 요구사항 문서 등)를 제공하세요. @ 기호 뒤에 파일 경로를 입력하여 해당 파일의 콘텐츠를 포함시킬 수 있습니다.

가장 작은 유용한 소스 집합을 선택하세요. 전체 로그나 디렉터리를 포함하면 관련 없는 내용이 추가되어 컨텍스트를 낭비할 수 있습니다. 로그를 공유하기 전에 인증 정보와 민감한 데이터를 제거하고, 제공한 문서 URL을 Claude가 불러올 수 있는 tools를 갖추고 있는지 확인하세요.

예시: `cat 오류.log | claude -p "이 오류를 설명해 주세요"`는 비대화형 요청으로 로그를 제출합니다. 파일 콘텐츠를 확인한 후에만 이 명령을 사용하십시오. 이것이 바로 문맥 기반 AI의 실질적인 가치입니다. 즉, 모델에 해당 작업과 관련된 정보를 제공하는 것입니다.

기능을 추가할 때는 저장소에서 유사한 컴포넌트나 기능을 찾아보세요. API 클라이언트, 유효성 검사 로직, 오류 처리, 테스트 구조 등 Claude가 따라야 할 규칙을 알려주세요.

“@src/widgets/Weather.tsx가 데이터를 가져오고 캐시하는 방식을 따르세요”라는 지침은 Claude에게 구체적인 참조 기준을 제공합니다. 또한 새로운 기능에 필요한 차이점을 명시하여 더 이상 적합하지 않은 동작이 복사되지 않도록 하세요. 이러한 규칙은 팀의 소프트웨어 개발 워크플로우를 반영해야 합니다.

코드 변경의 경우, 관련 테스트, 빌드 또는 린트 명령어와 해당 명령어가 확인해야 할 동작을 명시하십시오. 연구의 경우, 파일 참조 정보나 커밋 ID를 요청하십시오. UI 작업의 경우, 참조 이미지와 동일한 뷰포트에서 구현 내용을 캡처할 수 있는 설정된 방법을 제공하십시오.

Claude에게 실패 사항 및 건너뛴 검사 항목을 포함하여 실제로 무엇을 검사했는지 보고하도록 요청하세요. 해당 증거가 요구 사항을 충족하는지 검토하십시오. 빌드가 통과되었다고 해서 요청된 모든 동작이 정상적으로 작동한다는 것을 보장하지는 않습니다.

더 긴 작업의 경우, Claude Code는 /goal 조건과 Stop 후크 기능도 제공합니다. 목표 평가기는 파일을 별도로 검사하거나 테스트를 실행하는 대신, 대화 중에 드러난 증거를 바탕으로 평가합니다. 구성된 Stop 후크는 작업 완료를 차단할 수 있지만, 반복적인 차단에는 한도가 있습니다. 이 두 가지 모두 적절한 테스트와 사람의 검토를 대체할 수는 없습니다.

반복적인 수정으로도 문제가 해결되지 않는다면, 잠시 멈추고 초기 요청에서 명확하지 않았던 부분이 무엇인지 파악하세요. 대화를 종료하기 전에 유용한 발견 사항, 현재 Git 상태, 남은 일을 저장해 두세요.

Anthropic의 최고의 실행 방식 가이드에 따르면, 동일한 문제에 대해 두 번의 수정 시도가 실패한 후에는 처음부터 다시 시작하는 것이 좋습니다. /clear 명령어를 사용한 후, 배운 내용을 반영하여 수정된 프롬프트를 입력하세요. 대화를 초기화해도 파일 변경 사항은 취소되지 않습니다.

실행 중인 응답을 중단하려면 Esc 키를 누르세요. 프롬프트 입력이 비어 있는 상태에서 Esc 키를 두 번 누르면 되감기 메뉴가 열리며, 복원할 항목을 선택할 수 있습니다. 되감기 기능은 모든 외부 영향을 되돌리지는 않으므로, 데이터베이스나 원격 서비스의 변경 사항에 대해서는 Git 체크포인트와 별도의 복구 절차를 사용하세요.

프로젝트 전반에 적용되는 지침은 `CLAUDE.md`에, 반복 가능한 절차는 스킬에, 특정 파일에 대한 지침은 경로 범위 규칙에 저장하세요. 편집 후 포맷터를 실행하는 등 특정 이벤트와 연동된 작업을 수행하려면 훅을 활용하세요.

지침이 적용되어야 할 시점에 따라 선택하세요:

일반적으로 한 기능에 대한 요구사항은 CLAUDE.md 파일이 아닌 해당 작업 프롬프트나 사양서에 포함되어야 합니다. 프로젝트 전체에 적용되는 파일에 임시 지침을 추가하면, 저장소 전체에 적용되어야 하는 관례와 이를 구별하기가 더 어려워집니다.

예시로, 프로젝트의 테스트 명령어는 CLAUDE.md 파일에 포함하고, 구성 요소별 규칙은 경로 범위 규칙에 지정하며, 반복적으로 수행되는 검토 절차는 스킬로 저장하세요. 다른 프로젝트 문서와 마찬가지로, 명령어나 규칙이 변경될 때마다 이러한 파일을 검토하십시오.

프롬프트, CLAUDE.md 및 스킬은 Claude의 동작을 안내할 뿐, 지시가 반드시 이행될 것을 보장하지는 않습니다. 훅은 구성된 이벤트 발생 시 검사를 실행할 수 있지만, 그 신뢰성은 훅의 유형과 구현 방식에 따라 달라집니다.

명령어 훅은 스크립트를 실행합니다. 프롬프트 또는 에이전트 훅은 모델의 판단에 의존합니다. Anthropic의 최고의 실행 방식 가이드에서 설명하듯이, “프롬프트나 에이전트 훅은 다른 모델에게 결정을 요청하므로, 이 역시 결정론적이지 않습니다.” 반드시 적용되어야 하는 규칙의 경우, 적절한 권한 제어 기능을 사용하고, 오류 처리 방식을 포함하여 관련 명령어 또는 HTTP 훅을 테스트하십시오.

맞춤형 하위 에이전트는 반복적인 일을 체계화하는 또 다른 방법입니다. 별도의 검토 역할이나 도구 범위가 필요한 경우, 모든 전문가 지침을 메인 세션에 추가하는 대신 in.claude/agents/에서 전문가를 정의하세요. 일에 가장 적합한 Claude 모델 및 AI 에이전트 유형에 대한 이 가이드들은 추가적인 맥락을 제공합니다.

팀에서 여러 AI 제품에 걸쳐 프롬프트를 관리하고 있다면, Claude Code 외에도 라이브러리를 관리할 수 있는 다음 프롬프트 엔지니어링 tools를 확인해 보세요.

세션에서 불완전하거나 부적절한 결과가 도출된 경우, 요청 과정에서 중요한 결정 사항이 미해결로 남아 있는지 확인하십시오. 다음의 다섯 가지 실수는 일의 진단 및 검토를 더욱 어렵게 만들 수 있습니다.

“저장소 조사” 명령은 Claude에게 어떤 파일이 중요한지, 언제 중단해야 하는지에 대한 구체적인 지침을 거의 제공하지 않습니다. 프롬프트로 인해 발생한 문제에 대한 답변 없이 광범위한 요약만 제공받을 수 있습니다.

이해해야 할 동작이나 결정 사항에 이름을 붙이고, 시작 위치를 파악한 다음, 예상되는 결과를 정의하세요. 예시: “이 엔드포인트가 권한을 확인하는 과정을 추적하고 관련 기능을 제시하세요.” 서브에이전트를 사용하는 경우, 동일한 무제한 검색을 위임하기보다는 각 서브에이전트에 범위가 제한된 질문을 부여하세요.

기능, 관련 없는 버그, 문서화 요청 사이를 오가다 보면 대화에 현재 작업과 관련이 없는 맥락이 남아 있게 됩니다. “그 파일”이나 “이전의 접근 방식”과 같은 언급은 모호해집니다.

서로 관련 없는 작업은 별도의 세션을 사용하세요. 여러 세션에서 저장소를 편집할 경우, 동일한 작업 디렉터리를 수정하지 않도록 별도의 Git 작업 트리를 사용하세요. 잠깐 짚고 넘어갈 점으로, Claude Code의 /btw 명령어를 사용하면 해당 대화 내용이 메인 대화 기록에 포함되지 않습니다.

특정 기능이 제대로 작동하지 않더라도 빌드는 통과될 수 있습니다. 테스트 스위트는 오류가 발생하는 입력값을 한 번도 테스트하지 않았기 때문에 통과될 수도 있습니다. Claude에게 “테스트를 실행해 달라”고 요청한다고 해서, 해당 테스트가 어떤 요구 사항을 검증하는지 명확히 알 수는 없습니다.

수락 기준을 구체적인 점검 항목에 매핑하세요. 버그 수정 시, 변경 전에는 재현 테스트가 실패했으나 변경 후에는 통과했다는 증거를 요청하세요. 단 한 번의 명령어 실행이 성공했다고 해서 전체 변경 사항이 검증된 것으로 간주하지 말고, 테스트되지 않은 기준은 계속 가시성 높은 곳에 두세요.

점차 확장되는 CLAUDE.md 파일에는 구식 명령어, 중복된 규칙, 특정 작업의 요구 사항과 상충되는 지침이 포함될 수 있습니다. 표현을 더 강력하게 수정한다고 해서 이러한 상충을 해결할 수는 없습니다.

현재 리포지토리를 기준으로 파일을 검토하십시오. 더 이상 사용되지 않는 지침을 제거하고, 상충되는 규칙을 명확히 하며, 적용 범위가 좁은 지침은 경로 범위 규칙이나 기술 항목으로 이동시키십시오. 요구 사항을 반드시 준수해야 하는 경우, 반복적인 알림에 의존하기보다는 적절한 제어 기능을 구성하고 테스트하십시오.

코드 검토를 통해 실제 결함, 불확실한 문제점, 선택적 리팩토링 제안이 함께 도출될 수 있습니다. 모든 제안을 적용하면 요청된 동작은 개선되지 않은 채 변경 범위가 확대될 수 있습니다.

각 발견 사항의 근거와 영향을 확인하십시오. 정확성 문제와 충족되지 않은 요구 사항을 우선순위로 삼고, 불확실한 주장을 조사하며, 현재 diff에는 관련 없는 개선 사항을 포함하지 마십시오. 검토자는 근거가 그 결론을 지원할 경우, 조치할 만한 발견 사항이 없다고 보고할 수 있어야 합니다.

템플릿을 적용하려면, 템플릿 내의 자리 표시자를 프로젝트의 세부 정보로 대체하고, 변경을 적용하기 전에 Claude가 수행해야 할 작업을 결정하세요. 다음 단계를 따라 요청을 준비하고 결과를 검토하세요.

작고 명확하게 정의된 변경 사항의 경우, Claude에게 직접 구현해 달라고 요청할 수 있습니다. 익숙하지 않은 코드, 여러 파일에 걸친 변경 사항, 또는 명확히 정의되지 않은 요구 사항의 경우에는 먼저 플랜을 세우는 것부터 시작하세요.

'플랜(Plan)' 모드가 나타날 때까지 Shift+Tab을 누르거나, claude --permission-mode plan 명령어로 Claude Code를 실행하세요. 이 모드에서 Claude는 소스 코드를 편집하지 않고도 파일을 검사하고 읽기 전용 명령어를 실행할 수 있습니다. 구현을 승인하기 전에 제안된 파일, 의존성 및 테스트를 검토하세요. Ctrl+G를 눌러 에디터에서 제안된 플랜을 열어보세요.

Claude가 작업을 이해하는 데 필요한 증거 자료(파일 참조, 정제된 오류 로그, 스크린샷 또는 요구사항 문서 등)를 제공하세요. @ 기호 뒤에 파일 경로를 입력하여 해당 파일의 콘텐츠를 포함시킬 수 있습니다.

가장 작은 유용한 소스 집합을 선택하세요. 전체 로그나 디렉터리를 포함하면 관련 없는 내용이 추가되어 컨텍스트를 낭비할 수 있습니다. 로그를 공유하기 전에 인증 정보와 민감한 데이터를 제거하고, 제공한 문서 URL을 Claude가 불러올 수 있는 tools를 갖추고 있는지 확인하세요.

예를 들어, `cat 오류.log | claude -p "이 오류를 설명해 주세요"`는 비대화형 요청으로 로그를 제출합니다. 파일 콘텐츠를 확인한 후에만 이 명령을 사용하십시오. 이것이 바로 문맥 기반 AI의 실질적인 가치입니다. 즉, 모델에 해당 작업과 관련된 정보를 제공하는 것입니다.

기능을 추가할 때는 저장소에서 유사한 컴포넌트나 기능을 찾아보세요. API 클라이언트, 유효성 검사 로직, 오류 처리, 테스트 구조 등 Claude가 따라야 할 규칙을 알려주세요.

“@src/widgets/Weather.tsx가 데이터를 가져오고 캐시하는 방식을 따르세요”라는 지침은 Claude에게 구체적인 참조 기준을 제공합니다. 또한 새로운 기능에 필요한 차이점을 명시하여 더 이상 적합하지 않은 동작이 복사되지 않도록 하세요. 이러한 규칙은 팀의 소프트웨어 개발 워크플로우를 반영해야 합니다.

코드 변경의 경우, 관련 테스트, 빌드 또는 린트 명령어와 해당 명령어가 확인해야 할 동작을 명시하십시오. 연구의 경우, 파일 참조 정보나 커밋 ID를 요청하십시오. UI 작업의 경우, 참조 이미지와 동일한 뷰포트에서 구현 내용을 캡처할 수 있는 설정된 방법을 제공하십시오.

Claude에게 실패 사항 및 건너뛴 검사 항목을 포함하여 실제로 무엇을 검사했는지 보고하도록 요청하세요. 해당 증거가 요구 사항을 충족하는지 검토하십시오. 빌드가 통과되었다고 해서 요청된 모든 동작이 정상적으로 작동한다는 것을 보장하지는 않습니다.

더 긴 작업의 경우, Claude Code는 /goal 조건과 Stop 후크 기능도 제공합니다. 목표 평가기는 파일을 별도로 검사하거나 테스트를 실행하는 대신, 대화 중에 드러난 증거를 바탕으로 평가합니다. 구성된 Stop 후크는 작업 완료를 차단할 수 있지만, 반복적인 차단에는 한도가 있습니다. 이 두 가지 모두 적절한 테스트와 사람의 검토를 대체할 수는 없습니다.

반복적인 수정으로도 문제가 해결되지 않는다면, 잠시 멈추고 초기 요청에서 명확하지 않았던 부분이 무엇인지 파악하세요. 대화를 삭제하기 전에 유용한 발견 사항, 현재 Git 상태, 그리고 남은 일을 저장해 두세요.

Anthropic의 최고의 실행 방식 가이드에 따르면, 동일한 문제에 대해 두 번의 수정 시도가 실패한 후에는 처음부터 다시 시작하는 것이 좋습니다. /clear 명령어를 사용한 후, 배운 내용을 반영하여 수정된 프롬프트를 입력하세요. 대화를 초기화하더라도 파일 변경 사항은 취소되지 않습니다.

실행 중인 응답을 중단하려면 Esc 키를 누르세요. 프롬프트 입력이 비어 있는 상태에서 Esc 키를 두 번 누르면 되감기 메뉴가 열리며, 복원할 항목을 선택할 수 있습니다. 되감기 기능은 모든 외부 영향을 되돌리지는 않으므로, 데이터베이스나 원격 서비스의 변경 사항에 대해서는 Git 체크포인트와 별도의 복구 절차를 사용하세요.

프로젝트 전반에 적용되는 지침은 `CLAUDE.md`에, 반복 가능한 절차는 스킬에, 특정 파일에 대한 지침은 경로 범위 규칙에 저장하세요. 편집 후 포맷터를 실행하는 등 특정 이벤트와 연동된 작업을 수행하려면 훅을 활용하세요.

지침이 적용되어야 할 시점에 따라 선택하세요:

일반적으로 한 기능에 대한 요구사항은 CLAUDE.md 파일이 아닌 해당 작업 프롬프트나 사양서에 포함되어야 합니다. 프로젝트 전체에 적용되는 파일에 임시 지침을 추가하면, 리포지토리 전체에 적용되어야 하는 표준과 이를 구별하기가 더 어려워집니다.

예시로, 프로젝트의 테스트 명령어는 CLAUDE.md 파일에 포함하고, 구성 요소별 규칙은 경로 범위 규칙에 지정하며, 반복적으로 수행되는 검토 절차는 스킬로 저장하세요. 다른 프로젝트 문서와 마찬가지로, 명령어나 규칙이 변경될 때마다 이러한 파일을 검토하십시오.

프롬프트, CLAUDE.md 및 스킬은 Claude의 동작을 안내할 뿐, 지시가 반드시 이행될 것을 보장하지는 않습니다. 훅은 구성된 이벤트 발생 시 검사를 실행할 수 있지만, 그 신뢰성은 훅의 유형과 구현 방식에 따라 달라집니다.

명령어 훅은 스크립트를 실행합니다. 프롬프트 또는 에이전트 훅은 모델의 판단에 의존합니다. Anthropic의 최고의 실행 방식 가이드에서 설명하듯이, “프롬프트나 에이전트 훅은 다른 모델에게 결정을 요청하므로, 이 역시 결정론적이지 않습니다.” 반드시 적용되어야 하는 규칙의 경우, 적절한 권한 제어 기능을 사용하고, 오류 처리 방식을 포함하여 관련 명령어 또는 HTTP 훅을 테스트하십시오.

맞춤형 하위 에이전트는 반복적인 작업을 체계화하는 또 다른 방법입니다. 별도의 검토 역할이나 도구 범위가 필요한 경우, 모든 전문가 지침을 메인 세션에 추가하는 대신 in.claude/agents/에서 전문가를 정의하세요. 일에 가장 적합한 Claude 모델 및 AI 에이전트 유형에 대한 이 가이드들은 추가적인 맥락을 제공합니다.

팀에서 여러 AI 제품에 걸쳐 프롬프트를 관리하고 있다면, Claude Code 외에도 라이브러리를 관리할 수 있는 다음 프롬프트 엔지니어링 tools를 확인해 보세요.

세션에서 불완전하거나 부적절한 결과가 도출된 경우, 요청 과정에서 중요한 결정 사항이 미해결로 남아 있는지 확인하십시오. 다음의 다섯 가지 실수는 문제 진단과 코드 검토를 더욱 어렵게 만들 수 있습니다.

“리포지토리 조사” 명령은 Claude에게 어떤 파일이 중요한지, 언제 중단해야 하는지에 대한 구체적인 지침을 거의 제공하지 않습니다. 요청의 원인이 된 문제에 대한 답변 없이 광범위한 요약만 제공받을 수 있습니다.

이해해야 할 동작이나 결정 사항에 이름을 붙이고, 시작 위치를 파악한 다음, 예상되는 결과를 정의하세요. 예시: “이 엔드포인트가 권한을 확인하는 과정을 추적하고 관련 기능을 제시하세요.” 서브에이전트를 사용하는 경우, 동일한 무제한 검색을 위임하기보다는 각 서브에이전트에 범위가 제한된 질문을 부여하세요.

기능, 관련 없는 버그, 문서화 요청 사이를 오가다 보면 대화에 현재 작업과 관련이 없는 맥락이 남아 있게 됩니다. “그 파일”이나 “이전의 접근 방식”과 같은 언급은 모호해집니다.

서로 관련 없는 작업은 별도의 세션을 사용하세요. 여러 세션에서 리포지토리를 편집할 경우, 동일한 작업 디렉터리를 수정하지 않도록 별도의 Git 작업 트리를 사용하세요. 잠깐 짚고 넘어갈 점으로, Claude Code의 /btw 명령어를 사용하면 해당 대화 내용이 메인 대화 기록에 포함되지 않습니다.

특정 기능이 제대로 작동하지 않더라도 빌드는 통과될 수 있습니다. 테스트 스위트는 오류가 발생하는 입력값을 한 번도 테스트하지 않았기 때문에 통과될 수도 있습니다. Claude에게 “테스트를 실행해 달라”고 요청한다고 해서, 해당 테스트가 어떤 요구 사항을 검증하는지 명확히 알 수는 없습니다.

수락 기준을 구체적인 점검 항목에 매핑하세요. 버그 수정 시, 변경 전에는 재현 테스트가 실패했으나 변경 후에는 통과했다는 증거를 요청하세요. 단 한 번의 명령어 실행이 성공했다고 해서 전체 변경 사항이 검증된 것으로 간주하지 말고, 테스트되지 않은 기준은 계속 가시성 높은 곳에 두세요.

점차 확장되는 CLAUDE.md 파일에는 구식 명령어, 중복된 규칙, 특정 작업의 요구 사항과 상충되는 지침이 포함될 수 있습니다. 표현을 더 강력하게 수정한다고 해서 이러한 상충을 해결할 수는 없습니다.

현재 리포지토리를 기준으로 파일을 검토하십시오. 더 이상 사용되지 않는 지침을 제거하고, 상충되는 규칙을 명확히 하며, 적용 범위가 좁은 지침은 경로 범위 규칙이나 기술 항목으로 이동시키십시오. 요구 사항을 반드시 준수해야 하는 경우, 반복적인 알림에 의존하기보다는 적절한 제어 기능을 구성하고 테스트하십시오.

코드 검토를 통해 실제 결함, 불확실한 문제점, 선택적 리팩토링 제안이 함께 도출될 수 있습니다. 모든 제안을 적용하면 요청된 동작은 개선되지 않은 채 변경 범위가 확대될 수 있습니다.

각 발견 사항의 근거와 영향을 확인하십시오. 정확성 문제와 충족되지 않은 요구 사항을 우선순위로 삼고, 불확실한 주장을 조사하며, 현재 diff에는 관련 없는 개선 사항을 포함하지 마십시오. 검토자는 근거가 그 결론을 지원할 경우, 조치할 만한 발견 사항이 없다고 보고할 수 있어야 합니다.

템플릿을 적용하려면, 템플릿의 자리 표시자를 프로젝트의 세부 정보로 대체하고, 변경을 적용하기 전에 Claude가 수행해야 할 작업을 결정하세요. 다음 단계를 따라 요청을 준비하고 결과를 검토하세요.

작고 명확하게 정의된 변경 사항의 경우, Claude에게 직접 구현해 달라고 요청할 수 있습니다. 익숙하지 않은 코드, 여러 파일에 걸친 변경 사항, 또는 명확히 정의되지 않은 요구 사항의 경우에는 먼저 플랜을 세우는 것부터 시작하세요.

'플랜(Plan)' 모드가 나타날 때까지 Shift+Tab을 누르거나, claude --permission-mode plan 명령어로 Claude Code를 실행하세요. 이 모드에서 Claude는 소스 코드를 편집하지 않고도 파일을 검사하고 읽기 전용 명령어를 실행할 수 있습니다. 구현을 승인하기 전에 제안된 파일, 의존성 및 테스트를 검토하세요. Ctrl+G를 눌러 에디터에서 제안된 플랜을 열어보세요.

Claude가 작업을 이해하는 데 필요한 증거 자료(파일 참조, 정제된 오류 로그, 스크린샷 또는 요구사항 문서 등)를 제공하세요. @ 뒤에 파일 경로를 입력하여 해당 파일의 콘텐츠를 포함시킬 수 있습니다.

가장 작은 유용한 소스 집합을 선택하세요. 전체 로그나 디렉터리를 포함하면 관련 없는 내용이 추가되어 컨텍스트를 소모할 수 있습니다. 로그를 공유하기 전에 인증 정보와 민감한 데이터를 제거하고, 제공한 문서 URL을 Claude가 불러올 수 있는 tools를 갖추고 있는지 확인하세요.

예시: `cat error.log | claude -p "이 오류를 설명해 주세요"`는 비대화형 요청으로 로그를 제출합니다. 파일 콘텐츠를 확인한 후에만 이 명령을 사용하십시오. 이것이 바로 문맥 기반 AI의 실질적인 가치입니다. 즉, 모델에 해당 작업과 관련된 정보를 제공하는 것입니다.

기능을 추가할 때는 저장소에서 유사한 컴포넌트나 기능을 찾아보세요. API 클라이언트, 유효성 검사 로직, 오류 처리, 테스트 구조 등 Claude가 따라야 할 규칙을 알려주세요.

“@src/widgets/Weather.tsx가 데이터를 가져오고 캐시하는 방식을 따르세요”라는 지침은 Claude에게 구체적인 참조 기준을 제공합니다. 또한 새로운 기능에 필요한 차이점을 명시하여 더 이상 적합하지 않은 동작이 복사되지 않도록 하세요. 이러한 규칙은 팀의 소프트웨어 개발 워크플로우를 반영해야 합니다.

코드 변경의 경우, 관련 테스트, 빌드 또는 린트 명령어와 해당 명령어가 확인해야 할 동작을 명시하십시오. 연구의 경우, 파일 참조 정보나 커밋 ID를 요청하십시오. UI 작업의 경우, 참조 이미지와 동일한 뷰포트에서 구현 내용을 캡처할 수 있는 설정된 방법을 제공하십시오.

Claude에게 실패 사항 및 건너뛴 검사 항목을 포함하여 실제로 무엇을 검사했는지 보고하도록 요청하세요. 해당 증거가 요구 사항을 충족하는지 검토하십시오. 빌드가 통과되었다고 해서 요청된 모든 동작이 정상적으로 작동한다는 것을 보장하지는 않습니다.

더 긴 작업의 경우, Claude Code는 /goal 조건과 Stop 후크 기능도 제공합니다. 목표 평가기는 파일을 별도로 검사하거나 테스트를 실행하는 대신, 대화 중에 드러난 증거를 바탕으로 평가합니다. 구성된 Stop 후크는 작업 완료를 차단할 수 있지만, 반복적인 차단에는 한도가 있습니다. 이 두 가지 모두 적절한 테스트와 사람의 검토를 대체할 수는 없습니다.

반복적인 수정으로도 문제가 해결되지 않는다면, 잠시 멈추고 초기 요청에서 명확하지 않았던 부분이 무엇인지 파악하세요. 대화를 종료하기 전에 유용한 발견 사항, 현재 Git 상태, 그리고 남은 일을 저장해 두세요.

Anthropic의 최고의 실행 방식 가이드에 따르면, 동일한 문제에 대해 두 번의 수정 시도가 실패한 후에는 처음부터 다시 시작하는 것이 좋습니다. /clear 명령어를 사용한 후, 배운 내용을 반영한 수정된 프롬프트를 입력하세요. 대화를 초기화해도 파일 변경 사항은 취소되지 않습니다.

실행 중인 응답을 중단하려면 Esc 키를 누르세요. 프롬프트 입력이 비어 있는 상태에서 Esc 키를 두 번 누르면 되감기 메뉴가 열리며, 복원할 항목을 선택할 수 있습니다. 되감기 기능은 모든 외부 영향을 되돌리지는 않으므로, 데이터베이스나 원격 서비스의 변경 사항에 대해서는 Git 체크포인트와 별도의 복구 절차를 사용하세요.

프로젝트 전반에 적용되는 지침은 `CLAUDE.md`에, 반복 가능한 절차는 스킬에, 특정 파일에 대한 지침은 경로 범위 규칙에 저장하세요. 편집 후 포맷터를 실행하는 등 특정 이벤트와 연동된 작업을 수행하려면 훅을 활용하세요.

지침이 적용되어야 할 시점에 따라 선택하세요:

일반적으로 한 기능에 대한 요구사항은 CLAUDE.md 파일이 아닌 해당 작업 프롬프트나 사양서에 포함되어야 합니다. 프로젝트 전체에 적용되는 파일에 임시 지침을 추가하면, 리포지토리 전체에 적용되어야 하는 관례와 이를 구별하기가 더 어려워집니다.

예시로, 프로젝트의 테스트 명령어는 CLAUDE.md 파일에 포함하고, 구성 요소별 규칙은 경로 범위 규칙에 지정하며, 반복적으로 수행되는 검토 절차는 스킬로 저장하세요. 다른 프로젝트 문서와 마찬가지로, 명령어나 규칙이 변경될 때마다 이러한 파일을 검토하십시오.

프롬프트, CLAUDE.md 및 스킬은 Claude의 동작을 안내할 뿐, 지시가 반드시 이행될 것을 보장하지는 않습니다. 훅은 구성된 이벤트 발생 시 검사를 실행할 수 있지만, 그 신뢰성은 훅의 유형과 구현 방식에 따라 달라집니다.

명령어 훅은 스크립트를 실행합니다. 프롬프트 또는 에이전트 훅은 모델의 판단에 의존합니다. Anthropic의 최고의 실행 방식 가이드에서 설명하듯이, “프롬프트나 에이전트 훅은 다른 모델에게 결정을 요청하므로, 이 역시 결정론적이지 않습니다.” 반드시 적용되어야 하는 규칙의 경우, 적절한 권한 제어 기능을 사용하고, 오류 처리 방식을 포함하여 관련 명령어 또는 HTTP 훅을 테스트하십시오.

맞춤형 하위 에이전트는 반복적인 작업을 체계화하는 또 다른 방법입니다. 별도의 검토 역할이나 도구 범위가 필요한 경우, 모든 전문가 지침을 메인 세션에 추가하는 대신 in.claude/agents/에서 전문가를 정의하세요. 일에 가장 적합한 Claude 모델 및 AI 에이전트 유형에 대한 이 가이드들은 추가적인 맥락을 제공합니다.

팀에서 여러 AI 제품에 걸쳐 프롬프트를 관리하고 있다면, Claude Code 외에도 라이브러리를 관리할 수 있는 다음 프롬프트 엔지니어링 tools를 확인해 보세요.

세션에서 불완전하거나 부적절한 결과가 도출된 경우, 요청 과정에서 중요한 결정 사항이 미해결로 남아 있는지 확인하십시오. 다음의 다섯 가지 실수는 문제 진단과 검토를 더욱 어렵게 만들 수 있습니다.

“저장소 조사” 명령은 Claude에게 어떤 파일이 중요한지, 언제 중단해야 하는지에 대한 구체적인 지침을 거의 제공하지 않습니다. 요청의 원인이 된 문제에 대한 답변 없이 광범위한 요약만 제공받을 수 있습니다.

이해해야 할 동작이나 결정 사항에 이름을 붙이고, 시작 위치를 파악한 다음, 예상되는 결과를 정의하세요. 예시: “이 엔드포인트가 권한을 확인하는 과정을 추적하고 관련 기능을 제시하세요.” 서브에이전트를 사용하는 경우, 동일한 무제한 검색을 위임하기보다는 각 서브에이전트에 범위가 제한된 질문을 부여하세요.

기능, 관련 없는 버그, 문서화 요청 사이를 오가다 보면 대화에 현재 작업과 관련이 없는 맥락이 남아 있게 됩니다. “그 파일”이나 “이전의 접근 방식”과 같은 언급은 모호해집니다.

서로 관련 없는 작업은 별도의 세션을 사용하세요. 여러 세션에서 저장소를 편집할 경우, 동일한 작업 디렉터리를 수정하지 않도록 별도의 Git 작업 트리를 사용하세요. 잠깐 짚고 넘어갈 점으로, Claude Code의 /btw 명령어를 사용하면 해당 대화 내용이 메인 대화 기록에 포함되지 않습니다.

특정 기능이 제대로 작동하지 않더라도 빌드는 통과될 수 있습니다. 테스트 스위트는 오류가 발생하는 입력값을 한 번도 테스트하지 않았기 때문에 통과될 수도 있습니다. Claude에게 “테스트를 실행해 달라”고 요청한다고 해서, 해당 테스트가 어떤 요구 사항을 검증하는지 명확히 알 수는 없습니다.

수락 기준을 구체적인 점검 항목에 매핑하세요. 버그 수정 시, 변경 전에는 재현 테스트가 실패했으나 변경 후에는 통과했다는 증거를 요청하세요. 단 한 번의 명령어 실행이 성공했다고 해서 전체 변경 사항이 검증된 것으로 간주하지 말고, 테스트되지 않은 기준은 계속 가시성 높은 곳에 두세요.

점차 확장되는 CLAUDE.md 파일에는 구식 명령어, 중복된 규칙, 특정 작업의 요구 사항과 상충되는 지침이 포함될 수 있습니다. 표현을 더 강력하게 수정한다고 해서 이러한 상충을 해결할 수는 없습니다.

현재 저장소를 기준으로 파일을 검토하십시오. 더 이상 사용되지 않는 지침을 제거하고, 상충되는 규칙을 명확히 하며, 적용 범위가 좁은 지침은 경로 범위 규칙이나 기술 항목으로 이동시키십시오. 요구 사항을 반드시 준수해야 하는 경우, 반복적인 알림에 의존하기보다는 적절한 제어 기능을 구성하고 테스트하십시오.

코드 검토를 통해 실제 결함, 불확실한 문제점, 선택적 리팩토링 제안이 함께 도출될 수 있습니다. 모든 제안을 적용하면 요청된 동작이 개선되지 않은 채 변경 범위가 확대될 수 있습니다.

각 발견 사항의 근거와 영향을 확인하십시오. 정확성 문제와 충족되지 않은 요구 사항을 우선순위로 삼고, 불확실한 주장을 조사하며, 현재 diff에는 관련 없는 개선 사항을 포함하지 마십시오. 검토자는 증거가 그 결론을 지원할 경우, 조치할 만한 발견 사항이 없다고 보고할 수 있어야 합니다.

템플릿을 적용하려면, 템플릿 내의 자리 표시자를 프로젝트의 세부 정보로 대체하고, 변경을 적용하기 전에 Claude가 수행해야 할 작업을 결정하세요. 다음 단계를 따라 요청을 준비하고 결과를 검토하세요.

작고 명확하게 정의된 변경 사항의 경우, Claude에게 직접 구현해 달라고 요청할 수 있습니다. 익숙하지 않은 코드, 여러 파일에 걸친 변경 사항, 또는 명확히 정의되지 않은 요구 사항의 경우에는 먼저 플랜을 세우는 것부터 시작하세요.

'플랜(Plan)' 모드가 나타날 때까지 Shift+Tab을 누르거나, claude --권한-모드 플랜 명령어로 Claude Code를 실행하세요. 이 모드에서 Claude는 소스 코드를 편집하지 않고도 파일을 검사하고 읽기 전용 명령어를 실행할 수 있습니다. 구현을 승인하기 전에 제안된 파일, 의존성 및 테스트를 검토하세요. Ctrl+G를 눌러 에디터에서 제안된 플랜을 열어보세요.

Claude가 작업을 이해하는 데 필요한 증거 자료(파일 참조, 정제된 오류 로그, 스크린샷 또는 요구사항 문서 등)를 제공하세요. @ 기호 뒤에 파일 경로를 입력하여 해당 파일의 콘텐츠를 포함시킬 수 있습니다.

가장 작은 유용한 소스 집합을 선택하세요. 전체 로그나 디렉터리를 포함하면 관련 없는 내용이 추가되어 컨텍스트를 소모할 수 있습니다. 로그를 공유하기 전에 인증 정보와 민감한 데이터를 제거하고, 제공한 문서 URL을 Claude가 불러올 수 있는 tools를 갖추고 있는지 확인하세요.

예시로, `cat error.log | claude -p "이 오류를 설명해 주세요"`는 비대화형 요청으로 로그를 제출합니다. 파일 콘텐츠를 확인한 후에만 이 명령을 사용하십시오. 이것이 바로 문맥 기반 AI의 실질적인 가치입니다. 즉, 모델에 해당 작업과 관련된 정보를 제공하는 것입니다.

기능을 추가할 때는 저장소에서 유사한 컴포넌트나 기능을 찾아보세요. API 클라이언트, 유효성 검사 로직, 오류 처리, 테스트 구조 등 Claude가 따라야 할 규칙을 알려주세요.

“@src/widgets/Weather.tsx가 데이터를 가져오고 캐시하는 방식을 따르세요”라는 지침은 Claude에게 구체적인 참조 기준을 제공합니다. 또한 새로운 기능에 필요한 차이점을 명시하여 더 이상 적합하지 않은 동작이 복사되지 않도록 하세요. 이러한 규칙은 팀의 소프트웨어 개발 워크플로우를 반영해야 합니다.

코드 변경의 경우, 관련 테스트, 빌드 또는 린트 명령어와 해당 명령어가 확인해야 할 동작을 명시하십시오. 연구의 경우, 파일 참조 정보나 커밋 ID를 요청하십시오. UI 작업의 경우, 참조 이미지와 동일한 뷰포트에서 구현 내용을 캡처할 수 있는 설정된 방법을 제공하십시오.

Claude에게 실패 사항 및 건너뛴 검사 항목을 포함하여 실제로 무엇을 검사했는지 보고하도록 요청하세요. 해당 증거가 요구 사항을 충족하는지 검토하십시오. 빌드가 통과되었다고 해서 요청된 모든 동작이 정상적으로 작동한다는 것을 보장하지는 않습니다.

더 긴 작업의 경우, Claude Code는 /goal 조건과 Stop 후크 기능도 제공합니다. 목표 평가기는 파일을 별도로 검사하거나 테스트를 실행하는 대신, 대화 중에 드러난 증거를 바탕으로 평가합니다. 구성된 Stop 후크는 작업 완료를 차단할 수 있지만, 반복적인 차단에는 한도가 있습니다. 이 두 가지 모두 적절한 테스트와 사람의 검토를 대체할 수는 없습니다.

반복적인 수정으로도 문제가 해결되지 않는다면, 잠시 멈추고 초기 요청에서 명확하지 않았던 부분이 무엇인지 파악하세요. 대화를 삭제하기 전에 유용한 발견 사항, 현재 Git 상태, 남은 일을 저장해 두세요.

Anthropic의 최고의 실행 방식 가이드에 따르면, 동일한 문제에 대해 두 번의 수정 시도가 실패한 후에는 처음부터 다시 시작하는 것이 좋습니다. /clear 명령어를 사용한 후, 배운 내용을 반영한 수정된 프롬프트를 입력하세요. 대화를 초기화해도 파일 변경 사항은 취소되지 않습니다.

실행 중인 응답을 중단하려면 Esc 키를 누르세요. 프롬프트 입력이 비어 있는 상태에서 Esc 키를 두 번 누르면 되감기 메뉴가 열리며, 복원할 항목을 선택할 수 있습니다. 되감기 기능은 모든 외부 영향을 되돌리지는 않으므로, 데이터베이스나 원격 서비스의 변경 사항에 대해서는 Git 체크포인트와 별도의 복구 절차를 사용하세요.

프로젝트 전반에 적용되는 지침은 `CLAUDE.md`에, 반복 가능한 절차는 스킬에, 특정 파일에 대한 지침은 경로 범위 규칙에 저장하세요. 편집 후 포맷터를 실행하는 등 특정 이벤트와 연동된 작업을 수행하려면 훅을 활용하세요.

지침이 적용되어야 할 시점에 따라 선택하세요:

일반적으로 한 기능에 대한 요구사항은 CLAUDE.md 파일이 아닌 해당 작업 프롬프트나 사양서에 포함되어야 합니다. 프로젝트 전체에 적용되는 파일에 임시 지침을 추가하면, 저장소 전체에 적용되어야 하는 관례와 이를 구별하기가 더 어려워집니다.

예를 들어, 프로젝트의 테스트 명령어는 CLAUDE.md 파일에 포함하고, 구성 요소별 규칙은 경로 범위 규칙에 지정하며, 반복적으로 수행되는 검토 절차는 스킬로 저장하세요. 다른 프로젝트 문서와 마찬가지로, 명령어나 규칙이 변경될 때마다 이러한 파일을 검토하십시오.

프롬프트, CLAUDE.md 및 스킬은 Claude의 동작을 안내할 뿐, 지시가 반드시 이행될 것을 보장하지는 않습니다. 훅은 구성된 이벤트 발생 시 검사를 실행할 수 있지만, 그 신뢰성은 훅의 유형과 구현 방식에 따라 달라집니다.

명령어 훅은 스크립트를 실행합니다. 프롬프트 또는 에이전트 훅은 모델의 판단에 의존합니다. Anthropic의 최고의 실행 방식 가이드에서 설명하듯이, “프롬프트나 에이전트 훅은 다른 모델에게 결정을 요청하므로, 이 역시 결정론적이지 않습니다.” 반드시 적용되어야 하는 규칙의 경우, 적절한 권한 제어 기능을 사용하고, 오류 처리 방식을 포함하여 관련 명령어 또는 HTTP 훅을 테스트하십시오.

맞춤형 하위 에이전트는 반복적인 일을 체계화하는 또 다른 방법입니다. 별도의 검토 역할이나 도구 범위가 필요한 경우, 모든 전문가 지침을 메인 세션에 추가하는 대신 in.claude/agents/에서 전문가를 정의하세요. 일에 가장 적합한 Claude 모델 및 AI 에이전트 유형에 대한 이 가이드들은 추가적인 맥락을 제공합니다.

팀에서 여러 AI 제품에 걸쳐 프롬프트를 관리하고 있다면, Claude Code 외에도 라이브러리를 관리할 수 있는 다음 프롬프트 엔지니어링 tools를 확인해 보세요.

세션에서 불완전하거나 부적절한 결과가 도출된 경우, 요청 과정에서 중요한 결정 사항이 미해결로 남아 있는지 확인하십시오. 다음의 다섯 가지 실수는 일의 진단 및 검토를 더욱 어렵게 만들 수 있습니다.

“저장소 조사” 명령은 Claude에게 어떤 파일이 중요한지, 언제 중단해야 하는지에 대한 구체적인 지침을 거의 제공하지 않습니다. 요청의 원인이 된 문제에 대한 답변 없이 광범위한 요약만 제공받을 수 있습니다.

이해해야 할 동작이나 결정 사항에 이름을 붙이고, 시작 위치를 파악한 다음, 예상되는 결과를 정의하세요. 예시: “이 엔드포인트가 권한을 확인하는 과정을 추적하고 관련 기능을 제시하세요.” 서브에이전트를 사용하는 경우, 동일한 무제한 검색을 위임하기보다는 각 서브에이전트에 범위가 제한된 질문을 부여하세요.

기능, 관련 없는 버그, 문서화 요청 사이를 오가다 보면 대화에 현재 작업과 관련이 없는 맥락이 남아 있게 됩니다. “그 파일”이나 “이전의 접근 방식”과 같은 언급은 모호해집니다.

서로 관련 없는 작업은 별도의 세션을 사용하세요. 여러 세션에서 리포지토리를 편집할 경우, 동일한 작업 디렉터리를 수정하지 않도록 별도의 Git 작업 트리를 사용하세요. 잠깐 짚고 넘어갈 점으로, Claude Code의 /btw 명령어를 사용하면 해당 대화 내용이 메인 대화 기록에 포함되지 않습니다.

특정 기능이 제대로 작동하지 않더라도 빌드는 통과될 수 있습니다. 테스트 스위트는 오류가 발생하는 입력값을 한 번도 테스트하지 않았기 때문에 통과될 수도 있습니다. Claude에게 “테스트를 실행해 달라”고 요청한다고 해서, 해당 테스트가 어떤 요구 사항을 검증하는지 명확히 알 수는 없습니다.

수락 기준을 구체적인 점검 항목에 매핑하세요. 버그 수정 시, 변경 전에는 재현 테스트가 실패했으나 변경 후에는 통과했다는 증거를 요청하세요. 단 한 번의 명령어 실행이 성공했다고 해서 전체 변경 사항이 검증된 것으로 간주하지 말고, 테스트되지 않은 기준은 계속 가시성 높은 곳에 두세요.

점차 확장되는 CLAUDE.md 파일에는 구식 명령어, 중복된 규칙, 특정 작업의 요구 사항과 상충되는 지침이 포함될 수 있습니다. 표현을 더 강력하게 수정한다고 해서 이러한 상충을 해결할 수는 없습니다.

현재 리포지토리를 기준으로 파일을 검토하십시오. 더 이상 사용되지 않는 지침을 제거하고, 상충되는 규칙을 명확히 하며, 적용 범위가 좁은 지침은 경로 범위 규칙이나 기술 항목으로 이동시키십시오. 요구 사항을 반드시 준수해야 하는 경우, 반복적인 알림에 의존하기보다는 적절한 제어 기능을 구성하고 테스트하십시오.

코드 검토를 통해 실제 결함, 불확실한 문제점, 선택적 리팩토링 제안이 함께 도출될 수 있습니다. 모든 제안을 적용하면 요청된 동작이 개선되지 않은 채 변경 범위가 확대될 수 있습니다.

각 발견 사항의 근거와 영향을 확인하십시오. 정확성 문제와 충족되지 않은 요구 사항을 우선순위로 삼고, 불확실한 주장을 조사하며, 현재 diff에는 관련 없는 개선 사항을 포함하지 마십시오. 검토자는 증거가 그 결론을 지원할 경우, 조치할 만한 발견 사항이 없다고 보고할 수 있어야 합니다.

템플릿을 적용하려면, 템플릿 내의 자리 표시자를 프로젝트의 세부 정보로 대체하고, 변경을 적용하기 전에 Claude가 수행해야 할 작업을 결정하세요. 다음 단계를 따라 요청을 준비하고 결과를 검토하세요.

작고 명확하게 정의된 변경 사항의 경우, Claude에게 직접 구현해 달라고 요청할 수 있습니다. 익숙하지 않은 코드, 여러 파일에 걸친 변경 사항, 또는 명확히 정의되지 않은 요구 사항의 경우에는 먼저 플랜을 세우는 것부터 시작하세요.

'플랜(Plan)' 모드가 나타날 때까지 Shift+Tab을 누르거나, claude --permission-mode plan 명령어로 Claude Code를 실행하세요. 이 모드에서 Claude는 소스 코드를 편집하지 않고도 파일을 검사하고 읽기 전용 명령어를 실행할 수 있습니다. 구현을 승인하기 전에 제안된 파일, 의존성 및 테스트를 검토하세요. Ctrl+G를 눌러 에디터에서 제안된 플랜을 열어보세요.

Claude가 작업을 이해하는 데 필요한 증거 자료(파일 참조, 정제된 오류 로그, 스크린샷 또는 요구사항 문서 등)를 제공하세요. @ 뒤에 파일 경로를 입력하여 해당 파일의 콘텐츠를 포함시킬 수 있습니다.

가장 작은 유용한 소스 집합을 선택하세요. 전체 로그나 디렉터리를 포함하면 관련 없는 내용이 추가되어 컨텍스트를 소모할 수 있습니다. 로그를 공유하기 전에 인증 정보와 민감한 데이터를 제거하고, 제공한 문서 URL을 Claude가 불러올 수 있는 tools를 갖추고 있는지 확인하세요.

예를 들어, `cat 오류.log | claude -p "이 오류를 설명해 주세요"`는 비대화형 요청으로 로그를 제출합니다. 파일 콘텐츠를 확인한 후에만 이 명령을 사용하십시오. 이것이 바로 문맥 기반 AI의 실질적인 가치입니다. 즉, 모델에 해당 작업과 관련된 정보를 제공하는 것입니다.

기능을 추가할 때는 저장소에서 유사한 컴포넌트나 기능을 찾아보세요. API 클라이언트, 유효성 검사 로직, 오류 처리, 테스트 구조 등 Claude가 따라야 할 규칙을 알려주세요.

“@src/widgets/Weather.tsx가 데이터를 가져오고 캐시하는 방식을 따르세요”라는 지침은 Claude에게 구체적인 참조 기준을 제공합니다. 또한 새로운 기능에 필요한 차이점을 명시하여, 더 이상 적합하지 않은 동작이 복사되지 않도록 하세요. 이러한 규칙은 팀의 소프트웨어 개발 워크플로우를 반영해야 합니다.

코드 변경의 경우, 관련 테스트, 빌드 또는 린트 명령어와 해당 명령어가 확인해야 할 동작을 명시하십시오. 연구의 경우, 파일 참조 정보나 커밋 ID를 요청하십시오. UI 작업의 경우, 참조 이미지와 동일한 뷰포트에서 구현 내용을 캡처할 수 있는 설정된 방법을 제공하십시오.

Claude에게 실패 사항 및 건너뛴 검사 항목을 포함하여 실제로 무엇을 검사했는지 보고하도록 요청하세요. 해당 증거가 요구 사항을 충족하는지 검토하십시오. 빌드가 통과되었다고 해서 요청된 모든 동작이 정상적으로 작동한다는 것을 보장하지는 않습니다.

더 긴 작업의 경우, Claude Code는 /goal 조건과 Stop 후크 기능도 제공합니다. 목표 평가기는 파일을 별도로 검사하거나 테스트를 실행하는 대신, 대화 중에 드러난 증거를 바탕으로 평가합니다. 구성된 Stop 후크는 작업 완료를 차단할 수 있지만, 반복적인 차단에는 한도가 있습니다. 이 두 가지 모두 적절한 테스트와 사람의 검토를 대체할 수는 없습니다.

반복적인 수정으로도 문제가 해결되지 않는다면, 잠시 멈추고 초기 요청에서 명확하지 않았던 부분이 무엇인지 파악하세요. 대화를 삭제하기 전에 유용한 발견 사항, 현재 Git 상태, 그리고 남은 일을 저장해 두세요.

Anthropic의 최고의 실행 방식 가이드에 따르면, 동일한 문제에 대해 두 번의 수정 시도가 실패한 후에는 처음부터 다시 시작하는 것이 좋습니다. /clear 명령어를 사용한 후, 배운 내용을 반영하여 수정된 프롬프트를 입력하세요. 대화를 초기화해도 파일 변경 사항은 취소되지 않습니다.

실행 중인 응답을 중단하려면 Esc 키를 누르세요. 프롬프트 입력이 비어 있는 상태에서 Esc 키를 두 번 누르면 되감기 메뉴가 열리며, 복원할 항목을 선택할 수 있습니다. 되감기 기능은 모든 외부 영향을 되돌리지는 않으므로, 데이터베이스나 원격 서비스의 변경 사항에 대해서는 Git 체크포인트와 별도의 복구 절차를 사용하세요.

프로젝트 전반에 적용되는 지침은 `CLAUDE.md`에, 반복 가능한 절차는 스킬에, 특정 파일에 대한 지침은 경로 범위 규칙에 저장하세요. 편집 후 포맷터를 실행하는 등 특정 이벤트와 연동된 작업을 수행하려면 훅을 활용하세요.

지침이 적용되어야 할 시점에 따라 선택하세요:

일반적으로 한 기능에 대한 요구사항은 CLAUDE.md 파일이 아닌 해당 작업 프롬프트나 사양서에 포함되어야 합니다. 프로젝트 전체에 적용되는 파일에 임시 지침을 추가하면, 저장소 전체에 적용되어야 하는 표준과 이를 구별하기가 더 어려워집니다.

예시로, 프로젝트의 테스트 명령어는 CLAUDE.md 파일에 포함하고, 구성 요소별 규칙은 경로 범위 규칙에 지정하며, 반복적으로 수행되는 검토 절차는 스킬로 저장하세요. 다른 프로젝트 문서와 마찬가지로, 명령어나 규칙이 변경될 때마다 이러한 파일을 검토하십시오.

프롬프트, CLAUDE.md 및 스킬은 Claude의 동작을 안내할 뿐, 지시가 반드시 이행될 것을 보장하지는 않습니다. 훅은 구성된 이벤트 발생 시 검사를 실행할 수 있지만, 그 신뢰성은 훅의 유형과 구현 방식에 따라 달라집니다.

명령어 훅은 스크립트를 실행합니다. 프롬프트 또는 에이전트 훅은 모델의 판단에 의존합니다. Anthropic의 최고의 실행 방식 가이드에서 설명하듯이, “프롬프트나 에이전트 훅은 다른 모델에게 결정을 요청하므로, 이 역시 결정론적이지 않습니다.” 반드시 적용되어야 하는 규칙의 경우, 적절한 권한 제어 기능을 사용하고, 오류 처리 방식을 포함하여 관련 명령어 또는 HTTP 훅을 테스트하십시오.

맞춤형 하위 에이전트는 반복적인 일을 체계화하는 또 다른 방법입니다. 별도의 검토 역할이나 도구 범위가 필요한 경우, 모든 전문가 지침을 메인 세션에 추가하는 대신 in.claude/agents/에서 전문가를 정의하세요. 일에 가장 적합한 Claude 모델 및 AI 에이전트 유형에 대한 이 가이드들은 추가적인 맥락을 제공합니다.

팀에서 여러 AI 제품에 걸쳐 프롬프트를 관리하고 있다면, Claude Code 외에도 라이브러리를 관리할 수 있는 다음 프롬프트 엔지니어링 tools를 확인해 보세요.

세션에서 불완전하거나 부적절한 결과가 도출된 경우, 요청 과정에서 중요한 결정 사항이 미해결로 남아 있는지 확인하십시오. 다음의 다섯 가지 실수는 문제 진단과 코드 검토를 더욱 어렵게 만들 수 있습니다.

“리포지토리 조사” 명령은 Claude에게 어떤 파일이 중요한지, 언제 중단해야 하는지에 대한 구체적인 지침을 거의 제공하지 않습니다. 요청의 원인이 된 문제에 대한 답변 없이 광범위한 요약만 제공받을 수 있습니다.

이해해야 할 동작이나 결정 사항에 이름을 붙이고, 시작 위치를 파악한 다음, 예상되는 결과를 정의하세요. 예시: “이 엔드포인트가 권한을 확인하는 과정을 추적하고 관련 기능을 제시하세요.” 서브에이전트를 사용하는 경우, 동일한 무제한 검색을 위임하기보다는 각 서브에이전트에 범위가 제한된 질문을 부여하세요.

기능, 관련 없는 버그, 문서화 요청 사이를 오가다 보면 대화에 현재 작업과 관련이 없는 맥락이 남아 있게 됩니다. “그 파일”이나 “이전의 접근 방식”과 같은 언급은 모호해집니다.

서로 관련 없는 작업은 별도의 세션을 사용하세요. 여러 세션에서 저장소를 편집할 경우, 동일한 작업 디렉터리를 수정하지 않도록 별도의 Git 작업 트리를 사용하세요. 잠깐 짚고 넘어갈 점으로, Claude Code의 /btw 명령어를 사용하면 해당 대화 내용이 메인 대화 기록에 포함되지 않습니다.

특정 기능이 제대로 작동하지 않더라도 빌드는 통과될 수 있습니다. 테스트 스위트는 오류가 발생하는 입력값을 한 번도 테스트하지 않았기 때문에 통과될 수도 있습니다. Claude에게 “테스트를 실행해 달라”고 요청한다고 해서, 해당 테스트가 어떤 요구 사항을 검증하는지 명확히 알 수는 없습니다.

수락 기준을 구체적인 점검 항목에 매핑하세요. 버그 수정 시, 변경 전에는 재현 테스트가 실패했고 변경 후에는 통과했다는 증거를 요청하세요. 단 한 번의 명령어 실행이 성공했다고 해서 전체 변경 사항이 검증된 것으로 간주하지 말고, 테스트되지 않은 기준은 계속 가시적으로 관리하세요.

점차 확장되는 CLAUDE.md 파일에는 구식 명령어, 중복된 규칙, 특정 작업의 요구 사항과 상충되는 지침이 포함될 수 있습니다. 표현을 더 강력하게 수정한다고 해서 이러한 상충을 해결할 수는 없습니다.

현재 저장소를 기준으로 파일을 검토하십시오. 더 이상 사용되지 않는 지침을 제거하고, 상충되는 규칙을 명확히 하며, 적용 범위가 좁은 지침은 경로 범위 규칙이나 기술 항목으로 이동시키십시오. 요구 사항을 반드시 준수해야 하는 경우, 반복적인 알림에 의존하기보다는 적절한 제어 수단을 구성하고 테스트하십시오.

코드 검토를 통해 실제 결함, 불확실한 문제점, 선택적 리팩토링 제안이 함께 도출될 수 있습니다. 모든 제안을 적용하면 요청된 동작은 개선되지 않은 채 변경 범위가 확대될 수 있습니다.

각 발견 사항의 근거와 영향을 확인하십시오. 정확성 문제와 충족되지 않은 요구 사항을 우선순위로 삼고, 불확실한 주장을 조사하며, 현재 diff에는 관련 없는 개선 사항을 포함하지 마십시오. 검토자는 증거가 그 결론을 지원할 경우, 조치할 만한 발견 사항이 없다고 보고할 수 있어야 합니다.

템플릿을 적용하려면, 템플릿 내의 자리 표시자를 프로젝트의 세부 정보로 대체하고, 변경을 적용하기 전에 Claude가 수행해야 할 작업을 결정하세요. 다음 단계를 따라 요청을 준비하고 결과를 검토하세요.

작고 명확하게 정의된 변경 사항의 경우, Claude에게 직접 구현해 달라고 요청할 수 있습니다. 익숙하지 않은 코드, 여러 파일에 걸친 변경 사항, 또는 명확히 정의되지 않은 요구 사항의 경우에는 먼저 플랜을 세우는 것부터 시작하세요.

'플랜(Plan)' 모드가 나타날 때까지 Shift+Tab을 누르거나, claude --permission-mode plan 명령어로 Claude Code를 실행하세요. 이 모드에서 Claude는 소스 코드를 편집하지 않고도 파일을 검사하고 읽기 전용 명령어를 실행할 수 있습니다. 구현을 승인하기 전에 제안된 파일, 의존성 및 테스트를 검토하세요. Ctrl+G를 눌러 에디터에서 제안된 플랜을 열어보세요.

Claude가 작업을 이해하는 데 필요한 증거 자료(파일 참조, 정제된 오류 로그, 스크린샷 또는 요구사항 문서 등)를 제공하세요. @ 뒤에 파일 경로를 입력하여 해당 파일의 콘텐츠를 포함시킬 수 있습니다.

가장 작은 유용한 소스 집합을 선택하세요. 전체 로그나 디렉터리를 포함하면 관련 없는 내용이 추가되어 컨텍스트를 낭비할 수 있습니다. 로그를 공유하기 전에 인증 정보와 민감한 데이터를 제거하고, 제공한 문서 URL을 Claude가 불러올 수 있는 tools를 갖추고 있는지 확인하세요.

예시로, `cat 오류.log | claude -p "이 오류를 설명해 주세요"`는 비대화형 요청으로 로그를 제출합니다. 파일 콘텐츠를 확인한 후에만 이 명령을 사용하십시오. 이것이 바로 문맥 기반 AI의 실질적인 가치입니다. 즉, 모델에 해당 작업과 관련된 정보를 제공하는 것입니다.

기능을 추가할 때는 저장소에서 유사한 컴포넌트나 기능을 찾아보세요. API 클라이언트, 유효성 검사 로직, 오류 처리, 테스트 구조 등 Claude가 따라야 할 규칙을 알려주세요.

“@src/widgets/Weather.tsx가 데이터를 가져오고 캐시하는 방식을 따르세요”라는 지침은 Claude에게 구체적인 참조 기준을 제공합니다. 또한 새로운 기능에 필요한 차이점을 명시하여 더 이상 적합하지 않은 동작이 복사되지 않도록 하세요. 이러한 규칙은 팀의 소프트웨어 개발 워크플로우를 반영해야 합니다.

코드 변경의 경우, 관련 테스트, 빌드 또는 린트 명령어와 해당 명령어가 확인해야 할 동작을 명시하십시오. 연구의 경우, 파일 참조 정보나 커밋 ID를 요청하십시오. UI 작업의 경우, 참조 이미지와 동일한 뷰포트에서 구현 내용을 캡처할 수 있는 설정된 방법을 제공하십시오.

Claude에게 실패 사항 및 건너뛴 검사 항목을 포함하여 실제로 무엇을 검사했는지 보고하도록 요청하세요. 해당 증거가 요구 사항을 충족하는지 검토하십시오. 빌드가 통과되었다고 해서 요청된 모든 동작이 정상적으로 작동한다는 것을 보장하지는 않습니다.

더 긴 작업의 경우, Claude Code는 /goal 조건과 Stop 후크 기능도 제공합니다. 목표 평가기는 파일을 별도로 검사하거나 테스트를 실행하는 대신, 대화 중에 드러난 증거를 바탕으로 평가합니다. 구성된 Stop 후크는 작업 완료를 차단할 수 있지만, 반복적인 차단에는 한도가 있습니다. 이 두 가지 모두 적절한 테스트와 사람의 검토를 대체할 수는 없습니다.

반복적인 수정으로도 문제가 해결되지 않는다면, 잠시 멈추고 초기 요청에서 명확하지 않았던 부분이 무엇인지 파악하세요. 대화를 삭제하기 전에 유용한 발견 사항, 현재 Git 상태, 그리고 남은 일을 저장해 두세요.

Anthropic의 최고의 실행 방식 가이드에 따르면, 동일한 문제에 대해 두 번의 수정 시도가 실패한 후에는 처음부터 다시 시작하는 것이 좋습니다. /clear 명령어를 사용한 후, 배운 내용을 반영한 수정된 프롬프트를 입력하세요. 대화를 초기화해도 파일 변경 사항은 취소되지 않습니다.

실행 중인 응답을 중단하려면 Esc 키를 누르세요. 프롬프트 입력이 비어 있는 상태에서 Esc 키를 두 번 누르면 되감기 메뉴가 열리며, 복원할 항목을 선택할 수 있습니다. 되감기 기능은 모든 외부 영향을 되돌리지는 않으므로, 데이터베이스나 원격 서비스의 변경 사항에 대해서는 Git 체크포인트와 별도의 복구 절차를 사용하세요.

프로젝트 전반에 적용되는 지침은 `CLAUDE.md`에, 반복 가능한 절차는 스킬에, 특정 파일에 대한 지침은 경로 범위 규칙에 저장하세요. 편집 후 포맷터를 실행하는 등 특정 이벤트와 연동된 작업을 수행하려면 훅을 활용하세요.

지침이 적용되어야 할 시점에 따라 선택하세요:

일반적으로 한 기능에 대한 요구사항은 CLAUDE.md 파일이 아닌 해당 작업 프롬프트나 사양서에 포함되어야 합니다. 프로젝트 전체에 적용되는 파일에 임시 지침을 추가하면, 저장소 전체에 적용되어야 하는 관례와 이를 구별하기가 더 어려워집니다.

예를 들어, 프로젝트의 테스트 명령어는 CLAUDE.md 파일에 포함하고, 구성 요소별 규칙은 경로 범위 규칙에 지정하며, 반복적으로 수행되는 검토 절차는 스킬로 저장하세요. 다른 프로젝트 문서와 마찬가지로, 명령어나 규칙이 변경될 때마다 이러한 파일을 검토하십시오.

프롬프트, CLAUDE.md 및 스킬은 Claude의 동작을 안내할 뿐, 지시가 반드시 이행될 것을 보장하지는 않습니다. 훅은 구성된 이벤트 발생 시 검사를 실행할 수 있지만, 그 신뢰성은 훅의 유형과 구현 방식에 따라 달라집니다.

명령어 훅은 스크립트를 실행합니다. 프롬프트 또는 에이전트 훅은 모델의 판단에 의존합니다. Anthropic의 최고의 실행 방식 가이드에서 설명하듯이, “프롬프트나 에이전트 훅은 다른 모델에게 결정을 요청하므로, 이 역시 결정론적이지 않습니다.” 반드시 적용되어야 하는 규칙의 경우, 적절한 권한 제어 기능을 사용하고, 오류 처리 방식을 포함하여 관련 명령어 또는 HTTP 훅을 테스트하십시오.

맞춤형 하위 에이전트는 반복적인 작업을 체계화하는 또 다른 방법입니다. 별도의 검토 역할이나 도구 범위가 필요한 경우, 모든 전문가 지침을 메인 세션에 추가하는 대신 in.claude/agents/에서 전문가를 정의하세요. 일에 가장 적합한 Claude 모델 및 AI 에이전트 유형에 대한 이 가이드들은 추가적인 맥락을 제공합니다.

팀에서 여러 AI 제품에 걸쳐 프롬프트를 관리하고 있다면, Claude Code 외에도 라이브러리를 관리할 수 있는 다음 프롬프트 엔지니어링 tools를 확인해 보세요.

세션에서 불완전하거나 부적절한 결과가 도출된 경우, 요청 과정에서 중요한 결정 사항이 미해결로 남아 있는지 확인하십시오. 다음의 다섯 가지 실수는 일의 진단 및 검토를 더욱 어렵게 만들 수 있습니다.

“저장소 조사” 명령은 Claude에게 어떤 파일이 중요한지, 언제 중단해야 하는지에 대한 구체적인 지침을 거의 제공하지 않습니다. 요청의 원인이 된 문제에 대한 답변 없이 광범위한 요약만 제공받을 수 있습니다.

이해해야 할 동작이나 결정 사항에 이름을 붙이고, 시작 위치를 파악한 다음, 예상되는 결과를 정의하세요. 예시: “이 엔드포인트가 권한을 확인하는 과정을 추적하고 관련 기능을 제시하세요.” 서브에이전트를 사용하는 경우, 동일한 무제한 검색을 위임하기보다는 각 서브에이전트에 범위가 정해진 질문을 부여하세요.

기능, 관련 없는 버그, 문서화 요청 사이를 오가다 보면 대화에 현재 작업과 관련이 없는 맥락이 남아 있게 됩니다. “그 파일”이나 “이전의 접근 방식”과 같은 언급은 모호해집니다.

서로 관련 없는 작업은 별도의 세션을 사용하세요. 여러 세션에서 리포지토리를 편집할 경우, 동일한 작업 디렉터리를 수정하지 않도록 별도의 Git 작업 트리를 사용하세요. 잠깐 짚고 넘어갈 점으로, Claude Code의 /btw 명령어를 사용하면 해당 대화 내용이 메인 대화 기록에 포함되지 않습니다.

특정 기능이 제대로 작동하지 않더라도 빌드는 통과될 수 있습니다. 테스트 스위트는 오류가 발생하는 입력값을 한 번도 테스트하지 않았기 때문에 통과될 수도 있습니다. Claude에게 “테스트를 실행해 달라”고 요청한다고 해서, 해당 테스트가 어떤 요구 사항을 검증하는지 명확히 알 수는 없습니다.

수락 기준을 구체적인 점검 항목에 매핑하세요. 버그 수정 시, 변경 전에는 재현 테스트가 실패했으나 변경 후에는 통과했다는 증거를 요청하세요. 단 한 번의 명령어 실행이 성공했다고 해서 전체 변경 사항이 검증된 것으로 간주하지 말고, 테스트되지 않은 기준은 계속 가시성 높은 곳에 두세요.

점차 확장되는 CLAUDE.md 파일에는 구식 명령어, 중복된 규칙, 특정 작업의 요구 사항과 상충되는 지침이 포함될 수 있습니다. 표현을 더 강력하게 수정한다고 해서 이러한 상충을 해결할 수는 없습니다.

현재 저장소를 기준으로 파일을 검토하십시오. 더 이상 사용되지 않는 지침을 제거하고, 상충되는 규칙을 명확히 하며, 적용 범위가 좁은 지침은 경로 범위 규칙이나 기술 항목으로 이동시키십시오. 요구 사항을 반드시 준수해야 하는 경우, 반복적인 알림에 의존하기보다는 적절한 제어 기능을 구성하고 테스트하십시오.

코드 검토를 통해 실제 결함, 불확실한 문제점, 선택적 리팩토링 제안이 함께 도출될 수 있습니다. 모든 제안을 적용하면 요청된 동작은 개선되지 않은 채 변경 범위가 확대될 수 있습니다.

각 발견 사항의 근거와 영향을 확인하십시오. 정확성 문제와 충족되지 않은 요구 사항을 우선순위로 삼고, 불확실한 주장을 조사하며, 현재 diff에는 관련 없는 개선 사항을 포함하지 마십시오. 검토자는 증거가 그 결론을 지원할 경우, 조치할 만한 발견 사항이 없다고 보고할 수 있어야 합니다.