Claude 모델 선택하기
Opus/Sonnet/Haiku 트레이드오프 — 추측하지 않고 고르는 법.
토큰, 컨텍스트 및 가격
토큰을 정확히 세는 법, max_tokens 대 컨텍스트 윈도우, 비용 추정.
첫 API 호출
SDK를 설치하고 인증한 뒤, Python, TypeScript 또는 cURL로 Claude에 실제 호출을 해보세요.
API Version 2026-10-21 — The First Breaking Version in Three Years
Claude's anthropic-version header moved for the first time since 2023. What breaks, why your package manager decides when you adopt it, and the exact upgrade order.
스트리밍 & 멀티 턴 대화
무상태 API에서 응답을 스트리밍하고 히스토리를 관리하기.
도구 사용 / 함수 호출
도구를 정의하고, 에이전트 루프를 실행하고, 결과를 처리하기 — 400을 유발하는 세 가지 메시지 형태 규칙, 그리고 tool_choice "any"와 "tool"이 최신 Claude 모델에서 이제 오류를 내는 이유까지.
코드 실행 도구 — 샌드박스 Bash, 파일, Python
Anthropic의 서버 사이드 샌드박스는 Claude가 Bash를 실행하고 파일을 편집하고 Python을 돌릴 수 있게 해줍니다 — RAM 5 GiB, 30일간 컨테이너 재사용, 월 1,550시간 무료 티어까지. 세 가지 도구 버전, 각각이 추가하는 것, 언제 무료인지, 그리고 아무도 문서화하지 않은 파일 캡처 함정.
비전, PDF 및 파일 입력
이미지와 문서를 보내고, file_id로 업로드를 재사용하기.
구조화된 출력
믿고 쓸 수 있는 스키마 준수 JSON 얻기 — 프롬프트하고 기도하지 않기.
확장 사고와 노력(Effort)
적응형 추론과 노력(effort) 제어 — 작업량에 따라 사고 깊이 선택하기.
effort 튜닝: 5단계, 모델별 기본값, 그리고 캐시의 함정
2026년 7월의 effort 파라미터에는 low, medium, high, xhigh, max 다섯 단계가 있으며 최상위가 아니라 output_config 안에 들어갑니다. 사고뿐 아니라 도구 호출에도 영향을 주고, 대화 도중에 바꾸면 프롬프트 캐시가 무효화되며, 모델마다 권장 시작점이 다릅니다. 실전 튜닝 가이드입니다.
advisor 도구: Sonnet은 일을 하고, Fable은 생각을 한다
advisor 서버 도구(베타 advisor-tool-2026-03-01)는 빠른 실행자 모델이 턴 도중에 더 강력한 모델에 자문을 구할 수 있게 해줍니다. 전체 필드 레퍼런스, 대부분의 통합 개발자가 놓치는 토큰 계산 함정, 모델 페어링 매트릭스, 그리고 Anthropic이 프로덕션에서 실제로 배포하는 정확한 프롬프트까지.
Task Budgets — 에이전트가 우아하게 마무리하게 만드는 권고형 토큰 상한
2026년 3월 Messages API 베타는 에이전트 루프 전체 — 사고, 도구 호출, 도구 결과, 출력 — 에 토큰 예산을 부여해, 장시간 실행되는 에이전트가 폭주하지 않고 스스로 속도를 조절하며 깔끔하게 마무리하게 합니다. 카운트다운이 작동하는 방식, 왜 강제가 아니라 권고인지, 그리고 거부처럼 보이는 동작을 유발하지 않게 크기를 정하는 방법.
프롬프트 캐싱 & 비용 최적화
안정적인 프롬프트 접두부를 재사용해 비용과 지연을 줄이기 — 그리고 그것을 망가뜨리는 함정.
캐시 진단 — 캐시가 왜 빗나갔는지 정확히 알아내기
cache_read_input_tokens가 0인 이유를 더 이상 추측하지 마세요. API가 프롬프트의 어느 부분이 달라졌는지, 토큰 몇 개만큼 달라졌는지 알려줍니다.
Message Batches — 50% 할인되는 비동기 작업
대량 작업을 비동기 Batches API로 옮겨 비용을 절반으로 줄이고 처리량을 끌어올리는 방법 — 사람들이 흔히 걸려 넘어지는 함정까지 함께.
대화 중 시스템 메시지
프롬프트 캐시를 폭발시키지 않고 긴 에이전트 세션을 조종 — 어떤 user 턴 뒤에나 이어붙일 수 있는 새로운 system 역할.
대화 중 도구 변경
프롬프트 캐시를 무효화하지 않고 턴 사이에 도구를 추가·은퇴 — 긴 에이전트 세션의 가장 큰 숨은 세금을 고치는 Opus 5 베타.
API로 에이전트 구축하기
단일 호출 vs 워크플로우 vs 커스텀 에이전트 — 선택 기준과 루프 설계.
관리형 에이전트
Anthropic 호스팅 에이전트 루프: 에이전트 vs 세션, 환경, 메모리, Vault, 그리고 예약 배포(cron).
관리형 에이전트 메모리 스토어
2026년 7월 베타 — 버전 관리, 감사 추적, 편집(리댁션) 기능을 갖추고 관리형 에이전트 샌드박스에 마운트되는 서버 측 영구 메모리.
Managed Agents 세션 예산
2026년 8월 베타 — Managed Agents 세션에 공식 정가로 시행되는 하드 달러 상한, budget_reached 중지 사유, 요청 하나 분량의 초과, 그리고 일시정지-재개 모델.
Managed Agents 도메인 제한
2026년 8월 26일 베타 — Managed Agents의 web_search와 web_fetch에 적용되는 allowed_domains, blocked_domains, max_content_tokens, user_location. 형식 규칙, 멀티에이전트 의미론, 세션 중간 업데이트, 그리고 url_not_allowed 오류.
Cowork & 에이전트 팀
에이전트형 데스크톱 워크스페이스와 제품으로서의 멀티 에이전트 협업.
MCP와 도구 연결
Messages API에서 원격 MCP 서버를 바로 호출하기 — 요청 구조, 허용/거부 목록, 지연 로딩, 그리고 프로덕션에서 물어뜯는 한계들.
MCP 2026-07-28: 무상태 스펙
런칭 이후 MCP 최대 개정: 세션이 사라졌고, 모든 요청이 스스로를 기술하며, 어떤 서버 인스턴스도 어떤 호출에 응답할 수 있습니다. 2026년 7월 28일에 실제로 무엇이 바뀌었는지, 그리고 오늘의 서버를 깨뜨리지 않고 마이그레이션하는 법.
MCP Apps: 도구 호출 안에서의 인터랙티브 UI
MCP Apps(SEP-1865)는 MCP 서버가 HTML UI를 전송하고 클라이언트가 이를 샌드박스 iframe 안에서 렌더링하도록 하며, 모든 작업은 여전히 표준 JSON-RPC 감사 경로를 통해 라우팅됩니다. 사양이 실제로 말하는 것, 이것으로 무엇을 만들 것인지, 그리고 무엇을 만들지 않을 것인지.
MCP Tasks: 세션 없이 장기 실행 작업 처리하기
2026-07-28 stateless MCP 스펙이 세션을 없애버렸습니다 — 그렇다면 20분짜리 CI 작업, 배치 임포트, 사람 승인 게이트는 어떻게 모델링할까요? 공식 Tasks 확장(SEP-2663)으로 해결합니다. 전체 라이프사이클, 와이어 프로토콜, 기존 실험적 Tasks API에서의 마이그레이션, 그리고 프로덕션에서 실제로 작동하는 폴링/알림 패턴.
Playwright MCP: 실전 심층 가이드 (2026)
Microsoft의 Playwright MCP는 이제 세계 1위 MCP 서버 — GitHub와 Figma를 앞섭니다. 거의 아무도 가르쳐주지 않는 사실: 기본 접근성 스냅샷 모드는 비전보다 빠를 뿐만 아니라 완전히 다른 자동화 패러다임입니다. 프로파일, 옵트인 캡, 실제 Chrome에 연결되는 브라우저 확장 모드, Playwright-as-a-Skill과의 토큰 비용 싸움, 그리고 넘어서는 안 되는 보안 경계.
안전, 거부, 폴백
거부를 우아하게 처리하고 분류기 차단과 구분하기.
서버 사이드 폴백 및 폴백 크레딧
Fable 5 / Opus 5 거부를 단일 API 호출 내에서 정상 응답으로 변환하는 Opus 5 베타 — 그리고 재시도에서 프롬프트 캐시 비용을 두 번 지불하지 않게 해주는 크레딧 토큰.
오류, 속도 제한 & 안정성
오류 지도, 백오프를 사용한 재시도, 속도 제한 등급, 모델 마이그레이션.
메모리 & 컨텍스트 편집
에이전트에 영속적 메모리와 자동 정리되는 컨텍스트를 부여 — 클라이언트 측 memory tool에 더해 오래된 도구 결과를 비워 긴 실행을 견디게 하는 컨텍스트 편집까지.
Conversation Compaction — Summarize History Server-Side and Keep Going
The Messages API can summarize a conversation into one signed block you send back in place of the messages it replaces. The four flavors (on-demand, keep-tail, background, threshold), the swap rules, the two mistakes that fail silently with HTTP 200, and what a summary can never carry.
Tool Search & Deferred Loading
Scale to thousands of tools without context bloat: how defer_loading and the tool search tool actually work, the five 400s they produce, and why your request body does not get smaller.
Message Threads — Send Only the New Turn
The Messages API can keep your conversation on the server and let each turn send only the new messages. What it actually saves (bytes and latency, not tokens), the replay path you must build before you ship, the three field groups, and the 4-breakpoint cache limit.
Programmatic Tool Calling
코드 실행 샌드박스 안의 Python에서 Claude가 여러분의 도구를 호출하게 하기 — 왕복을 줄이고 중간 결과를 컨텍스트 밖에 둡니다.
Admin API: Claude 조직을 자동화하기
Anthropic Admin API 운영자 가이드 — 멤버 목록 조회, 사용자 초대, RBAC 그룹 운영, 깔끔한 오프보딩. Console + Claude Enterprise, 실제 팀이 걸려 넘어지는 seat-pool 및 SSO 함정 포함.
Agent Observability: Tracing an Agent You Can't Reproduce
An agent run is a non-deterministic distributed trace, so you cannot debug it by re-running it — you have to have recorded it. This page covers what to record: the OpenTelemetry GenAI span shapes (and why every gen_ai.* attribute is still 'Development'), Claude Code's exact metric and event names, the request-id that links your trace to Anthropic support, and the three privacy traps in agent telemetry.
First-Party OpenTelemetry Tracing: Two Paths, One Trace
Since October 2026 the Claude API and the Claude SDK emit OpenTelemetry spans themselves — no hand-rolled instrumentation. But the two paths overlap, and summing both will double your token numbers. This page covers the setup for each, the one rule that keeps token counts honest, the traceparent flag that silently deletes your traces, and the delivery rules that disable a destination after 24 hours.
The Usage & Cost Analytics API: Attribute Every Dollar
The practical guide to Claude's Usage and Cost Analytics API — the beta that replaced the legacy usage_report and cost_report endpoints. Row shape, the five-dimension limit, actor semantics, the 100x cents footgun, data-freshness rules that break naive dashboards, and the legacy migration table.
Inference Hooks: Claude Enterprise용 인라인 DLP
Claude Enterprise Inference Hooks에 대한 운영자 가이드 — DLP 서버가 모델이 보기 전에 chat, Claude Code, Cowork 전반의 모든 프롬프트를 허용하거나 거부할 수 있게 해주는 HTTPS 웹훅. 전체 스펙, 판정 스키마, 서명, 롤아웃 플레이북.
User Profiles & Enforcement: Don't Let One Customer Ban Your Whole Org
The operator's guide to Claude API user profiles — attribute every request to an end customer so a safety restriction or ban lands on one profile instead of your entire organization. Full field reference, the four enforcement_status values, the enac_ action schema, organization webhooks, and the polling loop you need because event delivery isn't live yet.