
Claude Code v2.1.218~221 요약: fast mode는 별도 과금, 무엇을 시도해야 할까
요약
Claude Code v2.1.218~221 업데이트 내용을 다룹니다. Opus 5가 기본 모델로 채택되었으며, 속도 중심의 fast mode 도입에 따른 별도 과금 체계와 주의사항을 설명합니다. 또한 코드 리뷰 방식의 개선과 서브 에이전트 계층 구조 확장 소식을 전합니다.
핵심 포인트
- Opus 5가 기본 모델로 전환되었으며 100만 토큰 컨텍스트 지원
- fast mode는 일반 모드보다 2배 비싸며 별도 종량제 크레딧 사용
- code-review 명령어가 백그라운드 서브 에이전트로 실행되어 컨텍스트 압박 감소
- 서브 에이전트의 계층 구조(nesting)가 최대 3단계까지 확장
Claude Code의 2026년 8월 첫째 주에는 v2.1.218부터 v2.1.221까지 총 4번의 업데이트가 있었습니다. Opus 5가 기본 모델이 된 것 외에도, 코드 리뷰(code review) 실행 위치나 서브 에이전트(sub-agent)의 계층 구조 등 일상적인 사용에 직접적인 영향을 미치는 변경 사항들이 이어지고 있습니다. 이 기사에서는 영상을 보지 않은 분들도 이해할 수 있도록, 오늘부터 바로 시도해 볼 수 있는 변경 사항과 조건부로 주의가 필요한 변경 사항을 정리합니다.
Opus 5가 기본 모델로, fast mode는 별도 계정
v2.1.219에서 Claude Code의 기본 Opus가 Opus 5로 전환되었습니다. 컨텍스트(context)는 100만 토큰, 최대 출력은 12만 8천 토큰입니다. 지식 컷오프(knowledge cutoff)는 2026년 5월로, 이전의 상위 모델들보다 최신 정보를 담고 있습니다. 가격은 입력 100만 토큰당 5달러, 출력이 25달러로 이는 이전의 Opus 4.8과 동일합니다. 여기까지는 추가적인 판단 없이 사용할 수 있는 변경 사항입니다.
반면, 동일한 Opus 5를 속도 우선으로 구동하는 "fast mode"라는 설정이 있습니다. 최대 2.5배 빨라지지만, 단가는 입력 10달러·출력 50달러로 일반 모드의 정확히 2배입니다. 속도와 단가의 관계만 보면 납득할 수 있는 범위이지만, 주의해야 할 점은 과금 방식입니다. fast mode는 구독 플랜의 이용 한도에 포함되지 않으며, usage credits라는 별도의 종량제 크레딧에서 차감됩니다. 플랜에 잔여 한도가 있더라도, fast mode를 사용한 분량은 첫 1토큰부터 usage credits로 계상됩니다.
또한, 대화 도중에 fast mode를 활성화하면, 그 시점까지 쌓인 전체 컨텍스트에 대해 fast mode의 미캐시(uncached) 입력 단가가 단 한 번 적용됩니다. 대화가 길어질수록 이 부담은 커집니다. 따라서 사용한다면 세션 시작 직후에 전환하는 것이 안전합니다. 과도한 사용을 방지하기 위한 설정으로는, fastModePerSessionOptIn을 true로 설정하여 매번 Off 상태로 시작하는 방법과, CLAUDE_CODE_DISABLE_FAST_MODE=1로 완전히 무효화하는 방법이 있습니다. 참고로 Opus 4.7의 fast mode는 2026년 7월에 삭제되었으므로, 화면상으로는 선택 가능한 것처럼 보여도 실제로는 API 측에서 거부됩니다. 따라서 Opus 5 또는 4.8로의 전환이 필요합니다.
code-review가 대화 외부에서 실행되도록 변경
v2.1.218에서 /code-review 명령어가 백그라운드 서브 에이전트(sub-agent)로서 실행되도록 변경되었습니다. 이전에는 리뷰의 중간 과정이 모두 메인 대화로 흘러 들어와, 리뷰가 길어질수록 대화의 컨텍스트를 압박했습니다. 이 변경 이후에는 리뷰가 뒷단에서 실행되며, 대화에는 결과만 반환됩니다. 리뷰를 진행하는 동안에도 본래의 작업을 멈추지 않고 계속할 수 있습니다.
이와 함께 /ultrareview 관련 버그도 2건 수정되었습니다. 하나는 자연어로 지시했을 때 실패하던 문제입니다. 앞으로는 현재 브랜치를 리뷰 대상으로 삼고, 지시문은 리뷰를 위한 메모로 취급됩니다. 다른 하나는 대화형이 아닌 세션에서 /code-review ultra를 실행할 경우, 클라우드의 멀티 에이전트(multi-agent) 리뷰가 아닌 로컬의 가벼운 리뷰로 조용히 전환되던 문제입니다. CI 등에서 호출하고 있는 경우에는 영향이 있었으므로, 업데이트 여부를 확인해 볼 가치가 있습니다.
서브 에이전트 계층 구조가 깊이 3까지 확장
v2.1.219에서는 서브 에이전트가 자식 서브 에이전트를 추가로 생성할 수 있는 "계층(nesting)"의 깊이가 기본적으로 1에서 3으로 확장되었습니다. 이전에는 부모가 자식 서브 에이전트를 생성하는 시점에서 분할이 끝났지만, 이제는 자식이 손자를, 손자가 증손자를 생성할 수 있습니다. 조사를 분할하고, 그 안에서 다시 분할하는 식의 구성이 가능해졌습니다.
이에 따라 화면 없이 구동하는 headless 실행의 stream-json 출력에도 변경이 있습니다. 깊이 2 이상의 서브 에이전트 출력이 --forward-subagent-text 옵션을 추가함으로써 전달되도록 되었습니다. 무인으로 구동하는 배치(batch) 처리 중 중간에 막혔을 때도, 로그를 추적하는 것만으로 원인을 파악하기 쉬워집니다.
한 번에 실행하는 에이전트의 수에 대해서도 기본 기준이 15체 미만(workflowSizeGuideline: medium)으로 변경되었습니다. 계층을 너무 깊게 만들고 싶지 않다면 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1로 설정하여 기존 동작으로 되돌릴 수 있습니다. 이 두 가지 사항은 CHANGELOG의 v2.1.219 내용만을 근거로 하며, 공식 문서에는 아직 기재되어 있지 않습니다.
zsh 권한 바이패스 및 기타 수정 사항
v2.1.221에서는 보안과 관련된 수정 사항이 포함되었습니다. zsh의 이중 대괄호 조건식, 즉 [[ $x =~ $(command) ]]와 같은 형태 내부에 명령 치환 (command substitution)을 숨길 경우, 권한 확인을 거치지 않고 해당 명령이 실행되어 버리는 문제입니다. 이 수정이 포함된 v2.1.221로 업데이트하기 전까지는 해결되지 않습니다.
이 외에도 print 모드(-p)에서 --mcp-config의 MCP 서버가 첫 번째 턴이 완료되기 전에 연결을 마치지 못했던 문제나, 샌드박스(sandbox)에서 허용 리스트 외의 호스트로의 통신을 확인 없이 거부하는 sandbox.network.strictAllowlist 설정이 추가되는 등, 무인 운용 및 자동화와 관련된 수정 사항들이 나열되었습니다. MCP 서버 연결 실패 시 HTTP 상태 코드와 에러 본문이 표시되도록 개선된 점이나, Esc 키로 대화를 취소하고 재전송할 때 파일 지정이 자동으로 해제되어 버리는 문제의 수정 또한 세세하지만 실무에 영향을 미치는 부분입니다.
타사 속도 우선 모드와의 차이점
Claude Code의 fast mode와 유사한 이름의 기능은 타사의 도구에도 존재합니다. 다만 내용은 정반대입니다. Codex CLI의 속도 우선 모드는 약 1.5배 빠르지만, 크레딧 소비는 2배에서 2.5배가 됩니다. 속도 향상 대비 단가 상승 폭은 Claude Code가 더 정직한 편이지만, 플랜 이용 한도(quota) 외에서 과금되는 것은 Claude Code뿐입니다. Cursor와 Gemini Code Assist의 경우, 확인된 범위 내에서는 속도 우선 모드 자체가 없으며, Cursor는 병렬로 실행하는 에이전트의 수로, Gemini Code Assist는 하루당 횟수로 차이를 두는 설계로 되어 있습니다 (2026년 8월 기준 각 사 공개 정보).
개인이나 소규모 팀이라면 대기 시간을 직접 돈으로 살 수 있는 fast mode나 Codex의 속도 우선 모드가 효과적입니다. 인원이 늘어날수록 속도 모드는 사용하는 인원수만큼 비용이 선형적으로 증가하기 때문에, 코드 리뷰 (code-review) 백그라운드 실행과 같은 자동화부터 도입하는 것이 비용을 절감하기에 더 쉽습니다.
출처
- CHANGELOG
- v2.1.219 릴리스 노트
- v2.1.221 릴리스 노트
- fast mode 문서
- 커맨드 문서
- 샌드박스 문서
- Codex Speed
- Cursor 문서
- Gemini Code Assist 문서
설정 이름이나 환경 변수, '깨달음 투어 (noticing tour)'의 나머지 항목 등 이 글에 다 쓰지 못한 내용은 영상 본편에 정리해 두었습니다. 다음 내용은 여기서 확인하실 수 있습니다:
Discussion

AI 자동 생성 콘텐츠
본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기