찰리초이 스토리 블로그

  학습용 가이드 · Anthropic 공식 문서 기반 Claude Code 공식 모범 사례 쉽게 이해하기 이 문서는 Anthropic의 공식 문서 Claude Code 모범 사례 를 바탕으로, 내용을 더 쉽게 이해할 수 있도록 설명과 예시를 추가해 재구성한 학습용 가이드입니다. 공식 문서: code.claude.com/docs/ko/best-practices 목차 한 줄 요약 챗봇이 아니라 "자율 코딩 작업자"다 완료 기준을 먼저 줘라 검증 기준의 종류 Before/After: 검증 기준 제공 탐색 → 계획 → 코딩 순서 Plan Mode가 필요한 경우 탐색 → 계획 → 구현 예시 구체적인 맥락을 넣어라 Before/After: 맥락 제공 풍부한 콘텐츠를 제공하라 CLAUDE.md는 짧은 운영 카드다 좋은 CLAUDE.md 예시 권한은 자동화의 브레이크다 CLI 도구를 적극 활용하라 MCP 서버로 외부 시스템 연결 Hooks: 반드시 실행되는 규칙 Skills: 반복 업무 저장 Subagents로 context 절약 Claude에게 질문도 잘 시켜라 세션 관리는 품질 관리다 체크포인트와 rewind 활용 비대화형 모드로 자동화하기 여러 세션 병렬 실행 대량 작업은 fan-out으로 적대적 리뷰 단계 추가 흔한 실패 패턴과 해결책 실무 시나리오별 완성 프롬프트 AI 개발팀 운영 모델 작업 전 체크리스트 바로 쓰는 기본 템플릿 최종 정리 0 한 줄 요약 Claude Code를 잘 쓰는 핵심은 AI에게 코딩을 맡기는 것 이 아니라, AI가 검증 가능한 방식으로 일하게 만드는 것 입니다. 좋은 AI 코딩 운영 = 목표 + 맥락 + 검증 기준 + 권한 제한 + 리뷰 구조 1 Claude Code는 챗봇이 아니라 "자율 코딩 작업자"다 일반 챗봇은 질문에 답하고 멈춥니다. 하지만 Claude Code는 다음 일을 할 수 있습니다. 파일 읽기 코드 수정 터미널 명령 실행 테스트 실행 빌드 확인 에러 로그 분석 여러 파일에 걸친 리팩터링...