Claude SDK Quest

Tracks

1. 01🧭Claude SDK 지도와 현재의 Claude 표면

   0/8 lessons

   Client SDK · Agent SDK · CLI 세 표면, 모델 라인업, OAuth 지형, 프로바이더 경계

   Anthropic Client SDK, 이름 바뀐 Claude Agent SDK, 그리고 Claude Code CLI를 명확히 분리하자. 일에 맞는 표면을 고르고 Claude 모델 라인업의 현재 좌표를 잡는다.

   Lesson list (8)

   • 01
     Claude SDK는 세 개야, 한 개가 아니라~18 min · sdk-map, client-sdk, agent-sdk, claude-code-cli
   • 02
     현재 Claude 라인업과 모델 고르는 법~16 min · models, opus, sonnet, haiku, model-id
   • 03
     인증 경로: API 키 · 콘솔 · OAuth · Bedrock/Vertex~18 min · auth, api-key, oauth, bedrock, vertex
   • 04
     리전 · 쿼터 · 레이트리밋의 현실~14 min · rate-limits, quota, regions, throughput
   • 05
     Docs는 ground truth, 모델은 의심 대상~12 min · docs, knowledge-cutoff, verification
   • 06
     SDK 경계의 보안과 프라이버시~14 min · security, privacy, secrets, logging
   • 07
     에코시스템 한 눈에: MCP · 도구 · Cookbook~12 min · mcp, ecosystem, cookbook
   • 08
     cwkPippa는 세 표면을 어떻게 다 써~16 min · cwkpippa, self-reference, architecture

   ✓퀴즈 · 4 문제→

2. 02✉️Messages API: 모든 것의 밑바닥 표면

   0/6 lessons

   요청 모양, 시스템 프롬프트, 멀티턴, 스트리밍, 구조화 출력, 그리고 비용 손잡이들

   Messages API는 Anthropic 모든 클라이언트 밑에 깔린 wire format. 요청 모양, 응답 모양, 그리고 네 개 레버(system / messages / max_tokens / stop_sequences)를 마스터하면 SDK는 얇은 편의 wrapper로 보여.

   Lesson list (6)

   • 01
     Messages 요청의 해부학~16 min · messages-api, request, system, max-tokens
   • 02
     시스템 프롬프트: 가장 큰 단일 레버~16 min · system-prompt, instructions, persona
   • 03
     멀티턴 대화와 메모리~14 min · multi-turn, memory, history
   • 04
     스트리밍: time-to-first-token이 중요해~16 min · streaming, sse, events
   • 05
     Stop sequences, stop reasons, 그리고 구조 강제~14 min · stop-sequences, stop-reason, json, structured-output
   • 06
     에러 · 재시도 · 멱등성 스토리~14 min · errors, retries, idempotency, 5xx

   ✓퀴즈 · 4 문제→

3. 03🐍Python SDK 깊이 파기

   0/6 lessons

   동기·비동기, 스트리밍, tool 루프, prompt caching, files, batches를 idiomatic Python으로

   anthropic Python SDK를 작업 도구로 마스터해 — sync vs async 클라이언트, 스트리밍 패턴, tool 루프, prompt caching, Files API, Batch API. 모든 예제는 실행 가능; 모든 패턴은 프로덕션에서 살아남아.

   Lesson list (6)

   • 01
     SDK 설치 · 핀 · 검증~12 min · install, pinning, version
   • 02
     FastAPI와 long-running worker에서 AsyncAnthropic~16 min · async, fastapi, concurrency
   • 03
     스트리밍 헬퍼 · final message · usage~14 min · streaming, stream-helper, usage
   • 04
     Python의 tool 루프: 한 라운드에서 여러 라운드까지~18 min · tool-use, tool-loop, function-calling
   • 05
     진짜 달러 절약을 위한 prompt caching~16 min · prompt-caching, cache-control, ephemeral
   • 06
     Files API와 Batch API: async-first 워크플로우~16 min · files-api, batch-api, async-workflows

   ✓퀴즈 · 4 문제→

