SpyBara
Go Premium

cli-reference.md 2026-10-21 23:02 UTC to 2026-10-22 22:58 UTC

This page contains 81 additions and 81 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Tue 6 23:59 Wed 7 23:59 Fri 9 23:02 Sat 10 23:01 Sat 17 23:57 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59

Referensi CLI

Referensi lengkap untuk antarmuka baris perintah Claude Code, termasuk perintah dan flag.

Perintah CLI

Anda dapat memulai sesi, menyalurkan konten, melanjutkan percakapan, dan mengelola pembaruan dengan perintah-perintah ini:

Perintah Deskripsi Contoh
claude Mulai sesi interaktif claude
claude "query" Mulai sesi interaktif dengan prompt awal claude "explain this project"
claude -p "query" Kueri melalui SDK, kemudian keluar claude -p "explain this function"
cat file | claude -p "query" Proses konten yang disalurkan cat logs.txt | claude -p "explain"
claude -c Lanjutkan percakapan terbaru di direktori saat ini claude -c
claude -c -p "query" Lanjutkan melalui SDK claude -c -p "Check for type errors"
claude -r "<session>" "query" Lanjutkan sesi berdasarkan ID atau nama claude -r "auth-refactor" "Finish this PR"
claude update Perbarui ke versi terbaru claude update
claude gateway Mulai server gateway aplikasi Claude yang di-host sendiri, untuk administrator yang menerapkan SSO dan kebijakan di depan Claude Code di Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry. Memerlukan --config yang menunjuk ke gateway.yaml. claude gateway --config gateway.yaml
claude install [version] Instal atau instal ulang binary asli. Menerima versi seperti 2.1.118, atau stable atau latest. Lihat Instal versi tertentu claude install stable
claude auth login Masuk ke akun Anthropic Anda. Gunakan --email untuk mengisi email Anda sebelumnya, --sso untuk memaksa autentikasi SSO, dan --console untuk masuk dengan Anthropic Console untuk penagihan penggunaan API alih-alih langganan Claude claude auth login --console
claude auth logout Keluar dari akun Anthropic Anda claude auth logout
claude auth status Tampilkan status autentikasi sebagai JSON. Gunakan --text untuk output yang dapat dibaca manusia. Keluar dengan kode 0 jika masuk, 1 jika tidak. JSON mencakup bidang configDirectory yang menamai direktori konfigurasi yang digunakan CLI. Bidang ini memerlukan Claude Code v2.1.268 atau lebih baru. Bidang authMethod pada JSON bernilai salah satu dari none, claude.ai, oauth_token, api_key, api_key_helper, atau third_party claude auth status
claude agents Buka tampilan agent untuk memantau dan mengirim sesi latar belakang paralel. Gunakan --cwd <path> untuk menampilkan hanya sesi yang dimulai di bawah direktori tersebut, atau --json untuk mencetak sesi aktif sebagai array JSON untuk skrip (--json --all juga mencakup sesi latar belakang yang selesai). Lewatkan --permission-mode, --model, --effort, atau --agent untuk menetapkan default untuk sesi yang dikirim. Menerima --settings, --add-dir, --plugin-dir, dan --mcp-config seperti perintah claude tingkat atas. Membuka tampilan agent memerlukan terminal interaktif claude agents --json
claude attach <id|name> Lampirkan ke sesi latar belakang di terminal ini. Meneruskan sebagian nama sesi yang sedang berjalan sebagai pengganti ID memerlukan Claude Code v2.1.290 atau lebih baru claude attach 7c5dcf5d
claude auto-mode defaults Cetak aturan pengklasifikasi auto mode bawaan sebagai JSON. Gunakan claude auto-mode config untuk melihat konfigurasi efektif Anda dengan pengaturan yang diterapkan. --label <prefix> mencetak hanya aturan yang labelnya dimulai dengan awalan tersebut, cocok tanpa memperhatikan huruf besar-kecil. Memerlukan Claude Code v2.1.208 atau lebih baru claude auto-mode defaults --label 'Git Destructive'
claude auto-mode reset Pulihkan konfigurasi auto mode default dengan menghapus bagian autoMode dari file pengaturan pengguna Anda. Meminta konfirmasi sebelum menulis; lewatkan -y/--yes untuk melewati prompt. Aturan dari pengaturan terkelola atau flag --settings masih berlaku. Memerlukan Claude Code v2.1.212 atau lebih baru. Lihat Periksa default dan konfigurasi efektif Anda claude auto-mode reset --yes
claude daemon logs Ikuti file log supervisor sesi latar belakang, ~/.claude/daemon.log, dengan mencetak baris baru saat muncul hingga Anda menekan Ctrl+C claude daemon logs
claude daemon run Jalankan supervisor sesi latar belakang di latar depan terminal ini, dengan mencetak log-nya claude daemon run
claude daemon status Cetak status supervisor sesi latar belakang, versi, direktori soket, dan jumlah pekerja untuk diagnostik. Keluar dengan 1 jika supervisor tidak berjalan claude daemon status
claude daemon stop --any Hentikan supervisor sesi latar belakang dan sesi yang dihosting. Lewatkan --keep-workers untuk membiarkan sesi latar belakang tetap berjalan sehingga supervisor berikutnya dapat terhubung kembali ke sesi tersebut. --any mengonfirmasi penghentian supervisor sesuai permintaan, yang merupakan default. Gunakan ini untuk pulih dari supervisor yang tidak responsif claude daemon stop --any --keep-workers
claude doctor Cetak diagnostik instalasi dan pengaturan read-only dari terminal tanpa memulai sesi, termasuk kesehatan instalasi, kesalahan validasi file pengaturan, dan kelayakan Remote Control. Untuk pemeriksaan pengaturan dalam sesi yang juga dapat menerapkan perbaikan, jalankan /doctor claude doctor
claude import [source] Mulai sesi interaktif yang menjalankan /import untuk membawa konfigurasi dari agent pengkodean lain ke Claude Code. Menerima opsi --dry-run dan --yes yang sama dengan perintah. Tidak tersedia di Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, atau Claude Platform di AWS. Juga tidak tersedia ketika Anda mematikan pengambilan flag fitur. Memerlukan Claude Code v2.1.213 atau lebih baru claude import codex --dry-run
claude logs <id|name> Cetak output terbaru dari sesi latar belakang. Meneruskan sebagian nama sesi sebagai pengganti ID memerlukan Claude Code v2.1.290 atau lebih baru claude logs 7c5dcf5d
claude mcp Konfigurasi server Model Context Protocol (MCP) Lihat dokumentasi Claude Code MCP.
claude mcp login <name> Jalankan alur OAuth server MCP yang dikonfigurasi tanpa membuka panel /mcp interaktif. Bekerja untuk server HTTP, SSE, dan konektor claude.ai. Tambahkan --no-browser melalui SSH untuk mencetak URL otorisasi alih-alih membuka browser. Untuk server HTTP atau SSE, tempel URL pengalihan kembali di prompt. Untuk konektor claude.ai, lihat Otorisasi ulang konektor dari shell Anda. Lihat Autentikasi dari baris perintah claude mcp login sentry
claude mcp logout <name> Hapus kredensial OAuth yang disimpan untuk server MCP claude mcp logout sentry
claude plugin Kelola Claude Code plugins. Alias: claude plugins. Lihat referensi plugin untuk subperintah claude plugin install code-review@claude-plugins-official
claude purge [path] Hapus semua status Claude Code lokal untuk proyek: transkrip, daftar tugas, log debug, riwayat edit file, baris riwayat prompt, dan entri proyek di ~/.claude.json. Abaikan [path] untuk memilih dari daftar interaktif. Flag: --dry-run untuk pratinjau, -y/--yes untuk melewati konfirmasi, -i/--interactive untuk mengonfirmasi setiap item, --all untuk setiap proyek. Lihat Hapus data lokal claude purge ~/work/repo --dry-run
claude remote-control Mulai server Remote Control untuk mengontrol Claude Code dari Claude.ai atau aplikasi Claude. Berjalan dalam mode server (tidak ada sesi interaktif lokal). Lihat flag mode server. Setelah Anda menghentikan server, Anda dapat membawa kembali sesi yang sedang dilayaninya. Lihat Lanjutkan sesi setelah menghentikan server claude remote-control --name "My Project"
claude respawn <id> Mulai ulang sesi latar belakang, berjalan atau dihentikan, dengan percakapannya tetap utuh. Gunakan --all untuk memulai ulang setiap sesi yang berjalan, misalnya untuk mengambil binary Claude Code yang diperbarui claude respawn 7c5dcf5d
claude rm <id> Hapus sesi latar belakang dari daftar. Ketika penghapusan ditolak melalui worktree sesi dan claude rm kedua dapat menyelesaikannya, penolakan mencetak flag dan nilai yang tepat untuk dilewatkan: --discard-unpushed <commit>@<worktree-id> membuang worktree yang memiliki commit yang belum didorong bersama dengan commit tersebut, dan --force-remove-worktree <worktree-id> menghapus direktori worktree yang tidak dapat dihapus oleh git atau hook WorktreeRemove. --discard-unpushed memerlukan Claude Code v2.1.260 atau lebih baru, dan --force-remove-worktree memerlukan v2.1.268 atau lebih baru. Transkrip percakapan tetap berada di mesin lokal Anda, tersedia melalui claude --resume claude rm 7c5dcf5d
claude self-hosted-runner Mulai proses runner yang mendaftarkan mesin atau kontainer ini dengan lingkungan yang di-host sendiri dan menghosting sesi cloud Claude Code di infrastruktur Anda. Jalankan claude self-hosted-runner setup untuk panduan operator interaktif, claude self-hosted-runner doctor untuk mendiagnosis runner yang diterapkan, dan claude self-hosted-runner orchestrator untuk menelurkan runner sesuai permintaan. Memerlukan Claude Code v2.1.224 atau lebih baru claude self-hosted-runner setup
claude setup-token Hasilkan token OAuth yang tahan lama untuk CI dan skrip. Mencetak token ke terminal tanpa menyimpannya. Memerlukan langganan Claude. Lihat Hasilkan token yang tahan lama claude setup-token
claude stop <id> Hentikan sesi latar belakang. Juga menerima claude kill claude stop 7c5dcf5d
claude ultrareview [target] Jalankan ultrareview secara non-interaktif. Mencetak temuan ke stdout dan keluar dengan 0 saat berhasil atau 1 saat gagal. Gunakan --json untuk payload mentah dan --timeout <minutes> untuk menimpa default 45 menit. Gunakan --post pada target pull request github.com untuk memposting temuan yang selesai ke PR sebagai satu komentar biasa dari akun GitHub Anda. --no-post adalah default. --post dan --no-post memerlukan Claude Code v2.1.227 atau lebih baru. Lihat Posting temuan ke pull request claude ultrareview 1234 --json

