/ai / claude

claude-code-best-practices

Що реально впливає на якість роботи Claude Code: CLAUDE.md, контекст, plan mode, сабагенти, хуки, MCP, дозволи, verification loop. Плюс огляд патернів caveman і ponytail.

raw .md ↓

Claude Code: практики, які дають різницю

Не переказ релізноутів. Список того, що змінює результат, згруповане за тим, де саме воно ламається.

CLAUDE.md

Стартувати з /init — він підтягне наявні .cursor/rules, .cursorrules, .github/copilot-instructions.md.

Ліміт — 200 рядків. Далі модель починає семплити файл, а не читати, і справжні правила губляться серед вати.

Тест на кожен рядок: чи зробить модель помилку, якщо цей рядок прибрати? Якщо ні — прибрати.

Класти Не класти
bash-команди, які неможливо вгадати те, що видно з коду
стильові правила, які відрізняються від дефолтних стандартні конвенції мови
який тест-раннер і як його запускати API-документацію (лінк замість неї)
етикет репозиторію, квірки середовища опис кожного файлу
архітектурні рішення й граблі те, що швидко змінюється

Інші деталі, які економлять години:

Контекст

Plan mode, effort, thinking

Сабагенти

Хуки

Детерміновані shell-команди на подіях життєвого циклу. Для того, що мусить статися щоразу: формат після редагування, блокування запису в migrations/, реінжект контексту після компакції.

Слеш-команди та скіли

MCP

Дозволи, headless, worktrees

Verification loop — те, без чого решта не має сенсу

Модель мусить мати команду, яка скаже «зроблено правильно» без участі людини: тести, exit code білда, лінтер, дифф фікстури, порівняння скріншотів. Без цього роль верифікатора виконує людина — і саме тут згорає весь виграш у швидкості.

Способи прив'язати:

Скріншот-цикл: кинути макет → «зроби, зніми скріншот результату, порівняй, перелічи відмінності, виправ».

TDD-розкладка: одна сесія пише тести, друга, зі свіжим контекстом, пише код під них. Той самий розкол працює для пари Writer/Reviewer.

І головне: вимагати доказ (команда + вивід), а не заяву «готово, все працює».

Антипатерни, за які платять усі

Чекліст на щодня

P.S. — caveman і ponytail

Два ком'юніті-скіли, які постійно згадують поруч, хоча вони про різне. Обидва — не від Anthropic.

caveman — «why use many token when few token do trick». Наказує агенту викинути з відповіді артиклі, прийменники, преамбули й метакоментарі, лишивши телеграфні уламки; код, команди й помилки не чіпаються. Стиснення вихідних токенів, на вхід і на reasoning не впливає взагалі. Народилось анонімним постом на r/ClaudeAI (~10K апвоутів, весна 2026), потім затверділо в інсталябельні скіли. Заявлено −65 % виводу; незалежний бенчмарк JetBrains поміряв −8.5 % по сесії цілком — бо основна маса токенів у агентній сесії це не проза моделі, а вивід інструментів.

ponytail — скіл Dietrich Gebert, який змушує агента поводитись як «найлінивіший сеньйор у кімнаті»: той, з хвостиком і овальними окулярами, що працює тут довше за систему контролю версій. Перед написанням коду проганяє драбину рішень: чи це взагалі має існувати (YAGNI) → чи цього вже нема в кодовій базі → чи це не робить stdlib/платформа → чи не можна одним рядком. Лікує over-engineering, не багатослівність. У репо заявлено 293 → 47 рядків і ~4× швидше на п'яти задачах.

Коротко: caveman стискає прозу, ponytail стискає код. Із двох другий важливіший — рядок, який не написано, не треба ні читати, ні тестувати, ні підтримувати.

P.P.S. — економіка оптимізації
   ЗАЯВЛЕНО −65% ТОКЕНІВ        ВИМІРЯНО −8.5%
   ┌──────────────────┐          ┌──────────────────┐
   │ ████████████████ │          │ ██               │
   └──────────────────┘          └──────────────────┘
            ▲                             ▲
            │                             │
      пресреліз                    той самий скіл,
                                   але з секундоміром

   ── куди пішли токени насправді ──────────────────
   вивід інструментів   ██████████████████████ 71%
   вміст файлів         ████████ 19%
   системний промпт     ███ 7%
   проза моделі         █ 3%   ← ось тут ми героїчно
                                  зрізали дві третини

Класика: оптимізували 3 % на 65 %, отримали 2 % і статтю в Decrypt.