Ikhtisar Claude Code

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

Claude Code adalah alat pengkodean agentic yang berada di terminal Anda, memahami basis kode Anda, dan membantu Anda mengkode lebih cepat melalui perintah bahasa alami. Dengan berintegrasi langsung dengan lingkungan pengembangan Anda, Claude Code memperlancar alur kerja Anda tanpa memerlukan server tambahan atau pengaturan yang rumit.

Kemampuan utama Claude Code meliputi:

• Mengedit file dan memperbaiki bug di seluruh basis kode Anda
• Menjawab pertanyaan tentang arsitektur dan logika kode Anda
• Menjalankan dan memperbaiki pengujian, linting, dan perintah lainnya
• Mencari melalui riwayat git, menyelesaikan konflik penggabungan, dan membuat commit dan PR

​

Sebelum Anda memulai

​

Periksa persyaratan sistem

• Sistem Operasi: macOS 10.15+, Ubuntu 20.04+/Debian 10+, atau Windows melalui WSL
• Perangkat Keras: Minimum RAM 4GB
• Perangkat Lunak:
  • Node.js 18+
  • git 2.23+ (opsional)
  • GitHub atau GitLab CLI untuk alur kerja PR (opsional)
  • ripgrep (rg) untuk pencarian file yang ditingkatkan (opsional)
• Jaringan: Koneksi internet diperlukan untuk autentikasi dan pemrosesan AI
• Lokasi: Hanya tersedia di negara yang didukung

​

Instal dan autentikasi

​

Fitur utama dan alur kerja

Claude Code beroperasi langsung di terminal Anda, memahami konteks proyek Anda dan mengambil tindakan nyata. Tidak perlu menambahkan file ke konteks secara manual - Claude akan menjelajahi basis kode Anda sesuai kebutuhan. Claude Code menggunakan claude-3-7-sonnet-20250219 secara default.

​

Keamanan dan privasi berdasarkan desain

Keamanan kode Anda adalah yang terpenting. Arsitektur Claude Code memastikan:

• Koneksi API langsung: Kueri Anda langsung ke API Anthropic tanpa server perantara
• Bekerja di tempat Anda bekerja: Beroperasi langsung di terminal Anda
• Memahami konteks: Mempertahankan kesadaran akan seluruh struktur proyek Anda
• Mengambil tindakan: Melakukan operasi nyata seperti mengedit file dan membuat commit

​

Dari pertanyaan ke solusi dalam hitungan detik

# Ajukan pertanyaan tentang basis kode Anda
claude
> bagaimana sistem autentikasi kita bekerja?

# Buat commit dengan satu perintah
claude commit

# Perbaiki masalah di beberapa file
claude "perbaiki kesalahan tipe di modul auth"

​

Inisialisasi proyek Anda

Untuk pengguna pertama kali, kami merekomendasikan:

1. Mulai Claude Code dengan claude
2. Coba perintah sederhana seperti ringkaskan proyek ini
3. Buat panduan proyek CLAUDE.md dengan /init
4. Minta Claude untuk melakukan commit file CLAUDE.md yang dihasilkan ke repositori Anda

​

Gunakan Claude Code untuk tugas umum

Claude Code beroperasi langsung di terminal Anda, memahami konteks proyek Anda dan mengambil tindakan nyata. Tidak perlu menambahkan file ke konteks secara manual - Claude akan menjelajahi basis kode Anda sesuai kebutuhan.

​

Memahami kode yang tidak familiar

> apa yang dilakukan sistem pemrosesan pembayaran?
> temukan di mana izin pengguna diperiksa
> jelaskan bagaimana lapisan caching bekerja

​

Mengotomatisasi operasi Git

> commit perubahan saya
> buat pr
> commit mana yang menambahkan pengujian untuk markdown pada Desember lalu?
> rebase ke main dan selesaikan konflik penggabungan

​

Mengedit kode secara cerdas

> tambahkan validasi input ke formulir pendaftaran
> refaktor logger untuk menggunakan API baru
> perbaiki race condition di antrian worker

​

Menguji dan debug kode Anda

> jalankan pengujian untuk modul auth dan perbaiki kegagalan
> temukan dan perbaiki kerentanan keamanan
> jelaskan mengapa pengujian ini gagal

​

Mendorong pemikiran lebih dalam

Untuk masalah kompleks, secara eksplisit minta Claude untuk berpikir lebih dalam:

> pikirkan bagaimana kita harus merancang layanan pembayaran baru
> pikirkan dengan keras tentang kasus-kasus tepi dalam alur autentikasi kita

