Claude SDK Quest

Tracks

1. 01🧭Claude SDK의 세 경로와 현재 지도

   0/8 lessons

   Client SDK · Agent SDK · CLI, 모델 티어, OAuth, 제공자 경계를 구분해

   Anthropic Client SDK와 이름이 바뀐 Claude Agent SDK, Claude Code CLI를 분명히 갈라 봐. 작업이 요구하는 능력으로 경로를 고르고 현재 모델·인증·보안 지형을 잡아.

   Lesson list (8)

   • 01
     Claude를 쓰는 길은 하나가 아니라 셋이야~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
     모델의 기억보다 지금의 공식 문서를 믿어~12 min · docs, knowledge-cutoff, verification
   • 06
     SDK 경계 밖으로 나가는 데이터부터 그려 봐~14 min · security, privacy, secrets, logging
   • 07
     SDK 바깥의 지도: MCP·서버 도구·Cookbook~12 min · mcp, ecosystem, cookbook
   • 08
     cwkPippa는 Claude의 세 경로를 어떻게 나눠 쓸까~16 min · cwkpippa, self-reference, architecture

   ✓퀴즈 · 4 문제→

2. 02✉️Messages API: 모든 Claude 호출의 바닥

   0/6 lessons

   요청 구조, 시스템 프롬프트, 멀티턴, 스트리밍, 출력 제어를 익혀

   Messages API는 Anthropic 클라이언트 아래에 놓인 전송 계약이야. 요청과 응답 구조, system·messages·max_tokens·stop_sequences를 이해하면 SDK 도우미가 무엇을 대신하는지 선명해져.

   Lesson list (6)

   • 01
     Messages 요청은 필드와 흐름을 함께 설계해~16 min · messages-api, request, system, max-tokens
   • 02
     시스템 프롬프트는 행동 계약이야~16 min · system-prompt, instructions, persona
   • 03
     멀티턴의 기억은 API가 아니라 애플리케이션이 맡아~14 min · multi-turn, memory, history
   • 04
     스트리밍은 첫 토큰을 앞당기는 대신 상태를 떠안아~16 min · streaming, sse, events
   • 05
     응답 길이보다 stop_reason을 먼저 확인해~14 min · stop-sequences, stop-reason, json, structured-output
   • 06
     오류 종류마다 재시도 규칙이 달라~14 min · errors, retries, idempotency, 5xx

   ✓퀴즈 · 4 문제→

3. 03🐍Python SDK 깊이 파기

   0/6 lessons

   동기·비동기, 스트리밍, 도구 루프, 프롬프트 캐싱, Files와 Batch를 Python답게

   anthropic Python SDK의 동기·비동기 클라이언트와 스트리밍, 도구 루프, 프롬프트 캐싱, Files API, Batch API를 실행 가능한 운영 패턴으로 익혀.

   Lesson list (6)

   • 01
     Python SDK는 설치한 버전부터 증명해~12 min · install, pinning, version
   • 02
     AsyncAnthropic은 프로세스마다 하나를 오래 써~16 min · async, fastapi, concurrency
   • 03
     Python 스트리밍은 화면과 최종 회계를 나눠 다뤄~14 min · streaming, stream-helper, usage
   • 04
     Python 도구 루프에는 등록부와 반복 예산이 필요해~18 min · tool-use, tool-loop, function-calling
   • 05
     프롬프트 캐싱은 안정된 앞부분에서 돈을 아껴~16 min · prompt-caching, cache-control, ephemeral
   • 06
     Files와 Batch API는 기다릴 수 있는 일을 싸게 만들어~16 min · files-api, batch-api, async-workflows

   ✓퀴즈 · 4 문제→

