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. Alias: claude rc. 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.
Flag CLI
Sesuaikan perilaku Claude Code dengan flag baris perintah berikut. claude --help tidak mencantumkan setiap flag, sehingga tidak adanya suatu flag di --help tidak berarti flag tersebut tidak tersedia.
| Flag | Deskripsi | Contoh |
|---|---|---|
--add-dir |
Menambahkan direktori kerja tambahan agar Claude dapat membaca dan mengedit file. Memberikan akses file; Claude Code tidak menemukan sebagian besar konfigurasi .claude/ dari direktori ini. Memvalidasi bahwa setiap path ada sebagai direktori. Anda tidak dapat menambahkan sebagian besar path jaringan, seperti \\server\share. Untuk mempertahankan direktori ini di seluruh sesi, atur permissions.additionalDirectories di pengaturan |
claude --add-dir ../apps ../lib |
--advisor <model> |
Mengaktifkan advisor tool sisi server untuk sesi ini dengan alias model, fable, opus, atau sonnet, atau ID model lengkap. Diutamakan daripada pengaturan advisorModel untuk sesi tersebut. fable memerlukan akses Fable |
claude --advisor opus |
--agent |
Menentukan agent untuk sesi saat ini (menimpa pengaturan agent) |
claude --agent my-custom-agent |
--agents |
Mendefinisikan subagent kustom secara dinamis melalui JSON. Menerima field yang tercantum untuk subagent yang didefinisikan melalui CLI. Dengan --print, nilainya dapat berupa path ke file JSON yang berisi objek tersebut; bentuk file memerlukan Claude Code v2.1.281 atau yang lebih baru. Claude Code memvalidasi nilai saat startup dan keluar jika nilainya tidak valid; lihat Invalid --agents configuration untuk pesannya serta untuk flag dan environment variable yang melewati validasi tersebut. Validasi memerlukan Claude Code v2.1.242 atau yang lebih baru |
claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' |
--allow-dangerously-skip-permissions |
Menambahkan bypassPermissions ke siklus mode Shift+Tab tanpa memulai di mode tersebut. Memungkinkan Anda memulai di mode lain 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 path 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 |
Menambahkan teks kustom ke akhir system prompt setiap subagent, termasuk subagent bertingkat, kecuali subagent fork, yang menggunakan kembali prompt milik percakapan itu sendiri. Hanya berlaku dalam mode non-interaktif dengan -p. Memerlukan Claude Code v2.1.205 atau yang lebih baru |
claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query" |
--append-subagent-system-prompt-file |
Memuat teks dari file dan menambahkannya ke system prompt subagent. Alternatif untuk --append-subagent-system-prompt untuk teks yang terlalu panjang untuk diteruskan di baris perintah. Kedua flag ini tidak dapat digabungkan. Hanya berlaku dalam mode non-interaktif dengan -p. Memerlukan Claude Code v2.1.261 atau yang lebih baru |
claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query" |
--append-system-prompt |
Menambahkan teks kustom ke akhir system prompt default | claude --append-system-prompt "Always use TypeScript" |
--append-system-prompt-file |
Memuat teks system prompt tambahan dari file dan menambahkannya ke prompt default | claude --append-system-prompt-file ./extra-rules.txt |
--autocompact <auto|tokens> |
Mengatur jendela auto-compact untuk sesi ini tanpa mengubah pengaturan yang tersimpan. Menerima nilai yang sama dengan /autocompact; bagian tersebut menjelaskan bentuk nilai dan apa yang menimpa flag ini. Memerlukan Claude Code v2.1.221 atau yang lebih baru |
claude --autocompact 500k |
--ax-screen-reader |
Merender output yang ramah pembaca layar: teks datar tanpa border dekoratif atau animasi. Memaksa renderer klasik, sehingga pengaturan tui tidak berpengaruh; sesi latar belakang yang terlampir tetap dirender layar penuh. Diutamakan daripada CLAUDE_AX_SCREEN_READER dan pengaturan axScreenReader. Memerlukan Claude Code v2.1.181 atau yang lebih baru |
claude --ax-screen-reader |
--bare |
Mode minimal: melewati penemuan otomatis hook, skill, perintah kustom, subagent, plugin yang terinstal, server MCP, auto memory, dan CLAUDE.md agar panggilan berskrip dimulai lebih cepat. Skill di direktori yang Anda teruskan dengan --add-dir tetap dimuat. Claude memiliki akses ke Bash, tool baca file, dan tool edit file. Mengatur CLAUDE_CODE_SIMPLE. Lihat bare mode |
claude --bare -p "query" |
--betas |
Header beta yang disertakan dalam permintaan API (hanya pengguna kunci API) | claude --betas interleaved-thinking |
--bg, --background |
Memulai sesi sebagai background agent dan langsung kembali. Mencetak ID sesi dan perintah manajemen. Gabungkan dengan --exec untuk menjalankan perintah shell sebagai job latar belakang alih-alih sesi Claude, atau dengan --agent untuk menjalankan subagent tertentu. Memeriksa workspace trust untuk direktori sebelum dimulai. Tidak dapat digabungkan dengan -p/--print; lihat referensi error |
claude --bg "investigate the flaky test" |
--channels |
(Research preview) Server MCP yang notifikasi channel-nya harus didengarkan Claude dalam sesi ini. Daftar entri plugin:<name>@<marketplace> yang dipisahkan spasi. Memerlukan autentikasi Anthropic melalui claude.ai atau kunci API Console |
claude --channels plugin:my-notifier@my-marketplace |
--chrome |
Mengaktifkan integrasi browser Chrome untuk otomatisasi dan pengujian web | claude --chrome |
--cloud |
Dengan deskripsi tugas, membuat sesi cloud baru. Dengan ID sesi (session_... atau cse_...) atau URL claude.ai/code, memasukkan pesan ke antrean sesi yang sudah ada tersebut, dengan -p. Lihat mengirim pesan tindak lanjut. |
claude --cloud "Fix the login bug" |
--continue, -c |
Memuat percakapan terbaru di direktori saat ini, termasuk sesi latar belakang yang sudah selesai; membuka sesi latar belakang yang sudah selesai memerlukan Claude Code v2.1.257 atau yang lebih baru. Melewati sesi yang dibuat dengan claude -p atau Agent SDK, serta sesi yang prompt pertamanya adalah /loop. claude -p --continue menyertakan sesi -p, SDK, dan /loop. Menyertakan sesi yang menambahkan direktori ini dengan /add-dir |
claude --continue |
--dangerously-load-development-channels |
Mengaktifkan channel yang tidak ada di allowlist yang disetujui, untuk pengembangan lokal. Menerima entri plugin:<name>@<marketplace> dan server:<name>. Meminta konfirmasi, sehingga berlaku di sesi interaktif. Dengan -p, Claude Code mengabaikan flag ini |
claude --dangerously-load-development-channels server:webhook |
--dangerously-skip-permissions |
Melewati permintaan izin. Setara dengan --permission-mode bypassPermissions. Lihat mode izin untuk apa yang dilewati dan tidak dilewati. Untuk sesi yang dimulai dengan --bg, mode ini tetap berlaku saat supervisor memulai ulang sesi |
claude --dangerously-skip-permissions |
--debug |
Mengaktifkan mode debug dengan pemfilteran kategori opsional, seperti --debug='mcp,startup' atau --debug='!mcp'. Filter hanya terikat dalam bentuk =; filter yang dipisahkan spasi mengaktifkan mode debug tanpa pemfilteran |
claude --debug='mcp,startup' |
--debug-file <path> |
Menulis log debug ke path file tertentu. Secara implisit mengaktifkan mode debug. Diutamakan daripada CLAUDE_CODE_DEBUG_LOGS_DIR |
claude --debug-file /tmp/claude-debug.log |
--desktop |
Membuka aplikasi Claude Desktop pada direktori saat ini dan keluar tanpa memulai sesi di terminal. Tambahkan --continue, atau --resume dengan ID sesi, untuk membuka sesi tersebut di Desktop sebagai gantinya. --resume di sini hanya menerima ID sesi, bukan nama atau path transkrip. Tidak menerima prompt dan tidak menerima flag lain kecuali --verbose dan flag --debug, karena aplikasi memulai sesi itu sendiri. Tersedia di macOS dan Windows x64 saat Anda masuk dengan langganan Claude. Memerlukan Claude Code v2.1.285 atau yang lebih baru |
claude --desktop |
--disable-slash-commands |
Menonaktifkan semua skill dan perintah untuk sesi ini | claude --disable-slash-commands |
--disallowedTools, --disallowed-tools |
Aturan deny. Nama tool saja akan menghapus tool yang cocok dari konteks Claude: "Edit" menghapus Edit, "*" menghapus setiap tool, dan "mcp__*" menghapus setiap tool MCP. Aturan bercakupan seperti Bash(rm *) membiarkan tool tetap tersedia dan hanya menolak panggilan yang cocok persis seperti yang ditulis. Aturan yang menyebutkan EndConversation tidak dapat menghapusnya selama masih ada tool lain |
"Bash(git log *)" "Bash(git diff *)" "Edit" |
--effort |
Mengatur tingkat effort untuk sesi saat ini. Opsi: low, medium, high, xhigh, max, atau ultracode. Tingkat yang tersedia bergantung pada model. ultracode meminta effort xhigh dengan ultracode diaktifkan, dan memerlukan Claude Code v2.1.203 atau yang lebih baru. Pada model percakapan utama, menimpa pengaturan modelSettings dan effortLevel untuk sesi ini dan tidak dipertahankan |
claude --effort high |
--enable-auto-mode |
Dihapus di v2.1.111. Auto mode kini ada di siklus Shift+Tab secara default; gunakan --permission-mode auto untuk memulai di mode tersebut |
claude --permission-mode auto |
--environment <environment-id> |
Membuat sesi cloud baru yang berjalan di lingkungan self-hosted dengan ID yang diberikan. ID lingkungan diawali dengan ccpool_. Lihat perilaku dispatch --environment untuk perilaku dispatch dan kombinasi flag yang ditolaknya. Memerlukan Claude Code v2.1.224 atau yang lebih baru |
claude -p "Fix the login bug" --environment ccpool_abc123 |
--exclude-dynamic-system-prompt-sections |
Memindahkan konteks per pengguna, seperti lokasi auto memory, dari system prompt ke pesan pengguna pertama. Meningkatkan penggunaan kembali prompt cache di antara pengguna dan mesin berbeda yang menjalankan tugas yang sama. Hanya berlaku dengan system prompt default; diabaikan saat --system-prompt atau --system-prompt-file diatur. Gunakan dengan -p untuk beban kerja berskrip multi-pengguna |
claude -p --exclude-dynamic-system-prompt-sections "query" |
--exec |
Menjalankan perintah shell sebagai job latar belakang berbasis PTY alih-alih memulai sesi Claude. Gunakan dengan --bg untuk meluncurkan dari shell |
claude --bg --exec 'pytest -x' |
--fallback-model |
Mengaktifkan fallback otomatis ke model yang ditentukan saat model utama kelebihan beban atau tidak tersedia, misalnya model yang sudah dipensiunkan. Menerima daftar yang dipisahkan koma yang dicoba secara berurutan. Lihat Rantai model fallback. Untuk mempertahankan rantai di seluruh sesi, gunakan pengaturan fallbackModel, yang ditimpa oleh flag ini |
claude --fallback-model sonnet,haiku |
--fork-session |
Saat melanjutkan, membuat ID sesi baru alih-alih menggunakan kembali yang asli (gunakan dengan --resume atau --continue) |
claude --resume abc123 --fork-session |
--forward-subagent-text |
Memancarkan teks dan thinking block 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 teks dan thinking block dari subagent yang berjalan di foreground. Memerlukan --print dan --output-format stream-json. Untuk subagent bertingkat, skill fork, dan versi yang dibutuhkan masing-masing, lihat Mengikuti pesan subagent. Environment variable CLAUDE_CODE_FORWARD_SUBAGENT_TEXT mengaktifkan perilaku yang sama. Memerlukan Claude Code v2.1.211 atau yang lebih baru |
claude -p --output-format stream-json --verbose --forward-subagent-text "query" |
--from-pr |
Membuka pemilih sesi yang difilter ke sesi yang ditautkan ke pull request tertentu. Menerima nomor PR, URL PR GitHub atau GitHub Enterprise, URL merge request GitLab, atau URL pull request Bitbucket. Sesi ditautkan secara otomatis saat Claude membuat pull request | claude --from-pr 123 |
--ide |
Secara otomatis terhubung ke IDE saat startup jika tepat satu IDE yang valid tersedia | claude --ide |
--init |
Menjalankan hook Setup dengan matcher init sebelum sesi (hanya mode print) |
claude -p --init "query" |
--init-only |
Menjalankan hook Setup dan SessionStart, lalu keluar tanpa memulai percakapan |
claude --init-only |
--include-hook-events |
Menyertakan event siklus hidup hook dalam stream output. Event hook SessionStart dan Setup selalu disertakan dan tidak memerlukan flag ini. Beberapa event hook, seperti Notification, SessionEnd, PreCompact, dan PostCompact, tidak pernah menghasilkan event hook_started, bahkan dengan flag ini. Untuk event tersebut, Claude Code tetap memancarkan hook_progress selama hook perintah yang berjalan lebih dari satu detik menghasilkan output, dan memancarkan hook_response hanya saat 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 |
Menyertakan event streaming parsial dalam output. Memerlukan --print dan --output-format stream-json |
claude -p --output-format stream-json --verbose --include-partial-messages "query" |
--input-format |
Menentukan format input untuk mode print (opsi: text, stream-json) |
claude -p --input-format stream-json --output-format stream-json --verbose |
--json-schema |
Mendapatkan output JSON tervalidasi yang cocok dengan JSON Schema setelah agent menyelesaikan alur kerjanya (hanya mode print). Lihat output terstruktur. Claude Code keluar dengan error 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 |
Menjalankan hook Setup dengan matcher maintenance sebelum sesi (hanya mode print) |
claude -p --maintenance "query" |
--max-budget-usd |
Menghentikan eksekusi setelah estimasi pengeluaran untuk panggilan API mencapai jumlah ini (hanya mode print). Claude Code memeriksa batas terhadap estimasi biaya sisi klien, yang dapat berbeda dari tagihan Anda. Pengeluaran dari subagent dihitung terhadap batas tersebut. Pengeluaran dapat melewati batas, jadi sisakan ruang. Saat Anda kembali ke percakapan dengan --continue atau --resume, total yang dipulihkan dari eksekusi sebelumnya tidak dihitung terhadapnya. Setelah pengeluaran mencapai batas, memunculkan subagent lain akan 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 yang lebih baru |
claude -p --max-budget-usd 5.00 "query" |
--max-turns |
Membatasi jumlah giliran agentik (hanya mode print). Tidak ada batas secara default. Dengan --input-format stream-json, pesan yang masih dalam antrean saat batas mengakhiri giliran tetap dalam antrean dan memulai giliran baru dengan batasnya sendiri |
claude -p --max-turns 3 "query" |
--mcp-config |
Memuat server MCP dari file atau string JSON (dipisahkan spasi). Saat 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 pertama kali digunakan. Di lingkungan self-hosted, penantian yang lebih singkat berlaku sebagai gantinya. Penantian ini memerlukan Claude Code v2.1.221 atau yang lebih baru |
claude --mcp-config ./mcp.json |
--model |
Mengatur 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 |
Mengatur nama tampilan untuk sesi, yang 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 |
Menonaktifkan integrasi browser Chrome untuk sesi ini | claude --no-chrome |
--no-session-persistence |
Menonaktifkan persistensi sesi sehingga sesi tidak disimpan ke disk dan tidak dapat dilanjutkan. Hanya mode print. Environment variable CLAUDE_CODE_SKIP_PROMPT_HISTORY melakukan hal yang sama di mode apa pun |
claude -p --no-session-persistence "query" |
--output-format |
Menentukan format output untuk mode print (opsi: text, json, stream-json) |
claude -p "query" --output-format json |
--permission-mode |
Memulai di mode izin tertentu. Menerima default, acceptEdits, plan, auto, dontAsk, bypassPermissions, atau manual sebagai alias untuk default. Alias manual memilih mode izin yang diberi label Manual oleh UI dan memerlukan Claude Code v2.1.200 atau yang lebih baru; claude --help mencantumkannya sebagai pengganti default, dan kedua nilai berfungsi. Menimpa defaultMode dari file pengaturan. Tanpa flag ini atau --dangerously-skip-permissions, sesi baru dimulai dalam mode izin yang dijelaskan di mode izin mana yang digunakan saat sesi dimulai, yang juga menjelaskan mode awal untuk eksekusi -p |
claude --permission-mode plan |
--permission-prompt-tool |
Menentukan tool MCP untuk menangani permintaan izin dalam mode non-interaktif. Teruskan nama lengkapnya, seperti mcp__<server>__<tool>, dari tool pada server MCP yang dimuat oleh eksekusi. Claude Code menunggu server MCP tool tersebut terhubung sebelum menjalankan giliran pertama, hingga timeout startup MCP_TIMEOUT, 30 detik secara default. Lihat apa yang harus dikembalikan tool. Tool prompt tidak dapat menyetujui tool MCP yang ditandai sebagai memerlukan interaksi pengguna: Claude Code mengubah hasil allow untuk tool tersebut menjadi deny. Pembatasan ini memerlukan Claude Code v2.1.199 atau yang lebih baru |
claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query" |
--permission-prompts |
Mengatur siapa yang menjawab permintaan izin dalam mode print. Dengan nilai default host, Claude Code mengirimkannya ke host Agent SDK atau tool --permission-prompt-tool. Teruskan none jika tidak ada yang dapat menjawab, dan Claude Code akan menolaknya sebagai gantinya. Lihat Mematikan permintaan izin dalam eksekusi tanpa pengawasan. Memerlukan Claude Code v2.1.259 atau yang lebih baru |
claude -p --permission-prompts none "query" |
--plugin-dir |
Memuat plugin dari direktori atau arsip .zip, atau beberapa plugin dari folder plugin, hanya untuk sesi ini. Setiap flag menerima satu path. Ulangi flag untuk path lainnya: --plugin-dir A --plugin-dir B.zip. Meneruskan folder plugin memerlukan Claude Code v2.1.265 atau yang lebih baru |
claude --plugin-dir ./my-plugin |
--plugin-url |
Mengambil arsip .zip plugin dari URL hanya untuk sesi ini. Ulangi flag untuk beberapa plugin, atau teruskan URL yang dipisahkan spasi dalam satu nilai berkutip |
claude --plugin-url https://example.com/plugin.zip |
--print, -p |
Mencetak respons tanpa mode interaktif (lihat dokumentasi Agent SDK untuk detail penggunaan terprogram). Untuk --resume pada sesi latar belakang yang masih berjalan, lihat Melanjutkan sesi latar belakang yang sedang berjalan |
claude -p "query" |
--prompt-suggestions |
Memancarkan pesan prompt_suggestion dengan prediksi prompt pengguna berikutnya setelah setiap giliran yang menghasilkannya; percakapan yang sangat singkat mungkin tidak menghasilkan apa pun. 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, mendasarkan checkout sesi baru pada ref bernama alih-alih HEAD lokal |
claude -p "Run the smoke test" --environment ccpool_abc123 --ref main |
--remote |
Alias deprecated untuk --cloud, termasuk bentuk sesi yang sudah ada |
claude --remote "Fix the login bug" |
--remote-control, --rc |
Memulai sesi interaktif dengan Remote Control diaktifkan sehingga Anda juga dapat mengendalikannya dari claude.ai atau aplikasi Claude. Secara opsional teruskan nama untuk sesi | claude --remote-control "My Project" |
--remote-control-session-name-prefix <prefix> |
Prefiks untuk nama sesi Remote Control yang dibuat otomatis saat tidak ada nama eksplisit yang diatur. Default-nya adalah hostname 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 |
Memancarkan ulang pesan pengguna dari stdin kembali ke stdout sebagai konfirmasi. 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 |
Memulai dalam mode terbatas. Gunakan saat harness evaluasi menjalankan claude di mesin bersama dan Claude Code tidak boleh menjalankan perintah atau membaca pengaturan pengguna dan proyek mesin tersebut. Claude Code menghapus tool bawaan yang menjalankan perintah atau kode, serta WebFetch, kecuali jika Anda menyebutkannya satu per satu di --tools, bukan melalui preset default. Mode ini juga membatasi tool file bawaan ke direktori kerja, hanya memuat pengaturan terkelola dan --settings, menolak bypassPermissions, dan menolak membuat sesi cloud. Memerlukan Claude Code v2.1.248 atau yang lebih baru |
claude --restricted -p "query" |
--resume, -r |
Melanjutkan sesi tertentu berdasarkan ID atau nama, atau menampilkan pemilih interaktif untuk memilih sesi. Sebagai pengganti ID, Anda dapat meneruskan path absolut ke file transkrip .jsonl sesi. Pemilih dan pencarian nama menyertakan sesi yang menambahkan direktori ini dengan /add-dir. Saat Anda meneruskan ID sesi, Claude Code mencari di direktori proyek saat ini dan git worktree-nya, lalu di setiap proyek lain di mesin ini. Sebelum v2.1.223, pencarian ID hanya mencakup direktori proyek saat ini dan git worktree-nya. Sesi latar belakang muncul di pemilih dengan tanda bg. Melanjutkan sesi yang masih berjalan akan membuka sesi tersebut di terminal ini melalui claude attach, dan prompt yang Anda teruskan di baris perintah dikirim ke sesi tersebut sebagai giliran berikutnya. Sebelum v2.1.285, Claude Code menolak dan mencetak perintah claude attach untuk dijalankan sebagai gantinya |
claude --resume auth-refactor |
--safe-mode |
Memulai dengan semua kustomisasi dinonaktifkan untuk memecahkan masalah konfigurasi yang rusak: CLAUDE.md, skill, plugin, hook, server MCP, perintah dan agent kustom, gaya output, workflow, tema kustom, pintasan keyboard kustom, perintah baris status dan saran file, server LSP, dan auto memory tidak dimuat. Autentikasi, pemilihan model, tool bawaan, dan izin berfungsi normal, yang berbeda dari --bare. Kebijakan pengaturan terkelola tetap berlaku, termasuk hook, baris status, dan perintah saran file yang dikonfigurasi kebijakan; plugin terkelola, skill terkelola, CLAUDE.md terkelola, dan server MCP yang dikonfigurasi kebijakan tidak berlaku. Berguna untuk memeriksa apakah suatu kustomisasi yang memicu fallback model otomatis. Mengatur CLAUDE_CODE_SAFE_MODE |
claude --safe-mode |
--session-id |
Menggunakan ID sesi tertentu untuk percakapan (harus berupa 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 agent view dan tim agent untuk sesi yang Anda mulai dari sesi ini yang mewarisi daftar tersebut |
claude --setting-sources user,project |
--settings |
Path ke file JSON pengaturan atau string JSON inline. Nilai yang Anda atur di sini menimpa kunci yang sama di file settings.json Anda untuk sesi ini. Kunci yang Anda hilangkan mempertahankan nilai berbasis filenya. File harus berupa file biasa yang tidak lebih besar dari 2 MiB. Lihat prioritas pengaturan |
claude --settings ./settings.json |
--strict-mcp-config |
Hanya menggunakan server MCP dari --mcp-config, mengabaikan semua konfigurasi MCP lainnya. Lihat Kontrol eksklusif dengan managed-mcp.json untuk apa yang dilakukan flag ini di bawah file MCP terkelola |
claude --strict-mcp-config --mcp-config ./mcp.json |
--system-prompt |
Mengganti seluruh system prompt dengan teks kustom | claude --system-prompt "You are a Python expert" |
--system-prompt-file |
Memuat system prompt dari file, menggantikan prompt default | claude --system-prompt-file ./custom-prompt.txt |
--system-prompt-snapshot |
Teruskan off untuk membangun ulang system prompt pada setiap permintaan alih-alih menggunakan kembali prompt yang direkam pada permintaan pertama percakapan, misalnya saat Anda melakukan iterasi pada teks --append-system-prompt di seluruh eksekusi --continue. Memerlukan Claude Code v2.1.257 atau yang lebih baru |
claude --system-prompt-snapshot off |
--teleport |
Melanjutkan sesi cloud di terminal lokal Anda | claude --teleport |
--teammate-mode |
Mengatur cara anggota tim agent ditampilkan: in-process (default), auto, tmux, atau iterm2. Menimpa pengaturan teammateMode untuk sesi ini. Lihat Memilih mode tampilan |
claude --teammate-mode auto |
--tmux |
Membuat sesi tmux untuk worktree. Memerlukan --worktree. Menggunakan panel native iTerm2 jika tersedia; teruskan --tmux=classic untuk tmux tradisional |
claude -w feature-auth --tmux |
--tools |
Membatasi tool bawaan mana yang dapat digunakan Claude. Gunakan "" untuk menonaktifkan semua, "default" untuk set default, atau nama tool seperti "Bash,Edit,Read". Di macOS, Linux, dan WSL, set default tidak menyertakan Glob dan Grep, seperti yang dijelaskan di perilaku tool Glob. Jika Anda menyebutkan salah satu tool pelacakan tugas di sini, Claude Code juga mengikutsertakan sesi tersebut. Flag ini tidak memengaruhi tool MCP; untuk menolak tool tersebut juga, gunakan --disallowedTools "mcp__*". Daftar yang tidak menyertakan EndConversation tidak menghapusnya; "" menghapusnya hanya jika tidak ada tool MCP yang tersisa |
claude --tools "Bash,Edit,Read" |
--verbose |
Mengaktifkan logging verbose, menampilkan output lengkap giliran demi giliran. Menimpa pengaturan viewMode untuk sesi ini |
claude --verbose |
--version, -v |
Menampilkan nomor versi | claude -v |
--worktree, -w |
Memulai Claude di git worktree terisolasi di <repo>/.claude/worktrees/<name>. Jika Anda tidak memberikan nama, Claude Code akan membuatnya. Teruskan #<number>, URL pull request GitHub, atau URL merge request GitLab untuk mengambil PR atau MR tersebut dari origin dan membuat branch worktree darinya. Membuat branch dari merge request GitLab memerlukan Claude Code v2.1.233 atau yang lebih baru |
claude -w feature-auth |
Flag system prompt
Claude Code menyediakan lima flag untuk menyesuaikan system prompt. Empat flag mengatur teksnya, dan dengan --system-prompt-snapshot Anda mengontrol apakah percakapan mempertahankan teks yang digunakan saat dimulai. Kelima flag berfungsi dalam mode interaktif maupun non-interaktif.
| Flag | Perilaku | Contoh |
|---|---|---|
--system-prompt |
Mengganti seluruh prompt default | claude --system-prompt "You are a Python expert" |
--system-prompt-file |
Mengganti dengan isi 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 isi file ke prompt default | claude --append-system-prompt-file ./style-rules.txt |
--system-prompt-snapshot |
Dengan off, membangun ulang prompt pada setiap permintaan. Dengan on, yang merupakan default, menggunakan kembali prompt yang direkam di mana perekaman 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 yang lebih baru, Anda juga dapat meneruskan sebuah flag bersama dengan bentuk file-nya 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 isi style.md, satu baris kosong, lalu Always reply in French. Isi file muncul lebih dulu meskipun Anda meneruskan --append-system-prompt sebelum --append-system-prompt-file.
Saat teks pengganti menggabungkan instruksi yang sama pada setiap eksekusi dengan konteks yang berubah per eksekusi, tambahkan baris yang hanya berisi __SYSTEM_PROMPT_DYNAMIC_BOUNDARY__ di antara instruksi dan konteks. Claude Code membagi prompt pada baris pertama seperti itu dan menghapus baris tersebut, sehingga bagian di atasnya tetap di-cache sementara bagian di bawahnya berubah. Memerlukan Claude Code v2.1.275 atau yang lebih baru. Cache bagian statis dari prompt kustom mencantumkan konfigurasi di mana pembagian ini berlaku.
Pilih berdasarkan apakah identitas default Claude Code masih sesuai dengan tugas Anda. Gunakan flag append saat Claude harus tetap menjadi asisten coding yang juga mengikuti aturan tambahan Anda: instruksi per pemanggilan, format output, atau konteks domain untuk skrip -p. Menambahkan mempertahankan panduan tool default, instruksi keamanan, dan konvensi coding, sehingga Anda hanya menyediakan apa yang berbeda. Gunakan flag pengganti saat surface, identitas, atau model izin berbeda dari Claude Code, seperti agent non-coding dalam pipeline yang tidak diawasi manusia. Mengganti menghilangkan seluruh prompt default, termasuk panduan tool dan instruksi keamanan, sehingga Anda bertanggung jawab atas apa pun yang masih dibutuhkan tugas Anda.
Untuk persona persisten yang dapat Anda ganti dan bagikan di seluruh proyek, gunakan gaya output. Untuk konvensi proyek yang harus selalu diikuti Claude, gunakan CLAUDE.md. Panduan Agent SDK tentang system prompt membahas keputusan yang sama secara lebih mendalam.
Flag system prompt dalam percakapan yang dilanjutkan
Secara default, Claude Code membangun system prompt sekali, pada permintaan pertama percakapan, dengan menerapkan teks dari flag system prompt apa pun, dan merekamnya dalam sesi. Hingga percakapan di-compact, setiap permintaan berikutnya menggunakan prompt yang direkam tersebut, termasuk setelah Anda kembali ke percakapan dengan --resume atau --continue. Jika Anda meneruskan teks flag system prompt yang berbeda, atau tidak meneruskannya sama sekali, pada peluncuran berikutnya, teks tersebut berlaku setelah percakapan di-compact atau saat Anda memulai percakapan baru.
Di luar sesi cloud, jika Anda memulai Claude Code dalam bare mode dengan meneruskan --bare atau mengatur CLAUDE_CODE_SIMPLE=1, perekaman tetap nonaktif kecuali Anda meneruskan --system-prompt-snapshot on. Sebelum v2.1.268, sesi yang tidak mengambil feature flag, termasuk sesi di Amazon Bedrock, Agent Platform Google Cloud, dan Microsoft Foundry, membangun ulang prompt pada setiap permintaan dan --system-prompt-snapshot tidak berpengaruh.
Untuk membangun ulang prompt pada setiap permintaan sebagai gantinya, misalnya saat Anda melakukan iterasi pada susunan katanya di seluruh eksekusi --continue, teruskan --system-prompt-snapshot off. Sebelum v2.1.265, meneruskan salah satu flag system prompt juga mematikan perekaman kecuali Anda meneruskan --system-prompt-snapshot on.
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