Claude Code - SubAgent 400 에러

Claude Code - Sub Agent

최근 클로드 코드 $100짜리 요금제로 업그레이드 한 후부터 가능한 많이 사용하고 있는 중이다.

지금은 토이프로젝트 중 하나를 온전히 클로드 코드한테만 맡겨서 진행해보고 있는 중인데
오늘은 갑자기 말을 안들어서 말을 듣게 하기까지 과정을 남겨보려고 한다.
사실 정확한 원인은 모르지만 어찌저찌 해결은 되었기에..
혹시나 같은 일을 겪을지 모르는 다른 사람들을 위해 남겨본다.

결론만 필요한 급한 사람이 있을 수 있으니 그냥 결론 먼저 쓰자면
claude code를 그냥 껐다 다시 켰더니 되었다.

현재 작업 플로우

지금 클로드코드에게 일을 시킬 때 작업 진행 순서를 정해두었다.
간략히 써보자면 다음과 같다.

Task Master에서 다음 작업 확인
간략히 작업 계획 프리뷰 후 작업 승인
작업 진행
작업 후 작업 결과 1차 검증(간단히 코드 문법 같이 가벼운 검증)
2차 검증 : code-reviewer sub agent로 코드 리뷰
코드 리뷰 후 이상 있으면 재작업
코드 리뷰 이상 없으면 마무리

토큰이 조금 낭비되고 내가 개입해야하는 절차가 있긴하지만 prd가 부실해서 관리감독을 안하면
어디로 튈지 모르기 때문에 위와 같이 진행하도록 지시해두었다.

절차를 보면 알겠지만 코드 리뷰의 경우에는 sub agent를 사용하도록 지시해두었는데
오늘 따라 리뷰 절차가 너무 빠르고 너무 아무 이슈가 없다고.. 보고를 받았다.

처음에는 오.. 결과물이 좋아서 그런가보다 하고 다음 작업으로 넘어갔었는데
계속 리뷰가 너무 깔끔하게 끝나서 제대로 확인해보니 agent를 안쓰고 스스로 리뷰를 하고 있었다...
그동안 코드는 오류가 쌓여버렸고..

왜 agent를 안썼냐고 물어보니 오류가 발생해서 직접 리뷰를 했다고 한다.
무슨 오류가 발생하냐 했더니 툭 던져진 오류 ..

  API Error: 400 - `clear_thinking_20251015` strategy requires `thinking` to be enabled

이 오류가 왜 발생하는건지 바로 물어봤고 이건 사용자도, 자기 스스로도 설정할 수 없는 부분이라며
그냥 자기가 계속 리뷰를 하겠다며....

해결책

오류 원인이 내가 뭔가 잘못 설정한걸 수도 있으니, 검색을 해봤는데 이렇다할 자료를 찾을 수 없었다. 비슷한 경우도 없고 clear_thinking_20251015를 검색해보니 앤트로픽 공식 문서에서 언급은
되고 있었는데 내가 겪고 있는 상황에 대한 해결책은 아닌 것 처럼 보였다.

클로드 코드 형제 격인 클로드 데스크탑에도 좀 찾아보라고 시켜봤다.
얘는 깃허브를 뒤져본건지 알려진 버그라면서 이슈 링크를 하나 가져왔다.
issue #1179

들어가보니 같은 400 오류긴한데 메시지가 달라서 동일한 상황이 아니었고, 단순히 thinking 키워드에
꽂혀서 찾아온 이슈인 것 같았다.

그러다 하나의 agent만 안되는게 아니라 전부 다 안되는걸 확인헀고, 해결을 꼭 해야할 것 같아서
클로드 형제한테 해결 방법 좀 제시하라고 했더니 코드가 다음과 같이 대답을 해주었다.

⏺ 현재 상황 정리:

  1. 이것은 Claude Code의 알려진 버그입니다
    - 약 1주일 전부터 발생
    - GitHub Issues에 보고됨 (#11231, #1183)
    - clear_thinking_20251015 strategy와 관련된 API 요청 문제
  2. 영향 범위:
    - 모든 Task tool agents (code-reviewer, flutter-developer 등)
    - WebFetch tool도 영향받음
    - thinking이 필요한 모든 작업
  3. 왜 아까는 됐을까?
    - API나 Claude Code가 최근 업데이트되었을 가능성
    - 세션이나 환경이 달라졌을 가능성

  가능한 해결책:

  1. Claude Code 재시작 - 세션 리셋
  2. Claude Code 업데이트 - 버그 픽스가 있을 수 있음
  3. 임시 우회: agent 없이 작업 진행

상황 정리 1번은 데스크탑이 찾아준 이슈 말고 다른게 있어서 봤더니 내 상황과 비슷했다.
하지만 이슈는 오픈 상태이고 댓글에도 해결책은 보이지 않았다.

해결책 중에 해볼 수 있는건 결국 1번과 2번인데 2번을 하려면 어차피 클로드코드를 꺼야하니
끄고 업데이트 명령을 쳐봤다.

$ claude update
Current version: 2.0.42
Checking for updates...
Claude Code is up to date (2.0.42)

최신 버전 확인 완료. 다시 클로드 코드 실행..

$ claude

/resume으로 이전 세션으로 돌아가서 agent 테스트 해봐. 했는데?
거짓말 처럼 정상 동작을 하는 모습..

뭐든 껐다가 다시 키면 잘되는구나? AI도 역시 그런거구나