메뉴
HN
Hacker News 5일 전

클로드 쿡북: 고급 AI 에이전트 개발 가이드

IMP
8/10
핵심 요약

클로드(Claude) 쿡북은 개발자들이 클로드를 활용하여 고도화된 AI 에이전트를 구축할 수 있도록 돕는 종합 가이드입니다. 프로그래밍 방식의 도구 호출, 문맥 자동 압축, 멀티 에이전트 오케스트레이션, 그리고 SRE 및 사이버 보안 등 실무에 즉시 투입 가능한 다양한 코드 패턴과 구현 노하우를 제공합니다. 장기 구동 및 대규모 툴 사용 환경에서 발생하는 비용과 지연 시간을 최적화하는 방법을 제시하여 매우 중요합니다.

번역된 본문

클로드 쿡북(Claude Cookbook)에 오신 것을 환영합니다.

[주요 가이드]

  • 프로그래밍 방식 도구 호출(PTC): 클로드가 코드 실행 환경에서 도구를 호출하는 코드를 직접 작성하게 하여 지연 시간과 토큰 소비량을 줄입니다.
  • 임베딩을 활용한 도구 검색: 의미론적 임베딩을 사용한 동적 도구 검색을 통해 클로드 애플리케이션을 수천 개의 도구로 확장합니다.
  • 자동 문맥 압축: 대화 기록을 자동으로 압축하여 장기 실행되는 에이전트 워크플로우에서 문맥 제한을 관리합니다.
  • 향상된 이미지 분석을 위한 자르기(Crop) 도구: 차트, 문서 및 다이어그램을 자세히 분석하기 위해 클로드에게 이미지 특정 영역을 확대하는 자르기 도구를 제공합니다.
  • 프론트엔드 미적 감각을 위한 프롬프팅: 뻔하지 않은 디자인에서 벗어나 세련되고 독특한 프론트엔드 디자인을 이끌어내는 클로드 프롬프팅 가이드입니다.
  • 클로드 스킬(Claude Skills) 소개: 클로드의 엑셀(Excel), 파워포인트(PowerPoint), PDF 스킬을 활용하여 문서를 생성하고, 데이터를 분석하며, 워크플로우를 자동화합니다.

[모든 쿡북 및 카테고리 목록]

• Messages API에서 클로드의 에이전트 검색 벤치마크 점수 재현 (2026년 6월) | 평가(Evals), 도구(Tools) | 작성자: Mengting Li 프로그래밍 방식 도구 호출, 서버 측 압축 및 작업 예산을 사용하여 공개된 DeepSearchQA 및 BrowseComp 점수를 재현하는 Messages API 하네스(테스트 환경)를 구축합니다.

• Claude Fable 5의 분류기(Classifier) 대체 및 빌링 (2026년 6월) | 응답, 안전장치, 빌링 | 작성자: Alexander Bricken, Mahesh Murag, Mikaela Grace Fable 5에서 안전 분류기 차단을 감지하고 스트리밍 동작 및 새로운 결제 변경 사항을 포함하여 서버 측 또는 SDK 기반 클라이언트 측 대체(Fallback)를 통해 Opus 4.8로 전환합니다.

• 비동기 멀티 에이전트 오케스트레이션 (2026년 6월) | 에이전트 패턴 | 작성자: Paul Chen 공유 허브를 통한 피어 메시징이 있는 고정된 N개 에이전트 팀과 동적으로 생성된 비동기 하위 에이전트 등 두 가지 비동기 멀티 에이전트 패턴을 핵심 메시징 및 수명 주기 메커니즘으로 단순화하여 설명합니다.

• 에이전트 호스팅하기 (2026년 6월) | Claude Agent SDK | 작성자: Kevin Tang, Anav Sharma 노트북 00번의 연구 에이전트를 Docker, Modal, Kubernetes의 3단계 운영 성숙도에 걸쳐 모든 계층에서 동일한 컨테이너 이미지와 HTTP 인터페이스를 사용하여 배포합니다.

• 멀티 에이전트: 전문가 팀 조율하기 (2026년 5월) | Claude Managed Agents, Tools | 작성자: Mark Nowicki 멀티 에이전트 코디네이터 구성을 통한 이기종 팀 구성을 다룹니다. 코디네이터는 웹 검색 연구원, 파일 읽기 사서, 규칙 기반 가격 책정자 등 세 명의 전문가를 실행하여 영업 제안서를 작성합니다. 멀티 에이전트 필드, thread_created/thread_message_received 이벤트 유형 및 역할별 도구 범위 지정을 다룹니다.

