서론

2026년 7월 24일에 출시된 Claude Opus 5는 프론티어급(Frontier-class) 지능을 약 절반 가격으로 제공하며, 100만 토큰의 입력 컨텍스트(Input Context)와 12.8만 토큰의 출력에 대응합니다.

"컨텍스트가 100만 토큰"이라고 해도 감이 잘 오지 않을 수 있지만, 실무적으로는 중규모의 코드베이스(Codebase)나 긴 기술 자료를 분할하지 않고 통째로 던질 수 있다는 의미입니다. 이 기사에서는 이를 활용하여 "리포지토리 전체를 요약하고 개선점을 도출하는" 간단한 파이프라인을 Python으로 구축합니다.

전체상

하는 일은 간단합니다. 대상 디렉토리의 소스를 수집하여 결합하고, 토큰(Token) 수를 개산하여 1M 예산 안에 들어오는지 확인한 뒤, Opus 5에 요약과 개선 제안을 요청하고 그 결과를 Markdown으로 저장합니다.

1. 소스 수집

대상 디렉토리를 재귀적으로 탐색하여 대상 확장자를 가진 파일만 결합합니다.

from pathlib import Path
EXTS = {".py", ".js", ".ts", ".go", ".rs", ".md"}
IGNORE = {".git", "node_modules", "dist", "build", "__pycache__"}
...

2. 토큰 개산

정확한 토크나이저(Tokenizer)가 없더라도 대략적으로 추산하면 예산 관리에는 충분합니다. 안전하게 측면을 고려하여 개산합니다.

def estimate_tokens(text: str) -> int:
# 안전한 개산: 2.5글자 = 1토큰이라고 가정
return int(len(text) / 2.5)
...

3. Opus 5에 요약 요청

import os
import anthropic
client = anthropic.Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])
...

4. 실행

if __name__ == "__main__":
src = collect_sources("./my_project")
print(f"개산 토큰: {estimate_tokens(src):,}")
...

포인트: 1M 컨텍스트의 활용처

분할·요약 전처리를 거치면 모듈 간의 관계가 상실되기 쉽습니다. 1M 컨텍스트의 가치는 문맥을 끊지 않고 전체를 한 번에 읽게 할 수 있다는 점에 있습니다. 횡단적인 설계 리뷰나 리팩터링(Refactoring) 제안에서는 이 "통째로 던지기"가 효과적입니다.

한편, 비용은 입력 토큰에 비례합니다. 가격이 절반으로 줄었다고는 해도 100만 토큰을 매번 던지면 비용이 꽤 발생합니다. 일상적인 가벼운 질문은 경량 모델을, 전체 리뷰는 Opus 5를 사용하는 것이 현실적인 해답입니다.

요약

Claude Opus 5의 1M 컨텍스트는 긴 문맥을 끊지 않고 다룰 수 있다는 점에서 개발 경험을 변화시킵니다. 이번 파이프라인은 50줄 정도이지만, CI에組み込めば(組み込めば) PR(Pull Request)별 자동 리뷰로도 확장할 수 있습니다. 저렴해진 고성능 AI를 단발성 채팅이 아닌 시스템으로 구현하면, 개인 개발에서도 효과가 클 것입니다.

Discussion