Jika Anda salah mengetik subperintah, Claude Code menyarankan kecocokan terdekat dan keluar tanpa memulai sesi. Misalnya, claude udpate mencetak Did you mean claude update?.

claude --dangerously-skip-permissions daemon <subcommand> menjalankan subperintah daemon, sehingga subperintah tetap berfungsi ketika claude memiliki alias untuk menyertakan flag tersebut. Hanya --dangerously-skip-permissions atau --allow-dangerously-skip-permissions yang terdepan yang merutekan ke daemon dengan cara ini; jika ada flag lain di depan daemon, subperintah tidak berjalan.

Bendera CLI

Sesuaikan perilaku Claude Code dengan bendera baris perintah ini. claude --help tidak mencantumkan setiap bendera, jadi ketiadaan bendera dari --help tidak berarti bendera tersebut tidak tersedia.

Bendera Deskripsi Contoh
--add-dir Tambahkan direktori kerja tambahan untuk Claude membaca dan mengedit file. Memberikan akses file; Claude Code tidak menemukan sebagian besar konfigurasi .claude/ dari direktori ini. Memvalidasi bahwa setiap jalur ada sebagai direktori. Anda tidak dapat menambahkan sebagian besar jalur jaringan, seperti \\server\share. Untuk mempertahankan direktori ini di seluruh sesi, atur permissions.additionalDirectories dalam pengaturan claude --add-dir ../apps ../lib
--advisor <model> Aktifkan alat penasihat sisi server untuk sesi ini dengan alias model, fable, opus, atau sonnet, atau ID model lengkap. Mengambil alih pengaturan advisorModel untuk sesi. fable memerlukan akses Fable claude --advisor opus
--agent Tentukan agen untuk sesi saat ini (menimpa pengaturan agent) claude --agent my-custom-agent
--agents Definisikan subagent kustom secara dinamis melalui JSON. Menerima field yang tercantum untuk subagent yang didefinisikan CLI. Dengan --print, nilainya dapat berupa jalur ke file JSON yang berisi objek tersebut; bentuk file memerlukan Claude Code v2.1.281 atau lebih baru. Claude Code memvalidasi nilai saat startup dan keluar jika nilainya tidak valid; lihat Invalid --agents configuration untuk pesan tersebut serta flag dan environment variable yang melewati validasi. Validasi memerlukan Claude Code v2.1.242 atau lebih baru claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allow-dangerously-skip-permissions Tambahkan bypassPermissions ke siklus mode Shift+Tab tanpa memulai di dalamnya. Memungkinkan Anda memulai dalam mode berbeda seperti plan dan beralih ke bypassPermissions nanti. Lihat mode izin claude --permission-mode plan --allow-dangerously-skip-permissions
--allowedTools, --allowed-tools Tool yang dijalankan tanpa meminta izin, kecuali pembacaan dari jalur jaringan. Lihat sintaks aturan izin untuk pencocokan pola. Untuk membatasi tool mana yang tersedia, gunakan --tools sebagai gantinya. Jika Anda menyebutkan salah satu tool pelacakan tugas di sini, Claude Code juga mengikutsertakan sesi tersebut "Bash(git log *)" "Bash(git diff *)" "Read"
--append-subagent-system-prompt Tambahkan teks khusus ke akhir prompt sistem setiap subagen, termasuk subagen bersarang, kecuali subagen yang bercabang, yang menggunakan kembali prompt percakapan sendiri. Hanya berlaku dalam mode non-interaktif dengan -p. Memerlukan Claude Code v2.1.205 atau lebih baru claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"
--append-subagent-system-prompt-file Muat teks dari file dan tambahkan ke prompt sistem subagen. Alternatif untuk --append-subagent-system-prompt untuk teks yang terlalu panjang untuk dilewatkan di baris perintah. Kedua bendera tidak dapat digabungkan. Hanya berlaku dalam mode non-interaktif dengan -p. Memerlukan Claude Code v2.1.261 atau lebih baru claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"
--append-system-prompt Tambahkan teks khusus ke akhir prompt sistem default claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Muat teks prompt sistem tambahan dari file dan tambahkan ke prompt default claude --append-system-prompt-file ./extra-rules.txt
--autocompact <auto|tokens> Atur jendela auto-compact untuk sesi ini tanpa mengubah pengaturan tersimpan Anda. Menerima nilai yang sama dengan /autocompact; bagian itu mencakup bentuk nilai dan apa yang menimpa bendera. Memerlukan Claude Code v2.1.221 atau lebih baru claude --autocompact 500k
--ax-screen-reader Render output yang ramah pembaca layar: teks datar tanpa batas dekoratif atau animasi. Memaksa renderer klasik, jadi pengaturan tui tidak berpengaruh; sesi latar belakang yang terlampir masih render layar penuh. Mengambil alih CLAUDE_AX_SCREEN_READER dan pengaturan axScreenReader. Memerlukan Claude Code v2.1.181 atau lebih baru claude --ax-screen-reader
--bare Mode minimal: lewati penemuan otomatis hooks, skills, perintah khusus, subagen, plugin, server MCP, memori otomatis, dan CLAUDE.md sehingga panggilan skrip dimulai lebih cepat. Skills dalam direktori yang Anda lewatkan dengan --add-dir masih dimuat. Claude memiliki akses ke alat Bash, pembacaan file, dan pengeditan file. Menetapkan CLAUDE_CODE_SIMPLE. Lihat mode bare claude --bare -p "query"
--betas Header beta untuk disertakan dalam permintaan API (hanya pengguna kunci API) claude --betas interleaved-thinking
--bg, --background Mulai sesi sebagai agen latar belakang dan kembali segera. Mencetak ID sesi dan perintah manajemen. Gabungkan dengan --exec untuk menjalankan perintah shell sebagai pekerjaan latar belakang yang didukung PTY alih-alih memulai sesi Claude, atau dengan --agent untuk menjalankan subagen tertentu. Memeriksa kepercayaan ruang kerja untuk direktori sebelum dimulai. Tidak dapat digabungkan dengan -p/--print; lihat referensi kesalahan claude --bg "investigate the flaky test"
--channels (Pratinjau penelitian) Server MCP yang notifikasi saluran Claude harus mendengarkan dalam sesi ini. Daftar yang dipisahkan spasi dari entri plugin:<name>@<marketplace>. Memerlukan autentikasi Anthropic melalui claude.ai atau kunci API Console claude --channels plugin:my-notifier@my-marketplace
--chrome Aktifkan integrasi browser Chrome untuk otomasi web dan pengujian claude --chrome
--cloud Dengan deskripsi tugas, buat sesi cloud baru. Dengan ID sesi (session_... atau cse_...) atau URL claude.ai/code, antrekan pesan ke sesi yang ada sebagai gantinya, dengan -p. Lihat kirim pesan lanjutan. claude --cloud "Fix the login bug"
--continue, -c Muat percakapan terbaru dalam direktori saat ini, termasuk sesi latar belakang yang telah selesai; membuka sesi latar belakang yang telah selesai memerlukan Claude Code v2.1.257 atau lebih baru. Melewati sesi yang dibuat dengan claude -p atau Agent SDK, dan sesi yang prompt pertamanya adalah /loop. claude -p --continue mencakup sesi -p, SDK, dan /loop. Mencakup sesi yang menambahkan direktori ini dengan /add-dir claude --continue
--dangerously-load-development-channels Aktifkan channel yang tidak ada di allowlist yang disetujui, untuk pengembangan lokal. Menerima entri plugin:<name>@<marketplace> dan server:<name>. Meminta konfirmasi, sehingga hanya berlaku dalam sesi interaktif. Dengan -p, Claude Code mengabaikan flag ini claude --dangerously-load-development-channels server:webhook
--dangerously-skip-permissions Lewati prompt izin. Setara dengan --permission-mode bypassPermissions. Lihat mode izin untuk apa yang dilakukan dan tidak dilakukan oleh ini. Untuk sesi yang dimulai dengan --bg, mode bertahan ketika supervisor memulai ulang sesi claude --dangerously-skip-permissions
--debug Aktifkan mode debug dengan penyaringan kategori opsional, seperti --debug='mcp,startup' atau --debug='!mcp'. Filter hanya berlaku dalam bentuk =; filter yang dipisahkan spasi mengaktifkan mode debug tanpa penyaringan claude --debug='mcp,startup'
--debug-file <path> Tulis log debug ke jalur file tertentu. Secara implisit mengaktifkan mode debug. Mengambil alih CLAUDE_CODE_DEBUG_LOGS_DIR claude --debug-file /tmp/claude-debug.log
--desktop Buka aplikasi Claude Desktop di direktori saat ini dan keluar tanpa memulai sesi di terminal. Tambahkan --continue, atau --resume dengan ID sesi, untuk membuka sesi itu di Desktop sebagai gantinya. --resume di sini hanya mengambil ID sesi, bukan nama atau jalur transkrip. Tidak mengambil prompt dan tidak ada bendera lain kecuali --verbose dan bendera --debug, karena aplikasi memulai sesi itu sendiri. Tersedia di macOS dan Windows x64 ketika Anda masuk dengan langganan Claude. Memerlukan Claude Code v2.1.285 atau lebih baru claude --desktop
--disable-slash-commands Nonaktifkan semua skills dan perintah untuk sesi ini claude --disable-slash-commands
--disallowedTools, --disallowed-tools Aturan penolakan. Nama alat telanjang menghapus alat yang cocok dari konteks Claude: "Edit" menghapus Edit, "*" menghapus setiap alat, dan "mcp__*" menghapus setiap alat MCP. Aturan yang dibatasi seperti Bash(rm *) membiarkan alat tersedia dan menolak hanya panggilan yang cocok seperti yang ditulis. Aturan yang menamai EndConversation tidak dapat menghapusnya saat alat lain tetap ada "Bash(git log *)" "Bash(git diff *)" "Edit"
--effort Atur tingkat upaya untuk sesi saat ini. Opsi: low, medium, high, xhigh, max, atau ultracode. Tingkat yang tersedia tergantung pada model. ultracode meminta upaya xhigh dengan ultracode diaktifkan, dan memerlukan Claude Code v2.1.203 atau lebih baru. Menimpa pengaturan modelSettings dan effortLevel untuk sesi ini dan tidak bertahan claude --effort high
--enable-auto-mode Dihapus di v2.1.111. Mode otomatis sekarang dalam siklus Shift+Tab secara default; gunakan --permission-mode auto untuk memulai di dalamnya claude --permission-mode auto
--environment <environment-id> Buat sesi cloud baru yang berjalan di lingkungan yang dihosting sendiri dengan ID yang diberikan. ID lingkungan dimulai dengan ccpool_. Lihat perilaku pengiriman --environment untuk perilaku pengiriman dan kombinasi bendera yang ditolaknya. Memerlukan Claude Code v2.1.224 atau lebih baru claude -p "Fix the login bug" --environment ccpool_abc123
--exclude-dynamic-system-prompt-sections Pindahkan konteks per-pengguna, seperti lokasi memori otomatis, keluar dari prompt sistem dan ke pesan pengguna pertama. Meningkatkan penggunaan kembali cache prompt di berbagai pengguna dan mesin yang menjalankan tugas yang sama. Hanya berlaku dengan prompt sistem default; diabaikan ketika --system-prompt atau --system-prompt-file diatur. Gunakan dengan -p untuk beban kerja multi-pengguna yang ditulis skrip claude -p --exclude-dynamic-system-prompt-sections "query"
--exec Jalankan perintah shell sebagai pekerjaan latar belakang yang didukung PTY alih-alih memulai sesi Claude. Gunakan dengan --bg untuk meluncurkan dari shell claude --bg --exec 'pytest -x'
--fallback-model Aktifkan fallback otomatis ke model yang ditentukan ketika model utama kelebihan beban atau tidak tersedia, misalnya model yang sudah pensiun. Menerima daftar yang dipisahkan koma yang dicoba secara berurutan. Lihat Rantai model fallback. Untuk mempertahankan rantai di seluruh sesi, gunakan pengaturan fallbackModel, yang bendera ini timpa claude --fallback-model sonnet,haiku
--fork-session Saat melanjutkan, buat ID sesi baru alih-alih menggunakan kembali yang asli (gunakan dengan --resume atau --continue) claude --resume abc123 --fork-session
--forward-subagent-text Pancarkan blok teks dan thinking subagent dalam stream output sebagai pesan assistant dan user dengan parent_tool_use_id diatur, sehingga Anda dapat merekonstruksi transkrip setiap subagent. Tanpa flag ini, Claude Code menghilangkan blok teks dan thinking dari subagent yang berjalan di foreground. Memerlukan --print dan --output-format stream-json. Untuk subagent bersarang, skill hasil fork, dan versi yang dibutuhkan masing-masing, lihat Ikuti pesan subagent. Environment variable CLAUDE_CODE_FORWARD_SUBAGENT_TEXT mengaktifkan perilaku yang sama. Memerlukan Claude Code v2.1.211 atau lebih baru claude -p --output-format stream-json --verbose --forward-subagent-text "query"
--from-pr Buka pemilih sesi yang disaring ke sesi yang ditautkan ke permintaan tarik tertentu. Menerima nomor PR, URL PR GitHub atau GitHub Enterprise, URL permintaan penggabungan GitLab, atau URL permintaan tarik Bitbucket. Sesi ditautkan secara otomatis ketika Claude membuat permintaan tarik claude --from-pr 123
--ide Terhubung secara otomatis ke IDE saat startup jika tepat satu IDE yang valid tersedia claude --ide
--init Jalankan hook Setup dengan pencocokan init sebelum sesi (mode cetak saja) claude -p --init "query"
--init-only Jalankan hook Setup dan SessionStart, kemudian keluar tanpa memulai percakapan claude --init-only
--include-hook-events Sertakan peristiwa siklus hidup hook dalam aliran output. Peristiwa hook SessionStart dan Setup selalu disertakan dan tidak memerlukan bendera ini. Beberapa peristiwa hook, seperti Notification, SessionEnd, PreCompact, dan PostCompact, tidak pernah menghasilkan peristiwa hook_started, bahkan dengan bendera ini. Untuk peristiwa tersebut, Claude Code masih memancarkan hook_progress saat hook perintah yang berjalan lebih dari satu detik menghasilkan output, dan memancarkan hook_response hanya ketika hook yang berjalan di latar belakang selesai. Memerlukan --output-format stream-json claude -p --output-format stream-json --verbose --include-hook-events "query"
--include-partial-messages Sertakan peristiwa streaming parsial dalam output. Memerlukan --print dan --output-format stream-json claude -p --output-format stream-json --verbose --include-partial-messages "query"
--input-format Tentukan format input untuk mode cetak (opsi: text, stream-json) claude -p --output-format json --input-format stream-json
--json-schema Dapatkan output JSON yang divalidasi yang cocok dengan JSON Schema setelah agen menyelesaikan alurnya (mode cetak saja). Lihat output terstruktur. Claude Code keluar dengan kesalahan pada skema yang tidak valid dan menerima kata kunci format sebagai anotasi tanpa validasi sisi klien claude -p --json-schema '{"type":"object","properties":{...}}' "query"
--maintenance Jalankan hook Setup dengan pencocokan maintenance sebelum sesi (mode cetak saja) claude -p --maintenance "query"
--max-budget-usd Hentikan eksekusi setelah estimasi pengeluaran untuk panggilan API mencapai jumlah ini (mode cetak saja). Claude Code memeriksa batas ini terhadap estimasi biaya sisi klien, yang dapat berbeda dari tagihan Anda. Pengeluaran dari subagent dihitung terhadap batas. Pengeluaran dapat melewati batas, jadi sisakan ruang. Ketika Anda kembali ke percakapan dengan --continue atau --resume, total yang dipulihkan dari eksekusi sebelumnya tidak dihitung terhadapnya. Setelah pengeluaran mencapai batas, memunculkan subagent lain gagal dengan Budget limit reached, dan Claude Code menghentikan subagent latar belakang yang masih berjalan; perilaku penegakan batas ini memerlukan Claude Code v2.1.217 atau lebih baru claude -p --max-budget-usd 5.00 "query"
--max-turns Batasi jumlah putaran agentic (mode cetak saja). Keluar dengan kesalahan ketika batas tercapai. Tidak ada batas secara default. Dengan --input-format stream-json, pesan yang masih antri ketika batas mengakhiri putaran tetap antri dan memulai putaran baru dengan batasnya sendiri claude -p --max-turns 3 "query"
--mcp-config Muat server MCP dari file atau string JSON (dipisahkan spasi). Ketika Anda meneruskan flag ini dengan -p, Claude Code menunggu server yang masih tertunda untuk terhubung sebelum menjalankan giliran pertama, hingga timeout startup MCP_TIMEOUT, 30 detik secara default; server dengan daftar tool yang di-cache melewati penantian dan terhubung saat penggunaan pertama. Di lingkungan yang dihosting sendiri, penantian yang lebih singkat berlaku sebagai gantinya. Penantian ini memerlukan Claude Code v2.1.221 atau lebih baru claude --mcp-config ./mcp.json
--model Menetapkan model untuk sesi saat ini dengan alias model seperti sonnet, opus, haiku, atau fable, atau nama lengkap model. Menimpa pengaturan model dan ANTHROPIC_MODEL claude --model claude-sonnet-5
--name, -n Atur nama tampilan untuk sesi, ditampilkan di /resume dan judul terminal. Anda dapat melanjutkan sesi bernama dengan claude --resume <name>. /rename mengubah nama di tengah sesi dan juga menampilkannya di bilah prompt claude -n "my-feature-work"
--no-chrome Nonaktifkan integrasi browser Chrome untuk sesi ini claude --no-chrome
--no-session-persistence Nonaktifkan persistensi sesi sehingga sesi tidak disimpan ke disk dan tidak dapat dilanjutkan. Mode cetak saja. Variabel lingkungan CLAUDE_CODE_SKIP_PROMPT_HISTORY melakukan hal yang sama dalam mode apa pun claude -p --no-session-persistence "query"
--output-format Tentukan format output untuk mode cetak (opsi: text, json, stream-json) claude -p "query" --output-format json
--permission-mode Mulai dalam mode izin yang ditentukan. Menerima default, acceptEdits, plan, auto, dontAsk, bypassPermissions, atau manual sebagai alias untuk default. Alias manual memilih mode izin yang UI label Manual dan memerlukan Claude Code v2.1.200 atau lebih baru; claude --help mencantumnya sebagai pengganti default, dan kedua nilai berfungsi. Menimpa defaultMode dari file pengaturan. Tanpa bendera ini atau --dangerously-skip-permissions, sesi baru dimulai dalam mode izin yang dijelaskan dalam mode izin mana sesi dimulai, yang juga mencakup apa yang dimulai oleh jalankan -p claude --permission-mode plan
--permission-prompt-tool Tentukan tool MCP untuk menangani permintaan izin dalam mode non-interaktif. Teruskan nama lengkap, seperti mcp__<server>__<tool>, dari tool pada server MCP yang dimuat oleh eksekusi tersebut. Claude Code menunggu server MCP tool itu untuk terhubung sebelum menjalankan giliran pertama, hingga timeout startup MCP_TIMEOUT, 30 detik secara default. Tool prompt tidak dapat menyetujui tool MCP yang ditandai sebagai memerlukan interaksi pengguna: Claude Code mengonversi hasil allow untuk tool tersebut menjadi penolakan. Pembatasan ini memerlukan Claude Code v2.1.199 atau lebih baru claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query"
--permission-prompts Atur siapa yang menjawab prompt izin dalam mode cetak. Dengan host default, Claude Code mengirimnya ke host Agent SDK atau alat --permission-prompt-tool. Lewatkan none ketika tidak ada yang dapat menjawab, dan Claude Code menolaknya sebagai gantinya. Lihat Matikan prompt izin dalam jalankan tanpa pengawasan. Memerlukan Claude Code v2.1.259 atau lebih baru claude -p --permission-prompts none "query"
--plugin-dir Muat plugin dari direktori atau arsip .zip, atau beberapa dari folder plugin, hanya untuk sesi ini. Setiap bendera mengambil satu jalur. Ulangi bendera untuk lebih banyak jalur: --plugin-dir A --plugin-dir B.zip. Melewatkan folder plugin memerlukan Claude Code v2.1.265 atau lebih baru claude --plugin-dir ./my-plugin
--plugin-url Ambil arsip plugin .zip dari URL hanya untuk sesi ini. Ulangi bendera untuk beberapa plugin, atau lewatkan URL yang dipisahkan spasi dalam nilai yang dikutip tunggal claude --plugin-url https://example.com/plugin.zip
--print, -p Cetak respons tanpa mode interaktif (lihat dokumentasi Agent SDK untuk detail penggunaan secara terprogram). Untuk --resume pada sesi latar belakang yang masih berjalan, lihat Lanjutkan sesi latar belakang yang sedang berjalan claude -p "query"
--prompt-suggestions Emit pesan prompt_suggestion dengan prompt pengguna berikutnya yang diprediksi setelah setiap putaran yang menghasilkan satu; percakapan yang sangat singkat dapat menghasilkan tidak ada. Memerlukan --print, --output-format stream-json, dan --verbose. Lihat Saran prompt claude -p --prompt-suggestions --output-format stream-json --verbose "query"
--ref <branch> Dengan --environment, dasarkan checkout sesi baru pada ref bernama alih-alih HEAD lokal claude -p "Run the smoke test" --environment ccpool_abc123 --ref main
--remote Alias yang sudah usang untuk --cloud, termasuk bentuk sesi yang ada claude --remote "Fix the login bug"
--remote-control, --rc Mulai sesi interaktif dengan Remote Control diaktifkan sehingga Anda juga dapat mengontrolnya dari claude.ai atau aplikasi Claude. Secara opsional lewatkan nama untuk sesi claude --remote-control "My Project"
--remote-control-session-name-prefix <prefix> Awalan untuk nama Remote Control yang dibuat secara otomatis ketika tidak ada nama eksplisit yang diatur. Default ke nama host mesin Anda, menghasilkan nama seperti myhost-graceful-unicorn. Atur CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX untuk efek yang sama claude remote-control --remote-control-session-name-prefix dev-box
--replay-user-messages Emit kembali pesan pengguna dari stdin ke stdout untuk pengakuan. Memerlukan --input-format stream-json dan --output-format stream-json claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages
--restricted Mulai dalam mode terbatas. Gunakan ketika harness evaluasi menjalankan claude di mesin bersama dan Claude Code tidak boleh menjalankan perintah atau membaca pengaturan pengguna dan proyek mesin itu. Claude Code menghapus alat bawaan yang menjalankan perintah atau kode, dan WebFetch, kecuali Anda menamai mereka secara individual dalam --tools, bukan melalui preset default. Ini juga membatasi alat file bawaan ke direktori kerja, memuat hanya pengaturan terkelola dan --settings, menolak bypassPermissions, dan menolak untuk membuat sesi cloud. Memerlukan Claude Code v2.1.248 atau lebih baru claude --restricted -p "query"
--resume, -r Lanjutkan sesi tertentu berdasarkan ID atau nama, atau tampilkan pemilih interaktif untuk memilih sesi. Sebagai pengganti ID, Anda dapat melewatkan jalur absolut ke file transkrip .jsonl sesi. Pemilih dan pencarian nama mencakup sesi yang menambahkan direktori ini dengan /add-dir. Ketika Anda melewatkan ID sesi, Claude Code mencari direktori proyek saat ini dan git worktrees-nya, kemudian setiap proyek lain di mesin ini. Sebelum v2.1.223, pencarian ID hanya mencakup direktori proyek saat ini dan git worktrees-nya. Sesi latar belakang muncul di pemilih yang ditandai dengan bg. Melanjutkan sesi yang masih berjalan membuka sesi itu di terminal ini melalui claude attach, dan prompt yang Anda lewatkan di baris perintah masuk ke dalamnya sebagai putaran berikutnya. Sebelum v2.1.285, Claude Code menolak dan mencetak perintah claude attach untuk dijalankan sebagai gantinya claude --resume auth-refactor
--safe-mode Mulai dengan semua kustomisasi dinonaktifkan untuk memecahkan masalah konfigurasi yang rusak: CLAUDE.md, skills, plugins, hooks, server MCP, perintah dan agen khusus, gaya output, alur kerja, tema khusus, pintasan keyboard khusus, perintah baris status dan saran file, server LSP, dan memori otomatis tidak dimuat. Autentikasi, pemilihan model, alat bawaan, dan izin bekerja secara normal, yang berbeda dari --bare. Kebijakan pengaturan terkelola masih berlaku, termasuk hook yang dikonfigurasi kebijakan, baris status, dan perintah saran file; plugin terkelola, skills terkelola, CLAUDE.md terkelola, dan server MCP yang dikonfigurasi kebijakan tidak. Berguna untuk memeriksa apakah kustomisasi adalah apa yang memicu fallback model otomatis. Menetapkan CLAUDE_CODE_SAFE_MODE claude --safe-mode
--session-id Gunakan ID sesi tertentu untuk percakapan (harus UUID yang valid) claude --session-id "550e8400-e29b-41d4-a716-446655440000"
--setting-sources Daftar sumber pengaturan yang dipisahkan koma untuk dimuat (user, project, local). Lihat tampilan agen dan tim agen untuk sesi yang Anda mulai dari sesi ini yang mewarisi daftar claude --setting-sources user,project
--settings Jalur ke file JSON pengaturan atau string JSON inline. Nilai yang Anda atur di sini menimpa kunci yang sama dalam file settings.json Anda untuk sesi ini. Kunci yang Anda lewatkan menyimpan nilai berbasis file mereka. File harus berupa file biasa tidak lebih besar dari 2 MiB. Lihat preseden pengaturan claude --settings ./settings.json
--strict-mcp-config Hanya gunakan server MCP dari --mcp-config, abaikan semua konfigurasi MCP lainnya. Lihat Kontrol eksklusif dengan managed-mcp.json untuk apa yang dilakukan bendera di bawah file MCP terkelola claude --strict-mcp-config --mcp-config ./mcp.json
--system-prompt Ganti seluruh prompt sistem dengan teks khusus claude --system-prompt "You are a Python expert"
--system-prompt-file Muat prompt sistem dari file, mengganti prompt default claude --system-prompt-file ./custom-prompt.txt
--system-prompt-snapshot Lewatkan off untuk membangun kembali prompt sistem pada setiap permintaan alih-alih menggunakan kembali prompt yang dicatat pada permintaan pertama percakapan, misalnya saat Anda mengulangi teks --append-system-prompt di seluruh jalankan --continue. Memerlukan Claude Code v2.1.257 atau lebih baru claude --system-prompt-snapshot off
--teleport Lanjutkan sesi cloud di terminal lokal Anda claude --teleport
--teammate-mode Atur bagaimana tim agen rekan kerja ditampilkan: in-process (default), auto, tmux, atau iterm2. Menimpa pengaturan teammateMode untuk sesi ini. Lihat Pilih mode tampilan claude --teammate-mode auto
--tmux Buat sesi tmux untuk worktree. Memerlukan --worktree. Menggunakan panel asli iTerm2 saat tersedia; lewatkan --tmux=classic untuk tmux tradisional claude -w feature-auth --tmux
--tools Batasi alat bawaan mana yang dapat digunakan Claude. Gunakan "" untuk menonaktifkan semua, "default" untuk set default, atau nama alat seperti "Bash,Edit,Read". Di macOS, Linux, dan WSL, set default menghilangkan Glob dan Grep, seperti yang dijelaskan di bawah perilaku alat Glob. Jika Anda menamai salah satu alat pelacakan tugas di sini, Claude Code juga mengikutsertakan sesi tersebut. Bendera tidak mempengaruhi alat MCP; untuk menolak mereka juga, gunakan --disallowedTools "mcp__*". Daftar yang menghilangkan EndConversation tidak menghapusnya; "" menghapusnya hanya ketika tidak ada alat MCP yang tersisa claude --tools "Bash,Edit,Read"
--verbose Aktifkan logging verbose, menampilkan output putaran penuh. Menimpa pengaturan viewMode untuk sesi ini claude --verbose
--version, -v Output nomor versi claude -v
--worktree, -w Mulai Claude dalam git worktree terisolasi di <repo>/.claude/worktrees/<name>. Jika Anda tidak memberikan nama, Claude Code menghasilkan satu. Lewatkan #<number>, URL permintaan tarik GitHub, atau URL permintaan penggabungan GitLab untuk mengambil PR atau MR itu dari origin dan cabang worktree darinya. Pencabangan dari permintaan penggabungan GitLab memerlukan Claude Code v2.1.233 atau lebih baru claude -w feature-auth