• 결과(Outcomes): 스스로 작업을 검증하는 에이전트 (2026년 5월) | Claude Managed Agents, Evals | 작성자: Mark Nowicki, Gagan Bhat 평가 및 수정 루프를 구축합니다. 작성자가 인용된 연구 브리프를 작성하고, 상태 비저장(stateless) 평가자가 모든 URL을 가져와 루브릭(Rubric)에 따라 모든 인용구를 확인하며, 브리프가 통과될 때까지 피드백을 통해 수정을 진행합니다.

• 사용자를 기억하는 에이전트 구축 (2026년 4월) | Claude Managed Agents, Tools | 작성자: Gagan Bhat Claude Managed Agents에 메모리 저장소를 제공하여 여러 상호 작용에 걸쳐 사용자의 선호도를 학습하고 기억하도록 합니다.

• 취약점 탐지 에이전트 (2026년 4월) | Claude Agent SDK, 사이버 보안(Cybersecurity) | 작성자: Eugene Yan 클로드 에이전트 SDK를 사용하여 C 대상을 위협 모델링하고, 내장된 파일 도구로 메모리 안전 버그를 찾고, 결과를 구조화된 보고서로 분류하는 취약점 발견 에이전트를 구축합니다.

• Claude Managed Agents를 활용한 SRE 인시던트 대응 에이전트 구축 (2026년 4월) | Claude Managed Agents, 관측 가능성(Observability) | 작성자: Gagan Bhat 클로드를 온콜(On-call) 워크플로우에 연결합니다. 알림이 발생하면 에이전트가 로그 및 런북(Runbook)을 읽고 근본 원인을 파악한 다음 수정 PR을 열고 병합하기 전에 사용자의 승인을 기다립니다.

• 데이터 구축 (Build a dat...)

