Output styles
Ubah peran, nada, dan format respons Claude Code dengan gaya output bawaan seperti Concise atau Explanatory, atau tulis gaya kustom Anda sendiri.
Output style adalah serangkaian instruksi yang menetapkan peran, nada, dan format respons Claude untuk setiap respons dalam sesi. Claude Code mencakup empat gaya bawaan selain defaultnya, dan Anda dapat menulis gaya Anda sendiri.
Gunakan output style untuk mengubah cara Claude merespons dan bekerja dengan Anda selama seluruh sesi, sehingga Anda tidak perlu mengulangi permintaan di setiap prompt. Misalnya, gaya bawaan dapat membuat respons lebih pendek, menambahkan penjelasan setiap perubahan, atau membuat Claude mulai bekerja tanpa mengajukan pertanyaan rutin. Gaya kustom juga dapat mengubah Claude menjadi sesuatu selain insinyur perangkat lunak, seperti asisten penulisan atau analis data.
- Untuk menggunakan gaya bawaan, pilih salah satu dari gaya output bawaan dan beralih ke gaya tersebut.
- Untuk menulis instruksi Anda sendiri, buat output style kustom.
Gaya output bawaan
Claude Code dimulai dalam gaya Default, instruksi standarnya untuk menyelesaikan tugas-tugas rekayasa perangkat lunak. Masing-masing dari empat gaya bawaan lainnya mempertahankan instruksi tersebut dan menambahkan instruksinya sendiri.
Tabel ini menunjukkan apa yang setiap gaya ubah tentang sesi dan kapan cocok digunakan:
| Gaya | Apa yang berubah | Gunakan ketika |
|---|---|---|
| Proactive | Claude mulai bekerja segera dan membuat asumsi yang masuk akal daripada bertanya tentang keputusan rutin | Anda ingin Claude terus bekerja melalui keputusan rutin, dan Anda akan mengubah arah jika asumsi salah |
| Concise | Respons dimulai dengan hasil dan menghilangkan pembukaan, narasi, dan rekap | Respons default lebih panjang dari yang Anda inginkan |
| Explanatory | Claude menambahkan blok Insight pendek yang menjelaskan pilihan di balik kode yang ditulisnya |
Anda sedang mengenal codebase atau menginginkan penalaran bersama dengan perubahan |
| Learning | Claude menjelaskan pilihannya dan meninggalkan potongan kode kecil untuk Anda tulis sendiri | Anda menginginkan praktik coding langsung sambil tugas masih selesai |
Default
Default berarti tidak ada gaya output yang dipilih. Claude Code tidak menambahkan instruksi gaya, dan Claude bekerja dari prompt sistem standar Claude Code, yang ditulis untuk tugas-tugas rekayasa perangkat lunak.
default muncul dalam daftar /output-style bersama dengan gaya lainnya, jadi Anda memilihnya dengan cara yang sama.
Proactive
Dalam gaya Proactive, Claude mulai mengimplementasikan segera setelah Anda mengirim tugas. Ini membuat asumsi yang masuk akal tentang keputusan rutin daripada berhenti untuk bertanya, dan tidak beralih ke plan mode kecuali Anda meminta rencana. Anda dapat mengalihkannya kapan saja.
Instruksi gaya juga memberi tahu Claude untuk memeriksa dengan Anda dalam percakapan sebelum tindakan yang menghapus data atau mengubah sistem bersama atau produksi. Pemeriksaan itu adalah instruksi yang Claude ikuti dan terpisah dari prompt izin.
Beralih ke gaya Proactive tidak mengubah mode izin Anda. Mode izin Anda masih menentukan panggilan alat mana yang berjalan tanpa meminta Anda, jadi prompt izin muncul dengan cara yang sama seperti sebelum Anda beralih.
Concise
Dalam gaya Concise, kalimat pertama respons menyatakan apa yang terjadi atau apa jawabannya. Claude menghilangkan pembukaan, narasi langkah demi langkah, dan rekap penutup, dan menjawab pertanyaan sederhana dalam satu hingga tiga kalimat. Ini melakukan pekerjaan rekayasa sethoroughly seperti dalam gaya Default. Memerlukan Claude Code v2.1.237 atau lebih baru.
Claude masih menulis dengan panjang penuh dalam kasus-kasus ini:
- Apa pun yang Anda minta: ketika Anda meminta penjelasan atau detail lebih lanjut, Claude menjawab secara lengkap.
- Apa pun yang Anda butuhkan untuk bertindak dengan aman: laporan kesalahan, output tes yang gagal, peringatan keamanan, dan konfirmasi untuk tindakan destruktif mempertahankan konten lengkap mereka.
Explanatory
Dalam gaya Explanatory, Claude melakukan tugas dengan cara yang sama seperti dalam gaya Default dan menambahkan penjelasan singkat tentang mengapa ia membuat pilihan yang ia buat. Setiap penjelasan muncul dalam percakapan, sebelum atau sesudah kode yang terkait, dalam blok berlabel Insight. Penjelasan tidak ditulis ke dalam file Anda sebagai komentar.
Blok Insight membawa dua atau tiga poin tentang codebase Anda atau kode yang Claude tulis, seperti yang ini setelah menambahkan endpoint API:
★ Insight ─────────────────────────────────────
- Setiap rute di repo ini melewati wrapper withAuth, jadi endpoint baru mendapatkan pemeriksaan sesi tanpa middleware-nya sendiri.
- Batas laju diatur per rute dalam limits.ts, itulah mengapa perubahan ini menambahkan entri di sana daripada default global.
─────────────────────────────────────────────────
Learning
Dalam gaya Learning, Claude menambahkan blok Insight yang sama seperti gaya Explanatory dan juga meminta Anda untuk menulis beberapa kode. Claude menangani implementasi rutin itu sendiri. Ketika mencapai bagian dengan keputusan desain nyata, seperti penanganan kesalahan, struktur data, atau logika bisnis dengan lebih dari satu pendekatan yang valid, ia meninggalkan beberapa baris untuk Anda.
Claude menandai tempat dengan komentar TODO(human) dalam file, kemudian mengirim permintaan yang mengatakan apa yang sudah dibangun, apa yang harus ditulis, dan apa yang harus dipertimbangkan:
● Learn by Doing
Context: Formulir upload sudah ada dan memanggil validateFile() sebelum menerima file. Pemeriksaan ukuran dan tipe berfungsi untuk gambar, tetapi pernyataan switch tidak memiliki penanganan untuk dokumen belum.
Your Task: Dalam upload.js, implementasikan cabang kasus "document" di dalam validateFile(). Cari TODO(human).
Guidance: Tentukan batas ukuran untuk dokumen dan apakah ekstensi file harus cocok dengan tipe MIME. Kembalikan {valid: boolean, error?: string}.
Claude kemudian berhenti dan menunggu. Tulis kode Anda di komentar TODO(human) dan beri tahu Claude ketika Anda selesai. Claude merespons dengan satu Insight tentang kode Anda dan melanjutkan tugas.
Ubah gaya output Anda
Pilih gaya dengan perintah, menu, atau file settings. Perintah dan kedua menu menyimpan pilihan Anda ke .claude/settings.local.json di tingkat proyek lokal.
-
Perintah
/output-style: jalankan/output-style <style>untuk beralih, misalnya/output-style concise. Tanpa argumen, perintah mencantumkan gaya yang dapat Anda pilih dan menandai yang saat ini.Perintah ini juga berfungsi dalam mode non-interaktif dan sesi Agent SDK, serta dari aplikasi mobile atau web melalui Remote Control, di mana Anda dapat mencantumkan dan memilih hanya gaya bawaan. Memerlukan Claude Code v2.1.269 atau lebih baru.
-
Menu Terminal: jalankan
/configdan pilih Output style untuk memilih gaya dari menu. -
Ekstensi VS Code: buka menu perintah dengan
/dan pilih Output styles untuk memilih gaya, termasuk gaya kustom Anda. 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"
}
Nilainya peka huruf besar-kecil, jadi tulis nama bawaan sebagai Proactive, Concise, Explanatory, dan Learning. Nilai yang tidak cocok dengan nama gaya secara tepat, seperti explanatory, memberikan Anda gaya Default. Perintah /output-style mengabaikan huruf besar-kecil.
Untuk menjadikan gaya Anda default di seluruh proyek, atur outputStyle dalam ~/.claude/settings.json. File settings proyek sendiri mengambil prioritas atas nilai tersebut.
Ketika Anda beralih gaya di tengah sesi, Claude menggunakan gaya baru mulai dari pesan Anda berikutnya. Untuk biaya pesan pertama itu dalam prompt caching, lihat Mengubah gaya output. 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 Claude.
Di VS Code extension, Anda juga dapat membuat file dari menu Output styles daripada menulisnya dengan tangan. Ini memerlukan Claude Code v2.1.261 atau lebih baru.
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 /output-style <style> di terminal, atau jalankan /config 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/.
Referensi frontmatter
Konfigurasikan output style dengan frontmatter YAML antara penanda --- di bagian atas file. Semua field bersifat opsional, dan nama field menggunakan kata-kata huruf kecil yang dipisahkan oleh tanda hubung. Field yang salah eja diabaikan tanpa kesalahan. Jika YAML tidak dapat diuraikan, style masih dimuat dengan nama filenya tanpa field yang ditetapkan; jalankan claude --debug untuk melihat kesalahan penguraian.
| Field | Diperlukan | Deskripsi |
|---|---|---|
name |
Tidak | Nama output style, ditampilkan dalam picker /config. Default: nama file |
description |
Tidak | Deskripsi output style, ditampilkan dalam picker /config |
keep-coding-instructions |
Tidak | Atur ke true untuk mempertahankan instruksi rekayasa perangkat lunak bawaan Claude Code bersama style Anda. Default: false |
force-for-plugin |
Tidak | Output styles plugin saja. Atur ke true untuk menerapkan 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. Default: false |
Pilih antara output style dan fitur lainnya
Output style berlaku untuk setiap respons dalam sesi. Ini adalah instruksi yang diikuti Claude, jadi tidak ada yang memberlakukannya. Ketika apa yang Anda inginkan lebih sempit daripada setiap respons, atau harus terjadi tanpa gagal, fitur lain lebih cocok.
Tabel ini mencocokkan apa yang Anda inginkan dengan fitur yang melakukannya:
| Anda ingin | Gunakan | Mengapa cocok |
|---|---|---|
| Setiap respons dalam suara, panjang, atau format tertentu, atau Claude dalam peran yang berbeda | Output style | Ini berlaku untuk seluruh sesi, dan Anda beralih style dengan satu perintah |
| Claude mengetahui konvensi, perintah, dan struktur proyek Anda | CLAUDE.md | Ini menyimpan apa yang harus diketahui Claude tentang codebase, dan tetap dimuat dengan style apa pun yang Anda pilih |
| Instruksi untuk satu jenis tugas, seperti checklist rilis atau prosedur review | A skill | Claude memmuatnya hanya ketika Anda menginvokasinya atau tugas cocok, jadi tidak membentuk respons yang tidak terkait |
| Sesuatu yang harus terjadi setiap saat tanpa terkecuali, seperti pemformatan setelah setiap edit atau memblokir perintah | A hook | Claude Code menjalankan hook itu sendiri pada acara lifecycle, jadi tidak bergantung pada Claude mengikuti instruksi |
| Pembantu dengan instruksi, model, dan tools sendiri untuk tugas yang terfokus | A subagent | Ini berjalan dalam konteks terpisah dengan system prompt sendiri dan mengembalikan ringkasan ke percakapan Anda |
| Penambahan pada instruksi Claude yang Anda berikan saat memulai Claude Code | --append-system-prompt |
Ini menambahkan ke system prompt tanpa menghapus apa pun |
Fitur-fitur ini dapat digabungkan. Misalnya, Anda dapat menggunakan CLAUDE.md untuk apa yang harus diketahui Claude, output style untuk cara meresponnya, dan hook untuk apa pun yang harus dijamin. Perluas Claude Code membandingkan fitur ekstensi lainnya.
Cara kerja output styles
Output style mengubah instruksi yang diberikan Claude Code kepada Claude.
- Claude Code mengirimkan instruksi style aktif dengan setiap permintaan.
- Output styles kustom 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 untuk percakapan utama dan untuk fork, yang mewarisi percakapan lengkap dan system prompt induk. Subagent lain menjalankan system prompt mereka sendiri, jadi styles tidak mengubah cara mereka merespons.
Penggunaan token tergantung pada style. Instruksi style menambahkan input tokens, meskipun prompt caching mengurangi biaya ini setelah permintaan pertama dalam sesi.
Style Explanatory dan Learning bawaan menghasilkan respons yang lebih panjang daripada Default secara desain, yang meningkatkan output tokens. Style Concise melakukan sebaliknya dengan menginstruksikan Claude untuk menjaga respons tetap singkat secara default. Untuk styles kustom, penggunaan output token tergantung pada apa yang instruksi Anda katakan kepada Claude untuk diproduksi.
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