꾸비데브

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

클로드 코드 설정 화면을 한 번도 안 열어봤다면, 기본값만 쓰면 놓치기 쉬운 설정 세 가지와 각각을 적용하는 방법을 정리했습니다.

한 줄 요약

클로드 코드는 설정을 안 건드려도 바로 쓸 수 있지만, 기본값만 쓰면 놓치기 쉬운 설정이 있습니다. outputStyle, autoCompactWindow, permissions.deny 세 가지 중 민감 파일을 지키는 permissions.deny를 가장 먼저 챙기면 됩니다.

AI에게 이렇게 시키기
클로드 코드 설정 문서(Settings reference) 기준으로 내 설정을 점검해 줘.
1. outputStyle: 내가 간결한 답과 자세한 설명 중 무엇을 원하는지 물어보고 맞는 값을 제안해 줘
2. autoCompactWindow: 지금 대화가 길어지는 프로젝트인지 보고 조정할 필요가 있는지 알려 줘
3. permissions.deny: .env 같은 민감 파일을 막을 항목이 있는지 확인해 줘
어느 설정 파일(사용자, 프로젝트, 로컬)에 넣는 것이 맞는지도 알려 주고, 설정 형식이 확실하지 않으면 공식 문서에서 확인하라고 알려 줘.

클로드 코드를 설치한 뒤 설정 화면을 한 번도 열어보지 않은 사람이 이 글을 읽어야 합니다. 설치하자마자 바로 대화가 되기 때문에 "일단 되니까" 설정을 안 건드리고 넘어가기 쉽습니다. 공식 설정 문서에는 기본값 그대로 두면 놓치기 쉬운 항목이 여럿 있는데, 그중 실제로 체감이 큰 세 가지만 골랐습니다.

기본값만 쓰면 놓치는 설정민감 파일 보호가 가장 먼저응답 스타일(outputStyle)자동 압축 시작 시점권한 거부 목록(deny)

놓치기 쉬운 이유

클로드 코드는 설치 직후에도 대화가 바로 되기 때문에, 설정을 안 건드려도 당장 불편함을 못 느낍니다. 그러다 대화가 길어져 중요한 맥락이 요약되어 사라지거나, 실수로 비밀 파일을 건드릴 뻔한 뒤에야 이런 설정이 있다는 걸 알게 되는 경우가 많습니다.

문제를 겪은 다음에 찾아보기보다, 미리 설정 문서를 한 번 훑어보는 편이 예방에 가깝습니다. 설정 항목은 이 세 가지 말고도 여러 개가 더 있지만, 처음부터 전부 익히려 하기보다 실제로 불편을 겪은 순간에 관련 항목을 찾아 하나씩 늘려가는 방식이 부담이 적습니다.

STEP 1

outputStyle로 응답 스타일을 고른다

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

STEP 2

autoCompactWindow로 자동 압축 시점을 정한다

대화가 길어지면 컨텍스트(AI가 그 세션에서 기억하는 정보량)가 가득 차기 전에 자동으로 요약(compact)이 걸립니다. autoCompactWindow는 컨텍스트가 얼마나 찼을 때 이 압축을 시작할지 정하는 설정입니다. 컨텍스트가 정확히 무엇으로 채워지고 압축될 때 무엇이 남는지는 토큰·컨텍스트 관리법에 따로 정리했습니다.

중요한 세부 내용을 오래 남기고 싶다면 이 시점을 조정할 수 있고, 압축 자체를 끄고 싶다면 함께 있는 autoCompactEnabled 설정으로 켜고 끌 수 있습니다.

STEP 3

permissions.deny로 세부 권한을 막는다

permissions.deny는 특정 파일이나 명령을 아예 건드리지 못하게 막는 설정입니다. 예를 들어 .env(비밀번호·API 키 같은 민감 정보가 담긴 설정 파일)를 실수로 고치거나 읽지 못하게 미리 막아 둘 수 있습니다. 지시 문장만으로 작업 범위를 막기 어렵다면 이런 권한 설정을 함께 걸어 두는 편이 안전합니다.

비밀 정보가 담긴 파일을 읽는 동작까지 막을 수 있다는 점에서, 단순히 편집을 막는 것보다 범위가 넓은 설정입니다.

STEP 4

설정 파일 위치를 정해 적용한다

세 설정 모두 설정 파일에 항목을 추가하는 방식으로 적용합니다. 나 혼자, 모든 프로젝트에 공통으로 적용하고 싶다면 사용자 설정 파일(~/.claude/settings.json)에 적고, 이 프로젝트에서만 팀과 함께 적용하고 싶다면 프로젝트 설정 파일(.claude/settings.json)에 적습니다.

설정을 적는 파일항목 이름은 세 파일 모두 같음나 혼자, 모든 프로젝트사용자 설정 파일~/.claude/settings.json이 프로젝트, 팀과 함께프로젝트 설정 파일.claude/settings.json나만, 버전 관리 제외로컬 설정 파일settings.local.json

나만 쓰고 버전 관리에는 올리고 싶지 않은 값은 로컬 설정 파일(.claude/settings.local.json)에 따로 둡니다. 세 파일 모두 같은 항목 이름을 그대로 쓸 수 있어, 적용 범위만 정하면 됩니다.

운영자 한마디

세 설정 중 가장 먼저 챙겨야 할 것은 permissions.deny입니다. outputStyle과 autoCompactWindow는 불편하면 나중에 고쳐도 되는 설정이지만, .env 같은 민감 파일이 실수로 노출되거나 수정되는 사고는 되돌리기 어려운 경우가 많기 때문입니다.

프로젝트를 새로 시작할 때 가장 먼저 하는 일이 코드를 짜는 것이 아니라 permissions.deny에 민감 파일 패턴을 등록하는 일이어야 하는 이유입니다. autoCompactWindow는 그다음 순위로, 대화가 길어지는 프로젝트일수록 기본값보다 여유 있게 잡아 두는 편이 중요한 맥락을 놓치지 않는 데 도움이 됩니다.

자주 하는 실수

일단 되니까 설정을 한 번도 열어보지 않음

문제를 겪은 다음에 찾아보기보다, 미리 설정 문서를 한 번 훑어보는 편이 예방에 가깝습니다.

민감 파일 보호를 뒤로 미룸

.env 같은 파일이 실수로 노출되거나 수정되는 사고는 되돌리기 어렵습니다. 새 프로젝트를 시작할 때 permissions.deny에 민감 파일 패턴부터 등록합니다.

설정을 처음부터 전부 익히려 함

설정 항목은 세 가지 말고도 여러 개가 더 있습니다. 실제로 불편을 겪은 순간에 관련 항목을 찾아 하나씩 늘려가는 방식이 부담이 적습니다.

자주 묻는 질문

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

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

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

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

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

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

정리

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

공식 자료

← BLOG 전체 보기무료자료 보기 →