4. 04🟦TypeScript SDK 깊이 파기

   0/6 lessons

   엄격한 타입, Node·Edge 스트리밍, tool 루프, Next.js 패턴

   @anthropic-ai/sdk TypeScript 클라이언트를 프로처럼 — 엄격한 타입, Node·Edge 런타임 스트리밍, tool 루프, Next.js Route Handler. Python과 같은 API 표면, 다른 idiom.

   Lesson list (6)

   • 01
     설치 · 타입 · 단일 클라이언트~14 min · install, types, esm, cjs
   • 02
     Node·Next.js에서 스트리밍~16 min · streaming, next-js, route-handler
   • 03
     TypeScript의 typed tool 루프~18 min · tool-use, typed, registry
   • 04
     Typed 에러와 retry 자세~12 min · errors, retries, discriminated
   • 05
     Next.js + Claude: 인증 · Edge · Server Components~16 min · next-js, edge, server-components, rsc
   • 06
     Deno · Bun · 크로스-런타임 현실~12 min · deno, bun, edge, cross-runtime

   ✓퀴즈 · 4 문제→

5. 05🛠️Tool Use: 커스텀 · built-in · 서버 도구

   0/6 lessons

   단일 함수 호출에서 병렬 dispatch, 서버 사이드 도구, code execution, computer use까지

   Tool use는 Claude를 챗봇에서 시스템 컴포넌트로 바꾸는 레버. JSON Schema 가진 커스텀 도구, 병렬-tool 패턴, 서버 도구(web search, code execution, computer use), 그리고 항상 불편한 failure 모드 마스터.

   Lesson list (6)

   • 01
     Tool 정의와 JSON Schema 규율~16 min · json-schema, input-schema, validation
   • 02
     한 라운드의 병렬 tool 호출~14 min · parallel, tool-use, concurrency
   • 03
     Tool 에러 · retry · 모델한테 알려주기~14 min · errors, retries, tool-result
   • 04
     서버 도구: web search · code execution · computer use~16 min · server-tools, web-search, code-execution, computer-use
   • 05
     Tool Runner: 재사용 가능한 루프 추상~14 min · tool-runner, abstraction, library
   • 06
     Tool 보안: permissions · sandbox · side effects~14 min · security, permissions, side-effects

   ✓퀴즈 · 4 문제→

6. 06🗂️Context window · vision · PDF · 문서

   0/6 lessons

   긴 컨텍스트 예산, multimodal 입력, Files API, 컨텍스트 right-sizing

   Claude의 입력 표면 마스터 — 긴 컨텍스트 윈도우, 이미지·PDF 입력, Files API, RAG 패턴, 그리고 모델에 중요한 것만 넣는 규율.

   Lesson list (6)

   • 01
     Context Window: 긴 게 free 아냐~14 min · context-window, tokens, budget
   • 02
     Vision: Claude한테 이미지 보내기~14 min · vision, images, multimodal
   • 03
     PDF 입력: 두 길 · 언제 어느 쪽~14 min · pdf, document, files-api
   • 04
     RAG vs Stuffing: lookup 빈도로 픽~14 min · rag, retrieval, embeddings
   • 05
     요약 · 메모리 압축 · drift~12 min · summarization, memory, compression
   • 06
     아키텍처로서의 컨텍스트~14 min · architecture, context-engine, self-reference

   ✓퀴즈 · 4 문제→

7. 07📈Scale: 비용 · 신뢰성 · observability

   0/6 lessons

   트래픽, surprise, finance review 살아남는 Claude 시스템 만들기

   동작하는 Claude 통합을 프로덕션 scale로 — per-token 비용 규율, 깊은 prompt caching, batch 워크플로우, retry 자세, observability, regression 막는 eval 규율.

   Lesson list (6)

   • 01
     Claude 청구서 해부학~14 min · cost, billing, tokens
   • 02
     깊이 있는 prompt caching 전략~16 min · prompt-caching, breakpoints, ttl
   • 03
     프로덕션의 Batch API 워크플로우~14 min · batch-api, async, evaluation
   • 04
     Retry 자세와 신뢰성 패턴~14 min · retries, reliability, circuit-breaker
   • 05
     LLM 워크로드 observability~14 min · observability, tracing, metrics
   • 06
     Eval 규율: user 발견 전에 regression 잡기~14 min · eval, regression, quality

   ✓퀴즈 · 4 문제→

