TypeScript Zod v4 + Claude API 구조화 출력 완전 가이드 — 타입 안전한 LLM 응답 파싱 실전
Zod v4 safeParse()와 변경된 스키마 API로 Claude API 응답을 타입 안전하게 파싱하는 패턴을 직접 검증했다. v3 대비 성능 수치, z.string().check() 신규 API, 중첩 스키마 설계 전략을 Claude API 통합 코드와 함께 정리한다.
jangwook.net
Kim Jangwook
Personal technical notes on AI agents, automation, developer tools, and the process of building software.
Latest Notes
Recent writing by language
The root page stays intentionally small. Choose a language, then read the full archive and related posts there.
한국어
AI 에이전트, 자동화, 개발 도구, 소프트웨어 제작 과정을 한국어로 기록합니다.
Vitest 4로 AI 에이전트 테스트하기 — LLM 호출 모킹, 스트리밍 응답 테스트 실전 패턴
Vitest 4.1.7로 Anthropic SDK messages.create()와 스트리밍 응답을 모킹하는 실전 패턴. vi.fn()과 화살표 함수 차이, async function* 제너레이터로 SSE 스트림을 재현해 9개 테스트를 142ms에 통과시키는 방법을 안내한다.
TypeScript로 나만의 MCP 서버 만들기 — @modelcontextprotocol/sdk 실전 튜토리얼
@modelcontextprotocol/sdk v1.29.0과 Zod v4로 TypeScript MCP 서버를 처음부터 구축하는 실전 튜토리얼. 도구 등록, InMemoryTransport 테스트, 공개 API 연동까지 30분 안에 동작하는 서버를 완성하는 방법을 단계별로 설명합니다.
English
Personal notes on AI agents, automation, developer tools, and building software.
TypeScript Zod v4 + Claude API: A Complete Guide to Type-Safe LLM Response Parsing
I tested Zod v4 safeParse() and the updated schema API with Claude API responses to build type-safe LLM output pipelines. Here: v3 performance comparison, the new z.string().check() API, nested schema design, and error handling patterns for production use.
Testing AI Agents with Vitest 4 — Mocking LLM Calls and Streaming Responses in Practice
I verified practical patterns for mocking Anthropic SDK messages.create() and streaming responses in Vitest 4.1.7. This covers why vi.fn().mockImplementation(function(){...}) differs from arrow functions, how to reproduce SSE streams with async function* generators, and how 9 tests pass in 142ms without a single API call.
Building Your Own MCP Server with TypeScript — A Practical @modelcontextprotocol/sdk Tutorial
A hands-on tutorial for building a TypeScript MCP server from scratch using @modelcontextprotocol/sdk v1.29.0 and Zod v4. Step-by-step guide covering tool registration, InMemoryTransport testing, and public API integration — a working server in under 30 minutes.
日本語
AIエージェント、自動化、開発ツール、ソフトウェア開発の記録です。
TypeScript Zod v4 + Claude API 構造化出力完全ガイド — 型安全なLLM応答パース実践
Zod v4のsafeParse()と変更されたスキーマAPIでClaude API応答を型安全にパースするパターンを実際に検証した。v3比の性能数値、z.string().check()新API、ネストスキーマ設計戦略をClaude API統合コードとともに整理する。
Vitest 4でAIエージェントをテストする — LLM呼び出しモック、ストリーミングレスポンステストの実践パターン
Vitest 4.1.7でAnthropic SDKのmessages.create()とストリーミングレスポンスをモッキングする実践パターンを直接検証した。vi.fn().mockImplementation(function(){...})がアロー関数と異なる理由、async function*ジェネレーターでSSEストリームを再現する方法まで、9テストが142ms以内に通過する過程をステップバイステップで解説する。
TypeScriptで自分だけのMCPサーバーを作る — @modelcontextprotocol/sdk 実践チュートリアル
@modelcontextprotocol/sdk v1.29.0とZod v4でTypeScript MCPサーバーをゼロから構築する実践チュートリアル。ツール登録、InMemoryTransportテスト、公開API連携まで30分以内に動作するサーバーを完成させる手順をステップごとに解説します。
简体中文
记录 AI 代理、自动化、开发工具和软件构建过程。
TypeScript Zod v4 + Claude API 结构化输出完全指南 — 类型安全的LLM响应解析实战
通过实际测试Zod v4的safeParse()和更新的schema API处理Claude API响应，构建类型安全的LLM输出解析方案。涵盖v3性能对比、z.string().check()新API、嵌套schema设计策略和生产级错误处理模式。
用 Vitest 4 测试 AI 代理 — LLM 调用模拟、流式响应测试实战模式
我在 Vitest 4.1.7 中直接验证了模拟 Anthropic SDK messages.create() 和流式响应的实战模式。涵盖 vi.fn().mockImplementation(function(){...}) 与箭头函数的区别、用 async function* 生成器重现 SSE 流的方法，以及 9 个测试在 142ms 内通过的完整过程。
用TypeScript构建自己的MCP服务器 — @modelcontextprotocol/sdk实战教程
用@modelcontextprotocol/sdk v1.29.0和Zod v4从零构建TypeScript MCP服务器的实战教程。逐步讲解工具注册、InMemoryTransport测试、公共API集成，30分钟内完成一个可运行的服务器。