Claude Code CLI: Referensi Teknis Definitif

Diperbarui 12 Desember 2025

Pembaruan Desember 2025: Claude Code kini mendukung alur kerja engineering enterprise dengan kemampuan editing multi-file berbasis agen, integrasi protokol MCP dengan 300+ layanan eksternal, subagent khusus untuk tugas kompleks, dan sistem hooks untuk otomatisasi CI/CD. Sistem permission memungkinkan kontrol keamanan yang detail. Perpindahan model antara Haiku (cepat/murah) dan Opus (powerful) mengoptimalkan pertukaran biaya-performa.

Saya telah menghabiskan berbulan-bulan mendorong Claude Code hingga batasnya di berbagai codebase produksi, pipeline CI/CD, dan deployment enterprise. Panduan ini menyaring pengalaman tersebut menjadi referensi komprehensif yang saya harapkan ada saat pertama kali memulai. Panduan ini mencakup segalanya mulai dari instalasi pertama hingga pola-pola lanjutan yang tidak pernah ditemukan sebagian besar pengguna.

Claude Code bukan sekadar antarmuka chat yang kebetulan memahami pemrograman. Ini adalah sistem berbasis agen yang membaca codebase Anda, mengeksekusi perintah, memodifikasi file, mengelola alur kerja git, terhubung ke layanan eksternal, dan mendelegasikan tugas kompleks ke subagent khusus—semuanya melalui antarmuka command-line yang terintegrasi dengan cara kerja developer sebenarnya.

Perbedaan antara menggunakan Claude Code secara kasual dan menggunakannya secara efektif adalah memahami arsitekturnya: hierarki konfigurasi yang mengontrol perilaku, sistem permission yang mengatur operasi, sistem hook yang memungkinkan otomatisasi deterministik, protokol MCP yang memperluas kapabilitas, dan sistem subagent yang menangani tugas multi-langkah yang kompleks. Kuasai sistem-sistem ini dan Claude Code menjadi pengali kekuatan. Lewatkan dan Anda meninggalkan sebagian besar nilainya di atas meja.

Panduan ini mengasumsikan Anda nyaman dengan tool command-line dan menginginkan gambaran lengkap. Setiap fitur didokumentasikan dengan sintaks aktual, contoh konfigurasi nyata, dan kasus-kasus edge yang menjebak pengguna berpengalaman. Baik Anda menyiapkan proyek pertama atau melakukan deployment di seluruh organisasi engineering enterprise, informasinya ada di sini.

Cara Kerja Claude Code: Model Mental

Sebelum mendalami fitur, pahami bagaimana arsitektur Claude Code membentuk semua yang Anda lakukan dengannya. Sistem beroperasi dalam tiga lapisan:

┌─────────────────────────────────────────────────────────┐
│                    LAPISAN CLAUDE CODE                   │
├─────────────────────────────────────────────────────────┤
│  LAPISAN EKSTENSI                                        │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐    │
│  │   MCP   │  │  Hooks  │  │ Skills  │  │ Plugins │    │
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘    │
│  Tool eksternal, otomatisasi deterministik, keahlian    │
│  domain, ekstensi terkemas                               │
├─────────────────────────────────────────────────────────┤
│  LAPISAN DELEGASI                                        │
│  ┌─────────────────────────────────────────────────┐    │
│  │              Subagent (hingga 10 paralel)        │    │
│  │   Explore | Plan | General-purpose | Custom      │    │
│  └─────────────────────────────────────────────────┘    │
│  Konteks terisolasi untuk kerja terfokus, return summary│
├─────────────────────────────────────────────────────────┤
│  LAPISAN INTI                                            │
│  ┌─────────────────────────────────────────────────┐    │
│  │         Konteks Percakapan Utama                 │    │
│  │   Tools: Read, Edit, Bash, Glob, Grep, dll.     │    │
│  └─────────────────────────────────────────────────┘    │
│  Interaksi utama Anda; konteks terbatas; berbayar       │
└─────────────────────────────────────────────────────────┘

