【Code with SOLO】致敬 Claude Code！我用 SOLO 搓了一个轻量级 Agent 框架

SOLO挑战赛专区
,
1

这两天被 Claude Code 泄露刷屏了，但官方源码又大又复杂，初学者根本看不懂它是怎么运转的。于是我用 SOLO 深度解剖了 Claude Code 的底层逻辑，并用 React Ink + Bun + TypeScript 复刻了一个极简开源版的 Agent 框架 —— LiteAgent。不仅实现了多模型热切换、终端虚拟 DOM 渲染，还支持隐形 Fork 试错和动态 Skill 加载。现在，任何人都可以用最少的代码搞懂大模型 CLI 到底是怎么运作的！

image
image1089×696 62 KB

1. 背景

最近大火的 Agent Harness（智能体运行时框架）概念让我很感兴趣，我之前了解到Agent Harness可以将对话型的LLM模型升级为可以干活的AI。但是，我不了解它内部是怎么实现的，借着最近的 Claude Coude 的源码泄露事件，看了一些源码和文档，我发现这些商业化代码里充斥着海量鉴权和冗余逻辑。

我的需求很明确：我想搞明白Agent Haress框架是如何通过LLM来工作的，我要的一个纯粹、剥离了商业杂质的 Agent 学习脚手架。 搞明白一个带终端 UI 渲染和复杂工具调用循环的 CLI 框架，要花很长时间去死磕底层流控制和异步状态机。我决定把开发工作，全部丢给 TRAE SOLO 来完成，边开发边学习。

2. 开始准备

跟SOLO对话，把这次泄露事件和 Agent Harness 的架构丢给它，跟它进行了一场深度的头脑风暴。

SOLO 帮我梳理了 Claude Code 为什么强大，它的设计理念和架构设计是怎么样的，对于将要开发的LiteAgent有个初步的了解和判断。

3. 实践过程

第一步：确立骨架与“对话主循环” 采用了与 Claude Code 同源的技术栈：Bun + React Ink + TypeScript。 首先，SOLO 帮我用 async function*（异步生成器）搓了一个最核心的 REPL 对话循环。这个时候它还只是个聊天机器人，但已经能优雅地处理流式输出（Streaming），并在终端里用虚拟 DOM 渲染对话了。

第二步：长出“手脚”，接入工具调用 (Tool Use) 有了大脑还不够，必须让它能干活。我让 SOLO 参考Claude Code帮我设计了一套标准的工具接口。

  • 先试水：先接了一个简单的“测试工具”，验证了循环逻辑：模型触发 tool_calls → 生成器挂起 → 本地执行 → 结果喂回模型 → 自动发起下轮请求。
  • 接管物理世界：验证通过后，我让 SOLO 对接了文件读取、写入、终端命令执行（Bash）等真实工具，让 Agent 真正长出了手脚。

第三步：注入灵魂，参考 Claude Code 引入 AGENT.md 为了让 Agent 每次启动都知道该干什么，我们参考了业界最佳实践，引入了全局约束机制。SOLO 帮我写了文件扫描逻辑，只要当前目录下有 AGENT.md 或 SOUL.md，就会在启动时自动把它们的内容作为核心规则注入到 System Prompt 里，实现了“人设”的可配置化。

第四步：防止发疯，设计动态 Skill 与隐形 Fork 架构 随着能力越来越强，System Prompt 越来越长，大模型开始出现“指令遗忘”和“Token 爆炸”。这是所有 Agent 开发者都会遇到的终极难题。

  • 瘦身计划 (Dynamic Skill)：SOLO 设计了模块化的技能加载器。只在需要时，才把特定的“专家工作流”注入给模型，保持系统提示词的纯净。
  • 隔离试错 (Fork Mode)：在复杂的代码检索时，传统单线对话会被垃圾日志填满（Context Pollution）。SOLO 帮我实现了架构隔离——Fork 出一个隐形的子 Agent 去疯狂调用搜索工具试错，最终只把“结论摘要”合并回主线对话！

第五步：用专属 Skill 生成官网 框架写完后，我直接调用了 SOLO 内置的 web-dev 技能，让它帮我写一个极客风的落地页。它直接产出了一个零依赖、单文件 (index.html) 的官网，自带原生的中英文自动切换和终端界面！

  • 提示词：“我只需要一个可以通过 github.io 直接访问的页面，不需要完整的代码，介绍 LiteAgent 即可，要赛博极客风，支持中英文切换，根据用户浏览器默认语言显示对应的文字。”

  • 成果：SOLO 帮我写了一个零依赖、纯单文件 (index.html) 的落地页！里面包含了 CSS Grid 架构卡片、原生的中英文自动检测切换，以及终端界面！最后它还顺手帮我把 GitHub Actions 部署工作流给写好了，一键上线。

4. 成果展示

目前 LiteAgent 已经发布到了 NPM 和 GitHub！

5. 总结

提效感受： 在 SOLO 的辅助下，不到两天就跑通了全部核心逻辑！尤其是在处理 Node.js 终端流控制（stdin/stdout 劫持）这种容易死锁的领域，SOLO 的排错能力简直是降维打击。

可复用的经验：

  • 遇事不决，先找官网源码：在让 SOLO 写代码前，我会先让它的 search 能力去翻阅类似开源项目的源码（比如 Claude Code），让它“抄作业”，这样写出来的架构直接就是工业级的。
  • 善用内置 Skill：写代码用默认对话，写官网直接切 web-dev，专业的事交给专属的 Prompt 模板去做。

如果你也对 Agent 底层架构感兴趣，欢迎来 LiteAgent 逛逛！项目代码极其精简，非常适合新手拆解学习。如果觉得有帮助，顺手点个 Star :star: 也是对我最大的鼓励啦！

1 个赞
2

:face_with_bags_under_eyes: 都是高手，还不清楚怎么玩

1 个赞