원문 보기
원문 보기 (영어)
Programmatic tool calling (PTC) Reduce latency and token consumption by letting Claude write code that calls tools programmatically in the code execution environment. Tool search with embeddings Scale Claude applications to thousands of tools using semantic embeddings for dynamic tool discovery. Automatic context compaction Manage context limits in long-running agentic workflows by automatically compressing conversation history. Giving Claude a crop tool for better image analysis Give Claude a crop tool to zoom into image regions for detailed analysis of charts, documents, and diagrams. Prompting for frontend aesthetics Guide to prompting Claude for distinctive, polished frontend designs avoiding generic aesthetics. Introduction to Claude Skills Create documents, analyze data, automate workflows with Claude's Excel, PowerPoint, PDF skills. All Cookbooks All Categories Title Categories Author(s) Date Reproduce Claude's agentic search benchmark scores in the Messages API Jun 2026 • Evals Tools Build a Messages API harness that reproduces published DeepSearchQA and BrowseComp scores, using programmatic tool calling, server-side compaction, and task budgets. Evals Tools Mengting Li Jun 2026 Classifier fallback and billing for Claude Fable 5 Jun 2026 • Responses Safeguards Billing Detect safety classifier blocks on Fable 5 and fall back to Opus 4.8 with server-side or SDK-based client-side fallback, including streaming behavior and the new billing changes. Responses Safeguards Billing Alexander Bricken Mahesh Murag Mikaela Grace Jun 2026 Async multi-agent orchestration Jun 2026 • Agent Patterns Two async multi-agent patterns — a fixed N-agent team with peer messaging through a shared hub, and dynamically spawned async subagents — reduced to their bare messaging and lifecycle mechanics. Agent Patterns Paul Chen Jun 2026 Hosting your agent May 2026 • Claude Agent SDK Deploy the research agent from notebook 00 through three tiers of operational maturity (Docker, Modal, Kubernetes) with the same container image and HTTP interface at every tier. Claude Agent SDK Kevin Tang Anav Sharma May 2026 Multiagent: coordinate a specialist team May 2026 • Claude Managed Agents Tools Heterogeneous team via the multiagent coordinator config — a coordinator runs three specialists (web-search researcher, file-reading librarian, rules-based pricer) with scoped toolsets to assemble a sales proposal. Covers the multiagent field, the thread_created / thread_message_received event types, and per-role tool scoping. Claude Managed Agents Tools Mark Nowicki May 2026 Outcomes: agents that verify their own work May 2026 • Claude Managed Agents Evals Build a grade-and-revise loop with Outcomes: a writer drafts a cited research brief, a stateless grader fetches every URL and checks every quote against a rubric, and feedback drives revisions until the brief passes. Covers user.define_outcome, the span.outcome_evaluation_* events, and how to write a rubric the grader can act on. Claude Managed Agents Evals Mark Nowicki Gagan Bhat May 2026 Build agents that remember your users Apr 2026 • Claude Managed Agents Tools Give your Claude Managed Agents a Memory store so they learn and remember your users' preferences across multiple interactions. Claude Managed Agents Tools Gagan Bhat Apr 2026 The vulnerability detection agent Apr 2026 • Claude Agent SDK Cybersecurity Build a vulnerability-discovery agent with the Claude Agent SDK that threat-models a C target, hunts memory-safety bugs with built-in file tools, and triages findings into a structured report. Claude Agent SDK Cybersecurity Eugene Yan Apr 2026 Build an SRE incident response agent with Claude Managed Agents Apr 2026 • Claude Managed Agents Observability Wire Claude into your on-call flow: when an alert fires, the agent reads logs and runbooks, pinpoints the root cause, opens a fix PR, and waits for your approval before merging. Claude Managed Agents Observability Gagan Bhat Apr 2026 Build a data analyst agent with Claude Managed Agents Apr 2026 • Claude Managed Agents Tools Build an analyst that turns a CSV into a narrative HTML report with interactive charts, using a sandboxed environment and file mounting. Claude Managed Agents Tools Charmaine Lee Jess Yan Apr 2026 Build a Slack data analyst bot with Claude Managed Agents Apr 2026 • Claude Managed Agents Integrations Mention the bot with a CSV to get an analysis report in-thread, with multi-turn follow-ups on the same session. Claude Managed Agents Integrations Charmaine Lee Apr 2026 Managed Agents tutorial: iterate on a failing test suite Apr 2026 • Claude Managed Agents Tools Entry-point tutorial for the Claude Managed Agents API. Walks through agent / environment / session creation, file mounts, and the streaming event loop by getting an agent to fix three planted bugs in a calc.py package. Claude Managed Agents Tools Paul Yang Apr 2026 Managed Agents tutorial: production setup Apr 2026 • Claude Managed Agents Integrations End-to-end production story for Managed Agents — vault-backed MCP credentials, the session.status_idled webhook pattern for human-in-the-loop without long-lived connections, and the resource lifecycle CRUD verbs. Claude Managed Agents Integrations Paul Yang Apr 2026 Managed Agents tutorial: prompt versioning and rollback Apr 2026 • Claude Managed Agents Evals Server-side prompt versioning — create v1, evaluate against a labelled test set, ship v2, detect a regression, roll back by pinning sessions to version 1. Covers agents.update, version pinning on sessions.create, and where the review gate moves when prompts are not code. Claude Managed Agents Evals Mark Nowicki Apr 2026 Threat intelligence enrichment agent Apr 2026 • Tools Agent Patterns Cybersecurity Build an agent that autonomously investigates IOCs by querying multiple threat intel sources, cross-referencing findings, mapping to MITRE ATT&CK, and producing structured reports for SIEM and SOAR integration. Tools Agent Patterns Cybersecurity Jannet Park Apr 2026 Building a session browser Mar 2026 • Claude Agent SDK Agent Patterns List, read, rename, tag, and fork Agent SDK sessions on disk to build a conversation history sidebar without writing a transcript parser. Claude Agent SDK Agent Patterns Qing Wang Mar 2026 Knowledge graph construction with Claude Mar 2026 • RAG & Retrieval Tools Build knowledge graphs from unstructured text using Claude for entity extraction, relation mining, deduplication, and multi-hop graph querying. RAG & Retrieval Tools Anthropic Mar 2026 Context engineering: memory, compaction, and tool clearing Mar 2026 • Tools Agent Patterns Compare context engineering strategies for long-running agents and learn when each applies, what it costs, and how they compose. Tools Agent Patterns Isabella He Mar 2026 Migrating from the OpenAI Agents SDK Mar 2026 • Claude Agent SDK Agent Patterns Port an OpenAI Agents SDK app to the Claude Agent SDK, mapping each primitive (tools, guardrails, sessions, handoffs) through a single expense-approval agent example. Claude Agent SDK Agent Patterns Preston Tuggle Mar 2026 The site reliability agent Feb 2026 • Claude Agent SDK Agent Patterns Build an incident response agent with read-write MCP tools for autonomous diagnosis, remediation, and post-mortem documentation. Claude Agent SDK Agent Patterns Ben Lehrburger Isabella He Feb 2026 Session memory compaction Jan 2026 • Agent Patterns Responses Manage long-running Claude conversations with instant session memory compaction using background threading and prompt caching. Agent Patterns Responses Joe Shamon Jan 2026 Programmatic tool calling (PTC) Nov 2025 • Tools Reduce latency and token consumption by letting Claude write code that calls tools programmatically in the code execution environment. Tools Pedram Navid Nov 2025 Tool search with embeddings Nov 2025 • Tools RAG & Retrieval Scale Claude applications to thousands of tools using semantic embeddings for dynamic tool discovery. Too