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 [codex|gemini] |
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. 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 30 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. 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.
Flag CLI
Sesuaikan perilaku Claude Code dengan flag baris perintah ini. claude --help tidak mencantumkan setiap flag, jadi ketiadaan flag dari --help tidak berarti flag tersebut tidak tersedia.
| Flag | 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 advisor sisi server untuk sesi ini dengan alias model, fable, opus, atau sonnet, atau ID model lengkap. Mengambil prioritas atas 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 subagents kustom secara dinamis melalui JSON. Menerima field yang tercantum untuk subagents 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 flag serta 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 |
Tools yang dieksekusi tanpa meminta izin. Lihat sintaks aturan izin untuk pencocokan pola. Untuk membatasi tools mana yang tersedia, gunakan --tools sebagai gantinya. Jika Anda menamai salah satu tools pelacakan tugas di sini, Claude Code juga memilih sesi masuk |
"Bash(git log *)" "Bash(git diff *)" "Read" |
--append-subagent-system-prompt |
Tambahkan teks kustom ke akhir prompt sistem setiap subagent, termasuk subagents bersarang, kecuali subagent yang di-fork, 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 subagent. Alternatif untuk --append-subagent-system-prompt untuk teks yang terlalu panjang untuk dilewatkan di baris perintah. Kedua flag tidak dapat dikombinasikan. 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 kustom 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 yang disimpan. Menerima nilai yang sama dengan /autocompact; bagian itu mencakup bentuk nilai dan apa yang menimpa flag. 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 background yang terlampir masih render fullscreen. Mengambil prioritas atas 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 kustom, subagents, plugins, server MCP, auto memory, dan CLAUDE.md sehingga panggilan skrip dimulai lebih cepat. Skills dalam direktori yang Anda lewatkan dengan --add-dir masih dimuat. Claude memiliki akses ke tools Bash, baca file, dan edit file. Menetapkan CLAUDE_CODE_SIMPLE. Lihat bare mode |
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 background dan kembali segera. Mencetak ID sesi dan perintah manajemen. Gabungkan dengan --exec untuk menjalankan perintah shell sebagai pekerjaan background alih-alih sesi Claude, atau dengan --agent untuk menjalankan subagent tertentu. Tidak dapat dikombinasikan dengan -p/--print; lihat referensi kesalahan |
claude --bg "investigate the flaky test" |
--channels |
(Pratinjau penelitian) Server MCP yang notifikasi channel Claude harus dengarkan 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 web baru di claude.ai. 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 di direktori saat ini, melewati sesi background, 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 channels yang tidak ada di daftar persetujuan yang disetujui, 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 prioritas atas 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 tool yang telanjang menghapus tools yang cocok dari konteks Claude: "Edit" menghapus Edit, "*" menghapus setiap tool, dan "mcp__*" menghapus setiap tool MCP. Aturan yang dibatasi seperti Bash(rm *) membiarkan tool tersedia dan menolak hanya panggilan yang cocok. Aturan yang menamai EndConversation tidak dapat menghapusnya saat tool 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 memulai sesi pada 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. Auto mode 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 pada lingkungan self-hosted dengan ID yang diberikan. ID lingkungan dimulai dengan ccpool_. Lihat perilaku dispatch --environment untuk perilaku dispatch dan kombinasi flag 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, informasi lingkungan, jalur memori, flag git-repo) ke pesan pengguna pertama. Meningkatkan reuse prompt-cache 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 background 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 Fallback model chains. Untuk mempertahankan rantai di seluruh sesi, gunakan pengaturan fallbackModel, yang flag 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 blok teks dan thinking subagent dalam aliran output sebagai pesan assistant dan user dengan parent_tool_use_id diatur, sehingga Anda dapat merekonstruksi transkrip setiap subagent. Tanpa flag ini, Claude Code hanya memancarkan blok tool_use dan tool_result subagent. Memerlukan --print dan --output-format stream-json. Claude Code juga meneruskan pesan dari subagents bersarang, menetapkan parent_tool_use_id ke ID panggilan tool 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 pull request tertentu. Menerima nomor PR, URL GitHub atau GitHub Enterprise PR, URL merge request GitLab, atau URL pull request Bitbucket. Sesi secara otomatis ditautkan ketika Claude membuat pull request | claude --from-pr 123 |
--ide |
Secara otomatis terhubung ke IDE saat startup jika tepat satu IDE valid tersedia | claude --ide |
--init |
Jalankan Setup hooks dengan matcher 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 flag ini. Beberapa peristiwa hook, seperti Notification, SessionEnd, PreCompact, dan PostCompact, tidak pernah menghasilkan peristiwa hook_started, bahkan dengan flag ini. Untuk peristiwa tersebut, Claude Code masih memancarkan hook_progress saat hook perintah berjalan selama lebih dari satu detik menghasilkan output, dan memancarkan hook_response hanya ketika hook yang berjalan di background 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 sesuai dengan JSON Schema setelah agen menyelesaikan alurnya (mode cetak saja). Lihat structured outputs. 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 Setup hooks dengan matcher 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 subagents dihitung terhadap batas. Setelah pengeluaran mencapai batas, menelurkan subagent lain gagal dengan Budget limit reached, dan Claude Code menghentikan subagents background 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 saat batas tercapai. Tidak ada batas secara default. Dengan --input-format stream-json, pesan yang masih antri saat 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 JSON atau string (dipisahkan spasi). Saat Anda melewatkan flag ini dengan -p, Claude Code menunggu server yang masih tertunda untuk terhubung sebelum menjalankan putaran pertama, hingga startup timeout MCP_TIMEOUT, 30 detik secara default; server dengan daftar tool yang di-cache melewati tunggu dan terhubung pada 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 live lain di mesin ini sudah menggunakan nama, Claude Code menerapkan varian darinya sebagai gantinya. /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 bekerja. Menimpa defaultMode dari file pengaturan. Tanpa flag ini atau --dangerously-skip-permissions, sesi baru dimulai dalam mode izin yang dijelaskan dalam mode izin mana sesi dimulai. Untuk -p, itu adalah default saat tidak ada yang dikonfigurasi |
claude --permission-mode plan |
--permission-prompt-tool |
Tentukan tool MCP untuk menangani prompt izin dalam mode non-interaktif. Claude Code menunggu server MCP tool tersebut untuk terhubung sebelum menjalankan putaran pertama, hingga startup timeout 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 satu menjadi 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 tool --permission-prompt-tool. Lewatkan none saat tidak ada yang dapat menjawab, dan Claude Code menolaknya sebagai gantinya. Lihat Matikan prompt izin dalam run 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 untuk sesi ini saja. Setiap flag mengambil satu jalur. Ulangi flag untuk beberapa plugin: --plugin-dir A --plugin-dir B.zip |
claude --plugin-dir ./my-plugin |
--plugin-url |
Ambil arsip plugin .zip dari URL untuk sesi ini saja. Ulangi flag untuk beberapa plugin, atau berikan URL yang dipisahkan spasi dalam satu nilai yang dikutip |
claude --plugin-url https://example.com/plugin.zip |
--print, -p |
Cetak respons tanpa mode interaktif (lihat dokumentasi Agent SDK untuk detail penggunaan programatik) | 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 tidak menghasilkan apa pun. Memerlukan --print, --output-format stream-json, dan --verbose. Lihat Prompt suggestions |
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 berikan nama untuk sesi | claude --remote-control "My Project" |
--remote-control-session-name-prefix <prefix> |
Awalan untuk nama sesi 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 |
Re-emit pesan pengguna dari stdin kembali 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 saat harness evaluasi menjalankan claude pada mesin bersama dan Claude Code tidak boleh menjalankan perintah atau membaca pengaturan pengguna dan proyek mesin itu. Claude Code menghapus tools bawaan yang menjalankan perintah atau kode, dan WebFetch, kecuali Anda menamai mereka secara individual dalam --tools, bukan melalui preset default. Ini juga membatasi tools 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. Pemilih dan pencarian nama mencakup sesi yang menambahkan direktori ini dengan /add-dir. Saat 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 background 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 kustom, gaya output, workflows, tema kustom, pintasan keyboard kustom, perintah status line dan file-suggestion, server LSP, dan auto memory tidak dimuat. Autentikasi, pemilihan model, tools bawaan, dan izin bekerja secara normal, yang berbeda dari --bare. Kebijakan pengaturan terkelola masih berlaku, termasuk hooks yang dikonfigurasi kebijakan, status line, dan perintah file-suggestion; plugins 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 mempertahankan nilai berbasis file mereka. File harus berupa file reguler tidak lebih besar dari 2 MiB. Lihat precedence 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 flag di bawah file MCP terkelola |
claude --strict-mcp-config --mcp-config ./mcp.json |
--system-prompt |
Ganti seluruh prompt sistem dengan teks kustom | 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 |
--teleport |
Lanjutkan sesi web di terminal lokal Anda | claude --teleport |
--teammate-mode |
Atur bagaimana rekan tim agen 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 pane native iTerm2 saat tersedia; berikan --tmux=classic untuk tmux tradisional |
claude -w feature-auth --tmux |
--tools |
Batasi tools bawaan mana yang dapat digunakan Claude. Gunakan "" untuk menonaktifkan semua, "default" untuk semua, atau nama tools seperti "Bash,Edit,Read". Jika Anda menamai salah satu tools pelacakan tugas di sini, Claude Code juga memilih sesi masuk. Flag tidak mempengaruhi tools MCP; untuk menolak yang juga, gunakan --disallowedTools "mcp__*". Daftar yang menghilangkan EndConversation tidak menghapusnya; "" menghapusnya hanya saat tidak ada tools 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 |
Keluarkan 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 pull request GitHub, atau URL merge request GitLab untuk mengambil PR atau MR itu dari origin dan membuat cabang worktree darinya. Membuat cabang dari merge request GitLab memerlukan Claude Code v2.1.233 atau lebih baru |
claude -w feature-auth |
Flag prompt sistem
Claude Code menyediakan empat flag untuk menyesuaikan prompt sistem. Keempat flag bekerja dalam mode interaktif dan non-interaktif.
| Flag | 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 dan --system-prompt-file saling eksklusif. Flag append dapat dikombinasikan dengan flag penggantian apa pun.
Pilih berdasarkan apakah identitas default Claude Code masih sesuai dengan tugas Anda. Gunakan flag append ketika Claude harus tetap menjadi asisten coding yang juga mengikuti aturan tambahan Anda: instruksi per-invocation, pemformatan output, atau konteks domain untuk skrip -p. Menambahkan mempertahankan panduan tool default, instruksi keamanan, dan konvensi coding, jadi Anda hanya menyediakan apa yang berbeda. Gunakan flag penggantian ketika permukaan, identitas, atau model izin berbeda dari Claude Code, seperti agen non-coding dalam pipeline yang tidak ada manusia yang menonton. Mengganti menghilangkan seluruh prompt default, termasuk panduan tool dan instruksi keamanan, jadi Anda bertanggung jawab atas apa pun yang masih dibutuhkan tugas Anda.
Flag ini hanya berlaku untuk invocation saat ini. Untuk persona persisten yang dapat Anda alihkan dan bagikan di seluruh proyek, gunakan output styles. Untuk konvensi proyek yang harus selalu diikuti Claude, gunakan CLAUDE.md. Panduan Agent SDK tentang system prompts mencakup keputusan yang sama dengan lebih mendalam.
Lihat juga
- Ekstensi Chrome - Otomasi browser dan pengujian web
- Mode interaktif - Pintasan keyboard, mode input, dan fitur interaktif
- Panduan quickstart - Memulai dengan Claude Code
- Alur kerja umum - Alur kerja dan pola lanjutan
- Pengaturan - Opsi konfigurasi
- Dokumentasi Agent SDK - Penggunaan programatik dan integrasi