Learn Coding Agent

Claude Code Architecture Study

**Introduction**: This project is a learning and research repository focused on CLI Agent architecture. All materials are compiled entirely from publicly available online references and discussions, with a particular focus on public information regarding the highly popular CLI Agent `claude-code`. Our intention is to help developers better understand and utilize Agent technologies. We will continue to share more insights and practical discussions on Agent architecture in the future. Thank you for your support!

**Disclaimer**: All content in this repository is provided strictly for technical research, study, and educational exchange among enthusiasts. **Commercial use is strictly prohibited.** No individual, organization, or entity may use this content for commercial purposes, profit-making activities, illegal activities, or any other unauthorized scenarios. If any content infringes upon your legal rights, intellectual property, or other interests, please contact us and we will verify and remove it immediately.

**Language**: **English** | [中文](README_CN.md) | [한국어](README_KR.md) | [日本語](README_JA.md)

---

Table of Contents

• Deep Analysis Reports (`docs/`) — Telemetry, codenames, undercover mode, remote control, future roadmap
• Directory Reference — Code structure tree
• Architecture Overview — Entry → Query Engine → Tools/Services/State
• Tool System & Permissions — 40+ tools, permission flow, sub-agents
• The 12 Progressive Harness Mechanisms — How Claude Code layers production features on the agent loop

---

Deep Analysis Reports (`docs/`)

Deep analysis reports compiled from publicly available online references and community discussions on Claude Code v2.1.88. Quadrilingual (EN/JA/KO/ZH).

docs/
├── en/                                        # English
│   ├──