Cmd. /config
테마, 모델, 출력 스타일 등 환경설정을 조정하는 탭형 Settings 인터페이스를 여는 명령 (별칭 /settings)
핵심 요약
/config(별칭/settings)는 테마·모델·출력 스타일 등을 한 화면에서 보고 수정하는 탭형 Settings 인터페이스를 엽니다.model·outputStyle같은 일부 키는 세션 시작 시 한 번만 읽혀 재시작 후 적용되고, 대부분의 다른 키는 편집 즉시 reload됩니다.- v2.1.73에서
/output-style이, v2.1.92에서/vim이 제거되어 출력 스타일과 Editor mode 전환은/config로 통합되었습니다. - v2.1.119부터
/config에서 바꾼 설정은~/.claude/settings.json에 저장되어 project/local/policy precedence에 참여합니다.
명령어 원본 선언
/config별칭(alias): /settings — 두 명령은 동일하게 동작합니다.
공식 설명 요약
공식 문서의 /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) 정보도 함께 보여주므로, 팀 표준 설정을 유지하고 세션 동작을 점검할 때 핵심이 되는 명령입니다.
최소 지원 버전
v2.0.71이상- 별칭
/settings는 공식 Commands 문서에 명시되어 있습니다.
사용법
/config# 동일하게 동작하는 별칭
/settings인자 없이 호출하며, 실행하면 탭형 Settings 인터페이스가 열립니다.
좋은 사용 예
- 신규 세션 시작 시 설정 기준 점검
- 팀 공통 정책과 개인 설정 차이 확인
- 이상 동작 시 진단 정보 확보 (Settings 화면에서 Status 정보도 함께 확인)
- 출력 스타일 관리 — v2.1.73에서
/output-style명령이 deprecated되어 출력 스타일 설정은/config에서 통합 관리 autoMemoryDirectory설정으로 자동 메모리 저장 디렉토리 지정 (v2.1.74)modelOverrides설정으로 모델별 오버라이드 구성 (v2.1.73)- v2.1.92에서
/vim이 제거되어, Vim/Normal 편집 모드 전환은/config→ Editor mode 에서 처리 - session recap/away summary, theme, renderer(
tui) 같은 최근 UX 설정 점검
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/config | 설정값 점검/조정 (Settings) | 설정 관리가 목적일 때 |
/settings | /config의 별칭 | 어느 쪽이든 동일하게 동작 |
/status | Settings의 Status 탭을 열어 버전·모델·계정·연결 상태 표시 | 현재 런타임 상태 확인 |
/permissions | 승인 정책 조정 (별칭 /allowed-tools) | 실행 권한 통제가 목적일 때 |
/theme | 색상 테마만 변경 | 테마만 빠르게 바꿀 때 |
활용 사례
- 온보딩 체크리스트 자동화
- 팀 공통 설정 템플릿 점검
주의사항
- 공유 환경에서는 민감 설정 노출 주의
- 변경 전 기본값 백업 권장
model,outputStyle같은 일부 키는 세션 시작 시 한 번만 읽혀 다음 재시작에 적용되고, 대부분의 다른 키는 편집 즉시 reload됩니다.- v2.1.72 UI 개선: Escape로 변경 취소, Enter로 저장 후 닫기, Space로 설정 토글
- v2.1.79에서 "Show turn duration"(
showTurnDuration) 토글 추가 — 각 턴의 소요 시간 표시 - 최신 환경에서는 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.144에서 무관한 설정을 토글할 때
/config종료 요약이 auto-compact·theme에 대한 허위(phantom) 변경을 보고하던 버그가 수정되었습니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Settings: https://code.claude.com/docs/en/settings
- Output styles: https://code.claude.com/docs/en/output-styles
- Changelog: https://code.claude.com/docs/en/changelog