Ikhtisar Claude Code
Pelajari tentang Claude Code, alat pengkodean agentic yang dibuat oleh Anthropic. Saat ini dalam beta sebagai pratinjau penelitian.
Instal NodeJS 18+, kemudian jalankan:
JANGAN gunakan sudo npm install -g
karena dapat menyebabkan masalah izin dan
risiko keamanan. Jika Anda mengalami kesalahan izin, lihat konfigurasi Claude
Code untuk solusi yang direkomendasikan.
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 merampingkan alur kerja Anda tanpa memerlukan server tambahan atau pengaturan yang kompleks.
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
Pratinjau penelitian
Code sedang dalam beta sebagai pratinjau penelitian. Kami mengumpulkan umpan balik pengembang tentang preferensi kolaborasi AI, alur kerja mana yang paling mendapat manfaat dari bantuan AI, dan bagaimana meningkatkan pengalaman agen.
Versi awal ini akan berkembang berdasarkan umpan balik pengguna. Kami berencana untuk meningkatkan keandalan eksekusi alat, dukungan untuk perintah yang berjalan lama, rendering terminal, dan pengetahuan diri Claude tentang kemampuannya dalam beberapa minggu mendatang.
Laporkan bug langsung dengan perintah /bug
atau melalui repositori GitHub kami.
Sebelum Anda mulai
Periksa persyaratan sistem
- Sistem Operasi: macOS 10.15+, Ubuntu 20.04+/Debian 10+, atau Windows melalui WSL
- Perangkat Keras: Minimal RAM 4GB
- Perangkat Lunak:
- Jaringan: Koneksi internet diperlukan untuk autentikasi dan pemrosesan AI
- Lokasi: Hanya tersedia di negara yang didukung
Pemecahan masalah instalasi WSL
Saat ini, Claude Code tidak berjalan langsung di Windows, dan sebagai gantinya memerlukan WSL. Jika Anda mengalami masalah di WSL:
-
Masalah deteksi OS/platform: Jika Anda menerima kesalahan selama instalasi, WSL mungkin menggunakan
npm
Windows. Coba:- Jalankan
npm config set os linux
sebelum instalasi - Instal dengan
npm install -g @anthropic-ai/claude-code --force --no-os-check
(JANGAN gunakansudo
)
- Jalankan
-
Error node tidak ditemukan: Jika Anda melihat
exec: node: not found
saat menjalankanclaude
, lingkungan WSL Anda mungkin menggunakan instalasi Node.js Windows. Anda dapat mengonfirmasi ini denganwhich npm
danwhich node
, yang seharusnya menunjuk ke jalur Linux yang dimulai dengan/usr/
daripada/mnt/c/
. Untuk memperbaikinya, coba instal Node melalui pengelola paket distribusi Linux Anda atau melaluinvm
.
Instal dan autentikasi
Instal Claude Code
Jalankan di terminal Anda: npm install -g @anthropic-ai/claude-code
JANGAN gunakan sudo npm install -g
karena dapat menyebabkan masalah izin dan
risiko keamanan. Jika Anda mengalami kesalahan izin, lihat konfigurasi Claude
Code untuk solusi yang direkomendasikan.
Navigasi ke proyek Anda
cd direktori-proyek-anda
Mulai Claude Code
claude
untuk meluncurkanSelesaikan autentikasi
Claude Code menawarkan dua opsi autentikasi:
-
Anthropic Console: Opsi default. Hubungkan melalui Anthropic Console dan selesaikan proses OAuth. Memerlukan penagihan aktif di console.anthropic.com.
-
Paket Max: Berlangganan paket Max Claude untuk satu langganan yang mencakup baik Claude Code maupun antarmuka web. Dapatkan nilai lebih pada titik harga yang sama sambil mengelola akun Anda di satu tempat. Masuk dengan akun Claude.ai Anda. Selama peluncuran, pilih opsi yang sesuai dengan jenis langganan Anda.
Fitur inti 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.
Keamanan dan privasi berdasarkan desain
Keamanan kode Anda sangat penting. 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
Inisialisasi proyek Anda
Untuk pengguna pertama kali, kami merekomendasikan:
- Mulai Claude Code dengan
claude
- Coba perintah sederhana seperti
ringkas proyek ini
- Buat panduan proyek CLAUDE.md dengan
/init
- 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
Otomatisasi operasi Git
Edit kode secara cerdas
Uji dan debug kode Anda
Mendorong pemikiran yang lebih dalam
Untuk masalah kompleks, secara eksplisit minta Claude untuk berpikir lebih dalam:
Claude Code akan menunjukkan ketika Claude menggunakan pemikiran yang diperluas (tersedia di Claude Sonnet 3.7, Claude Opus 4). Anda dapat secara proaktif meminta Claude untuk “berpikir” atau “berpikir dalam-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 “berpikir” untuk membuat rencana.
Claude akan berpikir lebih berdasarkan kata-kata yang Anda gunakan. Misalnya, “berpikir keras” akan memicu pemikiran yang lebih diperluas daripada hanya mengatakan “berpikir”.
Untuk tips lebih lanjut, lihat Tips pemikiran yang diperluas.
Otomatisasi 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:
Kontrol Claude Code dengan perintah
Perintah CLI
Perintah | Deskripsi | Contoh |
---|---|---|
claude | Mulai REPL interaktif | claude |
claude "query" | Mulai REPL dengan prompt awal | claude "jelaskan proyek ini" |
claude -p "query" | Jalankan kueri sekali pakai, lalu keluar | claude -p "jelaskan fungsi ini" |
cat file | claude -p "query" | Proses konten yang di-pipe | cat logs.txt | claude -p "jelaskan" |
claude config | Konfigurasi pengaturan | claude config set --global theme dark |
claude update | Perbarui ke versi terbaru | claude update |
claude mcp | Konfigurasi server Model Context Protocol | Lihat bagian MCP di tutorial |
Flag CLI:
--print
(-p
): Cetak respons tanpa mode interaktif--json
: Kembalikan output JSON dalam mode--print
, berguna untuk skrip dan otomatisasi--verbose
: Aktifkan logging verbose, menampilkan output turn-by-turn lengkap (membantu untuk debugging di kedua mode print dan interaktif)--dangerously-skip-permissions
: Lewati prompt izin
Perintah garis miring
Kontrol perilaku Claude dalam sesi:
Perintah | Tujuan |
---|---|
/bug | Laporkan bug (mengirim percakapan ke Anthropic) |
/clear | Bersihkan riwayat percakapan |
/compact [instructions] | Padatkan percakapan dengan instruksi fokus opsional |
/config | Lihat/modifikasi konfigurasi |
/cost | Tampilkan statistik penggunaan token |
/doctor | Memeriksa kesehatan instalasi Claude Code Anda |
/help | Dapatkan bantuan penggunaan |
/init | Inisialisasi proyek dengan panduan CLAUDE.md |
/login | Beralih akun Anthropic |
/logout | Keluar dari akun Anthropic Anda |
/memory | Edit file memori CLAUDE.md |
/pr_comments | Lihat komentar pull request |
/review | Minta tinjauan kode |
/terminal-setup | Instal pengikatan tombol Shift+Enter untuk baris baru (hanya iTerm2 dan VSCode) |
/vim | Masuk mode vim untuk mode sisipan dan perintah bergantian |
Kelola memori Claude
Claude Code dapat mengingat preferensi Anda di seluruh sesi, seperti pedoman gaya dan perintah umum dalam alur kerja Anda.
Tentukan jenis memori
Claude Code menawarkan tiga lokasi memori, masing-masing melayani tujuan yang berbeda:
Jenis Memori | Lokasi | Tujuan | Contoh Kasus Penggunaan |
---|---|---|---|
Memori proyek | ./CLAUDE.md | Konvensi dan pengetahuan yang dibagikan tim | Arsitektur proyek, standar pengkodean, alur kerja umum |
Memori proyek (lokal) | ./CLAUDE.local.md | Preferensi khusus proyek pribadi | URL sandbox Anda, data pengujian yang disukai |
Memori pengguna | ~/.claude/CLAUDE.md | Preferensi pribadi global | Preferensi gaya kode, pintasan alat pribadi |
Semua file memori secara otomatis dimuat ke dalam konteks Claude Code saat diluncurkan.
Bagaimana Claude mencari memori
Claude Code membaca memori secara rekursif: dimulai di cwd, Claude Code melakukan rekursi ke / dan membaca file CLAUDE.md atau CLAUDE.local.md yang ditemukannya. Ini sangat nyaman saat bekerja di repositori besar di mana Anda menjalankan Claude Code di foo/bar/, dan memiliki memori di foo/CLAUDE.md dan foo/bar/CLAUDE.md.
Cepat tambahkan memori dengan pintasan #
Cara tercepat untuk menambahkan memori adalah dengan memulai input Anda dengan karakter #
:
Anda akan diminta untuk memilih file memori mana yang akan menyimpan ini.
Edit memori langsung dengan /memory
Gunakan perintah garis miring /memory
selama sesi untuk membuka file memori apa pun di editor sistem Anda untuk penambahan atau pengorganisasian yang lebih ekstensif.
Praktik terbaik memori
- Spesifik: “Gunakan indentasi 2-spasi” lebih baik daripada “Format kode dengan benar”.
- Gunakan struktur untuk mengatur: Format setiap memori individual sebagai poin bullet dan kelompokkan memori terkait di bawah judul markdown deskriptif.
- Tinjau secara berkala: Perbarui memori saat proyek Anda berkembang untuk memastikan Claude selalu menggunakan informasi dan konteks yang paling up to date.
Kelola izin dan keamanan
Claude Code menggunakan sistem izin bertingkat untuk menyeimbangkan kekuatan dan keamanan:
Jenis Alat | Contoh | Persetujuan Diperlukan | Perilaku “Ya, jangan tanya lagi” |
---|---|---|---|
Hanya-baca | Baca file, LS, Grep | Tidak | N/A |
Perintah Bash | Eksekusi shell | Ya | Permanen per direktori proyek dan perintah |
Modifikasi File | Edit/tulis file | Ya | Sampai sesi berakhir |
Alat yang tersedia untuk Claude
Claude Code memiliki akses ke serangkaian alat yang kuat yang membantunya memahami dan memodifikasi basis kode Anda:
Alat | Deskripsi | Izin Diperlukan |
---|---|---|
Agent | Menjalankan sub-agen untuk menangani tugas kompleks, multi-langkah | Tidak |
Bash | Menjalankan perintah shell di lingkungan Anda | Ya |
Glob | Menemukan file berdasarkan pencocokan pola | Tidak |
Grep | Mencari pola dalam konten file | Tidak |
LS | Mencantumkan file dan direktori | Tidak |
Read | Membaca isi file | Tidak |
Edit | Membuat edit yang ditargetkan ke file tertentu | Ya |
Write | Membuat atau menimpa file | Ya |
NotebookEdit | Memodifikasi sel notebook Jupyter | Ya |
NotebookRead | Membaca dan menampilkan isi notebook Jupyter | Tidak |
WebFetch | Mengambil konten dari URL yang ditentukan | Ya |
Aturan izin dapat dikonfigurasi menggunakan /allowed-tools
atau di
pengaturan izin.
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 perlindungan terhadap serangan ini:
- Sistem izin: 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 sewenang-wenang dari web seperti
curl
danwget
Praktik terbaik untuk bekerja dengan konten yang tidak tepercaya:
- Tinjau perintah yang disarankan sebelum persetujuan
- Hindari piping konten yang tidak tepercaya langsung ke Claude
- Verifikasi perubahan yang diusulkan ke file kritis
- Laporkan perilaku mencurigakan dengan
/bug
Meskipun perlindungan ini secara signifikan mengurangi risiko, tidak ada sistem yang sepenuhnya kebal terhadap semua serangan. Selalu pertahankan praktik keamanan yang baik saat bekerja dengan alat AI apa pun.
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.
Variabel lingkungan
Claude Code mendukung variabel lingkungan berikut untuk mengontrol perilakunya:
Variabel | Tujuan |
---|---|
DISABLE_AUTOUPDATER | Setel ke 1 untuk menonaktifkan pembaruan otomatis |
DISABLE_BUG_COMMAND | Setel ke 1 untuk menonaktifkan perintah /bug |
DISABLE_COST_WARNINGS | Setel ke 1 untuk menonaktifkan pesan peringatan biaya |
DISABLE_ERROR_REPORTING | Setel ke 1 untuk tidak ikut serta dalam pelaporan kesalahan Sentry |
DISABLE_TELEMETRY | Setel ke 1 untuk tidak ikut serta dalam telemetri Statsig (perhatikan bahwa peristiwa Statsig tidak termasuk data pengguna seperti kode, jalur file, atau perintah bash) |
HTTP_PROXY | Tentukan server proxy HTTP untuk koneksi jaringan |
HTTPS_PROXY | Tentukan server proxy HTTPS untuk koneksi jaringan |
MCP_TIMEOUT | Batas waktu dalam milidetik untuk startup server MCP |
MCP_TOOL_TIMEOUT | Batas waktu dalam milidetik untuk eksekusi alat MCP |
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 <key>
- Ubah pengaturan:
claude config set <key> <value>
- Tambahkan ke pengaturan (untuk daftar):
claude config add <key> <value>
- Hapus dari pengaturan (untuk daftar):
claude config remove <key> <value>
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 <key> <value>
:
Kunci | Nilai | Deskripsi |
---|---|---|
autoUpdaterStatus | disabled atau enabled | Aktifkan atau nonaktifkan pembaruan otomatis (default: enabled ) |
env | JSON (mis. '{"FOO": "bar"}' ) | Variabel lingkungan yang akan diterapkan ke setiap sesi |
preferredNotifChannel | iterm2 , iterm2_with_bell , terminal_bell , atau notifications_disabled | Di mana Anda ingin menerima notifikasi (default: iterm2 ) |
theme | dark , light , light-daltonized , atau dark-daltonized | Tema warna |
verbose | true atau false | Apakah akan menampilkan output bash dan perintah lengkap (default: false ) |
Opsi izin pembaruan otomatis
Ketika Claude Code mendeteksi bahwa tidak memiliki izin yang cukup untuk menulis ke direktori prefiks npm global Anda (diperlukan untuk pembaruan otomatis), Anda akan melihat peringatan yang mengarah ke halaman dokumentasi ini. Untuk solusi terperinci untuk masalah pembaruan otomatis, lihat panduan pemecahan masalah.
Direkomendasikan: Buat prefiks npm baru yang dapat ditulis pengguna
Mengapa kami merekomendasikan opsi ini:
- Menghindari modifikasi izin direktori sistem
- Membuat lokasi khusus yang bersih untuk paket npm global Anda
- Mengikuti praktik terbaik keamanan
Karena Claude Code sedang aktif dikembangkan, kami merekomendasikan pengaturan pembaruan otomatis menggunakan opsi yang direkomendasikan di atas.
Menonaktifkan pembaruan otomatis
Jika Anda lebih suka menonaktifkan pembaruan otomatis daripada memperbaiki izin, Anda dapat menggunakan:
Konfigurasi proyek
Kelola konfigurasi proyek dengan claude config set <key> <value>
(tanpa flag -g
):
Kunci | Nilai | Deskripsi |
---|---|---|
allowedTools | array alat | Alat mana yang dapat dijalankan tanpa persetujuan manual |
ignorePatterns | array string glob | File/direktori mana yang diabaikan saat menggunakan alat |
Misalnya:
Lihat Izin untuk format aturan allowedTools
.
Optimalkan pengaturan terminal Anda
Claude Code bekerja paling baik ketika terminal Anda dikonfigurasi dengan benar. Ikuti pedoman 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
Jeda baris
Anda memiliki beberapa opsi untuk memasukkan jeda baris 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:
- Buka Settings → Profiles → Keyboard
- Centang “Use Option as Meta Key”
Untuk iTerm2 dan terminal VSCode:
- Buka Settings → Profiles → Keys
- 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 saat Claude menyelesaikan tugas dengan konfigurasi notifikasi yang tepat:
Notifikasi bel terminal
Aktifkan peringatan suara saat tugas selesai:
Untuk pengguna macOS: Jangan lupa untuk mengaktifkan izin notifikasi di System Settings → Notifications → [Aplikasi Terminal Anda].
Notifikasi sistem iTerm 2
Untuk peringatan iTerm 2 saat tugas selesai:
- Buka Preferensi iTerm 2
- Navigasi ke Profiles → Terminal
- Aktifkan “Silence bell” dan “Send notification when idle”
- 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 ekstensif atau instruksi 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 tempelan panjang
Mode Vim
Claude Code mendukung subset pengikatan tombol Vim yang dapat diaktifkan dengan /vim
atau dikonfigurasi melalui /config
.
Subset yang didukung meliputi:
- Pengalihan mode:
Esc
(ke NORMAL),i
/I
,a
/A
,o
/O
(ke INSERT) - Navigasi:
h
/j
/k
/l
,w
/e
/b
,0
/$
/^
,gg
/G
- Pengeditan:
x
,dw
/de
/db
/dd
/D
,cw
/ce
/cb
/cc
/C
,.
(ulangi)
Kelola biaya secara efektif
Claude Code mengkonsumsi token untuk setiap interaksi. Biaya rata-rata adalah $6 per pengembang per hari, dengan biaya harian tetap di bawah $12 untuk 90% pengguna.
Lacak biaya Anda
- Gunakan
/cost
untuk melihat penggunaan sesi saat ini - Pengguna Anthropic Console:
- Periksa penggunaan historis di Anthropic Console (memerlukan peran Admin atau Billing)
- Atur batas pengeluaran workspace untuk workspace Claude Code (memerlukan peran Admin)
- Pengguna paket Max: Penggunaan termasuk dalam langganan paket Max Anda
Kurangi penggunaan token
-
Padatkan percakapan:
-
Claude menggunakan auto-compact secara default ketika konteks melebihi 95% kapasitas
-
Alihkan auto-compact: Jalankan
/config
dan navigasi ke “Auto-compact enabled” -
Gunakan
/compact
secara manual ketika konteks menjadi besar -
Tambahkan instruksi kustom:
/compact Fokus pada sampel kode dan penggunaan API
-
Sesuaikan pemadatan dengan menambahkan ke CLAUDE.md:
-
-
Tulis kueri spesifik: Hindari permintaan samar yang memicu pemindaian yang tidak perlu
-
Pecah tugas kompleks: Bagi 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
Untuk penerapan tim, kami merekomendasikan untuk memulai dengan kelompok pilot kecil untuk menetapkan pola penggunaan sebelum peluncuran yang lebih luas.
Konfigurasi model
Secara default, Claude Code menggunakan claude-opus-4-20250514
. Anda dapat mengesampingkan ini menggunakan variabel lingkungan berikut:
Anda juga dapat mengatur variabel ini menggunakan konfigurasi global:
Lihat referensi nama model kami untuk semua model yang tersedia di berbagai penyedia.
Gunakan dengan API pihak ketiga
Claude Code memerlukan akses ke model Claude Sonnet 3.7 dan Claude Haiku 3.5, terlepas dari penyedia API mana yang Anda gunakan.
Hubungkan ke Amazon Bedrock
Jika Anda ingin mengakses Claude Code melalui proxy, Anda dapat menggunakan variabel lingkungan ANTHROPIC_BEDROCK_BASE_URL
:
Jika Anda tidak memiliki caching prompt yang diaktifkan, juga atur:
Memerlukan kredensial AWS SDK standar (mis., ~/.aws/credentials
atau variabel lingkungan yang relevan seperti AWS_ACCESS_KEY_ID
, AWS_SECRET_ACCESS_KEY
). Untuk mengatur kredensial AWS, jalankan:
Hubungi Amazon Bedrock untuk caching prompt untuk biaya yang lebih rendah dan batas tarif yang lebih tinggi.
Pengguna akan memerlukan akses ke model Claude Sonnet 3.7 dan Claude Haiku 3.5 di akun AWS mereka. Jika Anda memiliki peran akses model, Anda mungkin perlu meminta akses ke model ini jika belum tersedia. Akses ke Bedrock di setiap wilayah diperlukan karena profil inferensi memerlukan kemampuan lintas wilayah.
Hubungkan ke Google Vertex AI
Jika Anda ingin mengakses Claude Code melalui proxy, Anda dapat menggunakan variabel lingkungan ANTHROPIC_VERTEX_BASE_URL
:
Jika Anda tidak memiliki caching prompt yang diaktifkan, juga atur:
Claude Code di Vertex AI saat ini hanya mendukung wilayah us-east5
. Pastikan
proyek Anda memiliki kuota yang dialokasikan di wilayah spesifik ini.
Pengguna akan memerlukan akses ke model Claude Sonnet 3.7 dan Claude Haiku 3.5 di proyek Vertex AI mereka.
Memerlukan kredensial GCP standar yang dikonfigurasi melalui google-auth-library. Untuk mengatur kredensial GCP, jalankan:
Untuk pengalaman terbaik, hubungi Google untuk batas tarif yang lebih tinggi.
Hubungkan melalui proxy
Saat menggunakan Claude Code dengan proxy LLM (seperti LiteLLM), Anda dapat mengontrol perilaku autentikasi menggunakan variabel lingkungan dan konfigurasi berikut. Perhatikan bahwa Anda dapat mencampur dan mencocokkan ini dengan pengaturan khusus Bedrock dan Vertex.
Variabel lingkungan
ANTHROPIC_AUTH_TOKEN
: Nilai kustom untuk headerAuthorization
danProxy-Authorization
(nilai yang Anda atur di sini akan diawali denganBearer
)ANTHROPIC_CUSTOM_HEADERS
: Header kustom yang ingin Anda tambahkan ke permintaan (dalam formatName: Value
)HTTP_PROXY
: Atur URL proxy HTTPHTTPS_PROXY
: Atur URL proxy HTTPS
Jika Anda lebih suka mengkonfigurasi melalui file daripada variabel lingkungan, Anda dapat menambahkan variabel-variabel ini ke objek env
dalam konfigurasi Claude global Anda (di ~/.claude.json).
Opsi konfigurasi global
apiKeyHelper
: Skrip shell kustom untuk mendapatkan kunci API (dipanggil sekali saat startup, dan di-cache selama durasi setiap sesi)
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 pada kontainer (isolasi dan aturan firewall) memungkinkan Anda menjalankan claude --dangerously-skip-permissions
untuk melewati prompt izin untuk operasi tanpa pengawasan. Kami telah menyertakan implementasi referensi yang dapat Anda sesuaikan untuk kebutuhan Anda.
Meskipun devcontainer menyediakan perlindungan substansial, tidak ada sistem yang sepenuhnya kebal terhadap semua serangan. Selalu pertahankan praktik keamanan yang baik dan pantau aktivitas Claude.
Fitur utama
- Node.js siap produksi: Dibangun di atas Node.js 20 dengan dependensi pengembangan penting
- Keamanan berdasarkan desain: Firewall kustom yang 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
- Instal VS Code dan ekstensi Remote - Containers
- Klon repositori implementasi referensi Claude Code
- Buka repositori di VS Code
- 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 pemasangan volume
- Dockerfile: Mendefinisikan image kontainer dan alat yang diinstal
- init-firewall.sh: Menetapkan aturan keamanan jaringan
Fitur keamanan
Kontainer mengimplementasikan pendekatan keamanan multi-lapis dengan konfigurasi firewallnya:
- Kontrol akses yang tepat: Membatasi koneksi keluar hanya ke domain yang terdaftar dalam daftar putih (registri npm, GitHub, API Anthropic, dll.)
- Kebijakan default-deny: Memblokir semua akses jaringan eksternal lainnya
- Verifikasi startup: Memvalidasi aturan firewall saat 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
- Sesuaikan konfigurasi shell dan alat pengembang
Langkah selanjutnya
Tutorial Claude Code
Panduan langkah demi langkah untuk tugas umum
Pemecahan masalah
Solusi untuk masalah umum dengan Claude Code
Implementasi referensi
Klon implementasi referensi kontainer pengembangan kami.
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 mungkin 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.
Perlindungan privasi
Kami telah menerapkan beberapa perlindungan 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.