Claude Code v2.1.316 — 서브에이전트 effort 제어 + Opus 4.8 패스트 모드 종료

"에이전트에게도 집중도를 조절하는 다이얼이 생겼다."

2026년 10월 31일, Claude Code의 최신 버전 v2.1.316이 출시됐다. 이번 업데이트는 숫자는 작아 보이지만, 멀티에이전트 워크플로우를 쓰는 개발자에게는 꽤 실질적인 변화다.

서브에이전트 effort를 환경변수로 제어

이번 릴리스의 핵심은 서브에이전트 effort 지정 기능이다.

Claude Code는 복잡한 작업을 처리할 때 서브에이전트를 띄워 병렬로 처리한다. 예전에는 이 서브에이전트가 얼마나 열심히(=얼마나 많은 토큰을 써서) 생각할지를 코드 레벨에서만 조절할 수 있었다. 이제는 환경변수로 기본값을 설정할 수 있다.

# 서브에이전트 effort를 낮춤 (빠른 반복 작업에 유리)
CLAUDE_SUBAGENT_EFFORT=low claude

# 서브에이전트 effort를 높임 (복잡한 분석 작업에 유리)
CLAUDE_SUBAGENT_EFFORT=high claude

쉽게 말하면, 단순 코드 수정 작업엔 서브에이전트의 '집중 모드'를 낮춰 속도를 높이고, 아키텍처 설계나 복잡한 버그 분석엔 'high'로 올려 더 깊이 생각하게 만들 수 있다.

더 시급한 소식이 있다.

Opus 4.8 Fast Mode가 2026년 11월 30일 완전 종료된다. 이미 10월 30일에 deprecated(사용 중단 예고) 상태가 됐다.

종료 이후 Opus 4.8 Fast Mode로 요청을 보내면:

즉, 지금 워크플로우에서 claude-opus-4-8[1m](Fast Mode) 모델 ID를 쓰고 있다면, 11월 30일 이전에 claude-opus-5-5[1m]으로 변경해야 한다.

Anthropic은 Opus 4.8 Fast Mode 대신 Opus 5.5를 권장한다. Opus 5.5는 Opus 4.8보다 성능이 높으면서도 속도가 유사하다. Fast Mode를 쓰던 이유(빠른 응답)가 Opus 5.5에서 자연스럽게 충족된다.

또 다른 실용적인 변화는 Idle Compaction의 확대다.

대화가 20만 토큰 이상으로 길어진 상태에서 일정 시간 동안 입력이 없으면, Claude Code가 자동으로 대화 내용을 요약(compaction)한다. 이 요약은 프롬프트 캐시가 만료된 뒤 다음 메시지를 보낼 때 컨텍스트로 활용된다.

기존에는 터미널 버전에서만 작동하던 이 기능이 이번 업데이트부터 VS Code 확장과 데스크톱 앱 Code 탭에도 적용됐다. 긴 세션을 유지하면서 작업하는 개발자에게 특히 유용한 변화다.

Tip 1. CI/CD 파이프라인에서 빠른 검증엔 effort=low 단위 테스트 통과 확인이나 린트 오류 수정처럼 간단한 자동화 작업에는 서브에이전트 effort를 낮게 설정해 비용과 시간을 절약하자.

Tip 2. Fast Mode 모델 ID를 Grep으로 찾기 프로젝트 전체에서 claude-opus-4-8\[1m\] 문자열을 검색해 교체가 필요한 파일을 미리 파악하자. grep -r "opus-4-8\[1m\]" . 한 줄이면 충분하다.

Tip 3. VS Code에서 긴 세션을 이어갈 때 Idle Compaction이 자동으로 작동하지만, 중요한 컨텍스트(설계 결정, 제약 조건)는 직접 /memory에 저장해 두는 것이 더 안정적이다.

Sources: