1
2
3
4
5
6
7

Harness = Tools + Knowledge + Observation + Action Interfaces + Permissions

- Tools：文件读写、shell 执行、网络请求、数据库、浏览器
- Knowledge：产品文档、领域知识、API 规范、风格指南
- Observation：git diff、错误日志、浏览器状态、传感器数据
- Action：CLI 命令、API 调用、UI 交互
- Permissions：沙箱、审批工作流、信任边界

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

def agent_loop(messages):
    while True:
        response = client.messages.create(
            model=MODEL, system=SYSTEM,
            messages=messages, tools=TOOLS,
        )
        messages.append({"role": "assistant",
                         "content": response.content})

        if response.stop_reason != "tool_use":
            return

        results = []
        for block in response.content:
            if block.type == "tool_use":
                output = TOOL_HANDLERS[block.name](**block.input)
                results.append({
                    "type": "tool_result",
                    "tool_use_id": block.id,
                    "content": output,
                })
        messages.append({"role": "user", "content": results})

1
2
3
4
5
6
7

learn-claude-code/
|
|-- agents/           # Python 参考实现（s01-s12 + s_full）
|-- docs/{en,zh,ja}/  # 思维模型优先的文档（3种语言）
|-- web/              # 交互式学习平台（Next.js）
|-- skills/           # s05 所需的技能文件
+-- .github/workflows/ci.yml  # CI: 类型检查 + 构建

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

# 克隆仓库
git clone https://github.com/shareAI-lab/learn-claude-code
cd learn-claude-code

# 安装依赖
pip install -r requirements.txt

# 复制环境配置
cp .env.example .env
# 编辑 .env 填入你的 ANTHROPIC_API_KEY

# 运行第一个课程
python agents/s01_agent_loop.py

# 运行完整版本
python agents/s_full.py

1
2

cd web && npm install && npm run dev
# 访问 http://localhost:3000

1

npm i -g @shareai-lab/kode

1
2

learn-claude-code:  核心 harness（循环、工具、规划、团队、工作树隔离）
claw0:              主动常驻 harness（心跳、cron、IM 渠道、记忆、灵魂）

1
2
3
4
5
6
7
8
9

Claude Code = 一个 agent 循环
            + 工具（bash, read, write, edit, glob, grep, browser...）
            + 按需技能加载
            + 上下文压缩
            + 子智能体生成
            + 带依赖图的任务系统
            + 团队协调与异步邮箱
            + 并行执行的工作树隔离
            + 权限治理