Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Output styles mengubah cara Claude merespons, bukan apa yang Claude ketahui. Mereka memodifikasi system prompt untuk menetapkan peran, nada, dan format output. Gunakan satu ketika Anda terus-menerus meminta kembali untuk suara atau format yang sama setiap giliran, atau ketika Anda ingin Claude bertindak sebagai sesuatu selain seorang insinyur perangkat lunak. Custom output style menambahkan instruksi Anda ke system prompt dan memungkinkan Anda memilih apakah akan mempertahankan instruksi rekayasa perangkat lunak bawaan Claude Code. Pertahankan mereka ketika Anda mengubah cara Claude berkomunikasi tetapi masih coding, seperti selalu menjawab dengan diagram. Tinggalkan mereka ketika Claude tidak melakukan rekayasa perangkat lunak sama sekali, seperti asisten penulisan atau analis data. Untuk instruksi tentang proyek, konvensi, atau codebase Anda, gunakan CLAUDE.md sebagai gantinya.

Gaya output bawaan

Gaya output Default Claude Code adalah system prompt yang ada, dirancang untuk membantu Anda menyelesaikan tugas-tugas rekayasa perangkat lunak secara efisien. Ada tiga gaya output bawaan tambahan:
  • Proactive: Claude dieksekusi segera, membuat asumsi yang masuk akal alih-alih berhenti untuk keputusan rutin, dan lebih memilih tindakan daripada perencanaan. Ini menerapkan panduan yang sama seperti mode otomatis tanpa mengubah mode izin Anda, jadi Anda masih melihat prompt izin sebelum alat dijalankan.
  • Explanatory: Menyediakan “Insights” edukatif di antara membantu Anda menyelesaikan tugas-tugas rekayasa perangkat lunak. Membantu Anda memahami pilihan implementasi dan pola codebase.
  • Learning: Mode kolaboratif belajar-dengan-melakukan di mana Claude tidak hanya akan berbagi “Insights” saat coding, tetapi juga meminta Anda untuk berkontribusi dengan potongan kode kecil dan strategis sendiri. Claude Code akan menambahkan penanda TODO(human) dalam kode Anda untuk Anda implementasikan.

Ubah output style Anda

Jalankan /config dan pilih Output style untuk memilih style dari menu. Pilihan Anda disimpan ke .claude/settings.local.json di tingkat proyek lokal. Untuk menetapkan style tanpa menu, edit field outputStyle secara langsung dalam file settings:
{
  "outputStyle": "Explanatory"
}
Karena output style ditetapkan dalam system prompt saat awal sesi, perubahan berlaku saat Anda memulai sesi baru. Ini menjaga system prompt tetap stabil sepanjang percakapan sehingga prompt caching dapat mengurangi latensi dan biaya.

Buat custom output style

Custom output style adalah file Markdown: frontmatter untuk metadata, kemudian instruksi untuk ditambahkan ke system prompt.
1

Buat file Markdown

Simpan di salah satu dari tiga tingkat. Nama file menjadi nama style kecuali Anda menetapkan name dalam frontmatter.
2

Tambahkan frontmatter dan instruksi

Putuskan apakah akan mempertahankan instruksi rekayasa perangkat lunak Claude Code. Atur keep-coding-instructions: true jika Anda mengubah cara Claude berkomunikasi tetapi masih ingin coding dengan cara yang sama. Tinggalkan jika Claude tidak akan melakukan rekayasa perangkat lunak.Contoh ini memimpin setiap penjelasan dengan diagram sambil mempertahankan perilaku coding Claude:
---
name: Diagrams first
description: Lead every explanation with a diagram
keep-coding-instructions: true
---

When explaining code, architecture, or data flow, start with a Mermaid diagram showing the structure, then explain in prose.

## Diagram conventions

Use `flowchart TD` for control flow and `sequenceDiagram` for request paths. Keep diagrams under 15 nodes.
3

Beralih ke style Anda

Jalankan /config dan pilih style Anda di bawah Output style. Ini berlaku saat Anda memulai sesi berikutnya.
Plugins juga dapat mengirimkan output styles dalam direktori output-styles/.

Frontmatter

File output style mendukung field frontmatter ini:
FrontmatterTujuanDefault
nameNama output style, jika bukan nama fileMewarisi dari nama file
descriptionDeskripsi output style, ditampilkan dalam picker /configTidak ada
keep-coding-instructionsPertahankan instruksi rekayasa perangkat lunak bawaan Claude Codefalse
force-for-pluginPlugin output styles hanya: terapkan style ini secara otomatis kapan pun plugin diaktifkan, tanpa memerlukan pengguna untuk memilihnya. Mengesampingkan pengaturan outputStyle pengguna. Jika beberapa plugin yang diaktifkan menetapkan ini, Claude Code menggunakan yang pertama dimuat.false

Cara kerja output styles

Output styles secara langsung memodifikasi system prompt Claude Code.
  • Semua output styles memiliki instruksi kustom mereka sendiri yang ditambahkan ke akhir system prompt.
  • Semua output styles memicu pengingat bagi Claude untuk mematuhi instruksi output style selama percakapan.
  • Custom output styles menghilangkan instruksi rekayasa perangkat lunak bawaan Claude Code, seperti cara membatasi perubahan, menulis komentar, dan memverifikasi pekerjaan, kecuali keep-coding-instructions diatur ke true.
Penggunaan token tergantung pada style. Menambahkan instruksi ke system prompt meningkatkan input tokens, meskipun prompt caching mengurangi biaya ini setelah permintaan pertama dalam sesi. Built-in Explanatory dan Learning styles menghasilkan respons yang lebih panjang daripada Default secara desain, yang meningkatkan output tokens. Untuk custom styles, penggunaan output tokens tergantung pada apa yang instruksi Anda katakan kepada Claude untuk diproduksi.

Perbandingan dengan fitur terkait

Beberapa fitur menyesuaikan perilaku Claude Code. Output styles memodifikasi system prompt secara langsung dan berlaku untuk setiap respons. Yang lain menambahkan instruksi tanpa mengubah system prompt default, atau membatasi mereka ke tugas tertentu.
FiturCara kerjanyaGunakan ketika
Output stylesMemodifikasi system promptAnda menginginkan peran, nada, atau format respons default yang berbeda setiap giliran
CLAUDE.mdMenambahkan pesan pengguna setelah system promptClaude harus selalu mengetahui konvensi proyek dan konteks codebase Anda
--append-system-promptMenambahkan ke system prompt tanpa menghapus apa punAnda menginginkan penambahan satu kali untuk satu invokasi
AgentsMenjalankan subagent dengan system prompt, model, dan tools-nya sendiriAnda menginginkan helper dengan cakupan terpisah untuk tugas yang terfokus
SkillsMemuat instruksi khusus tugas saat dipanggil atau relevanAnda memiliki alur kerja yang dapat digunakan kembali

Sumber daya terkait

  • Settings: di mana field outputStyle berada dan cara kerja precedence settings
  • Permission modes: style Proactive mencerminkan mode otomatis tanpa mengubah mode izin Anda
  • Plugins: paket dan distribusikan output styles bersama skills, hooks, dan agents
  • Debug your configuration: diagnosa mengapa output style tidak berlaku