Как использовать системные инструкции в Claude

После выполнения этой инструкции вы сможете выбрать правильное место для системных инструкций в Claude и настроить их без типичных ошибок: без случайной замены дефолтного промпта в Claude Code, без неверного формата в API и без путаницы между личными, проектными и организационными правилами.

Короткий ответ: для одноразовой настройки в терминале используйте --append-system-prompt в Claude Code; для постоянных правил на весь аккаунт — Instructions for Claude в Claude.ai; для отдельной рабочей области — инструкции проекта; для прямых интеграций — верхнеуровневое поле system в Messages API.

• Время: 15–25 минут
• Сложность: средний
• Стоимость: зависит от вашего плана Claude.ai, Team/Enterprise и использования API; на цитируемых страницах цены для этих функций не детализированы, поэтому проверяйте официальные страницы цен отдельно
• Что потребуется: доступ к Claude.ai, Claude Code, Agent SDK или Claude API — в зависимости от выбранного способа; заранее подготовленный текст системной инструкции
• Актуальность: официальные страницы Anthropic и Claude Code Docs по состоянию на 2026-08-13/14; номера версий интерфейса в источниках не указаны

Практический вердикт: в большинстве случаев безопаснее не заменять, а дополнять системные инструкции. Для Claude Code это означает --append-system-prompt или --append-system-prompt-file; для Agent SDK — сохранение дефолтного поведения через preset claude_code и добавление своих правил поверх него. Редакционное ограничение: в источниках не зафиксированы номера версий интерфейса Claude.ai и не детализированы цены, поэтому инструкция опирается на официальные руководства и дату проверки, а не на номер сборки или тариф.

Пошагово

1. Определите область действия системной инструкции.

   Сначала решите, где правило должно жить: только в одном вызове, во всех ваших чатах, только в конкретном проекте, во всей организации или внутри собственного приложения. После этого выполняйте только тот путь ниже, который соответствует вашей задаче.

   Ожидаемый результат: вы понимаете, какой из вариантов использовать: Claude.ai, Project instructions, Organization instructions, Claude Code CLI, Agent SDK или Messages API.

2. Задайте личные Instructions for Claude, если правило должно работать во всех ваших разговорах.

   По официальной справке Claude.ai, профильные Instructions for Claude применяются ко всем разговорам на уровне аккаунта. Используйте этот путь для устойчивых предпочтений: язык ответа, формат, тон, правила оформления, ограничения на длину.

   Если вам не нужно глобальное поведение, не используйте этот уровень: он затронет не один чат, а все беседы аккаунта.

   Ожидаемый результат: одно и то же правило начинает влиять на все новые и текущие разговоры аккаунта в рамках персонализации.

3. Настройте Project instructions, если правило нужно только внутри одного проекта.

   Откройте Projects, создайте проект или откройте существующий, выберите Set project instructions, введите инструкцию и сохраните её. По справке Anthropic после сохранения Claude использует эти инструкции для всех чатов внутри этого проекта.

   Это лучший вариант для команды, клиента, продукта или курса, где правила не должны влиять на остальные беседы. Если вы ожидаете, что информация автоматически перенесётся из одного чата проекта в другой, учитывайте ограничение: контекст не переносится между отдельными чатами, если вы не добавили его в knowledge base проекта. Если вам нужна полноценная схема работы с проектами, инструкциями и базой знаний, посмотрите практическую инструкцию по Claude Projects.

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

4. В Claude Code добавьте одноразовую системную инструкцию через append, если хотите сохранить дефолтное поведение.

   Для разовых задач в терминале используйте флаг --append-system-prompt. По официальной документации он добавляет вашу инструкцию к дефолтному системному промпту Claude Code, а значит сохраняет встроенные указания по инструментам, безопасности и кодовым соглашениям.

   claude --append-system-prompt "Отвечайте по-русски, кратко и сначала показывайте план действий"

   Если удобнее хранить длинный текст в файле, используйте файловый вариант.

   claude --append-system-prompt-file ./instructions.txt

   Для типовых терминальных сценариев это обычно лучший путь. Если вы только начинаете работать с CLI, поможет отдельная инструкция как использовать Claude Code в терминале.

   Ожидаемый результат: Claude Code учитывает вашу инструкцию, но не теряет свои стандартные правила работы.

