Memodifikasi system prompts

• Cara kerja system prompts, dengan tabel keputusan untuk memilih antara preset, preset dengan append, dan prompt kustom
• Sesuaikan perilaku agen dengan file CLAUDE.md, output styles, append, atau string kustom
• Bandingkan empat pendekatan berdasarkan persistensi, cakupan, dan apa yang mereka pertahankan
• Gabungkan pendekatan untuk melapisi metode kustomisasi bersama-sama

​

Cara kerja system prompts

• Default minimal: ketika Anda tidak menetapkan systemPrompt di TypeScript atau system_prompt di Python, SDK menggunakan prompt minimal yang mencakup tool calling tetapi menghilangkan panduan coding Claude Code, gaya respons, dan konteks proyek. Ini berbeda dari claude -p, yang menggunakan prompt Claude Code lengkap secara default. Jika Anda bermigrasi dari CLI dan menginginkan perilaku yang cocok, atur preset claude_code.
• Preset claude_code: system prompt lengkap yang digunakan CLI Claude Code, dengan instruksi penggunaan tool, panduan gaya dan pemformatan kode, aturan nada dan verbositas respons, instruksi keamanan dan keselamatan, serta konteks tentang direktori kerja dan lingkungan. Atur systemPrompt: { type: "preset", preset: "claude_code" } di TypeScript atau system_prompt={"type": "preset", "preset": "claude_code"} di Python, secara opsional dengan append untuk menambahkan instruksi Anda sendiri di akhir.
• String kustom: prompt yang Anda tulis sendiri. SDK hanya mengirimkan apa yang Anda berikan.

​

Tentukan titik awal

• Permukaan berbeda: output tidak dibaca di terminal oleh orang yang memicunya. Chat UI, konsumen output terstruktur, dan otomasi non-coding masing-masing memerlukan prompt yang sesuai dengan cara output mereka dirender dan ditinjau. Otomasi coding tanpa pengawasan, seperti pekerjaan CI yang memperbaiki kesalahan lint atau meninjau diff, masih sesuai dengan preset karena pekerjaan itu sendiri adalah apa yang preset ditulis untuk.
• Identitas berbeda: agen tidak boleh menyajikan dirinya sebagai Claude Code. Bot dukungan, asisten analisis data, atau agen khusus domain apa pun memerlukan nama, cakupan, dan persona mereka sendiri.
• Model izin berbeda: agen berjalan secara otonom tanpa manusia menyetujui setiap langkah, atau beroperasi pada set sumber daya yang sempit. Prompt Claude Code mengasumsikan manusia berada dalam loop dengan akses ke set tool lengkap.
• Tugas non-coding: sebagian besar prompt Claude Code adalah panduan coding. Untuk penelitian, konten, atau agen operasi, panduan itu bersaing dengan instruksi yang benar-benar Anda butuhkan.

​

Sesuaikan perilaku agen

​

File CLAUDE.md untuk instruksi tingkat proyek

​

Muat CLAUDE.md dengan 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

​

Output styles untuk konfigurasi persisten

​

Buat output style

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

​

Aktifkan output style

• CLI: jalankan /config dan pilih output style
• Settings: atur outputStyle di .claude/settings.local.json
• TypeScript SDK: atur outputStyle di dalam objek settings inline yang dilewatkan ke query(), atau arahkan settings ke file pengaturan yang menetapkannya. outputStyle bukan field Options tingkat atas

​

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

​

Tingkatkan prompt caching di berbagai pengguna dan mesin

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

​

Custom system prompts

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

​

Perbandingan keempat pendekatan

​

Use cases dan best practices

​

Kapan menggunakan CLAUDE.md

​

Kapan menggunakan output styles

• Perubahan perilaku persisten di berbagai sesi
• Konfigurasi bersama tim
• Asisten khusus seperti code reviewer, data scientist, atau asisten DevOps
• Modifikasi prompt kompleks yang memerlukan versioning

• Membuat asisten optimasi SQL khusus
• Membangun code reviewer yang berfokus pada keamanan
• Mengembangkan asisten pengajaran dengan pedagogi spesifik

​

Kapan menggunakan systemPrompt dengan append

• Menambahkan standar coding atau preferensi spesifik
• Menyesuaikan pemformatan output
• Menambahkan pengetahuan domain-spesifik
• Memodifikasi verbositas respons
• Meningkatkan perilaku default Claude Code tanpa kehilangan instruksi tool

​

Kapan menggunakan custom systemPrompt

• Kontrol penuh atas perilaku Claude
• Tugas khusus sesi tunggal
• Menguji strategi prompt baru
• Situasi di mana tool default tidak diperlukan
• Membangun agen khusus dengan perilaku unik

​

Menggabungkan pendekatan

​

Menggabungkan gaya output dengan penambahan spesifik sesi

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

​

Lihat juga

• Output styles: buat, kelola, dan bagikan output styles untuk CLI, termasuk format file dan lokasi penyimpanan
• Bagaimana Claude mengingat proyek Anda: apa yang harus dimasukkan dalam CLAUDE.md, di mana menempatkannya, dan cara menulis instruksi proyek yang efektif
• Referensi TypeScript SDK: tipe Options lengkap, termasuk systemPrompt, settingSources, dan settings
• Referensi Python SDK: tipe ClaudeAgentOptions lengkap, termasuk system_prompt dan setting_sources
• Settings: referensi settings.json, termasuk di mana output styles dan konfigurasi lainnya disimpan