Lapisan Inti: Percakapan utama Anda. Setiap pesan, pembacaan file, dan output tool mengonsumsi konteks dari window 200K token bersama (1M dengan premium). Ketika konteks penuh, Claude kehilangan jejak keputusan sebelumnya dan kualitas menurun. Lapisan ini berbayar per token.

Lapisan Delegasi: Subagent muncul dengan konteks bersih, melakukan kerja terfokus, dan mengembalikan ringkasan. Hasil eksplorasi tidak membengkakkan percakapan utama Anda—hanya kesimpulan yang kembali. Gunakan subagent Haiku untuk eksplorasi (murah, cepat) dan Sonnet untuk implementasi.

Lapisan Ekstensi: MCP menghubungkan layanan eksternal (database, GitHub, Sentry). Hooks menjamin eksekusi perintah shell terlepas dari perilaku model. Skills mengkodekan keahlian domain yang diterapkan Claude secara otomatis. Plugins mengemas semua ini untuk distribusi.

Insight kunci: Sebagian besar pengguna bekerja sepenuhnya di Lapisan Inti, menyaksikan konteks membengkak dan biaya naik. Power user mendorong eksplorasi dan kerja khusus ke Lapisan Delegasi, menjaga Lapisan Ekstensi terkonfigurasi untuk alur kerja mereka, dan menggunakan Lapisan Inti hanya untuk orkestrasi dan keputusan akhir.

Daftar Isi

1. Instalasi dan Autentikasi
2. Mode Interaksi Inti
3. Pendalaman Sistem Konfigurasi
4. Pemilihan dan Perpindahan Model
5. Sistem Permission dan Keamanan
6. Sistem Hooks
7. MCP (Model Context Protocol)
8. Subagent dan Delegasi Tugas
9. Mode Extended Thinking
10. Gaya Output
11. Slash Commands
12. Skills
13. Sistem Plugin
14. Memory dan Manajemen Konteks
15. Input Gambar dan Multimodal
16. Integrasi Git dan Alur Kerja
17. Integrasi IDE
18. Pola Penggunaan Lanjutan
19. Claude Code Remote
20. Background Agents
21. Manajemen Biaya dan Billing
22. Optimasi Performa
23. Troubleshooting dan Debugging
24. Deployment Enterprise
25. Referensi Keyboard Shortcuts
26. Best Practices

Instalasi dan Autentikasi

Persyaratan Sistem

Claude Code berjalan di macOS 10.15+, Ubuntu 20.04+/Debian 10+, dan Windows 10+ melalui WSL atau Git Bash. Sistem membutuhkan minimal 4 GB RAM dan koneksi internet aktif. Kompatibilitas shell paling baik dengan Bash, Zsh, atau Fish.

Untuk Windows, baik WSL 1 maupun WSL 2 berfungsi. Git Bash juga berfungsi jika Anda lebih suka Windows native. Alpine Linux dan sistem berbasis musl lainnya memerlukan paket tambahan:

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0

Metode Instalasi

Instalasi native (direkomendasikan)

Binary native memberikan pengalaman paling bersih tanpa dependensi Node.js:

# macOS dan Linux
curl -fsSL https://claude.ai/install.sh | bash

# Alternatif Homebrew
brew install --cask claude-code

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Untuk instalasi versi spesifik:

# Install versi spesifik
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

# Install latest secara eksplisit
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Windows PowerShell - versi spesifik
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

Instalasi NPM

Untuk environment yang lebih memilih npm:

npm install -g @anthropic-ai/claude-code

Jangan pernah gunakan sudo dengan instalasi npm—ini menciptakan masalah permission yang mempersulit semuanya di kemudian hari.

Migrasi dari instalasi existing

Jika Anda memiliki instalasi berbasis npm yang lebih lama, migrasi ke binary native:

claude install

Opsi Autentikasi

Claude Code mendukung tiga jalur autentikasi, masing-masing dengan tradeoff berbeda:

Claude Console (API billing)

