Изменение системных промптов

​

Понимание системных промптов

• Инструкции по использованию инструментов и доступные инструменты
• Руководящие принципы стиля и форматирования кода
• Настройки тона ответа и многословности
• Инструкции по безопасности и защите
• Контекст о текущем рабочем каталоге и окружении

​

Методы изменения

​

Метод 1: Файлы CLAUDE.md (инструкции на уровне проекта)

​

Как CLAUDE.md работает с SDK

• Уровень проекта: CLAUDE.md или .claude/CLAUDE.md в вашем рабочем каталоге
• Уровень пользователя: ~/.claude/CLAUDE.md для глобальных инструкций во всех проектах

• Включите 'project' для загрузки CLAUDE.md на уровне проекта
• Включите 'user' для загрузки CLAUDE.md на уровне пользователя (~/.claude/CLAUDE.md)

• Руководящие принципы и стандарты кодирования
• Специфичный для проекта контекст
• Общие команды или рабочие процессы
• Соглашения API
• Требования к тестированию

​

Пример CLAUDE.md

# Руководящие принципы проекта

## Стиль кода

- Используйте строгий режим TypeScript
- Предпочитайте функциональные компоненты в React
- Всегда включайте комментарии JSDoc для публичных API

## Тестирование

- Запускайте `npm test` перед коммитом
- Поддерживайте >80% покрытия кода
- Используйте jest для модульных тестов, playwright для E2E

## Команды

- Сборка: `npm run build`
- Dev сервер: `npm run dev`
- Проверка типов: `npm run typecheck`

​

Использование CLAUDE.md с SDK

import { query } from "@anthropic-ai/claude-agent-sdk";

// ВАЖНО: Вы должны указать settingSources для загрузки CLAUDE.md
// Пресет claude_code сам по себе НЕ загружает файлы CLAUDE.md
const messages = [];

for await (const message of query({
  prompt: "Добавь новый React компонент для профилей пользователей",
  options: {
    systemPrompt: {
      type: "preset",
      preset: "claude_code", // Используй системный промпт Claude Code
    },
    settingSources: ["project"], // Требуется для загрузки CLAUDE.md из проекта
  },
})) {
  messages.push(message);
}

// Теперь Claude имеет доступ к руководящим принципам вашего проекта из CLAUDE.md

​

Когда использовать CLAUDE.md

• Общий для команды контекст - Руководящие принципы, которым должны следовать все
• Соглашения проекта - Стандарты кодирования, структура файлов, шаблоны именования
• Общие команды - Команды сборки, тестирования, развертывания, специфичные для вашего проекта
• Долгосрочная память - Контекст, который должен сохраняться во всех сессиях
• Инструкции под контролем версий - Коммит в git, чтобы команда оставалась синхронизированной

• ✅ Постоянство во всех сессиях в проекте
• ✅ Совместное использование с командой через git
• ✅ Автоматическое обнаружение (не требуется изменений кода)
• ⚠️ Требует загрузки настроек через settingSources

​

Метод 2: Стили вывода (постоянные конфигурации)

​

Создание стиля вывода

import { writeFile, mkdir } from "fs/promises";
import { join } from "path";
import { homedir } from "os";

async function createOutputStyle(
  name: string,
  description: string,
  prompt: string
) {
  // Уровень пользователя: ~/.claude/output-styles
  // Уровень проекта: .claude/output-styles
  const outputStylesDir = join(homedir(), ".claude", "output-styles");

  await mkdir(outputStylesDir, { recursive: true });

  const content = `---
name: ${name}
description: ${description}
---

${prompt}`;

  const filePath = join(
    outputStylesDir,
    `${name.toLowerCase().replace(/\s+/g, "-")}.md`
  );
  await writeFile(filePath, content, "utf-8");
}

// Пример: Создать специалиста по обзору кода
await createOutputStyle(
  "Code Reviewer",
  "Тщательный помощник по обзору кода",
  `Ты эксперт по обзору кода.

Для каждой отправки кода:
1. Проверь на ошибки и проблемы безопасности
2. Оцени производительность
3. Предложи улучшения
4. Оцени качество кода (1-10)`
);

