Claude Code settings.json이 없는 이유: v2.x부터 자동 생성되지 않는 구조 변경과 대처 방법

여러 컴퓨터에 설정을 변경하던 중 ~/.claude/settings.json 파일이 존재하지 않는 상황이 있었습니다..

• 설정이 적용되지 않은 것 같거나
• 설치가 잘못된 것처럼 보이지만

실제로는 정상 동작입니다.

---

AI에게 릴리즈 노트를 읽어달라고 잡도리를 한 결과,

Claude Code v2.x부터 설정 구조가 변경되었다고 합니다.

 

과거 (v1.x ~ v2.0 초반)

• 실행 시 자동으로 ~/.claude/settings.json 생성
• 일부 인증/옵션도 해당 파일에서 관리

현재 (v2.0.8 이후)

• settings.json은 필수 파일이 아님
• 인증 정보는 다음 우선순위로 처리됨:
  1. OAuth 로그인 / 구독 상태
  2. OS 환경 변수
  3. (선택) settings.json

즉 settings.json은 "없어도 되는 선택 설정 파일"로 변경된 상태입니다.

 

Claude Code는 실행 시 자체 번들된 MCP(Model Context Protocol)를 자동으로 로딩하기 때문에,

별도의 settings.json 파일을 생성하지 않아도 기본 기능 사용에는 문제가 없습니다.

 

"Remove deprecated .claude.json config options (instead, configure these in your settings.json)"

릴리즈 노트에도 이렇게 나와있습니다.

 

---

 

실제로 필요가 없으시다면 생성하지 않으셔도 무방하고 저처럼 토글용 혹은 다른 ai mcp 사용을 위해 꼭 써야한다 등의 이유가 있다면

touch ~/.claude/settings.json

등으로 직접 생성하셔서 사용하시면 됩니다.

 

토글해서 사용하는 화면 예시

claude settings

 

행복 개발~