Modificación de indicaciones del sistema

• Cómo funcionan las indicaciones del sistema, con una tabla de decisión para elegir entre el preset, el preset con append, y una indicación personalizada
• Personalizar el comportamiento del agente con archivos CLAUDE.md, estilos de salida, append, o una cadena personalizada
• Comparar los cuatro enfoques por persistencia, alcance, y qué preservan
• Combinar enfoques para superponer métodos de personalización juntos

​

Cómo funcionan las indicaciones del sistema

• Predeterminado mínimo: cuando no establece systemPrompt en TypeScript o system_prompt en Python, el SDK utiliza una indicación mínima que cubre la invocación de herramientas pero omite las directrices de codificación de Claude Code, el estilo de respuesta y el contexto del proyecto. Esto difiere de claude -p, que utiliza la indicación completa de Claude Code de forma predeterminada. Si está migrando desde la CLI y desea un comportamiento coincidente, establezca el preset claude_code.
• Preset claude_code: la indicación del sistema completa que utiliza la CLI de Claude Code, con instrucciones de uso de herramientas, directrices de estilo y formato de código, reglas de tono de respuesta y verbosidad, instrucciones de seguridad y protección, y contexto sobre el directorio de trabajo y el entorno. Establezca systemPrompt: { type: "preset", preset: "claude_code" } en TypeScript o system_prompt={"type": "preset", "preset": "claude_code"} en Python, opcionalmente con append para agregar sus propias instrucciones al final.
• Cadena personalizada: una indicación que usted escribe. El SDK envía solo lo que proporciona.

​

Decida sobre un punto de partida

• Superficie diferente: la salida no se lee en una terminal por la persona que la activó. Las interfaces de chat, los consumidores de salida estructurada y la automatización no codificadora cada una necesita una indicación que coincida con cómo se representa y revisa su salida. La automatización de codificación desatendida, como un trabajo de CI que corrige errores de lint o revisa diffs, aún se ajusta al preset porque el trabajo en sí es para lo que se escribió el preset.
• Identidad diferente: el agente no debe presentarse a sí mismo como Claude Code. Un bot de soporte, un asistente de análisis de datos, o cualquier agente específico del dominio necesita su propio nombre, alcance y persona.
• Modelo de permisos diferente: el agente se ejecuta de forma autónoma sin que un humano apruebe cada paso, u opera en un conjunto estrecho de recursos. La indicación de Claude Code asume que un humano está en el bucle con acceso a un conjunto completo de herramientas.
• Tareas no codificadoras: la mayoría de la indicación de Claude Code es orientación de codificación. Para agentes de investigación, contenido u operaciones, esa orientación compite con las instrucciones que realmente necesita.

​

Personalizar el comportamiento del agente

​

Archivos CLAUDE.md para instrucciones a nivel de proyecto

​

Cargar CLAUDE.md con el 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

​

Estilos de salida para configuraciones persistentes

​

Crear un estilo de salida

---
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)

​

Activar un estilo de salida

• CLI: ejecute /config y seleccione un estilo de salida
• Configuración: establezca outputStyle en .claude/settings.local.json
• TypeScript SDK: establezca outputStyle dentro del objeto settings en línea pasado a query(), o apunte settings a un archivo de configuración que lo establezca. outputStyle no es un campo Options de nivel superior

​

Agregar al preset 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);
  }
}

​

Mejorar el almacenamiento en caché de indicaciones entre usuarios y máquinas

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
    }
  }
})) {
  // ...
}

​

Indicaciones del sistema personalizadas

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);
  }
}

​

Comparación de los cuatro enfoques

​

Casos de uso y mejores prácticas

​

Cuándo usar CLAUDE.md

​

Cuándo usar estilos de salida

• Cambios de comportamiento persistentes en sesiones
• Configuraciones compartidas por el equipo
• Asistentes especializados como revisor de código, científico de datos o asistente de DevOps
• Modificaciones de indicaciones complejas que necesitan control de versiones

• Crear un asistente dedicado de optimización SQL
• Construir un revisor de código enfocado en seguridad
• Desarrollar un asistente de enseñanza con pedagogía específica

​

Cuándo usar systemPrompt con append

• Agregar estándares de codificación o preferencias específicas
• Personalizar el formato de salida
• Agregar conocimiento específico del dominio
• Modificar la verbosidad de la respuesta
• Mejorar el comportamiento predeterminado de Claude Code sin perder instrucciones de herramientas

​

Cuándo usar systemPrompt personalizado

• Control completo sobre el comportamiento de Claude
• Tareas especializadas de una sola sesión
• Prueba de nuevas estrategias de indicaciones
• Situaciones donde las herramientas predeterminadas no son necesarias
• Construcción de agentes especializados con comportamiento único

​

Combinación de enfoques

​

Combinación de un estilo de salida con adiciones específicas de sesión

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);
}

​

Ver también

• Estilos de salida: crear, gestionar y compartir estilos de salida para la CLI, incluido el formato de archivo y las ubicaciones de almacenamiento
• Cómo Claude recuerda su proyecto: qué poner en CLAUDE.md, dónde colocarlo y cómo escribir instrucciones de proyecto efectivas
• Referencia del SDK de TypeScript: el tipo Options completo, incluidos systemPrompt, settingSources y settings
• Referencia del SDK de Python: el tipo ClaudeAgentOptions completo, incluidos system_prompt y setting_sources
• Configuración: la referencia de settings.json, incluido dónde se almacenan los estilos de salida y otras configuraciones