Claude Code akan menunjukkan ketika Claude (3.7 Sonnet) menggunakan pemikiran yang diperpanjang. Anda dapat secara proaktif meminta Claude untuk “berpikir” atau “berpikir dalam” untuk tugas yang lebih intensif perencanaan. Kami menyarankan agar Anda terlebih dahulu memberi tahu Claude tentang tugas Anda dan biarkan ia mengumpulkan konteks dari proyek Anda. Kemudian, minta ia untuk “berpikir” untuk membuat rencana.

​

Mengotomatisasi alur kerja CI dan infrastruktur

Claude Code hadir dengan mode non-interaktif untuk eksekusi tanpa kepala. Ini sangat berguna untuk menjalankan Claude Code dalam konteks non-interaktif seperti skrip, pipeline, dan Github Actions.

Gunakan --print (-p) untuk menjalankan Claude dalam mode non-interaktif. Dalam mode ini, Anda dapat mengatur variabel lingkungan ANTHROPIC_API_KEY untuk menyediakan kunci API kustom.

Mode non-interaktif sangat berguna ketika Anda mengkonfigurasi sebelumnya set perintah yang diizinkan Claude untuk digunakan:

export ANTHROPIC_API_KEY=sk_...
claude -p "perbarui README dengan perubahan terbaru" --allowedTools "Bash(git diff:*)" "Bash(git log:*)" Edit

​

Kontrol Claude Code dengan perintah

​

Perintah CLI

Flag CLI:

• --print: Cetak respons tanpa mode interaktif
• --verbose: Aktifkan logging verbose
• --dangerously-skip-permissions: Lewati prompt perizinan (hanya dalam kontainer Docker tanpa internet)

​

Perintah garis miring

Kontrol perilaku Claude dalam sesi:

​

Kelola perizinan dan keamanan

Claude Code menggunakan sistem perizinan bertingkat untuk menyeimbangkan kekuatan dan keamanan:

​

Alat yang tersedia untuk Claude

Claude Code memiliki akses ke serangkaian alat yang kuat yang membantunya memahami dan memodifikasi basis kode Anda:

​

Lindungi dari injeksi prompt

Injeksi prompt adalah teknik di mana penyerang mencoba mengesampingkan atau memanipulasi instruksi asisten AI dengan menyisipkan teks berbahaya. Claude Code mencakup beberapa pengamanan terhadap serangan ini:

• Sistem perizinan: Operasi sensitif memerlukan persetujuan eksplisit
• Analisis sadar konteks: Mendeteksi instruksi yang berpotensi berbahaya dengan menganalisis permintaan lengkap
• Sanitasi input: Mencegah injeksi perintah dengan memproses input pengguna
• Daftar blokir perintah: Memblokir perintah berisiko yang mengambil konten sembarangan dari web seperti curl dan wget

Praktik terbaik untuk bekerja dengan konten yang tidak dipercaya:

1. Tinjau perintah yang disarankan sebelum persetujuan
2. Hindari meng-pipe konten yang tidak dipercaya langsung ke Claude
3. Verifikasi perubahan yang diusulkan ke file kritis
4. Laporkan perilaku mencurigakan dengan /bug

​

Konfigurasi akses jaringan

Claude Code memerlukan akses ke:

• api.anthropic.com
• statsig.anthropic.com
• sentry.io

Daftar putih URL ini saat menggunakan Claude Code di lingkungan terkontainer.

​

Konfigurasi Claude Code

Konfigurasi Claude Code dengan menjalankan claude config di terminal Anda, atau perintah /config saat menggunakan REPL interaktif.

​

Opsi konfigurasi

Claude Code mendukung konfigurasi global dan tingkat proyek.

Untuk mengelola konfigurasi Anda, gunakan perintah berikut:

• Daftar pengaturan: claude config list
• Lihat pengaturan: claude config get <kunci>
• Ubah pengaturan: claude config set <kunci> <nilai>
• Tambahkan ke pengaturan (untuk daftar): claude config add <kunci> <nilai>
• Hapus dari pengaturan (untuk daftar): claude config remove <kunci> <nilai>

Secara default config mengubah konfigurasi proyek Anda. Untuk mengelola konfigurasi global Anda, gunakan flag --global (atau -g).

​

Konfigurasi global

Untuk mengatur konfigurasi global, gunakan claude config set -g <kunci> <nilai>:

​

Opsi perizinan auto-updater