5. Заменяйте системный промпт в Claude Code только тогда, когда действительно хотите убрать дефолт.

   Флаг --system-prompt заменяет дефолтный системный промпт, а --system-prompt-file делает то же самое для содержимого файла. По документации именно этот режим убирает стандартные указания Claude Code, поэтому его стоит применять только в случаях, когда меняются идентичность, поверхность взаимодействия или модель разрешений.

   claude --system-prompt-file ./system.txt

   Учитывайте ограничения синтаксиса: --system-prompt и --system-prompt-file взаимоисключающие. При этом append-флаги можно комбинировать с любым из флагов замены.

   claude --system-prompt-file ./system.txt --append-system-prompt-file ./extra.txt

   Ожидаемый результат: вы либо полностью заменяете дефолтный системный промпт Claude Code, либо заменяете его и отдельно добавляете поверх дополнительные правила.

6. В Messages API передавайте системную инструкцию в верхнеуровневом поле system.

   В прямых запросах к Claude Messages системная инструкция задаётся не отдельным сообщением, а верхнеуровневым параметром system. Документация прямо указывает, что отдельного input message с ролью system нет.

   Ниже — не полный запрос, а минимальный фрагмент, показывающий правильное место системной инструкции в теле запроса.

   {
     "system": "Отвечайте по-русски и возвращайте результат в виде краткого списка.",
     "messages": [
       {"role": "user", "content": "Подготовьте план внедрения"}
     ]
   }

   Если вы строите более сложную интеграцию с инструментами и структурированными ответами, дальше удобно перейти к материалу как использовать function calling в API.

   Ожидаемый результат: ваш API-запрос передаёт системные правила корректным способом и не ломается из-за несуществующей роли system в массиве messages.

7. В Agent SDK используйте preset claude_code, если хотите поведение, близкое к Claude Code CLI.

   По документации Anthropic дефолтный системный промпт Agent SDK минимален: в нём нет кодовых рекомендаций, стиля ответа и проектного контекста, характерных для Claude Code. Если вам нужна близкая к CLI база поведения, используйте preset claude_code. Если вам нужны дополнительные правила, добавляйте их поверх дефолта, а не вместо него, когда хотите сохранить стандартное поведение.

   Этот шаг особенно важен, если вы переносите рабочий процесс из CLI в собственное приложение и ждёте одинакового поведения без явной настройки.

   Ожидаемый результат: вы не предполагаете ложный паритет между SDK и CLI и осознанно выбираете минимальный дефолт или preset claude_code.

8. Настройте organization instructions только на уровне организации и проверяйте их в новой беседе.

   Organization instructions доступны ролям Admin, Owner и Primary Owner на Team и Enterprise и применяются ко всем разговорам в организации. По официальной справке изменения могут распространяться до часа, а проверять их рекомендуется, начиная новый разговор.

   Это уровень для обязательных организационных правил: стандарты формата, общие ограничения, корпоративный стиль или единые требования к ответам. Не используйте этот механизм для частных предпочтений одного пользователя или одного проекта.

   Ожидаемый результат: после распространения новые разговоры в организации начинают учитывать единый набор инструкций.

Как проверить, что всё работает

Проверка зависит от поверхности, где вы задали системные инструкции.

• Claude.ai, личные инструкции: начните новый чат и задайте простой тестовый запрос, где соблюдение правила видно сразу, например требование отвечать по-русски, в фиксированном формате или в виде списка.
• Project instructions: откройте новый чат внутри того же проекта и задайте такой же тестовый запрос. Если открыть чат вне проекта, правило применяться не должно.
• Organization instructions: следуйте официальной рекомендации Anthropic и проверяйте результат в новой беседе. Если вы только что изменили правило, заложите до часа на распространение.
• Claude Code: повторите один и тот же короткий вызов с и без системной инструкции. Для сценариев и CI используйте структурированный вывод: --output-format json. Если нужен контроль схемы, документация Claude Code рекомендует --json-schema; для потоковой обработки — stream-json.
• Agent SDK: проверяйте, как инициализируется сессия. Документация указывает, что SDK испускает SystemMessage с subtype init и финальный ResultMessage с метаданными сессии, включая session ID, token usage и cost.
• Messages API: отправьте заведомо контролируемый запрос и проверьте, что модель следует именно системному правилу. Если ответ не соответствует, сначала убедитесь, что инструкция находится в поле system, а не в массиве messages.

Частые ошибки и исправления

