Learn Claude Code

Learn Claude Code

从 0 到 1 构建 nano Claude Code-like agent,每次只加一个机制

核心模式

所有 AI 编程 Agent 共享同一个循环:调用模型、执行工具、回传结果。生产级系统会在其上叠加策略、权限和生命周期层。

agent_loop.py
while True:
    response = client.messages.create(messages=messages, tools=tools)
    if response.stop_reason != "tool_use":
        break
    for tool_call in response.content:
        result = execute_tool(tool_call.name, tool_call.input)
        messages.append(result)

消息增长

观察 Agent 循环执行时消息数组的增长

messages[]len=0
[]

学习路径

20 个渐进式课程,从简单循环到完整多 Agent Harness

s01102

The Agent Loop

The smallest useful agent is a loop that calls the model, runs tools, and feeds results back.

s02135

Tool Use

The loop stays stable while capabilities register into a dispatch table.

s03180

Permission

Dangerous actions need a harness decision point before the shell runs.

s04232

Hooks

Cross-cutting behavior belongs around the loop, not tangled inside it.

s05236

TodoWrite

Explicit plans keep long-running work visible and correctable.

s06304

Subagent

Subagents give each subtask a clean message history while preserving the main thread.

s07335

Skill Loading

Inject specialized knowledge only when the task actually needs it.

s08414

Context Compact

Compression keeps the conversation usable when the context window gets crowded.

s09528

Memory

Some facts should survive summarization and future sessions.

s10166

System Prompt

The system prompt is a generated product of policy, tools, skills, and context.

s11287

Error Recovery

A robust harness classifies failures and decides what kind of retry is worthwhile.

s12297

Task System

A task graph turns vague goals into ordered, observable work.

s13379

Background Tasks

The agent can keep reasoning while slow work completes elsewhere.

s14645

Cron Scheduler

Recurring work should be created by the harness, not remembered by the model.

s15745

Agent Teams

Persistent teammates let work continue in parallel without stuffing every thought into one context.

s16709

Team Protocols

Multi-agent systems need explicit message contracts, not vibes.

s17648

Autonomous Agents

Teammates become useful when they can discover and claim work themselves.

s18802

Worktree Isolation

Parallel agents need isolated filesystems as much as isolated conversations.

s19835

MCP Tools

External services can become agent tools through a standard discovery and call protocol.

s201708

Comprehensive Agent

The final harness is still one loop, now surrounded by the systems that make it production-shaped.

架构层次

五个正交关注点组合成完整的 Agent