클로드 코드 처음 켤 때 설정 3가지: 권한 모드, 출력 스타일, 상태줄
Claude Code 권한 모드, 출력 스타일, 상태줄의 역할과 설정 방법입니다. auto와 bypassPermissions의 차이를 바로잡고 기본 설정에서 확인할 항목을 정리했습니다.
권한 모드는 도구 실행의 허용 방식, 출력 스타일은 응답 지침, 상태줄은 세션 정보 표시를 정합니다. 세 설정은 서로 다른 역할이므로 한 설정으로 다른 설정까지 바뀐다고 생각하지 마세요.
현재 Claude Code의 권한 모드, 출력 스타일, 상태줄 설정을 읽고 설명해 줘. 권한을 넓히지 말고 각 설정의 역할과 적용 범위를 먼저 알려 줘. 상태줄은 모델 이름과 컨텍스트 사용률을 표시하는 방법을 제안해 줘.
먼저 현재 설정을 확인하고 필요한 항목만 바꾸는 순서를 권합니다. 아래의 기능 설명은 공식 문서 기준이며, 초보자가 어떤 방식으로 시작할지에 대한 권고는 편집자의 제안입니다.
권한 모드 확인하기
- default(화면의 Manual): 도구의 첫 사용 등에 권한 확인을 요청하는 모드입니다. 이름이 default라고 해서 모든 설치 환경의 시작 모드라는 뜻은 아닙니다.
- plan: 조사와 계획에 사용하는 모드입니다. 읽기 작업과 허용된 명령 실행은 가능하므로 “아무 동작도 하지 않는다”는 뜻은 아닙니다.
- auto: 백그라운드 분류기가 명령이 사용자 요청에 맞는지 검사합니다. 무조건 확인 없이 실행하는 모드가 아닙니다.
- bypassPermissions: 권한 확인을 생략하는 모드입니다. 일부 별도 보호 장치까지 모두 사라진다는 뜻은 아니며, 일반 작업의 편의 설정으로 권하지 않습니다.
permissions.defaultMode는 새 세션의 시작 모드를 정합니다. 실제 적용은 설정 범위와 조직 정책의 영향을 받습니다. 처음에는 Manual 모드에서 승인 요청을 읽어 보고, 변경 전에 계획이 필요하면 plan 모드를 활용하세요. 특정 프롬프트 문구가 권한 체계를 대신하지는 않습니다.
출력 스타일 고르기
출력 스타일은 응답의 역할·어조·형식에 관한 지침입니다. /output-style로 선택할 수 있고, 설명을 원하면 Explanatory, 직접 코딩 연습을 원하면 Learning 같은 내장 스타일을 살펴볼 수 있습니다. 설치 버전에 따라 제공되는 스타일과 명령 지원이 달라질 수 있습니다.
설정 파일에 직접 넣을 때는 공식 문서의 정확한 이름과 대소문자를 사용하세요. 스타일을 바꿔도 권한 모드가 바뀌지는 않으며, 지침이 모든 응답을 보장하지도 않습니다.
상태줄 표시하기
상태줄은 로컬 스크립트가 받은 세션 정보를 화면에 표시하는 기능입니다. 다음과 같이 모델과 컨텍스트 사용률을 요청할 수 있습니다.
/statusline 모델 이름과 컨텍스트 사용률을 표시해 줘
명령은 스크립트와 설정을 생성할 수 있으므로 변경 내용을 확인하세요. 상태줄 정보는 표시용이며 권한을 제어하지 않습니다. 현재 권한 모드는 세션의 모드 표시에서 별도로 확인합니다.
적용 후 점검
이 글의 시작점은 권한을 넓히는 것이 아니라 지금 허용된 범위를 이해하는 것입니다. 설정을 바꿨다면 새 세션에서도 의도한 값이 적용되는지 확인하고, 불필요한 설정은 원래 값으로 되돌릴 수 있도록 기록해 두세요.
자주 묻는 질문
기본 권한 모드를 그대로 써도 되나요?
시작 모드는 버전·요금제·정책에 따라 다를 수 있습니다. 직접 승인을 확인하며 시작하려면 Manual 모드를 선택할 수 있습니다. 승인 창의 대상과 명령을 읽는 것이 먼저입니다. 확인 횟수를 줄이기 위해 권한을 넓히는 것을 기본 권고로 삼지는 않습니다.
auto는 승인 검사가 없는 모드인가요?
아닙니다. 공식 문서는 백그라운드 분류기의 검사를 설명합니다. bypassPermissions와 같은 뜻으로 사용하면 안 됩니다.
출력 스타일과 상태줄은 필수인가요?
필수는 아닙니다. 응답을 읽기 편하게 하거나 세션 정보를 보고 싶을 때 선택하면 됩니다. 두 기능 모두 권한 모드의 대체 수단은 아닙니다.
확인한 공식 자료
확인일: 2026년 10월 15일. 아래 자료가 설명하는 기능과 이 글에서 제안하는 활용 방법을 구분했습니다.
- Claude Code Permissions — 권한 모드와 auto 검사, bypassPermissions의 범위를 확인했습니다.
- Claude Code Settings — 설정 파일의 범위와 permissions.defaultMode를 확인했습니다.
- Claude Code Output styles — 출력 스타일 선택과 권한 모드의 독립성을 확인했습니다.
- Claude Code Status line — 상태줄 스크립트와 모델·컨텍스트 표시 예시를 확인했습니다.