Software Development
Flag CLI Claude Code: Yang Layak Dihafal per Pekerjaan
Agustus 202613 menit baca
Jalankan secara non-interaktif dengan flag print lalu setel format keluarannya. JSON mengembalikan hasilnya, session ID, pemakaian dan biayanya sebagai satu objek; stream-json memancarkan tiap pesan saat terjadi, yang Anda inginkan untuk run panjang. Ada juga flag yang memvalidasi keluarannya terhadap JSON Schema yang Anda berikan.
Beri ia jumlah giliran agentic maksimum dan belanja dolar maksimum saat peluncuran. Keduanya menghentikan run-nya ketimbang membiarkannya berlanjut tanpa batas. Flag effort dan pilihan model mengubah biaya per giliran, dan jendela auto-compact menentukan kapan riwayat diringkas, yang mendorong sebagian besar pertumbuhan di sesi panjang.
Flag bare melewati penemuan otomatis hook, skill, command, subagent, plugin dan MCP server, jadi sesinya mulai minimal. Safe mode mulai dengan semua kustomisasi dimatikan untuk penelusuran masalah. Keduanya menghapus variabel ketika sesuatu berulah, dan keduanya langkah pertama yang lebih baik ketimbang menghapus konfigurasi yang nanti Anda inginkan kembali.
Pakai subcommand setup-token untuk menghasilkan token OAuth berumur panjang yang memang dimaksudkan untuk CI dan skrip, ketimbang menaruh API key di secret pipeline. Pasangkan dengan batas giliran dan plafon anggaran supaya run yang macet berakhir tenang, dan pertimbangkan strict MCP config supaya run-nya hanya memakai server yang Anda berikan.
Jalankan subcommand doctor lebih dulu. Ia mencetak diagnostik instalasi dan settings, termasuk file settings mana yang berlaku dan bagaimana hasilnya, yang menjawab sebagian besar pertanyaan konfigurasi langsung. Tambahkan flag debug, yang menerima filter kategori, dan sebuah path file debug supaya keluarannya bertahan melewati sesinya.
Ringkasan Utama
Sebagian besar permukaan CLI Claude Code layak diabaikan sampai Anda butuh, dan sekitar lima belas flag layak dipelajari dengan sengaja. Semuanya jatuh ke lima pekerjaan: membentuk apa itu sebuah sesi, membatasi apa yang bisa dijangkaunya, membuat keluaran non-interaktif bisa di-parse, membatasi berapa yang boleh dihabiskan sebuah run, dan mencari tahu kenapa sesuatu rusak.
Saya menghabiskan waktu yang memalukan untuk men-debug sebuah sesi yang terus memuat plugin yang sudah saya matikan di mana pun saya bisa pikirkan, sebelum tahu bahwa satu flag memulai Claude Code dengan semua kustomisasi mati. Tiga puluh detik membaca halaman rujukan akan menghemat satu jam, yang merupakan aritmetika biasa dengan alat baris perintah dan alasan tulisan ini ada.
Rujukan resminya mendaftar semuanya secara alfabetis, yang benar untuk sebuah rujukan dan salah untuk belajar. Tulisan ini mengelompokkan permukaan yang sama berdasarkan apa yang sedang Anda coba lakukan: subcommand yang orang tidak tahu ada, flag yang membentuk sebuah sesi, membuat run non-interaktif terbaca oleh skrip, membatasi apa yang boleh disentuh sebuah run, menghemat biaya, dan mendiagnosis instalasi yang rusak.
Claude Code bukan hanya sesi interaktifnya. Sekitar dua lusin subcommand duduk di sampingnya, dan beberapa menjawab pertanyaan yang biasanya orang selesaikan dengan menebak. Dua di antaranya layak dihafal sekarang: perintah diagnostiknya, yang mencetak keadaan instalasi dan settings Anda, serta perintah token, yang mencetak kredensial berumur panjang untuk CI supaya Anda tak pernah menaruh key mentah di pipeline.
claude doctor # installation + settings diagnostics
claude auth status # who am I signed in as, as JSON
claude setup-token # long-lived OAuth token for CI and scripts
claude import codex # bring config over from another agent
claude import gemini
claude project purge . # delete ALL local state for a project
claude update # update to latest
claude install [version] # install or reinstall the native binary
claude agents # agent view: monitor and dispatch
claude attach <id> # attach to a background session
claude logs <id> # recent output from one
claude stop <id> / claude respawn <id> / claude rm <id>
claude daemon status # background-session supervisor state
claude daemon stop --any
claude auto-mode defaults # print the built-in classifier as JSON
claude auto-mode reset
claude mcp / claude plugin # configure servers and plugins
claude ultrareview [target] # run a deep review non-interactivelyIni flag yang menentukan sesi itu apa sebelum ia mulai, dan mereka mengelompok rapi ke tiga pertanyaan: sesi ini apa, ia bisa menjangkau apa, dan ia bicara apa. Apa pun yang Anda setel di sini mengalahkan apa kata file settings, yang menjadikannya alat tepat untuk sekali pakai dan alat salah untuk kebiasaan — flag yang Anda ketik tiap kali seharusnya tinggal di file settings.
# What the session IS
--model opus | sonnet | haiku | fable | <full name>
--fallback-model <model> # when the primary is unavailable
--effort low|medium|high|xhigh|max|ultracode
--agent <name> # start as a subagent definition
--agents '<json>' # define subagents inline
--permission-mode plan|acceptEdits|auto|manual|…
--name auth-refactor # findable later
--session-id <uuid>
# What it can REACH
--add-dir ../shared-lib # extra working directories
--tools Read,Edit,Bash # restrict the built-in tools
--allowedTools / --disallowedTools
--mcp-config ./servers.json # plus --strict-mcp-config to use
# ONLY those servers
--plugin-dir ./my-plugin # load a plugin for this session
--settings ./ci-settings.json # path OR inline JSON
--setting-sources user,project,local
# What it SAYS
--system-prompt / --system-prompt-file # replace it
--append-system-prompt / --append-system-prompt-file
--append-subagent-system-promptSatu flag pantas diperingatkan khusus: yang melewati prompt izin sepenuhnya. Ia ada untuk kontainer dan sandbox yang radius ledaknya memang sudah terbatas, dan ia sungguh ide buruk di mesin yang menyimpan kredensial atau repository yang Anda pedulikan. Kerabatnya yang lebih aman cuma menambahkan mode bypass-nya ke siklus mode, jadi Anda bisa masuk ke sana dengan sengaja ketimbang memulai dari sana.
Mode non-interaktif adalah tempat CLI-nya mendapat tempatnya di sebuah pipeline, dan beda antara run yang berguna dan yang tak terbaca adalah empat flag. Keluaran teks polos tidak mencetak apa pun sampai run-nya berakhir, yang membuat run panjang tampak menggantung; format JSON streaming memancarkan tiap pesan saat terjadi. Dan ketika Anda mau hasilnya dalam bentuk yang bisa diandalkan skrip Anda, ada flag yang memvalidasi keluarannya terhadap sebuah JSON Schema.
# Four flags turn a run into something a script can read.
claude -p "summarize the diff" --output-format json
claude -p "…" --output-format stream-json --verbose
claude -p "…" --input-format stream-json
claude -p "…" --json-schema ./schema.json # validated output
claude -p "…" --include-partial-messages # token-level events
# Bound it before you automate it:
--max-turns 12 # stop after N agentic turns
--max-budget-usd 5 # stop at a dollar amount
--no-session-persistence # write nothing to disk
# For CI, mint a token instead of shipping an API key:
claude setup-tokenUntuk apa pun yang berjalan di CI, hasilkan token OAuth berumur panjang dengan subcommand token-nya ketimbang menaruh API key di sebuah secret. Cuma satu perintah, ia menghasilkan kredensial yang memang dimaksudkan persis untuk ini, dan artinya akses pipeline-nya bisa dicabut tanpa menyentuh apa pun yang lain. Pasangkan dengan batas giliran dan plafon dolar supaya run yang macet tidak berubah jadi tagihan.
Sistem izinnya yang mengangkat beban beratnya, tapi beberapa flag mempersempit sebuah run saat peluncuran, dan itu yang Anda mau untuk otomasi. Semuanya bisa digabung, dan tahu mana yang alat tumpul menyelamatkan Anda dari meraih yang tumpul lebih dulu.
Mempersempit sebuah run:
| Flag | Yang dilakukannya |
|---|---|
| Flag tools | Membatasi tool bawaan mana yang ada sama sekali untuk sesi itu — yang terkuat dari ketiganya, karena tool yang tidak ada tidak bisa diminta |
| Allowed dan disallowed tools | Tool yang di-allow-list berjalan tanpa prompt; aturan deny memblokirnya. Keduanya membentuk soal bertanya, bukan soal keberadaan |
| Flag permission mode | Memulai di plan, accept-edits, auto, manual atau mode lain, yang menentukan seberapa banyak yang ditanyakan sejak awal |
| Strict MCP config | Memakai hanya server dari config yang Anda berikan, mengabaikan semua yang dikonfigurasi di tempat lain — flag yang membuat run CI bisa direproduksi |
| Batas giliran dan anggaran | Jumlah giliran agentic maksimum dan belanja dolar maksimum. Keduanya cara run yang lepas kendali berakhir dengan tenang ketimbang dengan mahal |
Tiga tuas mengubah biaya lebih besar dari apa pun yang bisa Anda lakukan dari baris perintah, dan layak disetel dengan sengaja ketimbang menerima apa pun yang diberikan bawaannya:
Men-debug instalasi yang berulah sebagian besar soal menghapus variabel, dan ada dua flag untuk itu dengan perbedaan penting di antaranya. Satu melewati penemuan otomatis hook, skill, command, subagent, plugin dan MCP server. Satunya memulai dengan semua kustomisasi dimatikan untuk penelusuran masalah. Raih keduanya sebelum Anda mulai menghapus konfigurasi yang nanti Anda inginkan kembali.
Jalankan subcommand diagnostiknya lebih dulu, tiap kali. Ia mencetak dari mana binernya berasal, file settings mana yang berlaku dan hasil resolusinya — yang menjawab sebagian besar pertanyaan konfigurasi langsung dan mengubah sisanya jadi laporan bug yang jauh lebih baik. Pasangkan dengan flag debug, yang menerima filter kategori opsional, dan sebuah path file debug supaya keluarannya bertahan melewati sesinya.
Empat lagi layak dibaca sekali sekarang supaya Anda mengenalinya nanti, karena masing-masing adalah jawaban pertanyaan yang akhirnya akan Anda ajukan:
Pelajari subcommand diagnostik dan dua flag penelusuran masalahnya hari ini, karena keduanya mengubah sore yang membingungkan jadi jawaban lima menit. Taruh apa pun yang Anda ketik lebih dari dua kali ke sebuah file settings ketimbang ke riwayat shell Anda. Dan sebelum mengotomasi sebuah run, beri ia batas giliran dan plafon anggaran — bukan karena Anda mengira ia akan lepas kendali, tapi karena versi diri Anda yang men-debug tengah malam akan bersyukur mode gagalnya berupa run yang berhenti ketimbang sebuah kejutan.
Sumber & bacaan lanjutan