Ketika Claude Code mendeteksi bahwa tidak memiliki izin yang cukup untuk menulis ke direktori prefix npm global Anda (diperlukan untuk pembaruan otomatis), Anda akan melihat peringatan yang mengarahkan ke halaman dokumentasi ini. Untuk solusi detail masalah auto-updater, lihat panduan pemecahan masalah.

​

Direkomendasikan: Buat prefix npm baru yang dapat ditulis pengguna

# Pertama, simpan daftar paket global yang ada untuk migrasi nanti
npm list -g --depth=0 > ~/npm-global-packages.txt

# Buat direktori untuk paket global Anda
mkdir -p ~/.npm-global

# Konfigurasi npm untuk menggunakan path direktori baru
npm config set prefix ~/.npm-global

# Catatan: Ganti ~/.bashrc dengan ~/.zshrc, ~/.profile, atau file yang sesuai untuk shell Anda
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# Terapkan pengaturan PATH baru
source ~/.bashrc

# Sekarang instal ulang Claude Code di lokasi baru
npm install -g @anthropic-ai/claude-code

# Opsional: Instal ulang paket global Anda sebelumnya di lokasi baru
# Lihat ~/npm-global-packages.txt dan instal paket yang ingin Anda pertahankan
# npm install -g paket1 paket2 paket3...

Mengapa kami merekomendasikan opsi ini:

• Menghindari memodifikasi perizinan direktori sistem
• Membuat lokasi khusus yang bersih untuk paket npm global Anda
• Mengikuti praktik terbaik keamanan

Karena Claude Code sedang aktif dikembangkan, kami merekomendasikan untuk mengatur pembaruan otomatis menggunakan opsi yang direkomendasikan di atas.

​

Menonaktifkan auto-updater

Jika Anda lebih suka menonaktifkan auto-updater daripada memperbaiki perizinan, Anda dapat menggunakan:

claude config set -g autoUpdaterStatus disabled

​

Konfigurasi proyek

Kelola konfigurasi proyek dengan claude config set <kunci> <nilai> (tanpa flag -g):

Contoh:

# Biarkan npm test berjalan tanpa persetujuan
claude config add allowedTools "Bash(npm test)"

# Biarkan npm test dan sub-perintahnya berjalan tanpa persetujuan
claude config add allowedTools "Bash(npm test:*)"

# Instruksikan Claude untuk mengabaikan node_modules
claude config add ignorePatterns node_modules
claude config add ignorePatterns "node_modules/**"

​

Optimalkan pengaturan terminal Anda

Claude Code bekerja paling baik ketika terminal Anda dikonfigurasi dengan benar. Ikuti panduan ini untuk mengoptimalkan pengalaman Anda.

Shell yang didukung:

• Bash
• Zsh
• Fish

​

Tema dan tampilan

Claude tidak dapat mengontrol tema terminal Anda. Itu ditangani oleh aplikasi terminal Anda. Anda dapat mencocokkan tema Claude Code dengan terminal Anda selama onboarding atau kapan saja melalui perintah /config

​

Baris baru

Anda memiliki beberapa opsi untuk memasukkan baris baru ke Claude Code:

• Escape cepat: Ketik \ diikuti dengan Enter untuk membuat baris baru
• Pintasan keyboard: Tekan Option+Enter (Meta+Enter) dengan konfigurasi yang tepat

Untuk mengatur Option+Enter di terminal Anda:

Untuk Mac Terminal.app:

1. Buka Settings → Profiles → Keyboard
2. Centang “Use Option as Meta Key”

Untuk iTerm2 dan terminal VSCode:

1. Buka Settings → Profiles → Keys
2. Di bawah General, atur Left/Right Option key ke “Esc+”

Tip untuk pengguna iTerm2 dan VSCode: Jalankan /terminal-setup dalam Claude Code untuk secara otomatis mengkonfigurasi Shift+Enter sebagai alternatif yang lebih intuitif.

​

Pengaturan notifikasi

Jangan pernah melewatkan ketika Claude menyelesaikan tugas dengan konfigurasi notifikasi yang tepat:

Notifikasi bel terminal

Aktifkan peringatan suara ketika tugas selesai:

claude config set --global preferredNotifChannel terminal_bell

Untuk pengguna macOS: Jangan lupa untuk mengaktifkan izin notifikasi di System Settings → Notifications → [Aplikasi Terminal Anda].

Notifikasi sistem iTerm 2

Untuk peringatan iTerm 2 ketika tugas selesai:

