Claude Cookbook: Anthropic이 공개한 Claude 활용 레시피 모음

TL;DR Highlight

Anthropic이 에이전트·툴 호출·RAG·캐싱 예제를 한곳에 모은 레시피 목록을 공개했다

Who Should Read

Claude API로 에이전트나 RAG를 만들면서 공식 예제 코드를 참고하고 싶은 백엔드 개발자

Core Mechanics

Claude Cookbook은 예제 모음 사이트다
- Claude 활용법을 다룬 실용 가이드와 예제를 카테고리별로 모아 둔 목록이다.
- 카테고리는 Agent Patterns, Tools, RAG & Retrieval, Evals, Observability, Multimodal, Skills, Thinking, Fine-Tuning 등이다.
툴 호출 최적화 레시피가 있다
- Programmatic tool calling(PTC)은 Claude가 코드 실행 환경에서 툴을 호출하는 코드를 직접 짜게 해서 지연과 토큰 소비를 줄이는 방법이다.
- Tool search with embeddings는 임베딩으로 필요한 툴을 동적으로 찾아 수천 개 툴까지 확장하는 방법이다.
긴 대화 컨텍스트 관리 레시피가 있다
- Automatic context compaction은 대화 기록을 자동으로 압축해 장시간 에이전트 작업의 컨텍스트 한도를 관리한다.
- Session memory compaction은 백그라운드 스레드와 프롬프트 캐싱으로 즉시 압축한다.
비용·속도 관련 레시피도 있다
- Message Batches API 레시피는 비동기 처리로 비용 50% 절감을 내세운다.
- Speculative prompt caching은 사용자가 질문을 쓰는 동안 캐시를 미리 데워 첫 토큰까지의 시간을 줄인다.
RAG·평가 레시피가 있다
- Contextual retrieval은 청크에 맥락을 붙여 임베딩해 RAG 정확도를 높이는 방법이다.

Community Reactions

공식 가이드 무용론이라는 의견
- 어차피 AI에게 물어보거나 하니스에 내장될 것이라 대부분 사소하고, 에이전트 워크플로 자료는 쇼에 가깝다는 의견이 있었다.
- 레시피는 결국 다음 모델 버전에 흡수된다는 의견도 있었다.
프론트엔드 미학 예제 품질 지적
- 전후 이미지가 둘 다 밋밋하거나 그라데이션만 더한 수준이라는 의견이 있었다.
- 표 간격 같은 UI 기본기도 안 맞는다는 지적이 있었다.
유지보수 우려와 대안 소개
- Copilot·OpenAI도 초기에 예제를 쏟아내고 이후 관리가 안 됐다는 경험이 공유됐다.
- OpenAI Cookbook도 함께 볼 만한 자료로 소개됐다.
CLAUDE.md는 없는 게 낫다는 의견
- 기술 스택이나 테스트 방식은 코드에서 드러나야 하므로 CLAUDE.md에 적을 이유가 없다는 의견이 있었다.

How to Apply

Cookbook에서 지금 쓰는 패턴 하나 찾아 읽기
- 오늘 에이전트 툴이 많거나 토큰이 많이 든다면 PTC와 Tool search with embeddings 레시피부터 읽어라.
- 현재 구현과 비교해 바꿀 부분을 메모하라.
긴 에이전트 세션에 컨텍스트 압축 적용하기
- 대화가 길어지는 에이전트에 Automatic context compaction 레시피를 붙여 보라.
- 압축 전후 토큰 수와 답변 품질을 비교하라.
반복 호출에 캐싱·배치 적용하기
- 실시간이 필요 없는 대량 요청은 Message Batches API로 옮겨라.
- 응답 속도가 중요한 곳은 Speculative prompt caching 레시피로 첫 토큰 지연을 측정하라.

Try It

복사해서 바로 해보기

# Claude에 그대로 붙여넣기 (Cookbook 레시피 선택용 간이 프롬프트)

나는 Claude API로 아래와 같은 서비스를 운영 중이다.
{{서비스 설명}}

현재 문제는 다음이다.
{{지연, 비용, 컨텍스트 초과, 툴 개수 등 문제}}

아래 Claude Cookbook 레시피 중 어떤 것을 먼저 적용할지 우선순위를 정해 달라.
- Programmatic tool calling
- Tool search with embeddings
- Automatic context compaction
- Speculative prompt caching
- Batch processing with Message Batches API
- Contextual retrieval

각 레시피마다 적용 이유와 30분 안에 해 볼 실험을 한 줄씩 써 줘.

이어서 해 볼 것: 1순위 레시피의 원문 노트북을 열어 내 코드와 차이를 비교해 봐.

Terminology

Programmatic tool calling툴을 하나씩 호출하는 대신 Claude가 툴 호출 코드를 한 번에 짜서 실행 환경에서 돌리는 방식이다. 심부름을 일일이 시키지 않고 할 일 목록 스크립트를 넘기는 것과 비슷하다.

Context compaction긴 대화 기록을 요약·압축해 컨텍스트 한도 안에 유지하는 기법이다. 회의록을 요약본으로 갈아끼우는 것과 같다.

Contextual retrieval문서 조각(청크)에 주변 맥락 설명을 붙여서 임베딩하는 RAG 개선 기법이다. 책 한 페이지에 챕터 제목을 붙여 두는 것과 비슷하다.

Managed AgentsAnthropic이 세션·환경·메모리 등을 관리해 주는 에이전트 실행 서비스다.