Anthropic 이 Claude Code 의 settings.json 에 125 개 이상의 키를 탑재했습니다. 공식 문서에는 약 40 개만 설명되어 있습니다.
그중 14 개는 Claude.ai UI 에서 3 단계 깊이에 숨겨져 있습니다. 4 개는 문서에 전혀 나타나지 않습니다. GitHub 이슈를 읽거나, 엔지니어들이 Discord 에서 흘린 정보를 보거나, 새벽 1 시에 Claude Code 바이너리를 뒤져야 찾을 수 있습니다.
대부분의 Claude 사용자는 Anthropic 이 6 개월 전에 제공한 설정을 그대로 사용합니다. 청구 금액은 천천히 늘어납니다. 출력 품질은 떨어집니다. 그리고 그 원인을 모델 탓으로 돌립니다.
아래: 실제로 Claude 를 제대로 작동하게 하는 18 개의 설정입니다.
Claude dot ai 에 8 개.
Claude Code 에 7 개.
API 및 Console 에 3 개.
각 설정에 대해: 위치, 기능, 한 줄 수정 방법을 설명합니다.
섹션 1: Claude (8 개 설정)
1. Memory: 범위, 제외 항목, "잊기" 명령
위치: 설정 -> 기능 -> Memory
기능: Memory 는 2026 년 3 월에 Free 및 Pro 요금제에 출시되었습니다. 기본적으로 Claude 가 저장할 가치가 있다고 판단하는 모든 것을 저장합니다. 대부분의 사람들이 놓치는 세 가지 제어 기능은 프로젝트별 범위, 제외 목록, 그리고 즉석에서 사용하는 잊기 명령입니다.
중요한 이유: 기본 메모리는 표류합니다. 4-6 주 후에는 일회성 수정 사항 ("Python 에서는 탭을 선호합니다" 라고 한 파일에 대해 한 번 말한 내용), 관련 없는 채팅으로 새어 나가는 프로젝트별 사실, 그리고 오래된 역할 컨텍스트로 가득 찹니다. Claude 가 잘못된 "당신"에 맞춰 최적화되기 때문에 출력 품질이 저하됩니다.
해결 방법:
- 프로젝트 범위 메모리 켜기: 설정 -> 기능 -> Memory -> 프로젝트별 범위. 프로젝트 내의 메모리는 해당 프로젝트에 남습니다. 이 설정만으로도 대부분의 표류 문제가 해결됩니다.
- 관련 없는 채팅에 표시되지 않도록 하려는 주제를 제외 목록에 추가하세요. 예: 이혼, 의료, 급여 정보, 고객 이름. 이러한 내용은 제외하지 않으면 컨텍스트에 관계없이 유지됩니다.
- 모든 채팅에서 인라인 잊기 명령 사용: [주제]에 대해 기억한 것을 잊어줘
Claude 가 이를 메모리 저장소에서 파싱하여 제거된 내용을 확인합니다. 메뉴나 설정 페이지가 필요 없습니다.
2. Extended Thinking: 채팅별 전환
위치: 채팅 입력 -> 모델 선택 드롭다운 -> Extended Thinking: Off / Light / Full
기능: Extended Thinking 은 답변 전에 <thinking> 추론 과정을 추가합니다. Anthropic 은 Opus 에 대해 기본적으로 활성화합니다. 세 가지 상태 전환은 채팅별로 적용되며 전역 설정을 재정의합니다.
중요한 이유: Extended Thinking 은 수학, 디버깅, 다단계 계획에 탁월합니다. 요약, 번역, 서식 지정, 재작성, 빠른 조회에는 낭비입니다. 이러한 작업에서는 3-12 초의 지연 시간과 동일한 답변에 대해 20-40% 더 많은 토큰이 추가됩니다.
해결 방법: 기본값을 Light 로 설정합니다(모델이 유용하다고 판단할 때만 생각 사용). 어려운 작업에는 명시적으로 Full 로 전환합니다. 제가 이 기능을 보여준 대부분의 사용자는 첫 주에 Opus 토큰 사용량을 18-25% 줄였습니다.
3. Custom Styles: "말투"가 아닌 실제 출력 계약
위치: 채팅 입력 -> 스타일 선택기 -> 새 스타일 만들기
기능: Styles 는 처음에 톤 전환("격식/간결/설명")으로 시작했습니다. Custom Styles 는 실제로 출력 계약입니다. 200-1500 단어의 명령어 파일을 붙여넣습니다. 해당 스타일의 모든 응답은 생성 전에 이를 적용합니다.
중요한 이유: 대부분의 사람들은 Styles 를 "더 짧게 만들기" 위해 사용합니다. 실제 용도는 다시 붙여넣지 않고 모든 응답에 구조적 규칙을 적용하는 것입니다. 인용 형식. 금지어. 필수 섹션. 코드 펜스 언어. 길이 제한. 후속 질문 여부.
해결 방법: 워크플로우당 하나의 Style 을 만드세요. 제 스타일은 다음과 같습니다.
세 가지를 순환 사용하면(X 초안 작성, 코드 리뷰, PDF 요약) 저장된 프롬프트의 80%를 대체합니다.
4. Projects: 대부분의 사람들이 비워두는 "지침" 필드
위치: 프로젝트 -> 오른쪽 상단 ⋯ -> 프로젝트 지침 편집
기능: Projects 는 영구 작업 공간입니다. 지침 필드는 해당 프로젝트의 모든 채팅에 주입되는 시스템 프롬프트와 동일합니다. Anthropic 은 지식 업로드 기능과 함께 Projects 를 소개했으며, 이것이 사람들이 기억하는 부분입니다. 지침 필드는 같은 페이지에 있으며, 제가 본 Projects 의 70%가 비어 있습니다.
중요한 이유: 프로젝트의 모든 채팅은 이 정보 없이 빈 상태로 시작합니다. 이 정보를 사용하면 컨텍스트를 다시 설정하는 것을 중단할 수 있습니다. ("이것은 Polymarket 리서치 워크플로우입니다. 기본적으로 회의적으로 접근하세요. 항상 확률 계산을 보여주세요. 거래를 추천하지 마세요 — EV 만 설명하세요.")
해결 방법: Claude 용 CLAUDE.md 처럼 취급하세요. 400 단어 미만으로 유지하세요. 역할, 기본 회의 수준, 서식 규칙, 절대 하지 말아야 할 것을 지정하세요. 한 달에 한 번 다시 읽고 정리하세요.
5. 과거 채팅 검색 (Pro+) 및 실제 검색 방법
위치: 설정 → 프로필 → 과거 채팅 검색 (활성화해야 함)
기능: Claude 가 관련성이 있을 때 대화 기록을 검색하도록 합니다. Pro+ 전용입니다.
중요한 이유: Pro 요금제에서도 새 계정에서는 기본적으로 꺼져 있습니다. 켜고 나면, 트릭은 키워드 일치를 수행한다는 것을 아는 것입니다. 의미론적 검색이 아닙니다. "어제 중국 로봇에 대해 논의한 내용"은 과거 채팅에 문자 그대로 "중국 로봇" 또는 "중국"과 "로봇"이 포함되어 있지 않으면 아무것도 반환하지 않습니다.
해결 방법: 켜세요. 그런 다음 실제 쿼리 형태를 배우세요. 내용 명사, 메타 단어가 아닙니다. "Polymarket 이란"은 작동합니다. "지난주에 이야기했던 그거"는 작동하지 않습니다.
6. 웹 검색: 대화별 전환 및 인용 동작
위치: 채팅 입력 -> + -> 웹 검색: 켜기 / 끄기
기능: 웹 검색 전환은 대화별로 적용되지만, 동작은 설정 -> 기능 -> 웹 검색 인용: 인라인 / 각주 / 숨김 의 덜 알려진 설정에 따라 변경됩니다.
중요한 이유: 기본값은 인라인입니다. 인라인 인용은 복사-붙여넣기를 방해합니다. Claude 의 답변을 다른 곳에 복사하면 아무 곳도 가리키지 않는 표시자를 복사하게 됩니다. 각주 모드는 답변을 깔끔하게 유지하고 끝에 출처를 나열합니다.
해결 방법: Claude 의 웹 검색 결과를 다른 문서, 이메일 또는 메시지에 복사하는 경우 각주로 전환하세요. Claude 내에서 모든 것을 읽는 경우에만 인라인을 유지하세요.
7. Connectors: Cowork 의 "이 폴더 신뢰" 함정
위치: 설정 -> Connectors -> Cowork -> 신뢰하는 폴더
기능: Cowork (2026 년 4 월 GA)는 Claude 에게 사용자 컴퓨터의 폴더에 대한 액세스 권한을 부여합니다. 기본적으로 Anthropic 은 각 세션 전에 폴더를 신뢰할지 묻습니다. 신뢰하는 폴더 목록은 이 과정을 건너뛰는 방법입니다.
중요한 이유: 폴더가 신뢰 목록에 추가되면 Claude 는 매 Cowork 세션마다 묻지 않고 해당 폴더를 읽습니다. 3 월에 테스트 중에 폴더를 추가하고 잊어버렸다면, Claude 는 그 이후로 모든 세션에서 조용히 그 폴더를 읽어 왔습니다.
해결 방법: 신뢰하는 폴더를 여세요. 현재 활성 프로젝트가 아닌 것은 모두 제거하세요. 목록은 생각보다 빠르게 늘어납니다.
8. 시크릿 모드 및 실제로 건너뛰는 항목
위치: 사이드바 -> 새 시크릿 채팅 (또는 Cmd/Ctrl + Shift + N)
기능: 시크릿 채팅은 저장되지 않으며, 기억되지 않으며, 검색할 수 없으며, 모델 개선에 사용되지 않습니다. 채팅을 닫으면 삭제됩니다.
중요한 이유: 사람들은 시크릿 모드가 채팅을 사이드바에서 숨기기만 한다고 생각합니다. 실제로는 네 가지 시스템을 건너뜁니다: 메모리 쓰기, 채팅 기록, 과거 채팅 검색 색인, 학습 데이터 옵트인(활성화한 경우).
해결 방법: 민감한 데이터(급여, 의료, 가족, 법률 초안, 고객 이름)가 포함된 모든 항목에 의도적으로 사용하세요. 세 번의 키 입력, 생각할 필요 없습니다.
섹션 2: Claude Code (7 개 설정)
이 설정들은 ~/.claude/settings.json (사용자 수준) 또는 .claude/settings.json (프로젝트 수준)에 있습니다. 후자가 우선합니다.
v2.1.105 바이너리에는 총 125 개 이상의 키가 있습니다. 아래 7 개는 실제로 성능에 영향을 미치는 것들입니다.
9. enabledPlugins - 비활성화, 제거하지 마세요
위치: ~/.claude/settings.json -> enabledPlugins
기능: 세션 시작 시 로드할 설치된 플러그인을 설정합니다. Plugin 마켓플레이스는 설치를 쉽게 만듭니다. 제거는 더 어렵고, 값을 false 로 설정하기만 하면 불필요합니다.
중요한 이유: 모든 활성 플러그인은 해당 후크, SKILL.md 콘텐츠 및 도구 스키마를 컨텍스트 예산에 로드합니다. 잊어버린 세 개의 플러그인 = 아무것도 입력하기 전에 3-8K 토큰의 선불 요금이 발생합니다.
이 감사를 시작했을 때 14 개의 플러그인이 활성화되어 있었습니다. 현재 4 개가 활성화되어 있습니다.
해결 방법:
false 로 설정하면 플러그인이 설치된 상태로 유지되지만 로드되지는 않습니다. 실제로 필요할 때 /plugin enable name@marketplace 를 사용하여 세션별로 다시 활성화하세요.
10. permissions.deny - 버그에 대해 알아야 할 사항
위치: ~/.claude/settings.json -> permissions.deny
기능: Claude 가 특정 도구를 실행하거나 특정 파일에 액세스하는 것을 차단합니다. 의도: rm -rf 방지, .env 읽기 방지, 프로젝트 외부 쓰기 방지.
중요한 이유: 알려진 버그가 있습니다. Deny 규칙이 때때로 차단되지 않습니다. 여러 GitHub 이슈가 제출되었습니다. 가장 많이 인용된 것(anthropics/claude-code#11544)은 유효한 구성에도 불구하고 후크가 로드되지 않는 것을 문서화합니다. 유사한 패턴이 deny 적용에 영향을 미칩니다. 규칙이 구성에 있습니다. 디버그 로그에는 "0 개의 일치자를 찾았습니다."가 표시됩니다. Claude 는 어쨌든 파일을 읽습니다.
해결 방법:
파일 시스템 수준에서 두 번째 계층을 추가하세요. chmod 600 .env 를 실행하여 Claude 가 읽으려고 해도 OS 가 거부하도록 합니다. Deny 목록만 신뢰하지 마세요. Claude Code 내에서 /permissions 로 확인하세요. 규칙이 나타나지 않으면 세션을 다시 시작하세요.
11. hooks.SessionStart - 컨텍스트 팽창을 30% 줄인 4 줄
위치: ~/.claude/settings.json -> hooks.SessionStart
기능: SessionStart 는 디렉토리에서 Claude Code 를 열 때 실행됩니다. env 정보 출력, git 상태 린트, 컨텍스트 파일 주입, 캐시 워밍 등 무엇이든 실행할 수 있습니다.
중요한 이유: 대부분의 사람들이 너무 많이 주입합니다. 모든 프로젝트 규칙이 들어갔기 때문에 CLAUDE.md 가 5K 토큰으로 늘어납니다. SessionStart 를 사용하면 현재 브랜치 또는 디렉토리와 관련된 규칙만 로드할 수 있습니다.
해결 방법:
메인 브랜치는 context-main.md 를 로드합니다. feat/auth 브랜치는 context-feat-auth.md 를 로드합니다. 각 파일은 작게 유지됩니다. 컨텍스트 예산이 새는 것을 막을 수 있습니다.
12. disableAllHooks - 비상 스위치
위치: ~/.claude/settings.json -> disableAllHooks: true
기능: 하나의 전환으로 모든 후크를 비활성화합니다. 2026 년 3 월 업데이트에서 출시되었습니다. 대부분의 사람들은 이 기능이 있는지 모릅니다.
중요한 이유: Claude Code 가 이상하게 작동하기 시작하면 (팬텀 명령 실행, 시작 시 세션 중단, 의문의 파일 쓰기), 80%는 잘못 작동하는 후크 때문입니다. 후크를 하나씩 비활성화하는 것은 느립니다. 이 기능은 모든 후크를 한 번에 비활성화하여 문제를 격리할 수 있게 해줍니다.
해결 방법: false 로 유지하세요. 문제가 발생하면 true 로 전환하고, 다시 시작하고, 문제가 사라지는지 확인하세요. 그렇다면 후크를 하나씩 다시 활성화하세요. 그렇지 않다면 버그가 다른 곳에 있습니다.
13. 모델 프로젝트별 재정의
위치: .claude/settings.json (프로젝트 루트) -> model
기능: 해당 프로젝트의 기본 모델을 설정합니다. 전역 설정을 재정의합니다.
중요한 이유: 대부분의 사람들은 어려운 작업을 위해 Opus 를 전역적으로 설정합니다. 그런 다음 주로 마크다운 편집 또는 쉘 스크립트 작업인 프로젝트를 엽니다. Haiku 가 1/20 비용으로 수행하는 작업에 Opus 요금을 지불합니다.
해결 방법:
프로젝트 수준 재정의가 적용됩니다. 프로젝트를 열고 올바른 모델을 설정하세요. 계속 진행하세요.
14. enabled 플래그가 있는 mcpServers
위치: ~/.claude/settings.json -> mcpServers
기능: MCP 서버는 Claude 를 외부 도구에 연결합니다. 연결된 각 서버는 전체 도구 스키마를 컨텍스트에 로드합니다. 서버당 800 에서 6,000 토큰까지입니다.
중요한 이유: 사람들은 테스트를 위해 MCP 서버를 연결하고 연결을 끊지 않습니다. 3 개월 후에는 12 개가 연결되어 있고, 그중 3 개만 적극적으로 사용합니다. 사용하지 않는 9 개의 서버는 매 세션 시작 시 약 25-40K 토큰의 컨텍스트 스키마 비용을 발생시킵니다.
해결 방법: enabled 플래그를 사용하여 연결은 구성된 상태로 유지하지만 로드되지는 않도록 하세요.
실제로 필요할 때 세션별로 true 로 전환하세요. 대부분의 날에는 2-3 개가 활성화되어 있습니다. 계획을 세우는 날에는 6 개입니다.
15. cleanupPeriodDays - 아무도 언급하지 않는 캐시
위치: ~/.claude/settings.json -> cleanupPeriodDays
기능: Claude Code 가 기록, 디버그 로그 및 중간 세션 데이터를 유지하는 일수를 설정합니다. 기본값은 30 일입니다.
중요한 이유: Dreaming 과 과거 채팅 검색은 모두 이러한 기록에 의존합니다. 기본 30 일 창을 사용하면 Dreaming 은 한 달의 작업에서만 학습할 수 있습니다. 6 개월은 6 배의 신호를 제공합니다. 디스크 비용: 약 200MB.
해결 방법:
180 일 분량의 세션 기록을 Dreaming, 메모리 통합 및 "3 월에 그 인증 버그에 대해 Claude 에게 뭐라고 말했더라?"라고 찾을 때 자신의 grep 에 사용할 수 있도록 설정하세요.
Claude Code 아티팩트: 7 개의 설정이 모두 적용된 하나의 settings.json
이것을 ~/.claude/settings.json 에 복사하세요. 경로와 플러그인 이름을 사용자 환경에 맞게 조정하세요. Claude Code 를 다시 시작하세요. /permissions 및 /hooks 를 다시 실행하여 모든 것이 로드되었는지 확인하세요.
프로젝트 수준 재정의는 프로젝트 루트의 .claude/settings.json 에 들어갑니다. 가장 유용하게 설정할 수 있는 것은 다음과 같습니다.
섹션 3: API 및 Console (3 개 설정)
이 설정들은 코드 또는 Anthropic Console 에 있습니다. 이 글에서 가장 비용 효율적인 설정입니다. 각각 청구 금액을 30-90%까지 변경할 수 있습니다.
16. cache_control 중단점: 배치할 위치
위치: API 요청 본문, 모든 콘텐츠 블록의 cache_control 필드
기능: 프롬프트의 접두사를 캐시 가능으로 표시합니다. 동일한 접두사를 가진 후속 요청은 전체 요금 대신 입력 요금의 약 10%가 청구됩니다.
중요한 이유: 이것은 API 에서 가장 큰 비용 절감 수단입니다. 사람들은 그 존재를 알고 있습니다. 대부분은 중단점을 잘못 배치하여 부분적인 절감 효과만 얻습니다. 제 설정에서는 중단점을 수정하여 월 $340 청구서를 $87로 줄였습니다.
해결 방법: 중단점은 정적 콘텐츠와 동적 콘텐츠 사이의 경계에 배치됩니다. 중단점 이전의 모든 것은 캐시됩니다. 이후의 모든 것은 다시 계산됩니다.
두 가지 TTL 을 사용할 수 있습니다: 5 분 임시(기본값) 및 1 시간. 세션 간에 변경되지 않는 시스템 프롬프트에는 1 시간을 사용하세요.
캐시 쓰기는 기본 입력보다 25% 더 비쌉니다. 캐시 읽기는 기본 입력의 10%입니다. 교차점: TTL 창 내에서 캐시된 접두사를 2 번 이상 읽으면 이점이 있습니다.
17. inference_geo 및 데이터 상주 세금
위치: API 요청 -> inference_geo 매개변수
기능: 추론을 특정 지리적 지역으로 라우팅합니다. 미국 전용 상주, EU 전용 등입니다.
중요한 이유: 미국 전용 데이터 상주는 Opus 4.7 이상에 10% 프리미엄을 추가합니다. 표준 가격 카드에는 없습니다. 청구서에서 확인할 수 있습니다.
해결 방법: 규정 준수 체제에 실제로 지역 상주가 필요하지 않은 경우 inference_geo 를 설정하지 마세요. 대부분의 앱은 법무 부서에서 "데이터가 미국에 머물러 있는지 확인하세요"라고 말했기 때문에 "안전을 위해" 기본적으로 설정합니다. 요구 사항이 계약상인지 이상적인 것인지 확인하세요. 이상적인 것이라면 매개변수를 생략하고 모든 Opus 호출에서 10%를 절약하세요.
실제로 필요한 경우 10%를 모델 선택에 반영하세요. $3 기본 요금의 Sonnet 은 효과적으로 $3.30이 되며, 이는 Opus 대 Sonnet 의 손익 분기점을 이동시킵니다.
18. 작업공간별 속도 제한 (새벽 3 시 장애를 방지하는 설정)
위치: Console -> 설정 -> 작업공간 -> [작업공간] -> 기능별 속도 제한
기능: 계정 수준 제한과 별도로 작업공간별, 기능별 속도 제한을 설정합니다.
중요한 이유: 계정 수준 제한은 파산을 방지합니다. 작업공간별 제한은 실행 중인 배치 작업이 전체 ITPM 허용량을 소비하려고 할 때 대화형 제품을 보호합니다. 새 기능을 출시하고, 버그가 발생하고, 루프에 빠지고, 모든 것을 소비하고, 고객 대상 채팅이 429 를 반환하기 시작합니다. 작업공간 제한은 한 기능이 다른 기능을 굶주리지 않도록 합니다.
해결 방법: 표면당 하나의 작업공간을 만드세요(대화형 채팅, 배치 처리, 내부 도구, 실험). 각 작업공간의 속도 제한을 계정 등급의 60-70%로 설정하세요. 버스트가 필요한 작업공간을 위해 30%를 예약하세요.
이 글의 네 번째 문서화되지 않은 설정: 각 작업공간 내에는 작업공간 개요가 아닌 특정 기능 카드를 클릭해야만 볼 수 있는 기능 수준 제한이 있습니다. 기본값 = 무제한.
하나의 작업공간에 세 가지 기능이 있는 경우, 그중 하나가 다른 두 기능을 굶주리게 할 수 있으며 작업공간 수준 제한이 이를 포착하지 못합니다. 배치 작업을 수행하는 모든 기능에 대해 기능별 제한을 설정하세요.
섹션 4: 18 개 항목 체크리스트
한 번만 살펴보세요. 20 분이면 충분합니다. 12 개월 동안 건드리지 않은 것은 아마 영원히 건드리지 않을 것입니다.
섹션 5: 감사 스크립트 (매주 실행)
이것을 ~/bin/claude-audit.sh 에 넣으세요. 매주 실행하세요. 체크리스트의 Claude Code 절반과 API 절반의 cache_control 측면을 확인합니다.
저장하고, chmod +x ~/bin/claude-audit.sh 를 실행하고, 각 줄이 목표에 도달할 때까지 매주 실행하세요.
섹션 6: 포함되지 않은 항목
게시하기 전에 네 개의 후보를 제거했습니다. 시간을 낭비하지 않도록 이름을 지정할 가치가 있습니다.
Adaptive Reasoning 전환. Anthropic 이 기본적으로 활성화하여 출시했습니다. 재정의는 설정 → 기능 → 추론 모드에 있습니다. 30 일간 비교한 결과, 재정의가 결과를 의미 있게 변경하는 워크플로우를 찾을 수 없었습니다. 기본값을 신뢰하고 넘어가세요.
Skill 자동 활성화. Claude 가 관련성 감지를 기반으로 스킬을 자동 로드할지 아니면 명시적 호출을 요구할지 전환할 수 있습니다. 이것이 중요할 것이라고 예상했지만 그렇지 않았습니다. 점진적 공개(필요할 때까지 SKILL.md 메타데이터만 로드)를 통한 자동 활성화는 잘 조정되어 있습니다. 켜두세요.
Dispatch 모바일-데스크톱 제어. 유용한 기능이지만 설정 감사 항목은 아닙니다. 이에 맞는 워크플로우가 있거나 없거나입니다. 숨겨진 전환으로 결과가 변경되지는 않습니다.
작업공간별 max_tokens 상한. 모든 응답을 800, 2000 또는 4000 에서 자르도록 강제할 수 있습니다. 말이 많은 워크플로우에서는 실제로 비용을 절약하지만 긴 출력이 필요한 코드 생성을 손상시킵니다. 작업공간별로 테스트할 가치가 있습니다. 기본값으로 권장할 가치는 없습니다.
T H E _ E N D
오늘 밤 체크리스트를 실행하세요. 대부분 6-8 개 항목을 수정할 것입니다. 일부는 14 개 이상을 수정할 것입니다. 청구 대시보드와 사용량 그래프의 숫자가 20 분의 가치가 있었는지 알려줄 것입니다.
북마크하고 오늘 밤 체크리스트를 실행하세요. "Claude 가 멍청해졌다"는 좌절감을 한 달 동안 덜어준다면 다시 게시해 주세요. AI 팁은 Telegram 에서 매일: https://t.me/+_ZWrQN7GuDA3ZDEy