8. 08🤖Claude Agent SDK 코어

   0/8 lessons

   Claude Code SDK에서 이름 바뀜: 설치, ClaudeAgentOptions, query vs ClaudeSDKClient, sessions, MCP, hooks, slash commands

   Claude Agent SDK가 Claude Code의 자율 에이전트 하니스 — 파일시스템 도구, 명령 실행, persistent 세션, MCP 통합, hooks — 를 프로그래머블 라이브러리로 줘. cwkPippa Claude 브레인을 만든 SDK.

   Lesson list (8)

   • 01
     이름 바뀜: Claude Code SDK는 이제 Claude Agent SDK~14 min · rename, install, claude-agent-sdk, migration
   • 02
     query() vs ClaudeSDKClient: lifecycle로 픽~16 min · query, ClaudeSDKClient, lifecycle
   • 03
     ClaudeAgentOptions: 중요한 모든 손잡이~18 min · options, configuration, ClaudeAgentOptions
   • 04
     디폴트 도구 셋: free로 받는 거~14 min · tools, default-tools, filesystem, bash
   • 05
     Agent SDK의 MCP 서버~16 min · mcp, model-context-protocol, servers
   • 06
     Hooks: pre·post tool use~16 min · hooks, PreToolUse, PostToolUse
   • 07
     세션 · resume · JSONL truth~16 min · sessions, resume, jsonl, persistence
   • 08
     Sub-agents · slash commands · skills~14 min · subagents, slash-commands, skills

   ✓퀴즈 · 4 문제→

9. 09🛡️Agent governance: permissions · 보안 · audit

   0/5 lessons

   프로덕션에 run 안전한 자율 에이전트 만들기 — permission 모드, sandbox, audit trail, prompt injection 방어

   자율 Claude 에이전트가 파일 읽기, 셸 run, API 호출 권한 가짐. Governance가 그 권한 bound하는 거 — permission 모드, sandbox, prompt-injection 방어, audit trail, no 말하는 규율.

   Lesson list (5)

   • 01
     Permission 모드 실전~14 min · permissions, permission-mode, safety
   • 02
     Sandboxing: cwd · env · 네트워크~14 min · sandbox, cwd, environment, network
   • 03
     Prompt injection 방어~16 min · prompt-injection, security, isolation
   • 04
     LLM 액션을 위한 audit trail~12 min · audit, logging, compliance
   • 05
     에이전트 행동 테스트~14 min · testing, evals, regression

   ✓퀴즈 · 4 문제→

10. 10🏗️cwkPippa-grade 프로덕션 패턴

    0/7 lessons

    Provider port (or not), fallback chain, JSONL ground truth, persistent 서브프로세스 풀, OAuth, 배포, post-mortem

    동작하는 Claude 통합을 프로덕트로 bet할 수 있는 거로 바꾸는 end-game 패턴 — 프로바이더 경계, fallback chain, durable JSONL truth, persistent 서브프로세스 풀, OAuth lifecycle, post-mortem 규율.

    Lesson list (7)

    • 01
      Provider port — 시점과 위치~16 min · provider-port, abstraction, architecture
    • 02
      Fallback chain과 degraded 모드~14 min · fallback, degraded-mode, reliability
    • 03
      JSONL ground truth, derived mirror~16 min · jsonl, persistence, rebuild
    • 04
      Persistent 서브프로세스 풀 (Agent SDK)~14 min · subprocess, pool, agent-sdk
    • 05
      프로덕션의 OAuth lifecycle~12 min · oauth, auth, tokens
    • 06
      배포 · 모니터링 · 재시작 규율~14 min · deployment, monitoring, restart, launchd
    • 07
      Post-mortem과 history 로그 습관~12 min · post-mortem, history, learning

    ✓퀴즈 · 4 문제→