• Ошибка: в Claude Code вы использовали --system-prompt и потеряли привычное поведение CLI.
  Исправление: если вам не нужно полностью менять идентичность или правила доступа, переходите на --append-system-prompt или --append-system-prompt-file, чтобы сохранить дефолтные указания по инструментам, безопасности и кодовым соглашениям.
• Ошибка: вы пытаетесь передать системную инструкцию в Messages API как отдельное сообщение с ролью system.
  Исправление: перенесите текст в верхнеуровневое поле system. По документации отдельного input message с такой ролью нет.
• Ошибка: вы ожидаете, что правила проекта автоматически перенесут контекст между всеми чатами проекта.
  Исправление: используйте Project instructions для правил поведения, а знания, которые должны быть доступны в разных чатах, добавляйте в knowledge base проекта.
• Ошибка: organization instructions не сработали сразу после сохранения.
  Исправление: подождите до часа и проверяйте результат в новой беседе, как рекомендует официальная справка.
• Ошибка: вы предполагаете, что Agent SDK по умолчанию ведёт себя как Claude Code CLI.
  Исправление: учитывайте, что дефолтный промпт SDK минимален. Если нужен паритет с CLI, используйте preset claude_code и только потом добавляйте свои инструкции.

Безопасность и ограничения

• Личные Instructions for Claude влияют на все разговоры аккаунта. Не помещайте туда узкоспециальные правила, которые могут мешать в других задачах.
• Project instructions ограничены проектом. Если вам важно повторное использование фактов между чатами, одной инструкции недостаточно: данные нужно положить в knowledge base проекта.
• Organization instructions — самый жёсткий уровень. Они применяются ко всем разговорам организации и доступны только определённым ролям на Team и Enterprise.
• Claude Code replacement убирает стандартный системный промпт. Это значит, что вместе с ним вы убираете дефолтные указания по инструментам, безопасности и кодовым соглашениям.
• Agent SDK по умолчанию не наследует всё поведение Claude Code. Если это критично, выбирайте preset claude_code.
• Messages API требует корректной структуры запроса. Системную инструкцию нужно держать в поле system, а не оформлять как отдельное сообщение.
• Практическое ограничение источников: в этой проверке не переподтверждалась региональная доступность на одной канонической странице, а цены для самих instruction-функций не перечислены на цитируемых страницах.

Что делать дальше

• Если вы внедряете правила прямо в терминальный поток работы, разберите как использовать Claude Code в терминале.
• Если вы строите постоянную рабочую область с файлами, базой знаний и отдельными правилами, откройте практическую настройку Claude Projects.
• Если вы проектируете API-интеграцию с вызовом инструментов, переходите к инструкции по function calling в API.
• Если хотите усилить качество ответов поверх системных инструкций, добавьте few-shot промптинг.

Источники

• CLI reference – Claude Code Docs
• Modifying system prompts – Claude Code Docs
• How the agent loop works – Claude Code Docs
• Run Claude Code programmatically – Claude Code Docs
• Create a Message – Claude API Reference
• Understanding Claude’s personalization features | Claude Help Center
• Как создавать проекты и управлять ими? | Anthropic Help Center
• Set organization instructions | Claude Help Center
• Release notes | Claude Help Center

Вопросы и ответы

Можно ли задать системную инструкцию только для одного проекта?

Да. Для этого используйте инструкции проекта в Claude.ai. Они действуют только для чатов внутри выбранного проекта, а не на весь аккаунт.

Что выбрать в Claude Code: append или replace?

Если вы хотите сохранить стандартные указания Claude Code по инструментам, безопасности и кодовым соглашениям, выбирайте append. Replace используйте только тогда, когда вам действительно нужно убрать дефолтный системный промпт.

Можно ли передать системную инструкцию в API как сообщение с ролью system?

Нет. В Messages API системная инструкция передаётся в верхнеуровневом поле system. Отдельного input message с ролью system нет.

Почему organization instructions не применились сразу?

По справке Anthropic распространение изменений может занимать до часа. Проверяйте результат в новой беседе, а не в уже открытом разговоре.

Совпадает ли поведение Agent SDK с Claude Code CLI по умолчанию?

Нет. Дефолтный системный промпт Agent SDK минимален и не включает весь набор кодовых рекомендаций, стиля ответа и проектного контекста Claude Code. Для близкого поведения используйте preset claude_code.