Bendera prompt sistem

Claude Code menyediakan lima bendera untuk menyesuaikan prompt sistem. Empat menetapkan teksnya, dan dengan --system-prompt-snapshot Anda mengontrol apakah percakapan menyimpan teks yang dimulainya. Kelima bendera bekerja dalam mode interaktif dan non-interaktif.

Bendera Perilaku Contoh
--system-prompt Mengganti seluruh prompt default claude --system-prompt "You are a Python expert"
--system-prompt-file Mengganti dengan konten file claude --system-prompt-file ./prompts/review.txt
--append-system-prompt Menambahkan ke prompt default claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Menambahkan konten file ke prompt default claude --append-system-prompt-file ./style-rules.txt
--system-prompt-snapshot Dengan off, membangun kembali prompt pada setiap permintaan. Dengan on, default, menggunakan kembali prompt yang dicatat di mana pencatatan berlaku claude --append-system-prompt "Draft rules" --system-prompt-snapshot off

Anda dapat menggabungkan flag-flag ini. Untuk mengganti prompt default dan tetap menambahkan teks Anda sendiri, teruskan --append-system-prompt atau --append-system-prompt-file bersama dengan --system-prompt atau --system-prompt-file. Dengan Claude Code v2.1.283 atau lebih baru, Anda juga dapat meneruskan sebuah flag bersama dengan bentuk filenya sendiri, seperti --append-system-prompt dengan --append-system-prompt-file, dan Claude Code menggunakan keduanya.

