Output styles
Sesuaikan Claude Code untuk penggunaan di luar rekayasa perangkat lunak
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 empat 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 adalah panduan eksekusi otonom yang lebih kuat daripada yang diterapkan mode otomatis, dan ini berfungsi tanpa mengubah mode izin Anda, jadi mode izin Anda masih menentukan apa yang berjalan tanpa meminta Anda.
-
Concise: Claude memimpin dengan hasil, melewatkan pembukaan dan narasi, dan membuat respons tetap singkat secara default, sambil melakukan pekerjaan rekayasa sebaik-baiknya seperti dalam gaya Default. Ketika Anda meminta penjelasan atau detail lebih lanjut, Claude menjawab secara lengkap. Claude selalu menyimpan konten lengkap laporan kesalahan, peringatan keamanan, dan konfirmasi untuk tindakan destruktif. Memerlukan Claude Code v2.1.237 atau lebih baru.
-
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 gaya output Anda
Pilih gaya dengan salah satu cara berikut:
- Terminal: jalankan
/configdan pilih Output style untuk memilih gaya dari menu. Claude Code menyimpan pilihan Anda ke.claude/settings.local.jsondi tingkat proyek lokal. - Ekstensi VS Code: buka menu perintah dengan
/dan pilih Output styles untuk memilih gaya, termasuk gaya kustom Anda. Claude Code menyimpan pilihan Anda ke.claude/settings.local.json, file yang sama yang ditulis menu terminal. Memerlukan Claude Code v2.1.257 atau lebih baru. - Aplikasi Desktop: atur field
outputStyledalam file settings, misalnya.claude/settings.local.json, file yang ditulis menu terminal. Ketika Anda menjalankan/configdi sana, Claude Code membuka Settings > Claude Code daripada menu.
Untuk menetapkan gaya tanpa menu, edit field outputStyle secara langsung dalam file settings:
{
"outputStyle": "Explanatory"
}
Ketika Anda beralih gaya di tengah sesi, Claude menggunakan gaya baru mulai dari pesan Anda berikutnya. Gaya adalah bagian dari system prompt, sehingga pesan pertama itu membangun ulang prompt cache sekali. Sebelum v2.1.251, gaya baru diterapkan hanya setelah Anda menjalankan /clear atau memulai sesi baru.
Buat custom output style
Custom output style adalah file Markdown: frontmatter untuk metadata, kemudian instruksi untuk ditambahkan ke system prompt.
Buat file Markdown
Simpan di salah satu dari tiga tingkat. Nama file menjadi nama style kecuali Anda menetapkan name dalam frontmatter.
- User:
~/.claude/output-styles - Project:
.claude/output-styles - Managed policy:
.claude/output-stylesdi dalam direktori pengaturan terkelola
Project output styles dimuat dari setiap .claude/output-styles/ antara direktori kerja dan akar repositori. Ketika lebih dari satu direktori bersarang ini mendefinisikan style dengan nama yang sama, Claude Code menggunakan yang paling dekat dengan direktori kerja.
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.
Beralih ke style Anda
Jalankan /config di terminal dan pilih style Anda di bawah Output style. Claude menggunakan style baru mulai dari pesan Anda berikutnya. Di terminal, Claude Code membaca file style saat dimulai, jadi jika Anda membuat atau mengedit satu selama sesi yang sedang berjalan, restart Claude Code untuk mengambil perubahan tersebut.
Plugins juga dapat mengirimkan output styles dalam direktori output-styles/.
Frontmatter
File output style mendukung field frontmatter ini:
| Frontmatter | Tujuan | Default |
|---|---|---|
name |
Nama output style, jika bukan nama file | Mewarisi dari nama file |
description |
Deskripsi output style, ditampilkan dalam picker /config |
Tidak ada |
keep-coding-instructions |
Pertahankan instruksi rekayasa perangkat lunak bawaan Claude Code | false |
force-for-plugin |
Plugin 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.
- Claude Code menambahkan instruksi kustom output style ke system prompt.
- Ketika Anda memilih style selain Default, Claude Code juga mengingatkan Claude tentang style tersebut 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-instructionsdiatur ketrue.
Output styles berlaku hanya untuk percakapan utama: subagent menjalankan system prompt-nya sendiri, jadi styles tidak mengubah cara subagents merespons. Fork adalah pengecualian, karena mewarisi system prompt lengkap parent.
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, dan style Concise melakukan sebaliknya dengan menginstruksikan Claude untuk menjaga respons tetap singkat secara default. 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.
| Fitur | Cara kerjanya | Gunakan ketika |
|---|---|---|
| Output styles | Memodifikasi system prompt | Anda menginginkan peran, nada, atau format respons default yang berbeda setiap giliran |
| CLAUDE.md | Menambahkan pesan pengguna setelah system prompt | Claude harus selalu mengetahui konvensi proyek dan konteks codebase Anda |
--append-system-prompt |
Menambahkan ke system prompt tanpa menghapus apa pun | Anda menginginkan penambahan satu kali untuk satu invokasi |
| Agents | Menjalankan subagent dengan system prompt, model, dan tools-nya sendiri | Anda menginginkan helper dengan cakupan terpisah untuk tugas yang terfokus |
| Skills | Memuat instruksi khusus tugas saat dipanggil atau relevan | Anda memiliki alur kerja yang dapat digunakan kembali |
Sumber daya terkait
- Settings: di mana field
outputStyleberada dan cara kerja precedence settings - Permission modes: bagaimana style Proactive dibandingkan dengan mode otomatis
- Plugins: paket dan distribusikan output styles bersama skills, hooks, dan agents
- Debug your configuration: diagnosa mengapa output style tidak berlaku