Deep Agents: ці сапраўды гэта архітэктура Claude Code бясплатна?
Deep Agents ад LangChain дае патэрн, на якім пабудаваны Claude Code, пад ліцэнзіяй MIT. Што насамрэч азначаюць налады па змаўчанні, памяць, выдаткі і падтрымка мадэляў.
Крыніцы: Deep Agents: Did LangChain Open-Source Claude Code’s Architecture?
У адыях, які распространяюцца, стаўляецца тверджэнне, што LangChain апублікаваў на адкрытым кодзе архітэктуру Claude Code пад ліцэнсам MIT, для будзь-ягох модэляў, без жадных платэжаў. Гэта прывабліва пропозыцыя — чаму плаціць за прэміум-падпіску, калі безкоштовны інструмент робіць тое ж самае? Цяе тверджэнне не ўсупрацоўвае і не ёсьць некальківаным; яго правдопадобнасць становіць або-альбо сяродзе семдзят процэнтаў, а тыя трохі застатковыя процэнты ўсё часта ствараюць разчароўванне. Чытайце дэталі, каб можна было прымкнуць рашэнне на аднойчынных падставах.
Чы ўсё-такі апублікавалі на адкрытым кодзе архітэктуру Claude Code?
У певным сэнсе. LangChain апублікаваў на адкрытым кодзе патэрн, а не сам Claude Code. Deep Agents — цэў інструмент, створаны на базе LangGraph, які аб’еднвае чатыры элемента: дзяўальны запрос для сістэмы, інструмент планавання, файловую сістэму і саб-агентаў. Ліцэнс MIT існуючы, і ён працюе з будзь-ямі модэлямі для вызыва інструментаў.
Але яго запуск не ў безплатнае варыянт, файловая сістэма за замовчанням ёсць віртуальной, а дзейнае памяць застаецца выключанай пакуль яе не пад’яждзіце. Хочаце архітэктуру? Яна ваша, можаце ўзяць яе сабе. Хочаце Claude Code? Продовжайце яго вікорыстоўваць.
Што гэта
Калі адмахнуцца ад маркетынгу, Deep Agents — гэта набор проміжных срэдств, створаных на базе LangGraph.
pip install deepagents
from deepagents import create_deep_agent
agent = create_deep_agent(
model="openai:gpt-5.5", # or anthropic:..., google_genai:..., a local one
tools=[my_tool],
system_prompt="You are a research assistant.",
)That’s real. It works. You get planning, a virtual file system, subagent delegation, human-in-the-loop, and shell access — plus everything LangGraph already gave you (streaming, checkpointing, Studio).
Гэта працюе. У вас ёсць можлівасць планавання, вяртуальная сістэма файлоў, дэлегаванне задач сабеянтам, апраўлення з удзелам чалавека і доступ да шэлу, плюс усё тое, што ужо прысутнае ў LangGraph: стрымінг, стварэнне пунктавых контроў і Studio.
Інтэрэснае не ў кодзе. Інтэрэсна тое, што LangChain публічна запісаў, з чаго складаецца глыбокі янт:
- Дзяўжы, дэталізаваны запрос да сістэмы
- Інструмент планавання
- Сістэма файлоў
- Сабеянты
Гэта ўсё, што трэба. Гад прычынілі людзі гэта до таёмніцы бізнесу, але гэта зменшваецца.
Першы пункт: інструмент планавання нічога не робіць
Інструмент write_todos не плануе і не выконвае нічога. Ён проста зберагае спіс задач у стане агента і на гэтым завершвае свою працу. LangChain сама з’явілася пра гэты інструмент, скопіяваны з Claude Code, і называе яго фактычна бездзейнаўчым элементам, а таксама стратэгіяю керавання кантэкстам, якая дапамагае агенту заставацца на правым шляху.
Чаму яго заставаць? Прыўедзенне плану у пісамы ў вігляды спісу дапамагае падаць яго знову ў кантэкст мадэлі. Кожны раз, калі агент працуе, спіс перачытваецца, чым запобiegае яго зблукаў. Гэта і ёсць механізм. Гэта не оркестрацыя, а сваерадкі знак прыкрэплення інформацыі. Калі гэта стане ясным, большая частка таго, што называецца прыглушанай архітэктурой агента, на самае справе ёсць проста кераванням кантэкстам у гарным фарматы.
Ешча ўсё не так проста. Першы спосаб — планаванне раней, — гэта галоўны пункт у кожнай пастцы пра праект, але з версіі 0.7 планаванне задач стала необов’язковым. Раней гэта было стандартным мідлваром, а цяпер — няма. Функцыя, якую всі выдвайнае на першы план, — гэта тая, якую трэба самостоятэльна увімкнуць.
Дзеўяты пункт: файловая сістэма не ў вас
У опісе сказана прыступ да файловай сістэмы, і вы уявляеце сабе папку вашага праекту. Стандартны бэкенд — StateBackend, дзе файлы знаходзяцца ў стане LangGraph, прыкладзеныя да адной ніткі, не дзеліцца з іншымі ніцямі і не ўтвараюцца на вашым дыску. Агент з радасцю запішае файл, прачытае яго знову і будзе вярціць, што працюе эфектывна. Потым ніта завершаецца, і файлы знікаюць, калі толькі чэкпойнт іх не зберагае.
Для рэальнага доступу да дыску вам патрэбны FilesystemBackend. Для шэлу таксама патрэбны LocalShellBackend. Чырагчы файлы між размовамі трэба іспользоваць StoreBackend, або CompositeBackend, каб направіць шлях /memories/ у якое-небудзь стойкае месца, тады калі рэшта застаецца у межах адзінаго потока. Нічога з гэтага няўажліва, але кожны варыянт — гэта рашэнне, пра якое вы нават не ведалі.
Дэталя трох: давялегкае запамятованне — гэта настройка
Тое ж самае стосуецца запамятовання. Яго паказваюць так, як будто ён ўключаны, як автомабіль уключае прыцеп: крэпленне існуе, а прыцеп — ні. За замовчанням ён належыць да адзінаго потока. Чырагчы запамятованне між потакамі трэба спецыяльны бэкенд. Прабавіце гэта ў ноутбуку: запускайце кернель занова, спытайце, што вы рашылі вчора, і адказ будзе абяцкай пустоцей.
Дэталя чатырох: участка людзіна трэбуе checkpointer
Дакументы нечыткія. Патрабуецца чэкпойнтар, таму што без яго няма стану, які можна было бы заморозіць, і няма перэрыву, які можна было бы вярнуць. Вярненне таксама не абароткае зноў вызов agent.invoke(). Пасля аналізу перэрыву неабходна састаўіць спіс decisions, які павінен адпавядаць зачакваным дзеянням адно да адного і па парадку, а потым вярнуцца за дапамою Command(resume={"decisions": decisions}) на тым жа ID адгульніка. Неправільны ID адгульніка, неправільная парада або відсутнасць чэкпойнтара прыводзяць да таго, што працэс затверджэння нічога не затверджвае.
Пяты ўзорак: сабадгульнікі і фіксацыя версій
Гэты прынцып ўжо выправлены, але ён навучае чагось. Спачатку заставім выконвацца довга задача, для якой на родным агенце задана значэнне recursion_limit=300. Спачатку SubAgentMiddleware не перадаваў гэтае настройкі падагентам, таму яны працавалі за стандартным значэнням LangGraph — 25. Падагент, якому было патрэбна 40 крокаў, досягаў ліміту у 25 і выклікаў GraphRecursionError, што ў верхніх роўнах выглядала як asyncio.CancelledError. Гэта выглядае як анулювання, а не ліміт, і дыбагаваць гэта пазней у ночы ёсць вельмі складна.
Гэта была проблема №1698 у рэпазітарыі deepagents, заявленая у марце 2026 года. Цяпер падагенты успадковуюць ліміт роднага агента, і яго можна задаць за дапамою agent.with_config({"recursion_limit": 100}).
Прычына, чаму трэба гаворыць пра гэта: патч быў выпускан у падзеўлі марца, а версія пакета да серпня стала 0.7.x. Праект развіваецца быстра, стандартныя настройкі таксама змінююцца, а ў багатох пасляўдзях опісваюцься версіі, якія вучора ўжо не існуе. Перад тым, як даваць веры якому-небудзь наставленню, закрэпіце сваю версію і прачытайце лог змян.
Пра нуль долераў
Ліцэнзыя не купуецца — яна безкоштовная. MIT, справаўды, без жадных астэрыскаў. Але ўпрацоўванне яе — гэта адна з іншых спрабаў. Вы самі прыносіце ключ модэлю і плаціце за кожны токен, а гэтая архітэктура прызначана для вітрачання токенав:
- Дзяўны сістэмны запіт на кожны раунд
- Спіс задач перачытваецца на кожны раунд, калі увімкнута функцыя планавання
- Кожны падагент — гэта самастоятэльны вызов модэлю
- Падсумоўванне — гэта ўжо іншы вызов модэлю, на адной з вашых кантэкстаў
Паравянуўшы з простым ціклам вызову інструментаў, глыбокі агент спалвае больш рэсурсаў. Гэта і ёсць компроміс: вы плаціце за акцэнт на дзейнасцях з длігкім часам выкарыстоўвання за дапамогай токенаў. Гэта справядліва цена, якшо толькі ніхто не спрыяжае гэта як безкоштовнае.
Праўяе заэканомленне крычыць у гнучкасці. Вы можэце выкорыстоўваць дэшавы мадэль для простых падагентаў і моцную — для рашэння задач, што ёсьць перавага, якой не мае Claude Code.
Пра будзь-які мадэль
Правда, з двума заўважэннямі. Ён працуе з будзь-яй мадэллю, якая падтрымлівае вызов інструментаў, а такіх ёсць многа. Аднак запросы былі налаштаваны па прычынам правілаў Claude Code, таму дызайн мае гэты уперадзіваны характэр. Слабейшая або локальная мадэль не дае працягласна слабейшага агента; ёй прыходзіць занедбваць свой спіс задач, непатрэбна дэлегаваць ў падагенты і застрагаць у цікле.
Другі прымечкі таксама маюць свою цену: функцыя быстраага кэшавання прымусова ўвімкнутая толькі для модэляў Anthropic і Bedrock. У модэлі Claude гэты большы сістэмны прымечак кэшуецца. У іншых модэлях вам можа знадобіцца плаціць пূрныя цены за яго ў кожнай раундзе. Фраза «незалежна ад модэля» значыць, што ён працюе будзь-дзе, але не тое, што яго працэс і вартасці будуць аднаковыя ў всіх месцах, таму неабходна праверыць час на адгук у разе змены модэля.
Варта спробаваць?
Спачатку чыстая адзначка: нічога з гэтага не вынута з рэальнай прыменення. Гэта рэтэльна чытанне дакументаў, рэпазітарыя і сістэмы фіксавання проблем, а не месяцы досвядчэння. Але два моманты застаюцца незменнымі.
Першы — самае ценнае, што запусціла LangChain, — гэта не сам пакет, а план. Чатыры основныя элементы, чытраціва выказаныя, пад ліцензыей MIT. Вы моглі б стварыць гэта самі за аднаго дня і зрозумець кожную лінію, а для агента з адной метаю вы, верагодна, і трэба гэта зробіць.
Паўтора, бесплатны клон какога-небудзь продукту рэдка калі выходзіць сабой тым продуктам. Вы отрымваеце лішь ега складовыя, плюс задачу самім ўсё налаштаваць. Інодзе гэта самэўсёлкавае, а інодзе проста хочацца, каб прылад працаваў. Гэта важна ведаць пры pip install.
Спаднія статыі
- Перабудова агента у стылі Claude Code за дапамойкай LangChain Deep Agents — як працюе сістэма керавання кодавальнага агента, ад основнага цыклу да інструментаў, планавання, памяці, падагентаў і процедураў затварэння, перабудавана пашагоўна з выкарыстаннем deepagents.