Что это
Системный промпт задаёт рамку всему разговору: роль, тон, границы, и каждое сообщение пользователя модель читает через эту рамку. В API это отдельное поле запроса. У Claude Code есть свой системный промпт от Anthropic, у каждого субагента свой: текст его файла им и становится.
Чем отличается от CLAUDE.md
CLAUDE.md я называю системным промптом проекта: он читается в начале каждой сессии. Технически Claude Code передаёт его первым сообщением после настоящего системного промпта, и строгого исполнения Anthropic не обещает. Правило, которое нельзя нарушить ни при каком раскладе, ставят хуком: эту проверку программа запускает сама, без участия модели.
Как это выглядит на практике
В системный промпт бота поддержки я кладу три вещи. Голос: на «ты», коротко, без канцелярита. Факты: дату, цену или число не называть по памяти, брать только из переданных данных. Границы: вернуть деньги или открыть доступ бот не может, это делает человек. Без последних двух бот однажды наобещает клиенту лишнего.