4. 04🟦TypeScript SDK 깊이 파기

   0/6 lessons

   엄격한 타입, Node·Edge 스트리밍, 도구 루프, Next.js 서버 경계를 익혀

   @anthropic-ai/sdk를 엄격한 타입과 함께 써. Node와 Edge의 스트리밍, 타입이 있는 도구 루프, Next.js Route Handler를 Python과 닮았지만 TypeScript다운 방식으로 연결해.

   Lesson list (6)

   • 01
     TypeScript SDK의 내보낸 타입을 그대로 써~14 min · install, types, esm, cjs
   • 02
     Node와 Next.js 스트리밍은 취소 신호까지 이어 줘~16 min · streaming, next-js, route-handler
   • 03
     TypeScript 도구 루프는 스키마에서 처리기 타입까지 이어져야 해~18 min · tool-use, typed, registry
   • 04
     TypeScript 오류 클래스에 재시도 정책을 걸어~12 min · errors, retries, discriminated
   • 05
     Next.js에서는 Claude 호출을 서버 경계 안에 가둬~16 min · next-js, edge, server-components, rsc
   • 06
     Deno·Bun·Edge에서는 SDK보다 런타임 제약을 먼저 봐~12 min · deno, bun, edge, cross-runtime

   ✓퀴즈 · 4 문제→

5. 05🛠️도구 사용: 커스텀·내장·서버 도구

   0/6 lessons

   단일 호출부터 병렬 실행, web_search, code_execution, computer_use까지

   도구 사용은 Claude를 대화 상대에서 시스템 구성요소로 바꿔. JSON Schema를 갖춘 커스텀 도구, 병렬 호출, 서버 도구, 오류와 권한 경계를 한 흐름으로 다뤄.

   Lesson list (6)

   • 01
     도구 선택은 설명이, 입력 제약은 스키마가 맡아~16 min · json-schema, input-schema, validation
   • 02
     독립적인 도구 호출은 한 턴에 함께 실행해~14 min · parallel, tool-use, concurrency
   • 03
     도구 오류도 모델이 읽을 결과로 돌려줘~14 min · errors, retries, tool-result
   • 04
     서버 도구는 Anthropic이 실행까지 맡아~16 min · server-tools, web-search, code-execution, computer-use
   • 05
     세 번째 도구부터 공통 루프를 Tool Runner로 뽑아~14 min · tool-runner, abstraction, library
   • 06
     도구에는 API와 같은 권한 심사가 필요해~14 min · security, permissions, side-effects

   ✓퀴즈 · 4 문제→

6. 06🗂️컨텍스트 창·이미지·PDF·문서

   0/6 lessons

   긴 문맥 예산, 다중 형식 입력, Files API, RAG와 입력 크기를 설계해

   Claude에 무엇을 얼마나 넣을지 익혀. 긴 컨텍스트 창과 이미지·PDF 입력, Files API, RAG, 요약을 연결해 모델에 필요한 자료만 전달하는 규율을 세워.

   Lesson list (6)

   • 01
     큰 컨텍스트 창은 공짜 기억이 아니야~14 min · context-window, tokens, budget
   • 02
     이미지는 질문에 필요한 크기만 보내~14 min · vision, images, multimodal
   • 03
     PDF는 한 번 읽을지 여러 번 쓸지로 경로를 골라~14 min · pdf, document, files-api
   • 04
     문서 크기와 조회 빈도로 RAG와 전체 삽입을 골라~14 min · rag, retrieval, embeddings
   • 05
     대화 요약은 무엇을 버릴지 정하는 손실 압축이야~12 min · summarization, memory, compression
   • 06
     컨텍스트 조립은 독립된 아키텍처 계층이야~14 min · architecture, context-engine, self-reference

   ✓퀴즈 · 4 문제→

7. 07📈규모 키우기: 비용·신뢰성·관측성

   0/6 lessons

   트래픽 급증과 예상 밖 청구서, 품질 회귀를 견디는 Claude 시스템을 만들어

   작동하는 Claude 통합을 운영 규모로 키워. 토큰 비용, 깊은 프롬프트 캐싱, Batch 흐름, 재시도와 회로 차단기, 관측성, 평가 문을 함께 설계해.

   Lesson list (6)

   • 01
     Claude 비용은 여섯 항목으로 나눠 봐~14 min · cost, billing, tokens
   • 02
     캐시 중단점 네 개를 변화 경계에 놓아~16 min · prompt-caching, breakpoints, ttl
   • 03
     Batch는 기다릴 수 있는 작업을 위한 별도 흐름이야~14 min · batch-api, async, evaluation
   • 04
     재시도·회로 차단기·예비 경로는 서로 다른 실패를 막아~14 min · retries, reliability, circuit-breaker
   • 05
     LLM 호출은 비용·지연·품질을 함께 관측해~14 min · observability, tracing, metrics
   • 06
     평가는 사용자가 회귀를 만나기 전에 멈추는 문이야~14 min · eval, regression, quality

   ✓퀴즈 · 4 문제→

