settings.json

settings.json은 도구가 읽을 설정 이름과 값을 JSON 계열 문법으로 저장하는 설정 파일입니다. 같은 파일명이라도 어느 제품의 어느 폴더에 있는지에 따라 허용 항목과 적용 범위가 달라집니다. VS Code의 편집 환경 설정과 Claude Code의 권한 설정은 각 제품이 정한 경로와 규칙으로 따로 읽습니다.

설정 이름과 값의 대응

설정 파일에는 기능을 가리키는 키와 적용할 값이 들어갑니다. 글자 크기를 바꾸는 숫자, 기능을 켜는 참·거짓, 여러 제외 경로를 담는 배열처럼 값의 종류는 항목별로 정해집니다. 파일 이름이 같아도 한 제품의 키를 다른 제품이 이해하지는 않습니다. 파일을 편집할 때는 먼저 그 파일을 읽는 프로그램과 해당 항목의 설명을 확인합니다. 구문이 올바른 JSON이라는 사실과 제품이 그 설정을 지원한다는 사실은 서로 다릅니다.

VS Code의 사용자·작업 공간 설정 문서는 설정 화면과 JSON 파일에서 같은 설정 값을 바꾸는 방법을 설명합니다. editor.fontSize는 편집기 글자 크기 설정의 식별자입니다. 화면에 표시된 한국어 항목 이름을 파일의 키로 옮기는 대신 공식 식별자를 사용합니다. 편집기의 자동 완성과 오류 표시를 함께 보면 값의 종류나 지원하지 않는 키를 찾기 쉽습니다. 다른 프로그램으로 복사할 때는 주석 허용 여부 등 문법 차이도 확인 대상입니다.

사용자 설정과 프로젝트 설정의 범위

VS Code의 사용자 설정은 개인 환경에 적용되고 작업 공간 설정은 해당 작업 공간에서 적용됩니다. 일반적인 단일 폴더 작업 공간에서는 프로젝트의 .vscode/settings.json에 설정을 둡니다. 여러 루트 폴더를 묶는 작업 공간에서는 작업 공간 파일과 폴더별 설정이 함께 관여합니다. 파일 하나만 보고 모든 프로젝트의 값이라고 판단하면 적용 범위를 잘못 읽게 됩니다. 같은 키가 여러 곳에 있다면 편집 중인 파일의 위치와 실제 유효값을 함께 살핍니다.

설정의 우선순위에는 언어별 설정과 원격 환경도 관여합니다. 특정 언어에만 지정한 편집 규칙이 일반 설정보다 우선할 수 있고, 보안과 업데이트처럼 작업 공간에서 덮어쓸 수 없는 항목도 있습니다. 프로젝트의 들여쓰기 규칙을 공유하려는 경우와 개인 화면 배율을 바꾸려는 경우는 저장할 범위가 다릅니다. 팀에 필요한 값만 프로젝트에 두면 다른 사람이 저장소를 열었을 때 개인 취향까지 강제로 적용하는 일을 줄일 수 있습니다. 두 컴퓨터에서 같은 저장소를 열었는데 동작이 다르면 개인 설정과 설치된 확장도 비교 대상입니다. 저장소 안의 설정만 같다고 전체 편집 환경이 같아지는 것은 아닙니다.

제품별 경로와 권한 설정의 구분

2026년 10월 11일 UTC에 확인한 Claude Code 설정 문서는 사용자 범위의 ~/.claude/settings.json, 프로젝트의 .claude/settings.json, 개인용 프로젝트 파일인 .claude/settings.local.json을 구분합니다. 이름이 비슷해도 .vscode/settings.json과 목적이 다릅니다. Claude Code의 설정에는 권한과 훅 같은 동작 항목이 포함되므로, 편집기 모양을 바꾸는 설정처럼 취급하면 실행에 미치는 영향을 놓칠 수 있습니다.

AI 코딩 도구에 설정 변경을 맡길 때는 제품과 경로, 바꿀 키와 원하는 범위를 함께 지정합니다. 설정 파일이 생성됐는지, 제품이 이를 실제로 읽었는지, 다른 범위의 값이 우선하는지는 차례로 확인할 대상입니다. 프로젝트와 함께 공유되는 파일에는 개인 자격 증명을 넣지 않고 제품이 제공하는 별도 비밀 저장 방식을 사용합니다. 설정 변경 후 문제가 생기면 다른 제품의 예시를 덧붙이기보다 이전 값과 이번에 바뀐 키를 비교하는 편이 원인을 좁히기 쉽습니다.