Claude Code – 공식 문서에 없는 모든 설정 방법

Claude Code의 소스 코드를 분석하여 공식 문서에는 공개되지 않은 다양한 비공개 설정과 자동화 기능을 공개한다.

YOLO Classifier라 불리는 자동 모드(auto-mode) 권한 시스템은 환경에 대한 자연어 설명을 통해 승인 여부를 결정할 수 있다. 예를 들어, "이곳은 스테이징 서버이므로 파괴적인 작업이 허용됨"과 같은 설명을 설정하면 분류기가 이를 읽고 안전 여부를 판단한다.

훅(Hooks) 시스템을 활용하면 Claude Code의 동작을 실시간으로 제어할 수 있다.

• PreToolUse 훅: 도구 실행 전 입력을 수정(updatedInput)하거나, 사용자 승인 없이 실행 여부를 결정(permissionDecision)하고, 대화에 추가 컨텍스트를 주입할 수 있다.
• SessionStart 훅: 자동 파일 감시(watchPaths)를 설정하거나 세션 시작 시 초기 메시지 및 컨텍스트를 주입할 수 있다.

설정 파일은 개인용(~/.claude/) 또는 프로젝트 공유용(.claude/) 디렉토리를 통해 관리하며, 프로젝트 단위의 설정은 Git을 통해 팀원과 공유할 수 있다.