← 빌드 일지
AI Lab2026-04-15·3분 읽기

Claude Code 갑자기 멍청해지는 5가지 이유와 해결법

어제까지 잘 되던 Claude Code가 갑자기 시키는 일을 못 하는 거 같은 느낌. 5개월 쓰면서 발견한 5가지 진짜 원인과 즉시 해결법.

Claude가 갑자기 멍청해지는 느낌

Claude Code 쓰다 보면 어떤 날은 천재 같은데 어떤 날은 시키는 일도 제대로 못 하는 느낌이 있다. 모델이 변한 게 아니다. 5개월 매일 쓰면서 5가지 진짜 원인을 발견했다. 각각 즉시 해결 가능.

원인 1 — 컨텍스트 오염 (가장 흔함)

증상: 세션 길어지면 답이 점점 일관성 잃고, 같은 실수 반복.

원인: 세션 컨텍스트에 충돌하는 정보가 누적됨. 예를 들어 처음에는 "Tailwind 쓰자"고 했다가 중간에 "styled-components로 가자"라고 했다가 다시 Tailwind로 돌아가면, Claude의 머릿속에는 둘 다 있어 어느 쪽이 현재 의도인지 헷갈림.

해결:

  • /clear로 새 세션 시작 (강력)
  • 새 세션에서 핵심 결정만 컨텍스트로 다시 던짐 (CLAUDE.md 활용)
  • 한 세션 안에서 큰 결정 변경 회피

원인 2 — 이전 작업 결과의 잔향 (subagent 경우)

증상: 서브에이전트 부르면 그 결과가 좋지 않음. 메인이 시킨 것을 정확히 안 함.

원인: 서브에이전트 부를 때 main 컨텍스트의 최근 turn을 자동 포함시키는데, 그 turn 안에 디버깅 시도 / 실패한 접근 같은 잡음이 섞여 있으면 서브에이전트가 그 잡음을 따라감.

해결:

  • 서브에이전트 부르기 전 main에서 깨끗한 1줄 요약 작성
  • 서브에이전트 prompt에 "지금까지 시도한 방향과 결과를 무시하고, 다음만 해" 명시
  • 또는 새 세션에서 서브에이전트 직접 호출

원인 3 — 모델 버전 자동 변경 (silent 변경)

증상: 평소 결과와 달리 답이 두루뭉술하거나 답변 길이가 갑자기 짧아짐.

원인: Anthropic이 Claude 4.6 → 4.5 → Haiku 4.5 같은 모델 자동 라우팅을 적용하기도 함. 또는 Pro 100 사용량 한도 도달 후 자동으로 더 작은 모델로 fallback.

해결:

  • /status 또는 claude --version으로 현재 모델 확인
  • 명시적 모델 지정: claude --model claude-opus-4-7
  • Pro 한도 체크 (대시보드)

원인 4 — 프롬프트의 모호한 조건문

증상: 작업이 50% 정도 됐다가 멈추거나, 시키지 않은 일을 함.

원인: "X해. 단, Y면 Z 해." 같은 조건문에서 Y/Z가 모호하면 Claude가 추측에 의존. 그 추측이 틀릴 때 작업 방향이 어긋남.

해결:

  • 조건문 명확히: "X해. Y가 false면 작업 멈추고 사용자에게 확인 받아."
  • 사람이 결정하는 부분과 Claude가 결정하는 부분 명시 분리
  • "확실하지 않으면 사용자에게 묻기" 룰을 CLAUDE.md에 박기

원인 5 — 도구 권한 (allowed-tools) 제한

증상: Claude가 작업을 못 끝내고 매번 권한 묻기 함. 또는 단순한 작업에 비효율 우회로.

원인: ~/.claude/settings.jsonallowed-tools 또는 작업 디렉토리의 CLAUDE.md에 도구 제한이 있으면 Claude가 우회로 시도.

해결:

  • 권한 설정 확인:
    cat ~/.claude/settings.json
    
  • 작업에 필요한 도구 명시적 허용
  • Bash(*) 같은 광범위 권한은 신뢰할 수 있는 작업에만

빌더 룰 — 세션 위생 5계명

5개월 쓰면서 만든 자기 룰:

  1. 세션 길이는 짧게 — 3-4시간 넘으면 무조건 새 세션
  2. 결정 변경 시 새 세션 — 큰 방향 바꾸면 깨끗한 시작
  3. 모델 명시 호출 — fallback 의존 X
  4. CLAUDE.md 짧게 유지 — 200줄 이상이면 우선순위 정리
  5. 에러는 사실로 — 디버깅 시도들을 컨텍스트에 누적시키지 말고, 깨끗한 reproduction 만들고 그것만 던지기

흔한 오해

"Claude 자체가 멍청해진 게 아니다. 거의 항상 컨텍스트 / 권한 / 모델 fallback 중 하나."

5개월 동안 "Claude가 갑자기 멍청해졌다"는 느낌의 90%는 위 5개 중 하나로 설명됐다. 모델 자체 변경은 가끔(분기 한 번) 있지만, 일상적 멍청함은 거의 항상 사용자 측 환경 문제.

한 줄 정리

이상한 답을 받으면 가장 먼저: /clear로 새 세션 + CLAUDE.md 점검 + 모델 명시 호출. 이 3가지로 80%의 멍청함이 해결된다.

— Jack

Wildeconforce

매일 만들고, 매일 분석하고, 매일 기록합니다.
© 2026 wildeconforce · build-in-public

이 사이트는 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.