Cmd. /config

역할

설정 UI 또는 직접 key/value 설정 (/settings)

/config [key=value ...]

사용 조건

설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.

사용 예

/config

# 동일하게 동작하는 별칭
/settings

인자 없이 실행하면 Settings 화면이 열립니다. /config theme=dark thinking=false처럼 여러 key=value를 직접 지정할 수도 있습니다. 이 형식은 -p와 모바일 Remote Control에서도 동작합니다. /config --help는 지원 키 목록을 출력합니다. 확인이 필요한 autoContinueAtUsageLimit 같은 설정은 이 방식으로 켤 수 없으며 패널을 사용해야 합니다.

선택 시점

1. 신규 세션 시작 시 설정 기준 점검
2. 팀 공통 정책과 개인 설정 차이 확인
3. 이상 동작 시 진단 정보 확보 (Settings 화면에서 Status 정보도 함께 확인)
4. 출력 스타일 관리 — /config에서 선택하거나 v2.1.269+의 /output-style [style] 사용
5. autoMemoryDirectory 설정으로 자동 메모리 저장 디렉토리 지정 (v2.1.74)
6. modelOverrides 설정으로 모델별 오버라이드 구성 (v2.1.73)
7. v2.1.92에서 /vim이 제거되어, Vim/Normal 편집 모드 전환은 /config → Editor mode 에서 처리
8. session recap/away summary, theme, renderer(tui) 같은 최근 UX 설정 점검
9. user/managed modelPicker의 전체 lineup·availableModels 필터, any-file prompt-cache TTL 정책 점검 (v2.1.242+)
10. Changelog에만 공개된 managed modelPricing은 조직 배포 schema가 있을 때만 사용하고 /cost를 invoice와 대조

관련 명령 선택

실행 결과와 유지 범위

선택한 설정과 저장 범위에 따라 이후 동작이 바뀝니다. 권한 확인이 필요한 옵션은 설정 화면에서 확인합니다.

공식 문서의 /config 설명은 다음과 같습니다.

Open the Settings interface to adjust theme, model, output style, and other preferences. Alias: /settings

/config(또는 /settings)는 대화형 REPL에서 탭형 Settings 인터페이스를 여는 진입점입니다. 테마(theme)·모델(model)·출력 스타일(output style)을 비롯한 각종 환경설정을 한 화면에서 확인하고 수정합니다. Settings 화면에서는 상태(Status) 정보도 함께 보여주므로, 팀 표준 설정을 유지하고 세션 동작을 점검할 때 핵심이 되는 명령입니다.

프로젝트 지침

프로젝트에 CLAUDE.md가 없으면 AGENTS.md를 읽습니다. /config의 Project instructions에서 변경할 수 있습니다. 이 fallback은 아직 Bedrock·Vertex·Foundry에는 적용되지 않습니다.

Changelog

설정 계약

{
  "modelPicker": {
    "options": [
      { "model": "sonnet", "label": "Daily" },
      { "model": "opus", "description": "Complex planning" }
    ],
    "replaceBuiltInOptions": true
  },
  "promptCacheTtl": "1h",
  "subagentPromptCacheTtl": "5m"
}

• modelPicker는 user 또는 managed settings에서만 읽습니다. replaceBuiltInOptions: true여도 Default와 현재 세션 행은 남고, availableModels가 최종 목록을 다시 제한합니다.
• promptCacheTtl은 interactive·-p·SDK·inline helper에, subagentPromptCacheTtl은 subagent·workflow·background·compaction·title 생성에 적용됩니다.
• 관련 환경변수가 settings보다 우선할 수 있으므로 /config 표시만 보지 말고 실행 process의 env도 확인합니다.
• maxProseWidth(v2.1.282+)는 넓은 터미널에서 Claude 산문 폭을 제한합니다. 표와 코드 블록은 전체 폭을 그대로 씁니다.
• "attribution": false(v2.1.281+)는 commit·PR attribution을 모두 숨깁니다. 이전 CLI는 이 값이 든 settings 파일 전체를 건너뛰므로, 여러 버전이 공유하는 파일에는 기존 객체 형태를 유지합니다.
• feedbackDrafts는 별도 user/managed setting이며 "notify"·"quiet"·"off"를 허용합니다. off는 SendFeedback 도구를 제거합니다.

v2.1.302부터 Idle compaction 행에서 유휴 압축을 끄거나 켭니다. idleCompaction 저장 설정도 사용할 수 있습니다.

Changelog.

주의사항

• 공유 환경에서는 민감 설정 노출 주의
• 변경 전 기본값 백업 권장
• model, outputStyle 같은 일부 키는 세션 시작 시 한 번만 읽혀 다음 재시작에 적용되고, 대부분의 다른 키는 편집 즉시 reload됩니다.
• v2.1.72 UI 개선: Escape로 변경 취소, Enter로 저장 후 닫기, Space로 설정 토글
• 최신 환경에서는 recap opt-out, theme, renderer(tui) 전환 같은 항목도 /config에서 자주 조정
• v2.1.116부터 /config 검색이 설정값까지 매칭하므로, 예를 들어 vim을 검색하면 Editor mode 설정을 찾을 수 있습니다.
• v2.1.119부터 /config에서 바꾼 theme, editor mode, verbose 등의 설정은 ~/.claude/settings.json에 저장되고 project/local/policy precedence에 참여합니다.
• v2.1.287부터 값이 순환하는 설정은 ‹ ›를 표시하고 ←/→로 양쪽으로 넘깁니다. 좁은 터미널에서는 값이 라벨 아래 줄로 내려가고, PgUp/PgDn으로 목록을 넘깁니다.
• v2.1.285부터 /config chrome=true는 Claude in Chrome을 기본으로 켜지 않고 /config 패널로 안내합니다. /config chrome=false는 켜져 있던 설정을 그대로 끕니다.

공식 근거

• Commands
• Settings
• Output Styles
• Changelog

전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록