클로드 코드 설정 3가지 2026 — 기본값만 쓰면 놓치는 것들
클로드 코드 설정 화면을 한 번도 안 열어봤다면, 기본값만 쓰면 놓치기 쉬운 설정 세 가지와 각각을 적용하는 방법을 정리했습니다.
클로드 코드는 설정을 안 건드려도 바로 쓸 수 있지만, 기본값만 쓰면 놓치기 쉬운 설정이 있습니다. outputStyle, autoCompactWindow, permissions.deny 세 가지 중 민감 파일을 지키는 permissions.deny를 가장 먼저 챙기면 됩니다.
클로드 코드 설정 문서(Settings reference) 기준으로 내 설정을 점검해 줘. 1. outputStyle: 내가 간결한 답과 자세한 설명 중 무엇을 원하는지 물어보고 맞는 값을 제안해 줘 2. autoCompactWindow: 지금 대화가 길어지는 프로젝트인지 보고 조정할 필요가 있는지 알려 줘 3. permissions.deny: .env 같은 민감 파일을 막을 항목이 있는지 확인해 줘 어느 설정 파일(사용자, 프로젝트, 로컬)에 넣는 것이 맞는지도 알려 주고, 설정 형식이 확실하지 않으면 공식 문서에서 확인하라고 알려 줘.
클로드 코드를 설치한 뒤 설정 화면을 한 번도 열어보지 않은 사람이 이 글을 읽어야 합니다. 설치하자마자 바로 대화가 되기 때문에 "일단 되니까" 설정을 안 건드리고 넘어가기 쉽습니다. 공식 설정 문서에는 기본값 그대로 두면 놓치기 쉬운 항목이 여럿 있는데, 그중 실제로 체감이 큰 세 가지만 골랐습니다.
놓치기 쉬운 이유
클로드 코드는 설치 직후에도 대화가 바로 되기 때문에, 설정을 안 건드려도 당장 불편함을 못 느낍니다. 그러다 대화가 길어져 중요한 맥락이 요약되어 사라지거나, 실수로 비밀 파일을 건드릴 뻔한 뒤에야 이런 설정이 있다는 걸 알게 되는 경우가 많습니다.
문제를 겪은 다음에 찾아보기보다, 미리 설정 문서를 한 번 훑어보는 편이 예방에 가깝습니다. 설정 항목은 이 세 가지 말고도 여러 개가 더 있지만, 처음부터 전부 익히려 하기보다 실제로 불편을 겪은 순간에 관련 항목을 찾아 하나씩 늘려가는 방식이 부담이 적습니다.
outputStyle로 응답 스타일을 고른다
outputStyle은 클로드의 역할·톤·출력 형식을 바꾸는 설정입니다. 기본값 그대로면 항상 같은 방식으로 답합니다. 간결한 답변을 원하는지, 설명을 자세히 풀어주는 방식을 원하는지 미리 골라 둘 수 있고, 어떤 파일에서든 적용되는 범위로 분류돼 있어 사용자 설정과 프로젝트 설정 어디에나 넣을 수 있습니다.
autoCompactWindow로 자동 압축 시점을 정한다
대화가 길어지면 컨텍스트(AI가 그 세션에서 기억하는 정보량)가 가득 차기 전에 자동으로 요약(compact)이 걸립니다. autoCompactWindow는 컨텍스트가 얼마나 찼을 때 이 압축을 시작할지 정하는 설정입니다. 컨텍스트가 정확히 무엇으로 채워지고 압축될 때 무엇이 남는지는 토큰·컨텍스트 관리법에 따로 정리했습니다.
중요한 세부 내용을 오래 남기고 싶다면 이 시점을 조정할 수 있고, 압축 자체를 끄고 싶다면 함께 있는 autoCompactEnabled 설정으로 켜고 끌 수 있습니다.
permissions.deny로 세부 권한을 막는다
permissions.deny는 특정 파일이나 명령을 아예 건드리지 못하게 막는 설정입니다. 예를 들어 .env(비밀번호·API 키 같은 민감 정보가 담긴 설정 파일)를 실수로 고치거나 읽지 못하게 미리 막아 둘 수 있습니다. 지시 문장만으로 작업 범위를 막기 어렵다면 이런 권한 설정을 함께 걸어 두는 편이 안전합니다.
비밀 정보가 담긴 파일을 읽는 동작까지 막을 수 있다는 점에서, 단순히 편집을 막는 것보다 범위가 넓은 설정입니다.
설정 파일 위치를 정해 적용한다
세 설정 모두 설정 파일에 항목을 추가하는 방식으로 적용합니다. 나 혼자, 모든 프로젝트에 공통으로 적용하고 싶다면 사용자 설정 파일(~/.claude/settings.json)에 적고, 이 프로젝트에서만 팀과 함께 적용하고 싶다면 프로젝트 설정 파일(.claude/settings.json)에 적습니다.
나만 쓰고 버전 관리에는 올리고 싶지 않은 값은 로컬 설정 파일(.claude/settings.local.json)에 따로 둡니다. 세 파일 모두 같은 항목 이름을 그대로 쓸 수 있어, 적용 범위만 정하면 됩니다.
운영자 한마디
세 설정 중 가장 먼저 챙겨야 할 것은 permissions.deny입니다. outputStyle과 autoCompactWindow는 불편하면 나중에 고쳐도 되는 설정이지만, .env 같은 민감 파일이 실수로 노출되거나 수정되는 사고는 되돌리기 어려운 경우가 많기 때문입니다.
프로젝트를 새로 시작할 때 가장 먼저 하는 일이 코드를 짜는 것이 아니라 permissions.deny에 민감 파일 패턴을 등록하는 일이어야 하는 이유입니다. autoCompactWindow는 그다음 순위로, 대화가 길어지는 프로젝트일수록 기본값보다 여유 있게 잡아 두는 편이 중요한 맥락을 놓치지 않는 데 도움이 됩니다.
자주 하는 실수
문제를 겪은 다음에 찾아보기보다, 미리 설정 문서를 한 번 훑어보는 편이 예방에 가깝습니다.
.env 같은 파일이 실수로 노출되거나 수정되는 사고는 되돌리기 어렵습니다. 새 프로젝트를 시작할 때 permissions.deny에 민감 파일 패턴부터 등록합니다.
설정 항목은 세 가지 말고도 여러 개가 더 있습니다. 실제로 불편을 겪은 순간에 관련 항목을 찾아 하나씩 늘려가는 방식이 부담이 적습니다.
자주 묻는 질문
설정을 안 건드리면 문제가 생기나요?
기본값으로도 동작 자체에는 문제가 없습니다. 다만 민감 파일 보호나 응답 스타일처럼 개인 작업 방식에 맞춰야 편한 항목들이 있어, 한 번쯤 점검해 두는 편이 좋습니다.
세 설정을 전부 프로젝트 파일에 넣어야 하나요?
그렇지 않습니다. 여러 프로젝트에 공통으로 적용하고 싶은 값은 사용자 설정에, 이 프로젝트에서만 팀과 공유할 값은 프로젝트 설정에 나눠 넣는 편이 관리하기 쉽습니다.
설정을 잘못 넣으면 되돌릴 수 있나요?
설정 파일은 일반 텍스트 파일이라 언제든 직접 열어 수정하거나 삭제할 수 있습니다. 값을 바꾼 뒤에는 새 세션에서 정상 적용됐는지 확인하는 습관이 필요합니다.
정리
outputStyle·autoCompactWindow·permissions.deny 세 설정은 전부 기본값 그대로 두면 존재조차 모르고 지나치기 쉬운 항목입니다. 응답 스타일과 압축 시점은 편의를 위한 설정이지만, permissions.deny는 민감 정보를 지키는 안전장치에 가까우므로 새 프로젝트를 시작할 때 가장 먼저 챙겨 두는 편이 안전합니다.