Изменение системных подсказок

• Как работают системные подсказки, с таблицей решений для выбора между предустановкой, предустановкой с append и пользовательской подсказкой
• Настройка поведения агента с файлами CLAUDE.md, стилями вывода, append или пользовательской строкой
• Сравнение четырёх подходов по постоянству, области действия и тому, что они сохраняют
• Объединение подходов для наслоения методов настройки вместе

​

Как работают системные подсказки

• Минимальное значение по умолчанию: когда вы не устанавливаете systemPrompt в TypeScript или system_prompt в Python, SDK использует минимальную подсказку, которая охватывает вызов инструментов, но исключает рекомендации по кодированию Claude Code, стиль ответов и контекст проекта. Это отличается от claude -p, который по умолчанию использует полную подсказку Claude Code. Если вы переходите с CLI и хотите совпадающее поведение, установите предустановку claude_code.
• Предустановка claude_code: полная системная подсказка, которую использует CLI Claude Code, с инструкциями по использованию инструментов, рекомендациями по стилю и форматированию кода, правилами тона и многословности ответов, инструкциями по безопасности и защите, а также контекстом о рабочем каталоге и окружении. Установите systemPrompt: { type: "preset", preset: "claude_code" } в TypeScript или system_prompt={"type": "preset", "preset": "claude_code"} в Python, опционально с append для добавления ваших собственных инструкций в конец.
• Пользовательская строка: подсказка, которую вы пишете сами. SDK отправляет только то, что вы предоставляете.

​

Выберите начальную точку

• Другая поверхность: вывод не читается в терминале человеком, который его запустил. Интерфейсы чата, потребители структурированного вывода и автоматизация без кодирования каждый требуют подсказку, которая соответствует тому, как их вывод отображается и проверяется. Автоматизация кодирования без присмотра, такая как задание CI, которое исправляет ошибки lint или проверяет различия, всё ещё соответствует предустановке, потому что сама работа — это то, для чего написана предустановка.
• Другая идентичность: агент не должен представлять себя как Claude Code. Бот поддержки, помощник по анализу данных или любой агент, специфичный для домена, нуждается в собственном имени, области и персоне.
• Другая модель разрешений: агент работает автономно без одобрения человеком каждого шага или работает с узким набором ресурсов. Подсказка Claude Code предполагает, что человек находится в цикле с доступом к полному набору инструментов.
• Задачи без кодирования: большая часть подсказки Claude Code — это руководство по кодированию. Для агентов исследования, контента или операций это руководство конкурирует с инструкциями, которые вам действительно нужны.

​

Настройка поведения агента

​

Файлы CLAUDE.md для инструкций на уровне проекта

​

Загрузка CLAUDE.md с SDK

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

const messages = [];

for await (const message of query({
  prompt: "Add a new React component for user profiles",
  options: {
    systemPrompt: {
      type: "preset",
      preset: "claude_code" // Use Claude Code's system prompt
    },
    settingSources: ["project"] // Loads CLAUDE.md from project
  }
})) {
  messages.push(message);
}

// Now Claude has access to your project guidelines from CLAUDE.md

​

Стили вывода для постоянных конфигураций

​

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

---
name: Code Reviewer
description: Thorough code review assistant
keep-coding-instructions: true
---

You are an expert code reviewer.

For every code submission:
1. Check for bugs and security issues
2. Evaluate performance
3. Suggest improvements
4. Rate code quality (1-10)

​

Активация стиля вывода

• CLI: запустите /config и выберите стиль вывода
• Параметры: установите outputStyle в .claude/settings.local.json
• TypeScript SDK: установите outputStyle внутри встроенного объекта settings, передаваемого в query(), или укажите settings на файл параметров, который его устанавливает. outputStyle не является полем Options верхнего уровня

​

Добавление к предустановке claude_code

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

const messages = [];

for await (const message of query({
  prompt: "Help me write a Python function to calculate fibonacci numbers",
  options: {
    systemPrompt: {
      type: "preset",
      preset: "claude_code",
      append: "Always include detailed docstrings and type hints in Python code."
    }
  }
})) {
  messages.push(message);
  if (message.type === "assistant") {
    console.log(message.message.content);
  }
}

​

Улучшение кэширования подсказок между пользователями и машинами

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

for await (const message of query({
  prompt: "Triage the open issues in this repo",
  options: {
    systemPrompt: {
      type: "preset",
      preset: "claude_code",
      append: "You operate Acme's internal triage workflow. Label issues by component and severity.",
      excludeDynamicSections: true
    }
  }
})) {
  // ...
}

​

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

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

const customPrompt = `You are a Python coding specialist.
Follow these guidelines:
- Write clean, well-documented code
- Use type hints for all functions
- Include comprehensive docstrings
- Prefer functional programming patterns when appropriate
- Always explain your code choices`;

const messages = [];

for await (const message of query({
  prompt: "Create a data processing pipeline",
  options: {
    systemPrompt: customPrompt
  }
})) {
  messages.push(message);
  if (message.type === "assistant") {
    console.log(message.message.content);
  }
}

​

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

​

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

​

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

​

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

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

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

​

Когда использовать systemPrompt с добавлением

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

​

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

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

​

Объединение подходов

​

Объединение стиля вывода с добавлениями, специфичными для сеанса

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

// Assuming "Code Reviewer" output style is active (via /config or settings)
// Add session-specific focus areas
const messages = [];

for await (const message of query({
  prompt: "Review this authentication module",
  options: {
    systemPrompt: {
      type: "preset",
      preset: "claude_code",
      append: `
        For this review, prioritize:
        - OAuth 2.0 compliance
        - Token storage security
        - Session management
      `
    }
  }
})) {
  messages.push(message);
}

​

См. также

• Стили вывода: создание, управление и совместное использование стилей вывода для CLI, включая формат файла и места хранения
• Как Claude запоминает ваш проект: что поместить в CLAUDE.md, где его разместить и как писать эффективные инструкции проекта
• Справочник TypeScript SDK: полный тип Options, включая systemPrompt, settingSources и settings
• Справочник Python SDK: полный тип ClaudeAgentOptions, включая system_prompt и setting_sources
• Параметры: справочник settings.json, включая место хранения стилей вывода и другой конфигурации