Claude Code 품질 저하 원인 파악하기: reasoning effort 설정 확인법

지난 두 달간 Claude Code 결과물이 예전만 못하다는 얘기가 커뮤니티에서 꽤 많이 나왔어요. 모델 자체가 나빠진 거 아니냐는 의심도 있었는데, Anthropic이 공식 포스트모템을 내놓으면서 원인이 세 가지였다고 밝혔어요. 그 중 하나가 reasoning effort 기본값이 high에서 medium으로 낮아진 것이었어요. 모델 문제가 아니라 Claude Code 하네스 설정 문제였던 거예요.

지금 Claude Code를 쓰고 있다면 현재 effort 설정이 어떻게 돼 있는지 바로 확인해볼 수 있어요. 30초면 충분해요.

준비물

• Claude Code 최신 버전 (터미널에서 claude --version으로 확인)
• Claude Code가 실행되는 프로젝트 디렉터리

스텝

1. Claude Code 세션 열기

확인하려는 프로젝트 폴더에서 Claude Code를 실행해요. 어떤 프로젝트든 상관없어요. effort 설정은 세션 단위라, 세션을 새로 열 때마다 적용 상태를 확인하면 돼요.

cd <YOUR_PROJECT_DIR>
claude

2. 현재 reasoning effort 확인하기

Claude Code 세션 안에서 /effort를 인자 없이 입력하면 v2.1.111부터 인터랙티브 슬라이더가 열려요. 방향키로 현재 선택된 레벨이 어디인지 바로 보이고, Enter로 확정하면 돼요.

/effort

슬라이더에 medium이 선택되어 있다면 품질 저하를 겪었을 가능성이 있어요. 이 상태가 기본값으로 내려가 있던 게 문제였거든요. 세션 헤더(상태 표시줄)에서도 현재 effort 레벨을 실시간으로 확인할 수 있어요.

3. high 또는 xhigh로 올리기

effort 값을 바꾸려면 /effort 뒤에 원하는 레벨을 붙여서 입력해요.

/effort high

더 복잡한 추론이 필요한 작업이라면 xhigh도 쓸 수 있어요.

/effort xhigh

xhigh는 응답이 좀 느려지는 대신 추론 깊이가 올라가요. 아키텍처 설계나 복잡한 버그 추적처럼 시간이 걸려도 되는 작업에 맞아요.

확인 방법

설정 후 /effort를 다시 입력하면 슬라이더에 변경된 레벨이 강조되어 있어요. 세션 헤더(상태 표시줄)에도 현재 레벨이 그대로 노출돼요.

low·medium·high·xhigh 레벨은 세션을 새로 열어도 그대로 유지돼요. max만 세션 단위로 초기화되니, max를 자주 쓰는 작업이라면 시작할 때 한 번 더 설정해야 해요. 영속 적용을 자동화하고 싶으면 환경변수 CLAUDE_CODE_EFFORT_LEVEL을 셸 프로필에 박아두거나, 실행 시 --effort 플래그를 붙여요.

export CLAUDE_CODE_EFFORT_LEVEL=high
# 또는 일회성 실행
claude --effort high

응용

스킬·서브에이전트 frontmatter에 effort 레벨을 적어두면, 해당 호출 단위로만 override할 수 있어요. 정확도가 중요한 테스트 작성 같은 작업엔 xhigh, 빠른 반복이 필요한 작업엔 medium처럼 작업 성격에 맞게 분리해서 쓸 수 있어요.

트러블슈팅

/effort 커맨드를 쳤는데 unknown command 에러가 나온다면 Claude Code 버전이 오래된 거예요. 빌트인 업데이터인 claude update로 올리는 게 가장 깔끔해요. Homebrew·WinGet 사용자는 각각 brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode로 올려요. npm 설치는 v2.1.15부터 deprecated라 가능하면 다른 방식으로 옮기는 게 좋아요.

설정을 high로 올렸는데도 응답 품질이 이전과 다르게 느껴진다면, 나머지 두 가지 원인도 있었다는 점을 기억하세요. effort는 세 가지 중 하나였어요.

이 설정 하나로 모든 게 해결되진 않지만, 확인하는 데 30초밖에 안 걸리니까 일단 여기서 시작하면 돼요.