Коротко про конфігурацію Claude Code

У минулому пості про Claude обіцяв розповісти про правильну конфігурацію CC (Claude Code, а не те що ти подумав) — буде коротко, але пізнавально.

1. CLAUDE.md — найважливіший файл

Починаємо з CLAUDE.md — при старті CC читає його першим і тримає у системному промпті протягом всієї роботи. Що там писати: овервью проєкту коротко, основні команди (npm run dev, make build тощо), структуру папок, правила прийняті у команді. Не пиши туди повну документацію, довгі теоретичні пояснення і правила лінтингу, якщо є файл конфігурації.

Два важливі моменти. Якщо є додаткові інструкції які потрібні тільки тобі — клади у CLAUDE.local.md. І 200 рядків — це максимум по розміру файлу, краще за нього не заходити.

2. Директорія .claude/

Тут тонка конфігурація CC для проєкту. Цих директорій насправді дві: одна глобальна ~/.claude/ доступна тільки на твоїй системі, інша під проєкт.

3. rules/ — правила за призначенням

Коли твій CLAUDE.md починає розростатися, у цю папку можна покласти інструкції за призначенням. testing.md для правил тестування, data-layer.md для роботи з даними, code-style.md для холівару про таби чи пробіли. Кожне правило можна назначити на свій скоуп — якщо CC працює з конкретним файлом який потрапляє під паттерн, правило активується.

---
paths:
  - "src/api/**/*.ts"
  - "src/handlers/**/*.ts"
---
# API Rules

4. commands/ та skills/

Інструкції з описом того, як робити ту чи іншу задачу. Основна різниця: команди ти викликаєш мануально, а скіли агент може викликати сам. Наприклад, у мене в проєкті є і скіл, і команда для ревью. Я можу сказати агенту /review, а можу "Давай видалимо усі TODO-коменти, а потім зробимо ревью". У другому випадку агент сам знайде скіл і зробить все по інструкції.

Ще одна відмінність: для skills можна покласти скрипти, темплейти і додаткові файли — CC буде їх використовувати. Команда — це завжди один файл.

Скіл — папка з усілякими ніштяками для агента. Команда — один нудний файл для людини.

Цікавий факт яким можна похизуватись у розумній розмові — у skills є штука під назвою progressive disclosure. У кожного скіла поряд з основною інструкцією є короткий опис того, що скіл робить. Замість аплоду повної інструкції в контекст, CC завантажує тільки короткий опис. А вже коли скіл дійсно потрібен — підвантажується вся інструкція з додатковими файлами. Контекст чистий, токени зекономлені.

---
description: Review the branch diff for issues before merge
---
## Changes to Review
!`git diff --name-only main...HEAD`
## Detailed Diff
!`git diff main...HEAD`
Review for: code quality, security, tests, etc.

Рекомендація стосовно того з чим працювати: якщо потрібна гнучкість і розширюваність — створюй скіли, якщо флоу простий і за межі одного файлу не вийде — команди.

5. agents/ — саб-агенти

Тут можна сетапити саб-агентів для різних цілей з різними моделями. Саб-агенти запускаються в окремому ізольованому контексті з конкретним набором інструментів. Менше токенів на основний контекст, менше галюцинацій основної моделі. Приклади — код-ревью або генерація копірайтів.

---
name: code-reviewer
description: Expert code reviewer. Use PROACTIVELY when reviewing PRs.
model: sonnet
tools: Read, Grep, Glob
---
…some instructions…

6. Плагіни на прикладі Codex

Плагін у CC — це набір скілів, команд і агентів в одному пакеті який можна встановити з маркетплейсу. OpenAI випустили офіційний плагін Codex для Claude Code — тобто з CC ти можеш делегувати задачі Codex прямо зі своєї звичної робочої сесії. Отримуєш команди типу /codex:review для код-ревью і /codex:rescue щоб віддати Codex задачу яка не йде у Claude. Працює через локальний Codex CLI, тому потрібен ChatGPT акаунт або OpenAI API key.

Ставиться в три кроки прямо в CC:

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/codex:setup

Якщо Codex CLI ще не стояв — команда /codex:setup сама запропонує його поставити.

---

Що далі? А далі чекаю на коменти та реакції і готую наступні пости про розробку продуктів в соло!