/config 설정을 settings.json에 영구 저장하기

Claude Code를 쓰다 보면 세션 시작할 때마다 테마를 다시 고르거나 verbose 모드를 켜는 게 은근히 귀찮아요. v2.1.119 이전엔 /config로 바꾼 값이 세션 안에서만 유효했거든요. 이제는 달라졌어요.

v2.1.119부터 /config로 변경한 설정이 ~/.claude/settings.json에 자동으로 기록돼요. 다음 세션에서 Claude Code를 열면 저장된 값 그대로 시작해요. 프로젝트별 설정이나 정책 오버라이드와도 우선순위 체계가 맞물려 있어서, 글로벌 기본값을 잡아두고 프로젝트마다 덮어쓰는 것도 가능해요.

준비물

• Claude Code v2.1.119 이상
• 터미널에서 claude --version으로 버전 확인 가능

claude --version
# claude-code 2.1.119 (또는 그 이상이면 OK)

스텝

1. Claude Code 실행 후 /config 열기

Claude Code 세션 안에서 /config를 입력하면 설정 패널이 열려요. 여기서 테마, 에디터 모드, verbose 출력 여부 같은 옵션을 고를 수 있어요.

2. 원하는 값으로 변경

패널에서 값을 바꾸면 돼요. 예를 들어 테마를 dark로, verbose를 true로 설정하면 해당 값이 즉시 ~/.claude/settings.json에 기록돼요. 따로 저장 버튼을 누를 필요 없어요.

3. 저장된 파일 확인

설정을 바꾼 뒤 터미널에서 파일을 열어보면 값이 들어가 있어요.

cat ~/.claude/settings.json

출력은 JSON 형태로 나온다.

{
  "theme": "dark",
  "editorMode": "vim",
  "verbose": true
}

실제 키 이름은 선택한 옵션에 따라 다를 수 있어요. 위는 예시 구조예요.

확인 방법

Claude Code를 완전히 종료했다가 다시 열어요. /config를 다시 입력해서 이전에 설정한 값이 그대로 남아 있는지 보면 돼요. 세션이 바뀌어도 값이 유지되면 정상이에요.

# 세션 종료 후 재시작
claude
# 세션 안에서
/config

응용

settings.json은 텍스트 파일이라 직접 편집해도 돼요. 여러 머신에서 같은 설정을 쓰고 싶다면 이 파일을 dotfiles 레포에 넣어서 심볼릭 링크로 관리하는 게 편해요.

# dotfiles 레포에 복사 후 심볼릭 링크 예시
cp ~/.claude/settings.json ~/dotfiles/claude/settings.json
ln -sf ~/dotfiles/claude/settings.json ~/.claude/settings.json

프로젝트 루트에 .claude/settings.json을 따로 두면 글로벌 설정을 덮어쓸 수 있어요. 팀 프로젝트에서 에디터 모드를 통일하거나, 특정 레포에서만 verbose를 끄고 싶을 때 유용해요.

트러블슈팅

설정이 저장 안 되는 것 같다면 버전을 다시 확인해요. v2.1.119 미만이면 이 기능 자체가 없어요.

JSON 파싱 오류가 난다면 파일을 직접 편집하다가 쉼표나 괄호를 빠뜨린 경우예요. cat ~/.claude/settings.json | python3 -m json.tool로 유효성 검사를 해볼 수 있어요.

cat ~/.claude/settings.json | python3 -m json.tool
# 오류 없으면 정상 출력, 오류 있으면 위치 알려줌

프로젝트 설정이 글로벌 설정을 무시한다면 의도된 동작이에요. 프로젝트 로컬 설정이 글로벌보다 우선순위가 높아요.

한 번만 설정해두면 어떤 프로젝트를 열든 같은 환경에서 시작할 수 있게 돼요.