8. 08🤖Claude Agent SDK 핵심

   0/8 lessons

   이름 변경, ClaudeAgentOptions, query와 Client, 세션, MCP, 훅, 명령과 스킬

   Claude Agent SDK는 Claude Code의 파일·명령·세션·MCP·훅 능력을 프로그래밍 가능한 실행 장치로 제공해. cwkPippa의 Claude 브레인이 오래 살아 움직이는 기반을 익혀.

   Lesson list (8)

   • 01
     Claude Code SDK는 Claude Agent SDK로 이름이 바뀌었어~14 min · rename, install, claude-agent-sdk, migration
   • 02
     query()와 ClaudeSDKClient는 수명으로 골라~16 min · query, ClaudeSDKClient, lifecycle
   • 03
     ClaudeAgentOptions가 에이전트 정책을 한곳에 모아~18 min · options, configuration, ClaudeAgentOptions
   • 04
     Agent SDK의 기본 도구도 권한으로 골라 줘~14 min · tools, default-tools, filesystem, bash
   • 05
     MCP 서버로 Agent SDK의 능력을 바깥에 분리해~16 min · mcp, model-context-protocol, servers
   • 06
     훅은 프롬프트보다 단단한 정책 경계야~16 min · hooks, PreToolUse, PostToolUse
   • 07
     세션은 이어 가고 JSONL은 다시 세울 근거를 남겨~16 min · sessions, resume, jsonl, persistence
   • 08
     하위 에이전트·슬래시 명령·스킬은 재사용 단위가 달라~14 min · subagents, slash-commands, skills

   ✓퀴즈 · 4 문제→

9. 09🛡️에이전트 거버넌스: 권한·보안·감사

   0/5 lessons

   권한 모드, 샌드박스, 감사 흔적, 프롬프트 주입 방어로 자율 행동을 묶어

   자율 Claude 에이전트는 파일을 읽고 셸과 API를 실행할 수 있어. 권한 모드와 샌드박스, 프롬프트 주입 방어, 감사 기록으로 그 힘의 경계를 운영 가능한 수준까지 좁혀.

   Lesson list (5)

   • 01
     권한 모드는 반대편에 누가 있는지로 골라~14 min · permissions, permission-mode, safety
   • 02
     샌드박스는 cwd·환경변수·네트워크에서 시작해~14 min · sandbox, cwd, environment, network
   • 03
     프롬프트 주입은 격리·승인·훅으로 막아~16 min · prompt-injection, security, isolation
   • 04
     에이전트 행동은 몇 달 뒤에도 재구성할 수 있어야 해~12 min · audit, logging, compliance
   • 05
     모델 행동은 넓게, 안전장치는 엄격하게 시험해~14 min · testing, evals, regression

   ✓퀴즈 · 4 문제→

10. 10🏗️cwkPippa급 운영 패턴

    0/7 lessons

    제공자 경계, 예비 사슬, JSONL 기준 기록, 서브프로세스 풀, OAuth, 배포와 사후 분석

    작동하는 Claude 통합을 믿고 맡길 제품으로 바꿔. 제공자 경계와 예비 사슬, 내구성 있는 JSONL, 지속 서브프로세스 풀, OAuth 수명 주기, 배포·감시·사후 분석을 연결해.

    Lesson list (7)

    • 01
      제공자 경계는 둘째 제공자가 들어올 때 결정해~16 min · provider-port, abstraction, architecture
    • 02
      예비 사슬은 품질 저하를 숨기지 않아야 해~14 min · fallback, degraded-mode, reliability
    • 03
      JSONL을 기준 기록으로 두고 파생 저장소는 다시 만들어~16 min · jsonl, persistence, rebuild
    • 04
      Agent SDK 서브프로세스 풀은 독립 인프라야~14 min · subprocess, pool, agent-sdk
    • 05
      OAuth도 만료와 복구를 가진 운영 자격 증명이야~12 min · oauth, auth, tokens
    • 06
      재시작은 supervisor가, 상태 설명은 health가 맡아~14 min · deployment, monitoring, restart, launchd
    • 07
      커밋은 무엇을, 운영 기록은 왜를 남겨~12 min · post-mortem, history, learning

    ✓퀴즈 · 4 문제→