Васьміўзроўневая налада Claude Code: CLAUDE.md, памяць, хукі і абмежаванні

Настройкі з'являюцца тым, насколькі можна даваць доверлець адпаведнай адпаведзі

Кожны можа запісаць запіт у Claude Code, але саме настройкі вплываюць на тое, чы рэзультат заслуговае на доверлець. Чырпамо пасляэтапнае аналізаванне рэалістычнай настройкі для серйозной інжынернай працы, а таксама пасляводы для кожнага етапу. Цэла не ўжо спіс функцый і не маркетынгавая версія. Восьць етапаў разам ствараюць прыбліжнае да добра настроюванага інжынернага інструмента раштунак, а не проста вікна для чату, якое віпадкова пішае код.

Этап 1: CLAUDE.md у двух рэжымах

Claude Code чытае файлы CLAUDE.md у розных сферах дзеяння, і разлік меж між ямі мае большое значэнне, ніж думае большасць людзей. Асобісты файл у ~/.claude/CLAUDE.md дыяўаць у кожным праекце, незалежна ад таго, які рэпазітарый ўвімкнуты. Кожны праект таксама мае свой CLAUDE.md, які зберагаецца ў сістэме керавання версіямі, таму весь калектыв чытае тыя ж інструкцыі праз сістэму керавання версіямі.

Простая правіла дапамагае разлучыць гэтыя два элементы. Усё, што стосуецца спосабу работы чалавека, незалежна ад базы коду, кладзецца ў глобальны файл: правілы выкарыстоўвання інструментаў, такія як прываленне пошуку інформацыі пра кода замест адкрытага запуску grep, прыярытэты і стандарты камунікацыі, якія павінны дапэўнівацца ў всіх месцах. Усё, што стосуецца конкрэтной базы коду, кладзецца ў файл для конкрэтнага рэпазітарыю: команды для будовы, рашэнні ў архітэктурных пытаннях, стандарты называння і класы багоў, якія вялікі пашкоджэння ў тым праекце. У будзь-ям іншым праекце гэтыя элементы ўжо не маюць значэння і толькі займаюць месца без корысты.

Прытак для запісу чаго-небудзь ёсць конкрэтным. Уявіце саблёзнечы патэрн, які з’яўляецца два разы ў той самы роцэ праекта. Рашэнне здаецца правільным і пры празглядзе не выклікае запытанняў, але ён зноў стварае тую ж проблему, таму што асновныя абмежэння ніколі не былі зафіксаваны там, дзе агент мог бы іх пабачыць. Першы раз абмежэнняяясняюцца па час размовы, і всі праходзяць да наступнага крока. Другі раз тая ж памылка вяртае тое ж адпаведзенне. Гэта і ёсць сігнал. Правілле патрабуецца ў CLAUDE.md не таму, што ён можа стаць корыстным калі-небудзь, а таму, што тое ж самае адбываецца два разы па час размовы. Калі правілле стае конкрэтным, можна яго пераканаць, а не толькі нечыясным паведамленнем, проблема перастае павтарацца.

Адзін практычны дэтал: контэнт CLAUDE.md дастаецца як паведамленне ад карыстальніка і не ўключаецца ў запыт сістэмы, таму конкрэтнасць мае большое значэнне чым дужына. Файл з менш чым 200 рэядамі конкрэтных правіл працюе лепшая, чым дугі файл з нечыткімі правіламі.

Слой 2: аўтаматычная памяць

CLAUDE.md — гэта тое, што распрацоўшчык паведамляе агенту, а памяць — гэта тое, што агент вырашае сам. Яны выконваюць разныя задачы і не трэба іх сплутваць. У Claude Code ёсць другая сістэма — аўтаматычная памяць, якая формуецца па праектах і зберагаецца параду з рэпазітарыем, і саме агент запісвае ў яе даны. У яй зберагаюцца чатыры відзныкі: ролі распрацоўшчыка і яго прыямлівыя до працы, парадкі і адзначэнні, якія ужо дадзены, стан праекта, які нельга вывесты з коду, і зовнішніе апыланні, якія вядуць да інфармацыі, якая знаходзіцца параду з кодбазай. Легкі файл MEMORY.md індэксуе усё.

