SpyBara
Go Premium

cli-reference.md 2026-09-17 05:00 UTC to 2026-09-18 23:58 UTC

This page contains 72 additions and 72 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Sun 13 21:00 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

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. Tersedia di Claude Code v2.1.195 dan lebih baru. 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 claude auth status
claude agents Buka tampilan agen 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 langsung 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 agen memerlukan terminal interaktif claude agents --json
claude attach <id> Lampirkan ke sesi latar belakang di terminal ini 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 yang dikelola 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 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 hanya-baca 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 agen 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> Cetak output terbaru dari sesi latar belakang 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, kemudian tempel URL pengalihan kembali di prompt. Memerlukan Claude Code v2.1.186 atau lebih baru. Lihat Autentikasi dari baris perintah claude mcp login sentry
claude mcp logout <name> Hapus kredensial OAuth yang disimpan untuk server MCP. Memerlukan Claude Code v2.1.186 atau lebih baru 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 project 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 project 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 mengganti 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?.

Mulai dari v2.1.199, claude --dangerously-skip-permissions daemon <subcommand> menjalankan subperintah daemon. Versi sebelumnya memperlakukan daemon <subcommand> sebagai prompt untuk sesi interaktif baru, sehingga subperintah tidak pernah berjalan ketika flag datang terlebih dahulu, setup umum ketika claude memiliki alias untuk menyertakan flag. Hanya --dangerously-skip-permissions atau --allow-dangerously-skip-permissions yang terdepan yang merutekan ke daemon dengan cara ini; flag terdepan lainnya masih memulai sesi interaktif.

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 Tentukan subagen khusus secara dinamis melalui JSON. Menerima bidang yang tercantum untuk subagen yang ditentukan CLI. Claude Code memvalidasi JSON saat startup dan keluar pada nilai yang tidak valid; lihat Konfigurasi --agents tidak valid untuk pesan dan untuk bendera dan variabel lingkungan 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 Alat yang dijalankan tanpa meminta izin. Lihat sintaks aturan izin untuk pencocokan pola. Untuk membatasi alat mana yang tersedia, gunakan --tools sebagai gantinya. Jika Anda menamai salah satu alat pelacakan tugas di sini, Claude Code juga memilih sesi masuk "Bash(git log *)" "Bash(git diff *)" "Read"
--append-subagent-system-prompt Tambahkan teks khusus ke akhir prompt sistem setiap subagen, termasuk subagen bersarang, terlepas dari 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. 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 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 saluran yang tidak ada di daftar persetujuan, untuk pengembangan lokal. Menerima entri plugin:<name>@<marketplace> dan server:<name>. Meminta konfirmasi 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='!1p'. Filter mengikat hanya 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
--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 bagian per-mesin dari prompt sistem (direktori kerja, info lingkungan, jalur memori, bendera git-repo) 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 Emit subagen blok teks dan pemikiran dalam aliran output sebagai pesan assistant dan user dengan parent_tool_use_id diatur, sehingga Anda dapat merekonstruksi transkrip setiap subagen. Tanpa bendera ini, Claude Code menghilangkan teks dan blok pemikiran subagen yang berjalan di foreground. Memerlukan --print dan --output-format stream-json. Claude Code juga meneruskan pesan dari subagen bersarang, menetapkan parent_tool_use_id ke ID panggilan alat Agent yang menelurkan masing-masing; ini memerlukan Claude Code v2.1.219 atau lebih baru. Variabel lingkungan 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 Jumlah dolar maksimum untuk dihabiskan pada panggilan API sebelum berhenti (mode cetak saja). Pengeluaran dari subagen dihitung menuju batas. Setelah pengeluaran mencapai batas, menelurkan subagen lain gagal dengan Budget limit reached, dan Claude Code menghentikan subagen latar belakang yang masih berjalan; perilaku penegakan batas 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 melewatkan bendera ini dengan -p, Claude Code menunggu server yang masih tertunda untuk terhubung sebelum menjalankan putaran pertama, hingga waktu tunggu startup MCP_TIMEOUT, 30 detik secara default; server dengan daftar alat yang di-cache melewati tunggu dan terhubung saat penggunaan pertama. Tunggu 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>. Dalam sesi interaktif, jika sesi langsung lain di mesin ini sudah menggunakan nama, Claude Code menerapkan varian darinya sebagai gantinya.

/rename mengubah nama pertengahan 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. Untuk -p, itu adalah default ketika tidak ada yang dikonfigurasi claude --permission-mode plan
--permission-prompt-tool Tentukan alat MCP untuk menangani prompt izin dalam mode non-interaktif. Claude Code menunggu server MCP alat itu untuk terhubung sebelum menjalankan putaran pertama, hingga waktu tunggu startup MCP_TIMEOUT, 30 detik secara default.

Alat prompt tidak dapat menyetujui alat MCP yang ditandai sebagai memerlukan interaksi pengguna: Claude Code mengonversi hasil allow untuk satu ke penolakan. Pembatasan ini memerlukan Claude Code v2.1.199 atau lebih baru
claude -p --permission-prompt-tool mcp_auth_tool "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 pemrograman) 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 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) 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 (ditambahkan di v2.1.186). 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 memilih sesi masuk. 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

--system-prompt dan --system-prompt-file saling eksklusif. Bendera append dapat digabungkan dengan bendera penggantian apa pun.

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