.claude 폴더는 Claude Code의 핵심 제어 센터로, 프로젝트 내에서 Claude의 동작 방식을 정의하는 구성 요소들을 포함합니다.

CLAUDE.md 파일은 Claude에게 프로젝트별 지침을 제공하는 시스템 프롬프트 역할을 하며, 팀의 코딩 규칙, 명령어, 아키텍처 결정 등을 간결하게 명시하여 Claude가 일관된 작업을 수행하도록 돕습니다.

rules/ 폴더는 대규모 팀에서 CLAUDE.md가 비대해지는 문제를 해결하기 위해 지침을 모듈화하고, 경로별로 적용 범위를 제한할 수 있어 유지보수와 협업에 유리합니다.

commands/ 폴더는 사용자 정의 슬래시 명령어를 생성하며, 쉘 명령어 실행 결과를 프롬프트에 동적으로 삽입해 실시간 작업 자동화를 지원합니다.

skills/ 폴더는 특정 상황에서 Claude가 자동으로 실행하는 워크플로우를 정의하며, agents/ 폴더는 복잡한 작업을 처리하는 전문 하위 에이전트 페르소나를 설정해 효율적이고 분리된 작업 처리를 가능하게 합니다.

마지막으로, settings.json 파일은 Claude의 권한과 실행 가능한 도구를 세밀하게 제어하여 안전한 작업 환경을 보장하며, 개인별 설정은 별도의 로컬 파일로 관리해 팀과 개인 설정을 분리할 수 있습니다.

이 구조를 이해하고 적절히 설정하면 Claude Code가 프로젝트 요구에 맞게 정확하고 효율적으로 작동하도록 최적화할 수 있습니다.