클로드 코드 처음 켤 때 설정 3가지: 권한 모드, 출력 스타일, 상태줄
클로드 코드를 설치하고 승인 창이나 밋밋한 화면이 신경 쓰이는 분께 맞는 글입니다. 처음 쓸 때 가장 헷갈리는 세 가지 설정과 적용 방법을 정리했습니다.
처음 쓸 때는 권한 모드, 출력 스타일, 상태줄 세 가지만 확인하면 됩니다. 권한 모드는 승인을 얼마나 물을지, 출력 스타일은 답변 방식, 상태줄은 화면 아래 정보를 정합니다.
클로드 코드 처음 설정을 점검하고 싶어. 아래 세 가지를 하나씩 확인해서, 지금 내 설정과 바꾸면 좋은 점을 알려 줘. 1. 권한 모드: 시작 모드(permissions.defaultMode)를 어떻게 정할지 2. 출력 스타일: 내 작업에 맞는 스타일(outputStyle)이 무엇인지 3. 상태줄: /statusline으로 모델과 모드를 보이게 하는 방법 되돌리기 어려운 작업 전에는 plan 모드로 바꾸는 방법도 함께 알려 줘.
클로드 코드는 설치하고 바로 쓸 수 있지만, 몇 가지 설정을 안 만지면 매번 같은 질문에 답하거나 화면이 심심하게 느껴질 수 있습니다.
공식 설정 문서(settings-reference)에 나오는 항목 중 처음 쓸 때 가장 헷갈리는 세 가지를 골랐습니다.
왜 헷갈리나요
설정이 한 곳에 모여 있지 않고, 권한·출력·화면 표시가 서로 다른 명령과 파일로 나뉘어 있습니다.
저도 처음엔 매번 뜨는 승인 창이 귀찮아서 설정을 뒤졌는데, 권한 모드라는 이름인 줄 모르고 한참 헤맸습니다.
권한 모드(permission mode) 정하기
작업마다 승인을 몇 번이나 물을지 정하는 설정입니다. 공식 문서에 나오는 대표 모드는 이렇습니다.
auto모드: 확인 질문 없이 계속 진행하도록 유도합니다. 다만 프롬프트나 스킬이 명시적으로 확인을 요구하면 그때는 물어봅니다.plan모드: 편집하기 전에 먼저 분석만 합니다. 되돌리기 어려운 작업 전에 켜 두면 안전합니다.bypassPermissions모드: 모든 검사를 건너뜁니다. 편하지만 위험도가 가장 높은 모드입니다.
새 세션이 시작할 때 어떤 모드로 열릴지는 permissions.defaultMode 설정으로 지정합니다. 세션 안에서 현재 모드를 확인하고, 설정 파일의 permissions.defaultMode로 시작 모드를 정하면 됩니다.
출력 스타일(output style) 고르기
클로드의 역할·어조·출력 형식을 바꾸는 저장된 지침입니다. 공식 문서에는 "출력 스타일로 클로드의 역할·어조·출력 형식을 바꿀 수 있다"고 돼 있습니다.
기본 내장 스타일(설명형·학습형 등) 중 고르거나 직접 만들 수 있습니다. outputStyle 설정에 원하는 스타일 이름을 넣거나 직접 작성해 지정합니다.
상태줄(statusline) 만들기
화면 아래에 지금 상태를 표시하는 줄입니다. 공식 문서는 "입력창 아래에 상태줄을 표시하려면 직접 명령을 실행하라"고 안내합니다.
/statusline 뒤에 보고 싶은 정보를 자연어로 적으면 클로드 코드가 스크립트를 대신 써 줍니다. 예를 들어 지금 쓰는 모델이나 남은 토큰을 적으면 됩니다.
상태줄은 세션 시작·재개, 새 응답 도착, 압축(/compact) 완료, 권한 모드 변경 시점마다 다시 실행됩니다.
/statusline 지금 쓰는 모델과 권한 모드를 보여 줘확인 체크리스트
세 가지를 적용한 뒤 아래를 점검합니다.
자주 하는 실수
저는 처음에 권한 모드를 안 건드리고 기본값 그대로 썼습니다. 그러다 되돌리기 힘든 파일 삭제 직전에도 승인이 안 뜨는 걸 보고 놀란 적이 있습니다.
지금은 위험한 작업을 할 땐 plan 모드로 먼저 검토하고, 반복 작업만 auto 모드로 돌립니다.
자주 묻는 질문
권한 모드는 기본값을 그대로 써도 되나요?
가벼운 반복 작업이면 괜찮습니다. 다만 파일을 지우거나 되돌리기 어려운 작업 전에는 plan 모드로 바꿔서 먼저 검토하는 것을 권합니다.
출력 스타일을 안 정하면 어떻게 되나요?
기본 스타일로 동작합니다. 다만 설명을 더 자세히 원하거나 짧게 원하는 경우 스타일을 지정하면 매번 요청하지 않아도 됩니다.
상태줄은 꼭 만들어야 하나요?
필수는 아닙니다. 다만 지금 어떤 모델·모드로 작업 중인지 한눈에 보이면 실수를 줄일 수 있습니다.
정리
권한 모드·출력 스타일·상태줄, 이 세 가지만 확인해도 처음 헤매는 시간이 줄어듭니다.
plan 모드 정의는 한 줄로 기억하면 됩니다. 편집 전에는 분석만 하고, 상태줄은 /statusline 뒤에 원하는 걸 적으면 끝입니다.