Як працює використання інструментів — Claude Code

Claude Code — агент Anthropic у терміналі. Він працює в циклі використання інструментів: модель обирає інструмент (список файлів, читання, пошук, shell), отримує результат і продовжує, доки не відповість або не попросить уточнення. Ви бачите кроки в сесії, а не лише фінальний текст. Це прозорість: можна зупинити небезпечну команду або попросити пояснити, навіщо агент читав певний файл.

Приклад циклу

Запит «де оголошена автентифікація?» → інструмент показує дерево → читання підозрілих файлів → коротка відповідь із шляхами. Без читання файлів модель би вигадала імена модулів. Саме тому агентний робочий процес надійніший за «вгадай структуру репо». Кожен виклик інструмента — маленький факт у контексті; накопичені факти формують відповідь, яку можна перевірити за шляхами на диску.

Цикл використання інструментів: запит → інструмент → результат → наступний крок або відповідь

Моделі та перемикання

Доступні різні моделі — Opus (глибший аналіз), Sonnet (баланс швидкості й якості), Haiku (легкі задачі). Перемкнути модель можна slash-командою або змінною середовища перед запуском. Для рефакторингу з багатьма файлами часто варто Opus або Sonnet; для «поясни цю функцію» достатньо Haiku і економії токенів.

Перед установкою Claude Code переконайтесь, що Node.js сучасний — пакет ставиться через npm і потребує актуального середовище виконання. Запустіть у терміналі:

Bash

node -v

Очікуйте v18 або новішу. Якщо команда не знайдена — спочатку встановіть Node, потім повертайтесь до модулю про встановлення.

Уже в сесії Claude Code статус сесії й вибір моделі змінюють слеш-команди. Спробуйте після запуску claude:

Bash

/status
/model

Порада

Змінна ANTHROPIC_MODEL задає модель за замовчуванням для нових сесій, наприклад sonnet або opus, залежно від вашого тарифу. Експортуйте її в .zshrc або .bashrc, якщо хочете однакову модель щодня.

Більше контексту

Використання інструментів — не магічний список API, а контракт: модель просить дію, середовище виконання виконує й повертає текстовий результат. Тому агент «бачить» лише те, що повернули інструменти. Якщо файл у .gitignore і політика блокує читання — агент про нього не дізнається, поки ви явно не дасте вміст.

Типові помилки

Не ігноруйте проміжні кроки в UI: там видно, чи агент шукає не там. Якщо він читає десять нерелевантні файлів — звузьте запит («шукай лише в src/автентифікація»). Не перемикайте модель посеред складного рефакторингу без потреби: контекст сесії лишається, але стиль відповідей може змінитись.

Приклад

Практика: у тестовому репо запитайте «де оголошено main точка входу?» і простежте ланцюжок викликів інструментів. Порівняйте з тим, скільки часу зайняв би ручний пошук.

Що запамʼятати

Claude Code = цикл використання інструментів у терміналі. Модель обирає інструменти; ви контролюєте дозволи й модель через /status, /model і ANTHROPIC_MODEL. Node 18+ — передумова для установки пакета.