1. Buka Preferensi iTerm 2
2. Navigasi ke Profiles → Terminal
3. Aktifkan “Silence bell” dan “Send notification when idle”
4. Atur penundaan notifikasi yang Anda inginkan

Perhatikan bahwa notifikasi ini khusus untuk iTerm 2 dan tidak tersedia di Terminal macOS default.

​

Menangani input besar

Saat bekerja dengan kode atau instruksi yang panjang:

• Hindari penempelan langsung: Claude Code mungkin kesulitan dengan konten yang ditempel sangat panjang
• Gunakan alur kerja berbasis file: Tulis konten ke file dan minta Claude untuk membacanya
• Sadar akan keterbatasan VS Code: Terminal VS Code sangat rentan terhadap pemotongan tempel panjang

Dengan mengkonfigurasi pengaturan ini, Anda akan menciptakan alur kerja yang lebih lancar dan efisien dengan Claude Code.

​

Kelola biaya secara efektif

Claude Code mengkonsumsi token untuk setiap interaksi. Penggunaan tipikal berkisar dari $5-10 per pengembang per hari, tetapi dapat melebihi $100 per jam selama penggunaan intensif.

​

Lacak biaya Anda

• Gunakan /cost untuk melihat penggunaan sesi saat ini
• Tinjau ringkasan biaya yang ditampilkan saat keluar
• Periksa penggunaan historis di Anthropic Console
• Atur Batas Pengeluaran

​

Kurangi penggunaan token

• Padatkan percakapan: Gunakan /compact ketika konteks menjadi besar
• Tulis kueri spesifik: Hindari permintaan samar yang memicu pemindaian yang tidak perlu
• Pecah tugas kompleks: Pisahkan tugas besar menjadi interaksi yang terfokus
• Bersihkan riwayat antar tugas: Gunakan /clear untuk mengatur ulang konteks

Biaya dapat bervariasi secara signifikan berdasarkan:

• Ukuran basis kode yang dianalisis
• Kompleksitas kueri
• Jumlah file yang dicari atau dimodifikasi
• Panjang riwayat percakapan
• Frekuensi pemadatan percakapan

​

Gunakan dengan API pihak ketiga

​

Hubungkan ke Amazon Bedrock

CLAUDE_CODE_USE_BEDROCK=1

Jika Anda ingin mengganti model default, Anda dapat menggunakan variabel lingkungan ANTHROPIC_MODEL (Claude 3.7 Sonnet digunakan secara default):

ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

Jika Anda ingin mengakses Claude Code melalui proxy, Anda dapat menggunakan variabel lingkungan ANTHROPIC_BEDROCK_BASE_URL:

ANTHROPIC_BEDROCK_BASE_URL='https://your-proxy-url'

Jika Anda tidak memiliki caching prompt yang diaktifkan, juga atur:

DISABLE_PROMPT_CACHING=1

Memerlukan kredensial AWS SDK standar (misalnya, ~/.aws/credentials atau variabel lingkungan yang relevan seperti AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY). Untuk mengatur kredensial AWS, jalankan:

aws configure

Hubungi Amazon Bedrock untuk caching prompt untuk biaya yang lebih rendah dan batas rate yang lebih tinggi.

​

Hubungkan ke Google Vertex AI

CLAUDE_CODE_USE_VERTEX=1
CLOUD_ML_REGION=us-east5
ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

Jika Anda ingin mengganti model default, Anda dapat menggunakan variabel lingkungan ANTHROPIC_MODEL (Claude 3.7 Sonnet digunakan secara default):

ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

Jika Anda ingin mengakses Claude Code melalui proxy, Anda dapat menggunakan variabel lingkungan ANTHROPIC_VERTEX_BASE_URL:

ANTHROPIC_VERTEX_BASE_URL='https://your-proxy-url'

Jika Anda tidak memiliki caching prompt yang diaktifkan, juga atur:

DISABLE_PROMPT_CACHING=1

Memerlukan kredensial GCP standar yang dikonfigurasi melalui google-auth-library. Untuk mengatur kredensial GCP, jalankan:

gcloud auth application-default login

Untuk pengalaman terbaik, hubungi Google untuk batas rate yang lebih tinggi.

​

Referensi implementasi kontainer pengembangan

Claude Code menyediakan konfigurasi kontainer pengembangan untuk tim yang membutuhkan lingkungan yang konsisten dan aman. Pengaturan devcontainer yang telah dikonfigurasi sebelumnya ini bekerja dengan mulus dengan ekstensi Remote - Containers VS Code dan alat serupa.

