尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
拆解 Claude Code Agent:工具调用与上下文管理背后的 4 个关键设计
拆解 Claude Code Agent工具调用与上下文管理背后的 4 个关键设计【免费下载链接】learn-claude-codeBash is all you need - A nano claude code–like 「agent harness」, built from 0 to 1项目地址: https://gitcode.com/GitHub_Trending/an/learn-claude-code你敲下帮我查这个仓库的报错这句话时Claude Code Agent 要在毫秒内决定调哪个工具、读哪个文件、之前的输出还值不值得保留。这就是 AI 工具调用机制的起点。开源项目 learn-claude-code 对 Claude Code v1.0.33 做了逆向拆解用 17 章 Python 代码把机制逐层复现本文只挑最值得抄的 4 个关键设计决策。 架构全景模型 HarnessClaude Code 一个 agent loop 工具 技能 压缩 子代理 权限。模型是司机harnessharness 指让模型在具体环境里运转的全部外围设施是车模型决策harness 执行。这个仓库的做法是把零件拆成 17 个文件从 s01 的单 bash 工具 单 while 循环开始每章加一个机制。⚙️ 循环是怎么转起来的一个循环两个信号核心就在agents/s01_agent_loop.py的agent_loop()里输入用户消息进messages列表处理调用 LLM把返回内容追加进 messages输出stop_reason tool_use就执行工具、把结果写回 messages 继续循环否则返回、结束结果是下一轮的输入工具结果被包装成tool_result块按tool_use_id对上号作为新的 user 消息还给模型。模型看到的工具其实只是对话里多出来的一段。这个设计解决的具体问题没有这个循环模型只能写出命令得靠人手动执行、再手动贴回结果人是中间层。 工具是怎么被选中并派发的工具数组 派发表循环本身不变只是往 TOOLS 数组里加了 read_file / write_file / edit_file 三个工具再写一张派发表见agents/s02_tool_use.py。输入模型返回带name字段的tool_use块处理按名字查TOOL_HANDLERS调用对应 handler输出handler 的返回字符串就是工具结果安全写在 handler 里不写在提示词里safe_path()解析路径不在工作区内直接抛错挡住../逃逸run_bash()字符串匹配sudo、rm -rf /等危险词即拒绝输出统一截断到 5 万字符这个设计解决的具体问题给模型真实的 shell 权限时爆炸半径必须在代码里圈住不能指望模型听话。 状态管理上下文压缩的三层管道长会话的死结是messages 只增不减迟早撞上 token 上限。agents/s06_context_compact.py的解法是一条三层管道。第一层micro_compact静默每轮跑只保留最近 3 条工具结果更早的 content 替换成占位符[Previous: used bash]。例外是read_file——文件内容是参考资料清了模型就得重读反而更贵。第二层auto_compact估算 token 超 5 万触发先把完整 transcript 存进.transcripts/落盘再让 LLM 生成摘要做了什么 / 当前状态 / 关键决策然后把全部 messages 替换成这唯一一条摘要。第三层compact 工具模型自己触发模型觉得上下文臃肿时主动调用 compact 工具逻辑同第二层只是触发方换成模型。多 Agent 协同场景下子代理保持独立的消息列表干完活只把摘要返回主代理——全局状态在主代理侧统一子代理的上下文不污染主对话。这个设计解决的具体问题让 agent 可以战略性遗忘会话长度不再被上下文窗口卡死。▶️ 动手跑起来git clone https://gitcode.com/GitHub_Trending/an/learn-claude-code cd learn-claude-code pip install -r requirements.txt # .env 里配好 ANTHROPIC_API_KEY 和 MODEL_ID 后 python agents/s01_agent_loop.py三个值得读的入口文件agents/s02_tool_use.py看TOOL_HANDLERS派发表与safe_path工具调用机制的最小完整形态agents/s06_context_compact.py看micro_compact和auto_compact如何串成管道agents/s_full.pys01–s11 全部机制合体的完整参考实现❓ 边界与开放问题危险命令黑名单是纯子串匹配注释里出现sudo会误杀模型仍可能执行rm -rf ./build代码里没有真正的沙箱隔离token 估算用len(str)//4的粗略启发式auto_compact 触发点和真实用量有明显偏差第二层压缩后细节只能靠翻磁盘 transcript 找回上下文缓存式的按相关性分级淘汰在代码里并不存在只有清空或保留两档多 Agent 邮箱是进程内状态重启即丢失跨节点协同无从谈起下次再敲下那句帮我查这个仓库的报错你知道毫秒内发生了什么一个 while 循环在转一张派发表在定位 bash一条压缩管道在悄悄决定哪些旧输出该被忘掉。【免费下载链接】learn-claude-codeBash is all you need - A nano claude code–like 「agent harness」, built from 0 to 1项目地址: https://gitcode.com/GitHub_Trending/an/learn-claude-code创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED

相关推荐

uv 自更新实操指南:一条命令搞定升级,4 个要点让团队版本不漂移

uv 自更新实操指南:一条命令搞定升级,4 个要点让团队版本不漂移

uv 自更新实操指南:一条命令搞定升级,4 个要点让团队版本不漂移 【免费下载链接】uv An extremely fast Python package and project manager, written in Rust. 项目地址: https://gitcode.com/GitHub_Trending/uv/uv uv 自更新就是 uv self upd…

📅 2026/10/14 23:26:41
COM-HPC Mini载板深度解析:从PCIe Gen5到DDR5的设计与选型指南

COM-HPC Mini载板深度解析:从PCIe Gen5到DDR5的设计与选型指南

1. 站在COM-HPC Mini载板前,先搞懂它解决的是哪类问题过去几年我一直在跟COM Express打交道,Type 6和Type 10模块做过好几个项目。今年开始明显感觉到,高带宽外设的需求已经压得老标准喘不过气了。PCIe Gen3的x4通道,算下来只有约…

📅 2026/10/5 1:43:16
从ESXi主机RAID在线扩容到Linux虚拟机LVM磁盘扩展

从ESXi主机RAID在线扩容到Linux虚拟机LVM磁盘扩展

1. 从物理层到虚拟化的完整扩容链路 当ESXi主机的本地存储空间告急时,传统做法往往需要停机维护,这对业务连续性要求高的场景简直是噩梦。现在我们可以像给手机换存储卡一样,实现从物理磁盘到虚拟机文件系统的 全链路在线扩容 。整个过程就…

📅 2026/10/20 5:41:10
MORE NEWS

更多资讯

📰

电工证哪里靠谱怎么考?上岗必备的证书你真的了解吗

电工证哪里靠谱怎么考?上岗必备的证书你真的了解吗 证书过期了不知道怎么复审延期,这几乎是每个特种作业人员都经历过的问题。特别是电工证,作为上岗必备的证件,如果过期不处理,不仅影响工作安排,还可能面临法律风险。很多人误以为电工证是“一劳永逸”…

📰

电工作业证6年过后怎么复审?网上查询方法+行业前景全解析

电工作业证6年过后怎么复审?网上查询方法+行业前景全解析 证书过期了不知道怎么复审延期,这事儿真让不少老电工头疼。你是不是也遇到过这种情况:手里拿着电工作业证,眼看着有效期快到了,但对复审流程一无所知?其实,国家早有明确规定,电工证的有效期…

📰

电工证哪里靠谱怎么报名?外省证能转过来吗?

电工证哪里靠谱怎么报名?外省证能转过来吗? 之前考的证在外省能不能转过来?这几乎是每个准备报考电工证或者已经在持证的从业者都会遇到的问题。如果你也在纠结【电工证哪里靠谱】,那这篇文章就为你详细解答,包括怎么报名、怎么选培训机构、证书有效期、…

📰

煤气作业证吃香吗到期换证流程

工地太忙根本没时间复习考试?煤气作业证值不值得考 工地太忙根本没时间复习考试,你不是一个人。很多人在项目上连吃饭都赶时间,更别说抽空准备考试了。特别是像 煤气作业证 这种证,很多人都会问:“ 煤气作业证吃香吗…

📰

海军高级电工证怎么考?郑州报考避坑指南全解析

海军高级电工证怎么考?郑州报考避坑指南全解析 你是不是也遇到过这样的情况?想考个 海军高级电工证 ,却不知道从哪开始,担心被中介坑钱、被骗资料、耽误时间?别急,这篇文章就是为你量身打造的 郑州报考避坑指南…

📰

电工证考试到发证多久?应届生想快速上岗得先搞清楚在哪考

电工证考试到发证多久?应届生想快速上岗得先搞清楚在哪考 你是不是刚毕业就急着找工作,结果被要求先考电工证?别急,今天就给你把电工证考试到发证多久讲明白,还有应届生怎么快速拿到证、在哪里考、怎么准备,全都给你说清楚。…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