Harness Engineering Ko

Harness Engineering: From Claude Code Internals to AI Coding Best Practices (한국어 번역)

Claude Code의 내부 구조에서 AI 코딩 모범 사례까지

이 저장소는 [**Harness Engineering: From Claude Code Internals to AI Coding Best Practices**](https://zhanghandong.github.io/harness-engineering-from-cc-to-ai-coding/en/preface.html)의 한국어 번역본이다.

원본 저장소: [ZhangHanDong/harness-engineering-from-cc-to-ai-coding](https://github.com/ZhangHanDong/harness-engineering-from-cc-to-ai-coding) (MIT License)

---

이 책에 대하여

이 책은 Anthropic의 AI 코딩 에이전트 **Claude Code**의 소스 코드를 체계적으로 분석하여, AI Agent 시스템의 핵심 엔지니어링 패턴을 추출한 기술서다. Agent Loop, Tool Orchestration, Prompt Engineering, Context Management, Prompt Caching, Safety System 등 Claude Code를 구성하는 핵심 서브시스템을 소스 코드 수준에서 해부하고, 이로부터 자신만의 AI Agent를 구축하기 위한 실용적 교훈을 도출한다.

---

목차

[Preface](preface.md)

Part I: Architecture — How Claude Code Works

Chapter	제목
Ch01	The Full Tech Stack of an AI Coding Agent
Ch02	Tool System — 40+ Tools as the Model's Hands
Ch03	Agent Loop — The Full Lifecycle from User Input to Model Response
Ch04	Tool Execution Orchestration — Permissions, Concurrency, Streaming, and Interrupts
Ch04b	Plan Mode — From "Act First, Ask Later" to "Look Before You Leap"

Part II: Prompt Engineering — System Prompts as the Control Plane

Chapter	제목
Ch05	System Prompt Architecture
Ch06	Steering Behavior Through Prompts
Ch06b	API Communication Layer — Retry, Streaming, and Degradation Engineering
Ch07