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 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. Lewatkan --permission-mode, --model, atau --effort untuk menetapkan default untuk sesi yang dikirim. Menerima --settings, --add-dir, --plugin-dir, dan --mcp-config seperti perintah claude tingkat atas. Memerlukan terminal interaktif |
claude agents --cwd ~/projects/my-app |
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 |
claude auto-mode defaults > rules.json |
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 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 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 | 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 | claude rm 7c5dcf5d |
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 |
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?.
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; sebagian besar konfigurasi .claude/ tidak ditemukan dari direktori ini. Memvalidasi setiap jalur ada sebagai direktori. Untuk mempertahankan direktori ini di seluruh sesi, atur permissions.additionalDirectories dalam pengaturan |
claude --add-dir ../apps ../lib |
--agent |
Tentukan agen untuk sesi saat ini (menimpa pengaturan agent) |
claude --agent my-custom-agent |
--agents |
Tentukan subagents kustom secara dinamis melalui JSON. Menggunakan nama field yang sama dengan frontmatter subagent, ditambah field prompt untuk instruksi agen |
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 |
Tools yang dieksekusi tanpa meminta izin. Lihat sintaks aturan izin untuk pencocokan pola. Untuk membatasi tools mana yang tersedia, gunakan --tools sebagai gantinya |
"Bash(git log *)" "Bash(git diff *)" "Read" |
--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 |
--bare |
Mode minimal: lewati penemuan otomatis hooks, skills, plugins, server MCP, auto memory, dan CLAUDE.md sehingga panggilan skrip dimulai lebih cepat. 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 |
Mulai sesi sebagai agen latar belakang dan kembali segera. Mencetak ID sesi dan perintah manajemen. Gabungkan dengan --agent untuk menjalankan subagent tertentu |
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 Claude.ai |
claude --channels plugin:my-notifier@my-marketplace |
--chrome |
Aktifkan integrasi browser Chrome untuk otomasi web dan pengujian | claude --chrome |
--continue, -c |
Muat percakapan terbaru di direktori saat ini. Mencakup sesi yang menambahkan direktori ini dengan /add-dir |
claude --continue |
--dangerously-load-development-channels |
Aktifkan channels 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 |
claude --dangerously-skip-permissions |
--debug |
Aktifkan mode debug dengan penyaringan kategori opsional (misalnya, "api,hooks" atau "!statsig,!file") |
claude --debug "api,mcp" |
--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 |
Tools yang dihapus dari konteks model dan tidak dapat digunakan | "Bash(git log *)" "Bash(git diff *)" "Edit" |
--effort |
Atur tingkat upaya untuk sesi saat ini. Opsi: low, medium, high, xhigh, max; tingkat yang tersedia tergantung pada model. Menimpa pengaturan effortLevel untuk sesi ini dan tidak bertahan |
claude --effort high |
--enable-auto-mode |
{/* max-version: 2.1.110 */}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 |
--exclude-dynamic-system-prompt-sections |
Pindahkan bagian per-mesin dari prompt sistem (direktori kerja, informasi lingkungan, jalur memori, status git) 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" |
--fallback-model |
Aktifkan fallback otomatis ke model yang ditentukan ketika model default kelebihan beban. Berlaku dalam mode cetak (-p) dan dalam sesi latar belakang, yang berjalan non-interaktif; diabaikan dalam sesi interaktif |
claude -p --fallback-model sonnet "query" |
--fork-session |
Saat melanjutkan, buat ID sesi baru alih-alih menggunakan kembali yang asli (gunakan dengan --resume atau --continue) |
claude --resume abc123 --fork-session |
--from-pr |
Lanjutkan 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 semua peristiwa siklus hidup hook dalam aliran output. Memerlukan --output-format stream-json |
claude -p --output-format stream-json --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 --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 -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) | 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 | claude -p --max-turns 3 "query" |
--mcp-config |
Muat server MCP dari file JSON atau string (dipisahkan spasi) | claude --mcp-config ./mcp.json |
--model |
Menetapkan model untuk sesi saat ini dengan alias untuk model terbaru (sonnet atau opus) atau nama lengkap model. Menimpa pengaturan model dan ANTHROPIC_MODEL |
claude --model claude-sonnet-4-6 |
--name, -n |
Atur nama tampilan untuk sesi, ditampilkan di /resume dan judul terminal. Anda dapat melanjutkan sesi bernama dengan claude --resume <name>. /rename mengubah nama di tengah sesi dan juga menampilkannya di bilah prompt |
claude -n "my-feature-work" |
--no-chrome |
Nonaktifkan integrasi browser Chrome untuk sesi ini | claude --no-chrome |
--no-session-persistence |
Nonaktifkan persistensi sesi sehingga sesi tidak disimpan ke disk dan tidak dapat dilanjutkan. Mode cetak saja. Variabel lingkungan CLAUDE_CODE_SKIP_PROMPT_HISTORY melakukan hal yang sama dalam mode apa pun |
claude -p --no-session-persistence "query" |
--output-format |
Tentukan format output untuk mode cetak (opsi: text, json, stream-json) |
claude -p "query" --output-format json |
--permission-mode |
Mulai dalam mode izin yang ditentukan. Menerima default, acceptEdits, plan, auto, dontAsk, atau bypassPermissions. Menimpa defaultMode dari file pengaturan |
claude --permission-mode plan |
--permission-prompt-tool |
Tentukan tool MCP untuk menangani prompt izin dalam mode non-interaktif | claude -p --permission-prompt-tool mcp_auth_tool "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" |
--remote |
Buat sesi web baru di claude.ai dengan deskripsi tugas yang disediakan | 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 --replay-user-messages |
--resume, -r |
Lanjutkan sesi tertentu berdasarkan ID atau nama, atau tampilkan pemilih interaktif untuk memilih sesi. Mencakup sesi yang menambahkan direktori ini dengan /add-dir |
claude --resume auth-refactor |
--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. Lihat precedence pengaturan |
claude --settings ./settings.json |
--strict-mcp-config |
Hanya gunakan server MCP dari --mcp-config, abaikan semua konfigurasi MCP lainnya |
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: auto (default), in-process, atau tmux. Menimpa pengaturan teammateMode untuk sesi ini. Lihat Pilih mode tampilan |
claude --teammate-mode in-process |
--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" |
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 tidak ada nama yang diberikan, satu akan dibuat secara otomatis. Berikan #<number> atau URL pull request GitHub untuk mengambil PR itu dari origin dan membuat cabang worktree darinya |
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