Terhubung ke API Anthropic langsung melalui console.anthropic.com. Buat akun, siapkan billing, dan autentikasi melalui CLI. Ini menyediakan billing berbasis penggunaan dengan akses API penuh. Workspace "Claude Code" khusus dibuat secara otomatis—Anda tidak dapat membuat API key untuk workspace ini, tetapi Anda dapat memantau penggunaan.

Langganan Claude Pro atau Max

Gunakan kredensial akun claude.ai Anda. Langganan mencakup antarmuka web dan penggunaan CLI dalam satu paket bulanan. Ini menyederhanakan billing untuk pengguna individu yang menginginkan biaya yang dapat diprediksi.

Platform enterprise

AWS Bedrock, Google Vertex AI, dan Microsoft Foundry masing-masing menyediakan akses tingkat enterprise dengan hubungan billing cloud yang sudah ada:

# AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_PROFILE=your-profile

# Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project

# Microsoft Foundry
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource-name
# Opsional: auth API key (jika tidak menggunakan Entra ID)
export ANTHROPIC_FOUNDRY_API_KEY=your-key

Untuk deployment enterprise di belakang proxy atau melalui LLM gateway:

# Corporate proxy
export HTTPS_PROXY='https://proxy.example.com:8080'

# LLM gateway (skip native auth)
export CLAUDE_CODE_USE_BEDROCK=1
export ANTHROPIC_BEDROCK_BASE_URL='https://your-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1

Verifikasi

claude doctor

Ini melaporkan tipe instalasi, versi, konfigurasi sistem, dan masalah yang terdeteksi.

Pembaruan

Claude Code melakukan auto-update secara default, memeriksa saat startup dan secara berkala selama sesi. Pembaruan diunduh di background dan diterapkan pada peluncuran berikutnya.

Menonaktifkan auto-update:

export DISABLE_AUTOUPDATER=1

Atau di settings.json:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Pembaruan manual:

claude update

Penghapusan Instalasi

Instalasi native (macOS/Linux/WSL):

rm -f ~/.local/bin/claude
rm -rf ~/.claude-code

Instalasi native (Windows PowerShell):

Remove-Item -Path "$env:LOCALAPPDATA\Programs\claude-code" -Recurse -Force
Remove-Item -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\claude.exe" -Force

Membersihkan konfigurasi (menghapus semua pengaturan):

rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude
rm -f .mcp.json

Mode Interaksi Inti

REPL Interaktif

Jalankan Claude Code tanpa argumen untuk masuk ke read-eval-print loop interaktif:

cd your-project
claude

REPL mempertahankan konteks percakapan antar giliran. Ketik query langsung, terima respons, dan lanjutkan sampai Anda keluar dengan /exit atau Ctrl+D.

Mulai dengan prompt awal untuk memfokuskan sesi:

claude "jelaskan alur autentikasi di proyek ini"

Tips expert: REPL mempertahankan state di seluruh event compaction. Ketika konteks tumbuh terlalu besar, Claude secara otomatis merangkum percakapan lama sambil mempertahankan keputusan kunci dan snippet kode. Anda dapat memicu ini secara manual dengan /compact atau menambahkan instruksi kustom untuk apa yang harus dipertahankan.

Mode Non-Interaktif

Mode print (-p) mengeksekusi query tunggal dan keluar:

# Query langsung
claude -p "daftar semua komentar TODO di proyek ini"

# Memproses input yang di-pipe
cat error.log | claude -p "identifikasi akar penyebab kegagalan ini"

# Rangkai dengan tool lain
claude -p "generate README" > README.md

Untuk output terstruktur yang cocok untuk parsing dalam script:

claude -p "hitung baris berdasarkan tipe file" --output-format json

Output JSON mencakup semua yang Anda butuhkan untuk otomatisasi:

{
  "type": "result",
  "subtype": "success",
  "total_cost_usd": 0.0034,
  "is_error": false,
  "duration_ms": 2847,
  "duration_api_ms": 1923,
  "num_turns": 4,
  "result": "Teks respons di sini...",
  "session_id": "abc-123-d

[Konten dipotong untuk terjemahan]