Modificando prompts do sistema

# Diretrizes do Projeto

## Estilo de Código

- Use modo strict do TypeScript
- Prefira componentes funcionais em React
- Sempre inclua comentários JSDoc para APIs públicas

## Testes

- Execute `npm test` antes de fazer commit
- Mantenha >80% de cobertura de código
- Use jest para testes unitários, playwright para E2E

## Comandos

- Build: `npm run build`
- Dev server: `npm run dev`
- Type check: `npm run typecheck`

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

// IMPORTANTE: Você deve especificar settingSources para carregar CLAUDE.md
// A predefinição claude_code sozinha NÃO carrega arquivos CLAUDE.md
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"], // Required to load CLAUDE.md from project
  },
})) {
  messages.push(message);
}

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

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

async function createOutputStyle(
  name: string,
  description: string,
  prompt: string
) {
  // User-level: ~/.claude/output-styles
  // Project-level: .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");
}

// Example: Create a code review specialist
await createOutputStyle(
  "Code Reviewer",
  "Thorough code review assistant",
  `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)`
);

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";

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

Recurso	CLAUDE.md	Estilos de Saída	`systemPrompt` com append	`systemPrompt` personalizado
Persistência	Arquivo por projeto	Salvo como arquivos	Apenas sessão	Apenas sessão
Reutilização	Por projeto	Entre projetos	Duplicação de código	Duplicação de código
Gerenciamento	No sistema de arquivos	CLI + arquivos	No código	No código
Ferramentas padrão	Preservadas	Preservadas	Preservadas	Perdidas (a menos que incluídas)
Segurança integrada	Mantida	Mantida	Mantida	Deve ser adicionada
Contexto do ambiente	Automático	Automático	Automático	Deve ser fornecido
Nível de personalização	Apenas adições	Substituir padrão	Apenas adições	Controle completo
Controle de versão	Com projeto	Sim	Com código	Com código
Escopo	Específico do projeto	Usuário ou projeto	Sessão de código	Sessão de código

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

// Assuming "Code Reviewer" output style is active (via /output-style)
// 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);
}

Modificando prompts do sistema

Entendendo prompts do sistema

Modificando prompts do sistema

Entendendo prompts do sistema

Método 1: Arquivos CLAUDE.md (instruções em nível de projeto)

Como CLAUDE.md funciona com o SDK

Exemplo CLAUDE.md

Usando CLAUDE.md com o SDK

Quando usar CLAUDE.md

Método 2: Estilos de saída (configurações persistentes)

Criando um estilo de saída

Usando estilos de saída

Método 3: Usando `systemPrompt` com append

Método 4: Prompts do sistema personalizados

Comparação de todas as quatro abordagens

Casos de uso e melhores práticas

Quando usar CLAUDE.md

Quando usar estilos de saída

Quando usar `systemPrompt` com append

Quando usar `systemPrompt` personalizado

Combinando abordagens

Exemplo: Estilo de saída com adições específicas da sessão

Veja também

Entendendo prompts do sistema

Entendendo prompts do sistema

Método 1: Arquivos CLAUDE.md (instruções em nível de projeto)

Como CLAUDE.md funciona com o SDK

Exemplo CLAUDE.md

Usando CLAUDE.md com o SDK

Quando usar CLAUDE.md

Método 2: Estilos de saída (configurações persistentes)

Criando um estilo de saída

Usando estilos de saída

Método 3: Usando systemPrompt com append

Método 4: Prompts do sistema personalizados

Comparação de todas as quatro abordagens

Casos de uso e melhores práticas

Quando usar CLAUDE.md

Quando usar estilos de saída

Quando usar systemPrompt com append

Quando usar systemPrompt personalizado

Combinando abordagens

Exemplo: Estilo de saída com adições específicas da sessão

Veja também

Método 3: Usando `systemPrompt` com append

Quando usar `systemPrompt` com append

Quando usar `systemPrompt` personalizado