Разлік заключаецца ў тым, што CLAUDE.md мае намерова запісаныя інструкцыі, тады як памяць зберагае кантэкст, адзібраны пад час спільной працы сесія за сесіяй, які ніколі не фіксуецца у формальных документах. Одна з ягоў — гэта кніга правіл. Іншая нагадвае інстытуцыянальныя знанні давгастажнага колегі, якія ён мае без жадных інструкцый з адкультурацыі. Тры прыклады паказваюць, што змініцца:

• Одноразовыя поправкі, такія як «не чапайце гэты файл без падзеўкі», пераходзяць у наступную сесію і не трэба павтараць іх ў кожны раз, калі пачынаецца размова.
• Стан праекту, невідразумелы ў кодзе, застаецца ў памяці: працэс міграцыі, намерова адкладзенае рашэнне аб архітэктурэ, якая выглядае некорэктнаю праз якісь обмежэнні, якія не паказваюцца ў разліках.
• Спылі на тое, дзе знаходзяцца адпаведныя адказы, застаюцца: напрыклад, які дашборд, які зовнішні документ аб якая сістэма мае тое, чаго кодбаза не можа сказаць.

Нічыя з гэтых рэчаў не патрабуецца ў CLAUDE.md, адтуды што нічыя з іх не ўжо ўважаюцца правіламі, якія павінны быць выкананы. Гэта кантэкст, які знікне як толькі сесія будзе завершана.

Слой 3: хукі як намераваны тэртак

Намераваны тэртак зовсім не супанае з тэртакам, з якім проста давягаецца стаці. Хукі выкананы дэтэрміністычна, як справжнія команды шэлу у фіксаваныя моменты жыцёвага цыклу, і гэта ўжо болей надзеяна гаранцыя, чым проста спадзяванне, што мадэль зазвычай памятае. Хук PreToolUse запускаецца перад кожным вызовам інструмента і можа ўсё ў тым запярэчыць. Хук Stop запускаецца, калі Claude завершае свой адказ, і можа змусіць яго продаваць, калі якаясь умова яшчэ не выпанялася.

Самым корыстным шаблонам ёсць хук PreToolUse, які прызначаны толькі для рэдагавання файлаў. Перш чым прыняць рэшэнь пра рэдагаванне, неабходна пісьмовая інформацыя пра факты: якія модулі імпортуюць файл, што можа зламацца і які саме быў запіт. Ён выступае як свяжучы механізм проты неакуратных змян, і гэтыя зусіллі вартуюць таго, таму што ён дзейсніць самэ там, дзе неабходна абераганне. На вядзменна з людскім увагай, хук не фіксуе і не прышвычваецца да чацвертага рэдагавання ў дужа дзягучай сесіі.

Другій хук адмініструецькае выходныя даны, заставляючы адказы быць кароткімі, адзяляючы зайвыя фразы і неяснасці, якія з’яўляюцца падчас дужа дзяўніх сесій. Гэта больш пра тое, каб не марнаваць час на чытанне зайвай інфармацыі, чым пра безпеку. Трэцій хук сочыць за станам кантэксту, прабуючы стварыць канцэнтрацію ў прыродным моменце, а не пры будзь-якім іншым. Хук PreCompact або SessionStart, прыўязаны да падзеяў канцэнтраціі, можа запрашаць падсумак, калі размова справды досягла канца, ўтаму ёй не будзе перарвана на паўслове.

Чы рэзультаты такіх заходаў вартыя зусілляў? Для захоўніка файлоў — абавесці, таму што ён запобігае справжнім памылкам, прычым яны не ператвараюцца на серьёзныя проблемы. Хукі, якія ствараюць кароткасць і контролююць кантэкст, больш служаюць для зручнасці чытання, чым для захавання, але яны дапамагаюць, калі ўстановлены правільна.

Слой 4: граф знанняў коду лепшы за grep

Grep паказвае, дзе з’являецца аўтамат, але не тое, што яго вызывае, калі ён вызывае, чыі ён вызывае, і не тое, што ламаецца, калі ён змініцца. Класычны спосаб аналізу — гэта цікл: шукаеце тэрмін, ачынаеце файл, шукаеце тое, што імпортуець гэты файл, ачынаеце і яго, і так далей, пакуль не сформуецца цэлісная картына. Гэты метод працюе, але медленна, і ён выконвае многія запыты інструментаў, каб перазбудаваць ментальную мадэль, створаную на адной структурныя факты, якія не павінны зноў адкрывацца сілой ў кожнай сесіі.

