클로드 코드 설정 3가지 2026 — 기본값만 쓰면 놓치는 것들

outputStyle은 클로드의 역할·톤·출력 형식을 바꾸는 설정입니다. 기본값 그대로면 항상 같은 방식으로 답합니다. 간결한 답변을 원하는지, 설명을 자세히 풀어주는 방식을 원하는지 미리 골라 둘 수 있고, 어떤 파일에서든 적용되는 범위로 분류돼 있어 사용자 설정과 프로젝트 설정 어디에나 넣을 수 있습니다.

대화가 길어지면 컨텍스트(AI가 그 세션에서 기억하는 정보량)가 가득 차기 전에 자동으로 요약(compact)이 걸립니다. autoCompactWindow는 컨텍스트가 얼마나 찼을 때 이 압축을 시작할지 정하는 설정입니다. 중요한 세부 내용을 오래 남기고 싶다면 이 시점을 조정할 수 있고, 압축 자체를 끄고 싶다면 함께 있는 autoCompactEnabled 설정으로 켜고 끌 수 있습니다.

permissions.deny는 특정 파일이나 명령을 아예 건드리지 못하게 막는 설정입니다. 예를 들어 .env(비밀번호·API 키 같은 민감 정보가 담긴 설정 파일)를 실수로 고치거나 읽지 못하게 미리 막아 둘 수 있습니다. 비밀 정보가 담긴 파일을 읽는 동작까지 막을 수 있다는 점에서, 단순히 편집을 막는 것보다 범위가 넓은 설정입니다.

세 설정 모두 설정 파일에 항목을 추가하는 방식으로 적용합니다. 나 혼자, 모든 프로젝트에 공통으로 적용하고 싶다면 사용자 설정 파일(~/.claude/settings.json)에 적고, 이 프로젝트에서만 팀과 함께 적용하고 싶다면 프로젝트 설정 파일(.claude/settings.json)에 적습니다. 나만 쓰고 버전 관리에는 올리고 싶지 않은 값은 로컬 설정 파일(.claude/settings.local.json)에 따로 둡니다. 세 파일 모두 같은 항목 이름을 그대로 쓸 수 있어, 적용 범위만 정하면 됩니다.

클로드 코드는 설치 직후에도 대화가 바로 되기 때문에, 설정을 안 건드려도 당장 불편함을 못 느낍니다. 그러다 대화가 길어져 중요한 맥락이 요약되어 사라지거나, 실수로 비밀 파일을 건드릴 뻔한 뒤에야 이런 설정이 있다는 걸 알게 되는 경우가 많습니다. 문제를 겪은 다음에 찾아보기보다, 미리 설정 문서를 한 번 훑어보는 편이 예방에 가깝습니다. 설정 항목은 이 세 가지 말고도 여러 개가 더 있지만, 처음부터 전부 익히려 하기보다 실제로 불편을 겪은 순간에 관련 항목을 찾아 하나씩 늘려가는 방식이 부담이 적습니다.

세 설정 중 가장 먼저 챙겨야 할 것은 permissions.deny입니다. outputStyle과 autoCompactWindow는 불편하면 나중에 고쳐도 되는 설정이지만, .env 같은 민감 파일이 실수로 노출되거나 수정되는 사고는 되돌리기 어려운 경우가 많기 때문입니다. 프로젝트를 새로 시작할 때 가장 먼저 하는 일이 코드를 짜는 것이 아니라 permissions.deny에 민감 파일 패턴을 등록하는 일이어야 하는 이유입니다. autoCompactWindow는 그다음 순위로, 대화가 길어지는 프로젝트일수록 기본값보다 여유 있게 잡아 두는 편이 중요한 맥락을 놓치지 않는 데 도움이 됩니다.

설정을 안 건드리면 문제가 생기나요?

기본값으로도 동작 자체에는 문제가 없습니다. 다만 민감 파일 보호나 응답 스타일처럼 개인 작업 방식에 맞춰야 편한 항목들이 있어, 한 번쯤 점검해 두는 편이 좋습니다.

세 설정을 전부 프로젝트 파일에 넣어야 하나요?

그렇지 않습니다. 여러 프로젝트에 공통으로 적용하고 싶은 값은 사용자 설정에, 이 프로젝트에서만 팀과 공유할 값은 프로젝트 설정에 나눠 넣는 편이 관리하기 쉽습니다.

설정을 잘못 넣으면 되돌릴 수 있나요?

설정 파일은 일반 텍스트 파일이라 언제든 직접 열어 수정하거나 삭제할 수 있습니다. 값을 바꾼 뒤에는 새 세션에서 정상 적용됐는지 확인하는 습관이 필요합니다.

outputStyle·autoCompactWindow·permissions.deny 세 설정은 전부 기본값 그대로 두면 존재조차 모르고 지나치기 쉬운 항목입니다. 응답 스타일과 압축 시점은 편의를 위한 설정이지만, permissions.deny는 민감 정보를 지키는 안전장치에 가까우므로 새 프로젝트를 시작할 때 가장 먼저 챙겨 두는 편이 안전합니다.

• Anthropic — Settings reference (https://code.claude.com/docs/en/settings-reference, 확인일 2026-09-18)