>
Agentic Loop
理解 LLM + System Prompt + Context + Tools 的核心循环 — 与 Claude Code、Cursor 相同的设计模式。
ClawdCode从零构建 AI Coding Agent
参考 Claude Code 架构，从原理到实现，构建一个生产级 CLI 编程助手。17 章深度教程，完整开源。
Skip to content
🔨 你将构建什么
一个功能完整的 CLI Coding Agent，具备以下能力：
🤖 智能对话 — 基于 OpenAI 兼容 API 的多轮对话，支持思考过程展示与自动折叠
📂 文件操作 — 读写、编辑、搜索、Glob 匹配，Agent 自主操作你的代码库
⚡ 命令执行 — Shell 命令执行，带权限控制和用户确认机制
🧠 上下文管理 — Token 统计、自动压缩、会话持久化，突破上下文窗口限制
🎨 交互式 UI — 语法高亮、Markdown 渲染、主题切换、命令补全、代码块复制
🧩 可扩展架构 — MCP 协议、自定义命令、Hooks 系统，面向真实场景设计
🏗️ 架构总览
┌──────────────────────────────────────────────────────────┐
│ CLI Entry (yargs) │
│ ↓ │
│ Agent Loop ←──────────────────────────────┐ │
│ ├─ Build Context (messages + tools) │ │
│ ├─ Call LLM (streaming) │ │
│ ├─ Parse Response │ │
│ │ ├─ text → render to UI │ │
│ │ └─ tool_calls → Execution Pipeline │ │
│ │ ├─ 1. Discovery │ │
│ │ ├─ 2. Permission │ │
│ │ ├─ 3. Pre-Hooks │ │
│ │ ├─ 4. Confirmation (UI) │ │
│ │ ├─ 5. Execute │ │
│ │ ├─ 6. Post-Hooks │ │
│ │ └─ 7. Format │ │
│ └─ Inject Results ──────────────────────┘ │
│ │
│ Store (Zustand) ← → UI (Ink/React) ← → Theme Manager │
│ Context Manager ← → Token Counter ← → Compaction │
│ MCP Registry ← → External Tool Servers │
└──────────────────────────────────────────────────────────┘💡 为什么选择这个教程
🔬 参考 Claude Code
不是玩具项目。参考 Anthropic Claude Code 的真实架构设计，包括权限系统、Hooks、MCP 集成。
📖 17 章循序渐进
从 Hello World 到完整 Agent，每章都有可运行的代码。理解每一行为什么存在。
✅ 生产级质量
TypeScript 严格模式、Zod 运行时验证、完整错误处理、AbortController 中断机制。
📦 开箱即用
npm install -g clawdcode 直接使用，不只是教学项目 — 它本身就是一个可用的 Coding Agent。
🚀 快速开始
bash
# 安装
npm install -g clawdcode
# 配置
export OPENAI_API_KEY=sk-...
# 使用
clawdcode "帮我分析一下这个项目的架构"🔧 技术栈
TypeScript类型安全，LLM 最熟悉的语言
Bun极速构建与运行时
InkReact for CLI — 声明式终端 UI
Zustand轻量状态管理，细粒度订阅
OpenAI SDK兼容 OpenAI / DeepSeek / 本地模型
Zod运行时参数验证
MCPModel Context Protocol 外部工具集成
lowlight140+ 语言语法高亮
📊 数据一览
17章节
7内置工具
7管道阶段
11Hook 事件
5预设主题
MIT开源协议