Mencoba contoh
Contoh-contoh di halaman ini adalah cuplikan, bukan mod utuh. Masing-masing adalah kode untuk satu elemen dan apa pun yang bersarang di dalamnya. Untuk melihat contoh di terminal Anda sendiri, buat mod kecil dengan langkah-langkah berikut dan tempelkan contoh ke dalamnya. Mod ini menambahkan perintah/gallery yang membuka panel dan menggambar contoh di sana. Panel adalah bilah samping di sebelah transkrip pada terminal layar penuh yang lebar, atau wilayah berbingkai di atas prompt jika tidak.
1
Buat mod
Buat direktori bernama Tentukan titik masuk Anda di Simpan kode sebagai
gallery dengan direktori .claude-plugin dan hooks di dalamnya. Membuat mod menjelaskan file-filenya.Simpan manifes sebagai gallery/.claude-plugin/plugin.json:gallery/.claude-plugin/plugin.json
gallery/hooks/hooks.json:gallery/hooks/hooks.json
gallery/hooks/register.js. Kode ini menambahkan perintah /gallery yang membuka panel, dan menggambar Plain text di panel tersebut:gallery/hooks/register.js
2
Jalankan mod
Di shell Anda, jalankan Claude Code dari direktori yang berisi Di prompt Claude Code, jalankan
gallery:/gallery. Sebuah panel terbuka dengan Plain text di dalamnya.3
Ganti dengan contoh
Salin contoh dari halaman ini. Di
register.js, tempelkan contoh tersebut menggantikan Text({ children: ['Plain text'] }), sehingga berada setelah return, lalu simpan file. Claude Code memuat ulang modul setiap kali Anda menyimpan, jadi jalankan /gallery lagi untuk melihat contoh yang baru.Memilih elemen
Contoh-contoh dikelompokkan berdasarkan apa yang ingin Anda tampilkan di layar:- Menampilkan teks:
Text,Markdown, danLink - Menampilkan kode dan perubahan:
Code - Mengatur elemen:
Box - Menerima input:
Button,Input, danSelect - Menggambar gambar:
Raster,Svg,Image, danClient
Menampilkan teks
Tiga elemen menampilkan kata-kata di layar:Text untuk gaya Anda sendiri, Markdown untuk konten yang sudah diformat, dan Link untuk URL.
Text
Text menggambar string dengan gaya yang Anda berikan. Contoh ini menampilkan teks biasa dan delapan gaya, satu di setiap baris:


dimColor menggambar teks berwarna abu-abu. backgroundColor hanya mengisi selebar teks.
Markdown
Markdown memformat teks dengan cara yang sama seperti balasan Claude diformat. Berikan konten di text, bukan di children:


#. Kode inline digambar berwarna tanpa backtick. Kutipan digambar miring dengan bilah di sebelah kirinya.
Link
Link menggambar label diikuti URL-nya:


Menampilkan kode dan perubahan
Code menggambar teks sumber dengan warna sintaks milik Claude Code sendiri, atau sebuah diff. Di ekstensi VS Code, Code menampilkan source-nya sebagai teks biasa, tanpa warna, nomor baris, atau bayangan diff seperti pada tangkapan layar ini.
Code
Sebutkan language, atau berikan path agar Claude Code menyimpulkannya. Dengan startLine, baris-baris diberi nomor mulai dari angka tersebut:


Code sebagai diff
Dengan format: 'diff', source adalah satu atau beberapa hunk unified diff:


@@. Jika baris yang dihapus dan baris yang ditambahkan mirip, kata-kata yang berubah mendapat bayangan yang lebih kuat.
Mengatur elemen
Box
Box menata isinya dalam baris atau kolom, dan dapat menggambar bingkai. Contoh ini menempatkan sebaris kata di atas kotak berbingkai:


Menerima input
Button, Input, dan Select adalah kontrol: pengguna berpindah di antaranya dengan Tab dan menggunakan kontrol yang sedang memiliki fokus. Fokus keyboard dan hotkey menjelaskan tombol mana yang mencapainya.
Buka panel dengan focus: true untuk mengajukan permintaan fokus keyboard bagi panel tersebut. Huruf yang diketik mencapai Input setelah kontrol itu memiliki fokus. Untuk memilih kolom mana yang memiliki fokus saat panel terbuka, lihat Mengatur hotkey dan fokus pertama.
Button
Sebuah tombol menjalankan onPress. Contoh ini menampilkan bentuk default, tombol plain dengan hotkey, dan tombol redup:




Input
Input adalah kolom teks yang secara default memuat satu baris dan menjalankan onSubmit saat pengguna menekan Enter:


submitLabel ditampilkan setelah ⏎:




rows ke 2 atau lebih untuk kolom yang memuat beberapa baris, seperti catatan atau pesan commit:
rows memerlukan Claude Code v2.1.301 atau yang lebih baru. Pada versi sebelumnya, kolom ini memuat satu baris.
Kolom ini menempati jumlah baris yang Anda atur, bahkan saat kosong, hingga setinggi panel atau pita tempat kolom itu digambar. Selama kolom memiliki fokus, teks yang lebih panjang digulir di dalamnya.
- Di terminal, Enter tetap mengirimkan. Di sana, pengguna memulai baris baru dengan mengetik garis miring terbalik lalu menekan Enter, atau dengan menekan Shift+Enter jika emulator terminal mendukungnya. Tombol-tombol ini sama dengan yang digunakan di prompt.
- Di terminal, Up dan Down berpindah di antara baris-baris kolom. Dari baris pertama dan terakhirnya, tombol ini berpindah ke kontrol sebelum atau sesudahnya.
onSubmitdanonInputmenerima seluruh teks dengan baris-barisnya digabungkan oleh\n.
Select
Select memungkinkan pengguna memilih salah satu dari beberapa opsi, dan menjalankan onSelect dengan value dari opsi tersebut:






