Claude Code 실전 사용 가이드

현재 저장소에서 먼저 pwd, git status, 현재 브랜치, 주요 설정과 프로젝트 지침을 읽어줘. [작업 목표]와 관련된 파일만 찾아 읽고 수정 전 계획을 보여줘. 비밀값은 출력하지 말고 아직 명령으로 외부 상태를 바꾸지 마.

사용 팁: 처음에는 읽기 전용 탐색과 계획만 요청하세요.

[기능 또는 오류]의 흐름을 검색해 진입점부터 데이터 저장까지 파일·함수 순서로 설명해줘. 검색 결과를 근거로 쓰고 모르는 부분은 확인 필요로 남겨. 수정은 하지 말고 관련 파일을 7개 이하로 제한해.

사용 팁: 넓은 저장소일수록 사용자 행동 하나로 범위를 좁히세요.

[요구사항]을 구현하되 [허용 파일]만 수정하고 [보존 조건]은 유지해. 먼저 계획과 예상 diff를 설명하고 구현 후 git diff --stat, 핵심 diff와 [테스트 명령] 결과를 보고해. 무관한 포맷 변경은 하지 마.

사용 팁: 파일과 변경 금지 범위를 작업 계약처럼 적으세요.

오류 로그 [로그]와 재현 [절차]를 분석해. 코드와 설정에서 원인 후보의 증거를 찾고 재현 테스트를 먼저 실행해. 확인된 원인만 최소 수정하고 같은 명령으로 해결 여부를 검증해. 패키지 업그레이드나 오류 무시는 하지 마.

사용 팁: 토큰·이메일·경로의 개인정보는 마스킹하세요.

[테스트 명령]을 실행하고 실패하면 첫 원인과 연쇄 오류를 구분해. 테스트 설정이나 기대값을 바꿔 통과시키지 말고 제품 코드와 요구사항을 대조해 수정안을 제안해. 수정 후 관련 테스트와 전체 검증 순서로 재실행해.

사용 팁: 처음에는 가장 빠른 관련 테스트부터 실행하세요.

[큰 작업]을 독립적으로 검증 가능한 단계로 나눠줘. 각 단계에 입력, 수정 파일, 완료 조건, 테스트, 되돌리는 방법을 적고 한 번에 한 단계만 진행해. 외부 서비스·배포·데이터 변경은 별도 승인 지점으로 표시해.

사용 팁: 중간 결과를 커밋하거나 검증할 수 있는 크기로 나누세요.

[대상 코드]를 [목표]로 개선해. 공개 인터페이스와 현재 동작을 테스트로 고정하고 중복 제거, 이름 개선, 구조 이동을 각각 분리해. 단계별 diff와 테스트 결과를 보고하고 성능 효과는 측정 전 단정하지 마.

사용 팁: 구조 이동과 기능 변경을 같은 diff에 넣지 마세요.

[변경 범위]를 입력 검증, 인증·권한, 비밀값, 로그, 외부 URL, 데이터 삭제 관점에서 검토해. 실제 공격 경로가 있는 문제만 근거와 함께 보고하고 비밀값 자체는 출력하지 마. 수정 전 우선순위를 제시해.

사용 팁: 샘플 로그도 실제 토큰이 포함되지 않았는지 확인하세요.

[리뷰 의견]이 현재 코드에서 유효한지 먼저 재현하거나 근거를 찾아줘. 유효하면 최소 수정과 테스트를 적용하고, 유효하지 않으면 코드 근거로 설명해. 여러 의견은 각각 독립된 diff로 처리해.

사용 팁: 모든 리뷰 의견을 자동으로 맞다고 가정하지 마세요.

현재 작업을 종료하기 전에 git status와 diff를 확인해. 변경 파일별 목적, 실행한 명령과 결과, 미실행 테스트, 남은 위험, 되돌리는 방법을 짧게 보고해. 요청되지 않은 commit, push, deploy는 하지 마.

사용 팁: 완료 보고에 미실행 검증도 명시하게 하세요.