Langkah-langkah keamanan yang ditingkatkan kontainer (isolasi dan aturan firewall) memungkinkan Anda menjalankan claude --dangerously-skip-permissions untuk melewati prompt perizinan untuk operasi tanpa pengawasan. Kami telah menyertakan implementasi referensi yang dapat Anda sesuaikan untuk kebutuhan Anda.

​

Fitur utama

• Node.js siap produksi: Dibangun di atas Node.js 20 dengan dependensi pengembangan penting
• Keamanan berdasarkan desain: Firewall kustom membatasi akses jaringan hanya ke layanan yang diperlukan
• Alat ramah pengembang: Termasuk git, ZSH dengan peningkatan produktivitas, fzf, dan lainnya
• Integrasi VS Code yang mulus: Ekstensi dan pengaturan yang telah dikonfigurasi sebelumnya
• Persistensi sesi: Mempertahankan riwayat perintah dan konfigurasi antara restart kontainer
• Bekerja di mana saja: Kompatibel dengan lingkungan pengembangan macOS, Windows, dan Linux

​

Memulai dalam 4 langkah

1. Instal VS Code dan ekstensi Remote - Containers
2. Klon repositori implementasi referensi Claude Code
3. Buka repositori di VS Code
4. Saat diminta, klik “Reopen in Container” (atau gunakan Command Palette: Cmd+Shift+P → “Remote-Containers: Reopen in Container”)

​

Rincian konfigurasi

Pengaturan devcontainer terdiri dari tiga komponen utama:

• devcontainer.json: Mengontrol pengaturan kontainer, ekstensi, dan mount volume
• Dockerfile: Mendefinisikan image kontainer dan alat yang diinstal
• init-firewall.sh: Menetapkan aturan keamanan jaringan

​

Fitur keamanan

Kontainer menerapkan pendekatan keamanan multi-lapis dengan konfigurasi firewallnya:

• Kontrol akses presisi: Membatasi koneksi keluar hanya ke domain yang diizinkan (registry npm, GitHub, API Anthropic, dll.)
• Kebijakan default-tolak: Memblokir semua akses jaringan eksternal lainnya
• Verifikasi startup: Memvalidasi aturan firewall ketika kontainer diinisialisasi
• Isolasi: Menciptakan lingkungan pengembangan yang aman yang terpisah dari sistem utama Anda

​

Opsi kustomisasi

Konfigurasi devcontainer dirancang untuk dapat disesuaikan dengan kebutuhan Anda:

• Tambah atau hapus ekstensi VS Code berdasarkan alur kerja Anda
• Modifikasi alokasi sumber daya untuk lingkungan perangkat keras yang berbeda
• Sesuaikan izin akses jaringan
• Kustomisasi konfigurasi shell dan alat pengembang

​

Langkah selanjutnya

​

Lisensi dan penggunaan data

Claude Code disediakan sebagai pratinjau penelitian Beta di bawah Ketentuan Layanan Komersial Anthropic.

​

Bagaimana kami menggunakan data Anda

Kami bertujuan untuk sepenuhnya transparan tentang bagaimana kami menggunakan data Anda. Kami dapat menggunakan umpan balik untuk meningkatkan produk dan layanan kami, tetapi kami tidak akan melatih model generatif menggunakan umpan balik Anda dari Claude Code. Mengingat sifatnya yang berpotensi sensitif, kami menyimpan transkrip umpan balik pengguna hanya selama 30 hari.

​

Transkrip umpan balik

Jika Anda memilih untuk mengirimkan umpan balik tentang Claude Code, seperti transkrip penggunaan Anda, Anthropic dapat menggunakan umpan balik tersebut untuk men-debug masalah terkait dan meningkatkan fungsionalitas Claude Code (misalnya, untuk mengurangi risiko bug serupa terjadi di masa depan). Kami tidak akan melatih model generatif menggunakan umpan balik ini.

​

Pengamanan privasi

Kami telah menerapkan beberapa pengamanan untuk melindungi data Anda, termasuk periode retensi terbatas untuk informasi sensitif, akses terbatas ke data sesi pengguna, dan kebijakan yang jelas terhadap penggunaan umpan balik untuk pelatihan model.

Untuk detail lengkap, silakan tinjau Ketentuan Layanan Komersial dan Kebijakan Privasi kami.

​

Lisensi

© Anthropic PBC. Semua hak dilindungi undang-undang. Penggunaan tunduk pada Ketentuan Layanan Komersial Anthropic.