Claude Code의 성능 저하를 해결하기 위한 설정 및 워크라운드 가이드

커뮤니티 반응

작성자가 제시한 구체적인 설정값과 스크립트가 GitHub 이슈(#42796)의 해결책으로 공유되었으며, Anthropic 엔지니어의 발언을 인용하는 등 기술적 신뢰도가 높게 평가받고 있다.

주요 논점

01찬성다수

기본 설정의 Adaptive Thinking이 복잡한 코딩 작업에서 모델의 성능을 저하시키므로 수동 제어가 필요하다

합의점 vs 논쟁점

합의점

Claude Code의 기본 설정이 특정 상황에서 모델의 추론 능력을 제한하고 있다
settings.json 수정을 통해 모델의 행동 방식을 세밀하게 조정할 수 있다

논쟁점

Effort Level을 High로 설정하는 것만으로는 성능 향상이 제한적이며 다른 설정과 병행해야 효과가 있다

실용적 조언

~/.claude/settings.json 파일에 effortLevel을 high로, showThinkingSummaries를 true로 설정하여 모델의 사고 과정을 모니터링하라
jq 도구를 사용하여 설정 파일이 올바른 JSON 형식인지, 워크라운드가 정상적으로 적용되었는지 검증하라

섹션별 상세

Adaptive Thinking 기능을 비활성화하여 모델이 추론 토큰을 임의로 줄이는 현상을 방지했다. Opus 4.6 모델부터 도입된 이 기능은 모델이 스스로 판단하여 추론량을 결정하는데, 중요한 작업에서 추론 토큰을 과소 할당하는 문제가 확인되어 환경 변수 설정을 통해 이를 강제로 껐다.

Stop-Phrase Guard Hook을 도입하여 모델이 작업을 회피하거나 조기에 중단하려는 30개 이상의 특정 문구를 감시한다. Bash 스크립트가 모델의 출력 종료 시점에 개입하여 '기존의 문제이다' 또는 '새 세션에서 계속하자'와 같은 회피성 문구가 발견되면 작업을 차단하고 계속 진행하도록 강제하는 방식이다.

컨텍스트 윈도우의 자동 압축 임계값을 기존 800K-1M 수준에서 400,000 토큰으로 낮추어 성능을 최적화했다. 컨텍스트가 가득 찼을 때 도구 실행 결과가 사용자 모르게 잘려나가는 현상을 방지하기 위해 더 이른 시점에 압축을 수행하도록 설정값을 조정했다.

모델의 노력 수준(Effort Level)을 기본값인 medium(85)에서 high로 강제 설정하여 전체적인 추론 예산을 확보했다. 2026년 3월 도입된 기본 설정은 추론 예산을 보수적으로 잡는 경향이 있어, 다른 워크라운드와 결합하여 모델이 더 깊게 사고하도록 유도했다.

언급된 도구

Claude Code중립

Anthropic의 CLI 기반 코딩 에이전트 도구

jq추천

명령줄에서 JSON 데이터를 처리하고 검증하는 도구

언급된 리소스

GitHubClaude Code Issue #42796