Menggambar gambar
Raster
Raster adalah kisi sel karakter berwarna, untuk peta panas, sparkline, atau papan permainan. Terminal yang menggambarnya. Contoh ini menggunakan fungsi cellsOf di modul awal, yang mengemas sel-sel ke dalam string yang diterima Raster. Menggambar kisi sel berwarna menjelaskannya:


Raster membulatkan setiap warna ke palet yang lebih kecil, sehingga 0x2e7d32 digambar sebagai #337733.
Svg
Svg menggambar dokumen SVG di aplikasi Desktop dan ekstensi VS Code:
Svg akan terbuka kosong. Untuk menggambar sesuatu yang lain di sana, periksa e.surface dan kembalikan tree yang berbeda.
Image dan Client
Image dan Client tidak memiliki contoh di sini. Image menggambar PNG atau piksel mentah di terminal. Client adalah wilayah yang digambar oleh file kedua milik Anda, untuk animasi dan input penunjuk. Referensi elemen mencantumkan props-nya.
Image digambar sebagai gambar di terminal-terminal berikut:
- kitty 0.28 atau yang lebih baru
- Ghostty
- iTerm2 3.5 atau yang lebih baru. Menggambar di iTerm2 memerlukan Claude Code v2.1.305 atau yang lebih baru.
alt dari Image, dalam warna redup, sebagai pengganti gambar. Tulis teks alt yang dapat dipahami dengan sendirinya, karena teks tersebut juga ditampilkan dalam kasus-kasus berikut, di antara yang lain:
- GNU screen: sesi yang berjalan di dalam screen, di terminal apa pun.
- tmux: sesi yang berjalan di dalam tmux yang tidak memenuhi salah satu persyaratan untuk menggambar di dalam tmux.
- Sesi latar belakang: setiap sesi latar belakang, dari terminal mana pun sesi tersebut dilampirkan.
- iTerm2 di luar rendering layar penuh: di iTerm2, gambar hanya digambar di bawah rendering layar penuh, dan tidak saat
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINTdiatur ke1. Untuk melihat gambar, jalankan/tui fullscreendi prompt Claude Code dan biarkan variabel tersebut tidak diatur. - Sumber berupa path file di iTerm2 atau tmux: di iTerm2 dan di dalam tmux,
Imageyangsource-nya menyebutkanfilemenampilkan teksaltalih-alih gambar. Jika mod Anda memiliki pengguna iTerm2 atau tmux, berikan gambar sebagai base64 disource.pngatausource.rgbaalih-alih sebagai path disource.file.
CLAUDE_CODE_FORCE_TERMINAL_IMAGES ke 1. Mereka sebaiknya tidak mengaturnya di dalam GNU screen, di dalam tmux yang lebih lama dari 3.3, di popup tmux, atau saat allow-passthrough tmux nonaktif. Di sana mereka tidak melihat gambar dan melihat sebuah kotak sebagai pengganti teks alt.
Menggambar Image di dalam tmux
Jika Image menampilkan teks alt-nya di dalam tmux, periksa persyaratan berikut bersama dengan kasus teks alt lainnya seperti sesi latar belakang:
- Claude Code v2.1.310 atau yang lebih baru
- tmux 3.3 atau yang lebih baru
- Claude Code berjalan di panel tmux, bukan popup tmux
- tmux berjalan di dalam kitty 0.28 atau yang lebih baru, Ghostty, atau iTerm2 3.5 atau yang lebih baru
- Opsi tmux
focus-eventsdanallow-passthroughbernilaion. Di dalam kitty atau Ghostty,allow-passthroughjuga dapat bernilaiall. - Di dalam iTerm2, tmux berjalan tanpa
-CC, rendering layar penuh aktif, danCLAUDE_CODE_ALT_SCREEN_FULL_REPAINTtidak diatur. - Di dalam iTerm2, jendela tmux tidak lebih besar dari jendela iTerm2. Untuk memeriksanya, jalankan
tmux display-message -p '#{window_bigger}'di jendela tmux tersebut. Jika perintah itu mencetak1, sesuaikan ukuran jendela tmux, lalu mulai ulang Claude Code. - Pembuat mod memberikan gambar sebagai byte
pngataurgba, bukan sebagai pathfile. Jika Anda menggunakan mod yang tidak Anda tulis sendiri dan persyaratan lainnya terpenuhi, minta pembuatnya untuk memeriksa persyaratan ini.
~/.tmux.conf juga.
Melihat di mana mod dapat menggambar
Semua contoh menggambar di panel. Mod juga dapat menggambar di tempat lain, dan memanggil Claude Code untuk menampilkan sesuatu untuknya:- Panel dan band: Memilih tempat menggambar
- Baris milik Claude Code sendiri, seperti spinner: Mengubah apa yang sudah digambar Claude Code
- Toast, baris status, dan baris log: Menampilkan sesuatu tanpa memulai giliran
- Dialog pertanyaan: Menahan panggilan tool hingga pengguna memutuskan
Langkah selanjutnya
- Menggambar di antarmuka: membangun panel dengan tab, langkah demi langkah
- Menguji gambar: menekan tombol Anda dari sebuah pengujian
- Referensi elemen: props utama setiap elemen dan aplikasi yang menggambarnya