Проектировать под модель: как в Anthropic придумывают тулзы для Claude Code

У любой обвязки вокруг агента рано или поздно всплывает тихий кризис: что ему отдать в руки — один универсальный примитив вроде bash или десятки узких команд? В свежем посте команды Claude Code они предлагают смотреть на задачу с позиции самой модели и постепенно уточнять набор инструментов.

Бумага, калькулятор или компьютер

Авторы сравнивают это с трудной задачей по математике: кому-то хватит листа и ручки, кому-то — калькулятора с «продвинутыми» кнопками, а максимум скорости даст код на машине — если умеешь им пользоваться. Так же и у агента: оптимальный набор тулов зависит не от вашей фантазии, а от того, что модель реально умеет стабильно вызывать и доводить до конца.

«Видеть глазами агента»

Чтобы это понять, приходится читать траектории, смотреть на ошибки и экспериментировать — буквально учиться видеть мир так, как его видит агент при выборе следующего шага. Отсюда и практические вопросы: когда добавлять новый инструмент, когда выкидывать лишний и как не перепутать симптом с причиной.

Структура вместо свободного текста

На примере AskUserQuestion они показывают, зачем иногда выносить «спросить у человека» в отдельный тул: формализованный вопрос и варианты ответа лучше подходят для elicitation, чем размытая фраза в чате — меньше недопонимания и проще дальше строить цепочку действий.

Источник: Anthropic — Seeing like an agent: how we design tools in Claude Code