Misalnya, jalankan perintah berikut di shell Anda untuk menambahkan panduan gaya dari file sekaligus satu instruksi tambahan:

claude -p --append-system-prompt-file ./style.md --append-system-prompt "Always reply in French" "Summarize README.md"

Claude menerima system prompt default diikuti oleh konten style.md, sebuah baris kosong, lalu Always reply in French. Konten file selalu berada di depan meskipun Anda meneruskan --append-system-prompt sebelum --append-system-prompt-file.

Ketika teks penggantian menggabungkan instruksi yang sama pada setiap jalankan dengan konteks yang berubah per jalankan, tambahkan baris yang berisi hanya __SYSTEM_PROMPT_DYNAMIC_BOUNDARY__ antara instruksi dan konteks. Claude Code membagi prompt pada baris pertama seperti itu dan menghapus baris itu, jadi bagian di atasnya tetap di-cache sementara bagian di bawahnya berubah. Memerlukan Claude Code v2.1.275 atau lebih baru. Cache bagian statis dari prompt khusus mencantumkan konfigurasi di mana pemisahan berlaku.

Pilih berdasarkan apakah identitas default Claude Code masih sesuai dengan tugas Anda. Gunakan bendera append ketika Claude harus tetap menjadi asisten pengkodean yang juga mengikuti aturan tambahan Anda: instruksi per-invokasi, pemformatan output, atau konteks domain untuk skrip -p. Menambahkan mempertahankan panduan alat default, instruksi keselamatan, dan konvensi pengkodean, jadi Anda hanya menyediakan apa yang berbeda. Gunakan bendera penggantian ketika permukaan, identitas, atau model izin berbeda dari Claude Code, seperti agen non-pengkodean dalam pipeline yang tidak ada manusia yang menonton. Mengganti menghilangkan seluruh prompt default, termasuk panduan alat dan instruksi keselamatan, jadi Anda bertanggung jawab atas apa pun yang masih dibutuhkan tugas Anda.