Прыедындэксаваныя графы знанняяў змінююць прыроду эканамікі ўраджэння інфармацыі. Адна запытка вяртае неабходныы істочнік дакументацыі разам з рэальнымі шляхамі вызова: хто яго вызывае, куды ён вызывае і насколькі далека праходзіць ланцуг залежнасцяў. Гэта адбываецца за адну пераходзь у працэ, а не праз многа пошукі, таму ёсць менш раунд-трыпаў, і з самага пачатку ёсць болей цэлісная карціна, адколі дакладныя відпаведнія шляхамі вызова, якіх ніколі не даў бы grep, проста прыходзяць разам з рэзультатам.

Слой 5: перакананне на рэальным прыстрое

Важна тая чыстка, чы рэштрынкаванне працуе на самай прыстрою чы толькі было скомпілявана, і гэта два разныя твэрджэння. Для Flutter гэты слой ўжоўся найчым чашчэ. Перзначальнае стварэнне праекта з нуля, каб пераканацца ў незначным змяненні інтэрфейсу, ёсць марнатраплам, калі існуе можлівасць з’яўіцца на з’ўязак з аплікацыяй, якая працуе на рэальным прыстрое, і гэты з’ўязак заполняе прасвет, да якога не можа дасягнуць генераванне коду. Ён падтрымлівае зйомку экрана, перэходы па разныя элементы інтэрфейсу і аналіз жывага дрэва інтэрфейса. Claude Code цяпер правільна падтрымлівае гэта, прымоўляючы доступ да сімулятара iOS і функцыі для камп’ютара, якія можаць пераканацца ў правільнасці натыўнага білда, відтворыць бягу проблемы з макетам чы запрацаваць сімулятарны прыем па таму, што ўжо было атрыбутавана.

З’еднанне з віртуальным машынам Dart для гарачага перзагрузкі і гарачага перзапуску ператварае цыкл з «здагадка, перабудова, чаканне, перакананне» на «здагадка, перзагрузка, перакананне». Гэта прыямейша, і гэта таксама запобегае частай пастцы: спрытліванню чыстай компіляцыі як доказа таго, што практыка працюе. Компіляцыя, якая працюе, і працэйная праца на апаратнай частцы — гэта два розныя тверджэння, і прыкмета перабудовы толькі не можа іх адзінакаваць. Запуск на прыстрое адразу дае адказ на гэты вопыт.

Слой 6: запускайце інструменты толькі калі трэба

Кожны інструмент, які знаходзіцца ў кантэксце, незалежна ад таго, чы робіцца з яго выкарыстоўванне, вплывае на кожны крок, а не толькі на тыя, дзе ён выкарыстоўваецца. Таму не усё завантажваецца за замовчаннем, і гэта ўсвядомлена дызайнавая выбор. Спецыялізаваныя інструменты, такія як автаматызацыя браузера, рэдкія серверы MCP і ўсё, што выкарыстоўваецца час а часу, завантажваюцца за патрэбай і не займаюць кантэкст на весь сеанс.

Этый эфект парадоксальнаўся працэсе длігай сесіі, адколькі кожная вялічына інструмента коштае токены ў кожны момент, незалежна ад таго, выкарыстоўваецца ён у тым моменты чы ні. Функцыя пошуку інструментаў MCP у Claude Code створана, каб скасаваць гэтую проблему. Серверы можаць зарэгістравацца для пошуку за патрэбай, замест таго, каб загадзя завантажваць усі вялічыны інструментаў на пачатку сесіі, што дапамагае падтрымваць эфектыўнасць сесіі трываласцю колька гадзін і не перавантажвае ёй сістэму мертвым кантэкстам, які ніколі не выкарыстоўваецца, але продовжае коштаць.

Слой 7: выкарыстоўвайце пакаваныя рабочыя працэсы, якія вам дасканальна патрэбны

Claude Code прыносіць з сабой вялікі экасістэм пакаваных рабочых процэсаў, укладаючы перагляд коду, перагляд безпекі, спецыяльных пераглядачаў для прамэў, а таксама агентаў для планавання і выканання. Кожны з іх можа быць выкліканы як самастойна, таму тая ж самая логіка не павінна будавацца занова ў кожной сесіі. Вялікая бібліятэка мае малая значыць, калі выкарыстоўваецца толькі тры елементы, таму адкрытыя падрахункі фактычнага выкарыстоўвання лепшыя, чым спіс усіх элементаў каталогу.

