Claude Code 권한 모드 & 자동화 설정 정리

Claude Code(터미널용 AI 코딩 도구)를 켤 때마다 매번 확인 창을 넘기거나 모드를 바꾸는 게 번거롭다면, settings.json 몇 줄로 "켜자마자 바로 auto 모드 + 불필요한 확인/설문 제거" 상태로 만들 수 있다. 이 글에서 다루는 설정은 세 가지다.

"permissions": { "defaultMode": "auto" },
"skipAutoPermissionPrompt": true,
"feedbackSurveyRate": 0

1. 설정 파일 위치

Claude Code 설정은 머신(서버)마다 로컬 파일에 저장된다. 클라우드/기기 간 자동 동기화가 안 되므로, 여러 서버를 쓴다면 각각 설정해야 한다.

로드 순서는 user → project → local 이며, 나중 것이 앞의 것을 덮어쓴다.

팁(멀티유저 서버): 여러 시스템 유저가 한 서버를 공유한다면, 설정 원본을 한 곳(예: /srv/claude/settings.json)에 두고 각 유저의 ~/.claude/settings.json을 심볼릭 링크로 걸어두면, 한 파일만 고쳐도 전 유저에 반영된다. (단 로그인 자격증명은 유저별로 격리됨 — 설정은 공유돼도 로그인은 각자.)

2. permissions.defaultMode — 권한 모드

Claude Code에는 권한 모드가 있다. 세션 중엔 Shift+Tab으로 돌려가며 바꾸는 그것이고, 이걸 defaultMode로 지정하면 켤 때마다 그 모드로 시작한다.

"defaultMode": "auto"를 넣으면 → 매번 켤 때 자동으로 auto 모드로 시작한다. 안 넣으면 default로 시작해 매번 Shift+Tab으로 바꿔야 한다.

⚠️ auto 모드 = "아무것도 안 묻는" 게 아니다

auto 모드는 읽기·빌드·일반 파일 편집 같은 안전한 대다수를 안 묻고 진행하되, 파괴적·되돌리기 어려운·보안에 민감한 동작은 여전히 막거나 질문한다. 내부 분류기(classifier)가 매 동작을 판정한다.

예: 권한 자체를 완화하는 설정 편집, 민감 파일 덮어쓰기, 위험한 삭제 등은 auto 모드에서도 차단되고 사용자 확인을 요구한다. → "편해지되 안전장치는 유지" 가 auto 모드의 취지다.

3. skipAutoPermissionPrompt — 최초 동의 창 생략

auto 모드를 처음 켤 때 딱 한 번 뜨는 안내/동의 창이 있다. "auto 모드는 일부 동작을 자동 승인합니다. 켜시겠습니까?" 류의 일회성 확인이다.

"skipAutoPermissionPrompt": true → 이 최초 동의 창을 미리 수락 처리해서 안 뜨게 한다.

defaultMode: "auto"와 짝으로 쓴다:

• defaultMode: "auto" → 켜면 auto 모드로 진입
• skipAutoPermissionPrompt: true → 그때 뜰 확인 창 생략
• 결과: 켜자마자 아무 확인 없이 곧장 auto 모드로 시작

4. feedbackSurveyRate — 세션 평가 설문 끄기

위 둘과 완전히 별개다. 세션이 끝날 때 가끔 뜨는 "이번 대화 어땠나요" 품질 평가 설문의 노출 확률(0~1)이다.

• "feedbackSurveyRate": 0 → 설문 안 뜸
• 예: 0.05면 5% 확률로 노출

5. 적용하는 법 (3가지)

방법 A — settings.json 직접 편집 (세 개 다 한 번에, 권장)

~/.claude/settings.json을 열어 아래 블록을 추가한다(기존 내용은 유지하고 병합):

{
  "permissions": { "defaultMode": "auto" },
  "skipAutoPermissionPrompt": true,
  "feedbackSurveyRate": 0
}

JSON이므로 쉼표·중괄호 짝에 주의. 기존에 이미 { ... }가 있으면 그 안에 키만 추가한다.

방법 B — /config 슬래시 명령

Claude Code 안에서 /config 입력 → 메뉴에서 permission mode를 auto로 설정.

• ✅ defaultMode(권한 모드)는 /config로 가능
• ❌ skipAutoPermissionPrompt, feedbackSurveyRate는 /config에 노출 안 됨 → 방법 A나 C 필요

방법 C — Claude에게 말로 시키기 (다른 서버에서 제일 간편)

새 서버의 Claude Code에게 그냥 이렇게 입력하면 알아서 settings.json을 고쳐준다:

내 ~/.claude/settings.json 에 defaultMode auto, skipAutoPermissionPrompt true, feedbackSurveyRate 0 넣어줘

적용 시점: 현재 실행 중인 세션엔 반영 안 되고, 다음에 claude를 새로 켤 때부터 적용된다.

6. 완성된 settings.json 예시

{
  "model": "opus[1m]",
  "effortLevel": "high",
  "tui": "fullscreen",
  "theme": "dark",
  "permissions": {
    "defaultMode": "auto"
  },
  "skipAutoPermissionPrompt": true,
  "feedbackSurveyRate": 0
}

7. 요약

• auto 모드는 안전한 작업은 자동, 위험한 작업은 여전히 차단 → 편의와 안전의 절충.
• 설정은 머신마다 로컬 → 클라우드마다 각각 넣어야 함(방법 C가 가장 빠름).
• 언제든 세션 중 Shift+Tab으로 모드 변경 가능하고, 값만 지우면 원복된다.