Untuk persona persisten yang dapat Anda alihkan dan bagikan di seluruh proyek, gunakan gaya output. Untuk konvensi proyek yang Claude harus selalu ikuti, gunakan CLAUDE.md. Panduan Agent SDK tentang prompt sistem mencakup keputusan yang sama secara lebih mendalam.

Bendera prompt sistem dalam percakapan yang dilanjutkan

Secara default, Claude Code membangun prompt sistem sekali, pada permintaan pertama percakapan, dengan teks dari bendera prompt sistem apa pun yang diterapkan, dan mencatatnya dalam sesi. Sampai percakapan dikompak, setiap permintaan nanti menggunakan prompt yang dicatat, termasuk setelah Anda kembali ke percakapan dengan --resume atau --continue. Jika Anda melewatkan teks bendera prompt sistem yang berbeda, atau tidak ada, pada peluncuran nanti, itu berlaku setelah percakapan dikompak atau ketika Anda memulai percakapan baru.

Di luar sesi cloud, jika Anda memulai Claude Code dalam mode bare dengan melewatkan --bare atau menetapkan CLAUDE_CODE_SIMPLE=1, pencatatan tetap mati kecuali Anda melewatkan --system-prompt-snapshot on. Sebelum v2.1.268, sesi yang tidak mengambil bendera fitur, termasuk sesi di Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, membangun kembali prompt pada setiap permintaan dan --system-prompt-snapshot tidak berpengaruh.

Untuk membangun kembali prompt pada setiap permintaan sebagai gantinya, misalnya saat Anda mengulangi kata-katanya di seluruh jalankan --continue, lewatkan --system-prompt-snapshot off. Sebelum v2.1.265, melewatkan salah satu bendera prompt sistem juga mematikan pencatatan kecuali Anda melewatkan --system-prompt-snapshot on.

Lihat juga