Тры ўспалююцца рэгулярна. Перш чым які-небудзь значыцыцкі элемент з’едыніцца, адбываецца загальны адзінак перагляду коду. Адзінак, які фокусуецца на безпецы, пераглядае все, што стосуецца аўтэнтыфікацыі чы працы з данымі. Спецыяльны падагент для планавання караце кожную задачу, якая настолькі веліка, што безпосерэдняя рэалізацыя выклікала б прыгнуце без адпрацоўкі архітэктуры. Гэтыя тры элементы адпавядаюць за практычна ўсе прымусовыя вызывы.

Большасць адзінакаў, прызначаных для конкрэтных фрэймворкаў, якія не выкарыстоўваюцца, застаюцца недаступнымі, так сама як і болей экзотычныя патэрны падагентаў, створаныя для велікіх паралельных доследжэнняў. Гэтыя інструменты не ўжо паслабыя. Якраз у павсякдзеннай рабоце не патрабуецца такога масштабу дакладнага аналізу, а вікорыстоўванне інструментаў, якія перавышаюць патрэбы задачы, ёсць марнатратнасцю. Ценнасць крыўціцца з ведамае пра тры-чатыры інструменты, якія можна надзеясціва выкарыстоўваць, не чуваючыся зобав’язанымі вікорыстоўваць рэшту толькі таму, што яны існуюць.

Слой 8: паўтарнае перакананне

Скорасць лічыцца як перавага толькі тады, калі рэзультат застаецца надзеяным, а калі доверлівасць зменшыцца, сама скорасць стае прычыной няхора. Нават калі увесь набор функцый актыўны, дзеянні, якія можуць завяліць шкоду, завжды трэбуе явнага падтверджэння: разрушальныя операцыі з git, аплоўванні дадзеннямі і ўсё тое, што сапраўды не можа быць вярнуцца у пачатковы стан. Жадны ступень автаматызацыі не дапамагае абойсці гэтага рызыку, адтолькі ўпуск у такіх моментах не значыць толькі перадзеяння працы — гэта значыць падліквідаванне шкоды, якая можа ўзагалі не падліквідавацца.

Равнавага залежыць ад таго, насколькі можна вярнуць конкрэтную дзеянне, а не ад таго, насколькі рызыкавана здаецца задача. Масштабная перэработка дзесяткаў файлаў выклікае велікія зусіллі, але за дапамогою кантролю версій застаецца цалкам вярнаемай, таму ёю можна кераваць з меншым наглядам. Однак git push --force не выклікае практычна жадных зусілляў, але можа стаць незворачным, таму яму накладаецца строгі запрэт, незалежна ад таго, насколькі ён здаецца рутынным. Зусіллі і рызык належаць да разных вектараў, і самэ спалучэнне іх ўводзіць да таго, што вялікая автаномія даходзіць да неправільных дзеянняў.

Выбір между негайным дзеяннем і прабамай прадзеяння не зводзіцца да аднаго параметра. Гэта рашэнне для кожнага тыпу дзеяння, якое прымецца загадзя і ніколі не пераглядаецца тады, калі вымушанне робіць падтверджэння схожым на раздражаючы перакананне.

Што даеесягледы

Ні адзін з восьміх слоёў не выдзеляецца сам па сабе. CLAUDE.md — гэта файл з простым тэкстам, а хук — гэта команда шэлу, якая запускаецца у правы момент. Разам яны ператвараюць Claude Code з быстраага клавішніка, які не мае стойкага кантэксту і жаднага разумення можлівасці відкату, у інструмент з памяцю, механізмамі контролю, структурным розуменням кодбазы і рэальной перацэнкай прыстрою.

Сама наладка не ўсё тое, што цікава, а прычыны, якія стояць за кожным слоём. Кожны, хто запускае Claude Code без жадной з гэтых налаштаванняў, не павінен прымыкаты ўсе восьмі слоёў адразу. Пачніце з рэальнага CLAUDE.md, створанага на адной з адмылак, якія вяліся вялікія два разы, а потым расшырайце яго.