​

Использование стилей вывода

• CLI: /output-style [имя-стиля]
• Настройки: .claude/settings.local.json
• Создать новый: /output-style:new [описание]

​

Метод 3: Использование systemPrompt с append

import { query } from "@anthropic-ai/claude-agent-sdk";

const messages = [];

for await (const message of query({
  prompt: "Помоги мне написать Python функцию для вычисления чисел Фибоначчи",
  options: {
    systemPrompt: {
      type: "preset",
      preset: "claude_code",
      append:
        "Всегда включай подробные docstrings и подсказки типов в Python коде.",
    },
  },
})) {
  messages.push(message);
  if (message.type === "assistant") {
    console.log(message.message.content);
  }
}

​

Метод 4: Пользовательские системные промпты

import { query } from "@anthropic-ai/claude-agent-sdk";

const customPrompt = `Ты специалист по Python кодированию.
Следуй этим руководящим принципам:
- Пиши чистый, хорошо документированный код
- Используй подсказки типов для всех функций
- Включай исчерпывающие docstrings
- Предпочитай шаблоны функционального программирования, когда это уместно
- Всегда объясняй свой выбор кода`;

const messages = [];

for await (const message of query({
  prompt: "Создай конвейер обработки данных",
  options: {
    systemPrompt: customPrompt,
  },
})) {
  messages.push(message);
  if (message.type === "assistant") {
    console.log(message.message.content);
  }
}

​

Сравнение всех четырех подходов

​

Случаи использования и лучшие практики

​

Когда использовать CLAUDE.md

• Специфичных для проекта стандартов и соглашений кодирования
• Документирования структуры и архитектуры проекта
• Перечисления общих команд (сборка, тест, развертывание)
• Общего для команды контекста, который должен быть под контролем версий
• Инструкций, которые применяются ко всему использованию SDK в проекте

• “Все API конечные точки должны использовать шаблоны async/await”
• “Запускай npm run lint:fix перед коммитом”
• “Миграции базы данных находятся в каталоге migrations/”

​

Когда использовать стили вывода

• Постоянных изменений поведения между сессиями
• Конфигураций, общих для команды
• Специализированных помощников (обзорщик кода, специалист по данным, DevOps)
• Сложных изменений промпта, которые нуждаются в версионировании

• Создание специализированного помощника по оптимизации SQL
• Построение обзорщика кода, ориентированного на безопасность
• Разработка помощника по обучению с конкретной педагогикой

​

Когда использовать systemPrompt с append

• Добавления конкретных стандартов или предпочтений кодирования
• Настройки форматирования вывода
• Добавления знаний, специфичных для домена
• Изменения многословности ответа
• Улучшения поведения Claude Code по умолчанию без потери инструкций по инструментам

​

Когда использовать пользовательский systemPrompt

• Полного контроля над поведением Claude
• Специализированных задач одной сессии
• Тестирования новых стратегий промпта
• Ситуаций, где инструменты по умолчанию не нужны
• Построения специализированных агентов с уникальным поведением

​

Комбинирование подходов

​

Пример: Стиль вывода с дополнениями, специфичными для сессии

import { query } from "@anthropic-ai/claude-agent-sdk";

// Предполагая, что стиль вывода "Code Reviewer" активен (через /output-style)
// Добавить области фокуса, специфичные для сессии
const messages = [];

for await (const message of query({
  prompt: "Просмотри этот модуль аутентификации",
  options: {
    systemPrompt: {
      type: "preset",
      preset: "claude_code",
      append: `
        Для этого обзора приоритизируй:
        - Соответствие OAuth 2.0
        - Безопасность хранения токенов
        - Управление сессиями
      `,
    },
  },
})) {
  messages.push(message);
}

​

См. также

• Стили вывода - Полная документация по стилям вывода
• Руководство по TypeScript SDK - Полное руководство по использованию SDK
• Справочник по TypeScript SDK - Полная документация API
• Руководство по конфигурации - Общие опции конфигурации