Pengaturan Claude Code
Konfigurasikan Claude Code dengan pengaturan global dan tingkat proyek, serta variabel lingkungan.
Claude Code menawarkan berbagai pengaturan untuk mengkonfigurasi perilakunya agar sesuai dengan kebutuhan Anda. Anda dapat mengkonfigurasi Claude Code dengan menjalankan perintah /config
saat menggunakan REPL interaktif.
File pengaturan
File settings.json
adalah mekanisme resmi kami untuk mengkonfigurasi Claude
Code melalui pengaturan hierarkis:
- Pengaturan pengguna didefinisikan dalam
~/.claude/settings.json
dan berlaku untuk semua proyek. - Pengaturan proyek disimpan dalam direktori proyek Anda:
.claude/settings.json
untuk pengaturan yang di-check in ke kontrol sumber dan dibagikan dengan tim Anda.claude/settings.local.json
untuk pengaturan yang tidak di-check in, berguna untuk preferensi pribadi dan eksperimen. Claude Code akan mengkonfigurasi git untuk mengabaikan.claude/settings.local.json
saat dibuat.
- Untuk deployment enterprise Claude Code, kami juga mendukung pengaturan kebijakan yang dikelola enterprise. Ini memiliki prioritas lebih tinggi daripada pengaturan pengguna dan proyek. Administrator sistem dapat men-deploy kebijakan ke
/Library/Application Support/ClaudeCode/managed-settings.json
di macOS dan/etc/claude-code/managed-settings.json
di Linux dan Windows melalui WSL.
Pengaturan yang tersedia
settings.json
mendukung sejumlah opsi:
Kunci | Deskripsi | Contoh |
---|---|---|
apiKeyHelper | Skrip kustom, yang akan dieksekusi dalam /bin/sh , untuk menghasilkan nilai auth. Nilai ini umumnya akan dikirim sebagai header X-Api-Key , Authorization: Bearer , dan Proxy-Authorization: Bearer untuk permintaan model | /bin/generate_temp_api_key.sh |
cleanupPeriodDays | Berapa lama menyimpan transkrip chat secara lokal (default: 30 hari) | 20 |
env | Variabel lingkungan yang akan diterapkan ke setiap sesi | {"FOO": "bar"} |
includeCoAuthoredBy | Apakah akan menyertakan byline co-authored-by Claude dalam commit git dan pull request (default: true ) | false |
permissions | Lihat tabel di bawah untuk struktur permissions. |
Pengaturan permission
Kunci | Deskripsi | Contoh |
---|---|---|
allow | Array aturan permission untuk mengizinkan penggunaan tool | [ "Bash(git diff:*)" ] |
deny | Array aturan permission untuk menolak penggunaan tool | [ "WebFetch", "Bash(curl:*)" ] |
additionalDirectories | Direktori kerja tambahan yang dapat diakses Claude | [ "../docs/" ] |
defaultMode | Mode permission default saat membuka Claude Code | "allowEdits" |
disableBypassPermissionsMode | Atur ke "disable" untuk mencegah mode bypassPermissions diaktifkan. Lihat pengaturan kebijakan yang dikelola | "disable" |
Prioritas pengaturan
Pengaturan diterapkan berdasarkan urutan prioritas:
- Kebijakan enterprise (lihat dokumentasi IAM)
- Argumen command line
- Pengaturan proyek lokal
- Pengaturan proyek yang dibagikan
- Pengaturan pengguna
Variabel lingkungan
Claude Code mendukung variabel lingkungan berikut untuk mengontrol perilakunya:
Semua variabel lingkungan juga dapat dikonfigurasi dalam settings.json
. Ini berguna sebagai cara untuk secara otomatis mengatur variabel lingkungan untuk setiap sesi, atau untuk meluncurkan serangkaian variabel lingkungan untuk seluruh tim atau organisasi Anda.
Variabel | Tujuan |
---|---|
ANTHROPIC_API_KEY | Kunci API yang dikirim sebagai header X-Api-Key , biasanya untuk Claude SDK (untuk penggunaan interaktif, jalankan /login ) |
ANTHROPIC_AUTH_TOKEN | Nilai kustom untuk header Authorization dan Proxy-Authorization (nilai yang Anda atur di sini akan diawali dengan Bearer ) |
ANTHROPIC_CUSTOM_HEADERS | Header kustom yang ingin Anda tambahkan ke permintaan (dalam format Name: Value ) |
ANTHROPIC_MODEL | Nama model kustom yang akan digunakan (lihat Konfigurasi Model) |
ANTHROPIC_SMALL_FAST_MODEL | Nama model kelas Haiku untuk tugas latar belakang |
BASH_DEFAULT_TIMEOUT_MS | Timeout default untuk perintah bash yang berjalan lama |
BASH_MAX_TIMEOUT_MS | Timeout maksimum yang dapat diatur model untuk perintah bash yang berjalan lama |
BASH_MAX_OUTPUT_LENGTH | Jumlah maksimum karakter dalam output bash sebelum dipotong di tengah |
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR | Kembali ke direktori kerja asli setelah setiap perintah Bash |
CLAUDE_CODE_API_KEY_HELPER_TTL_MS | Interval dalam milidetik di mana kredensial harus di-refresh (saat menggunakan apiKeyHelper ) |
CLAUDE_CODE_MAX_OUTPUT_TOKENS | Atur jumlah maksimum token output untuk sebagian besar permintaan |
CLAUDE_CODE_USE_BEDROCK | Gunakan Bedrock (lihat Bedrock & Vertex) |
CLAUDE_CODE_USE_VERTEX | Gunakan Vertex (lihat Bedrock & Vertex) |
CLAUDE_CODE_SKIP_BEDROCK_AUTH | Lewati autentikasi AWS untuk Bedrock (misalnya saat menggunakan gateway LLM) |
CLAUDE_CODE_SKIP_VERTEX_AUTH | Lewati autentikasi Google untuk Vertex (misalnya saat menggunakan gateway LLM) |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | Setara dengan mengatur DISABLE_AUTOUPDATER , DISABLE_BUG_COMMAND , DISABLE_ERROR_REPORTING , dan DISABLE_TELEMETRY |
DISABLE_AUTOUPDATER | Atur ke 1 untuk menonaktifkan updater otomatis |
DISABLE_BUG_COMMAND | Atur ke 1 untuk menonaktifkan perintah /bug |
DISABLE_COST_WARNINGS | Atur ke 1 untuk menonaktifkan pesan peringatan biaya |
DISABLE_ERROR_REPORTING | Atur ke 1 untuk opt out dari pelaporan error Sentry |
DISABLE_NON_ESSENTIAL_MODEL_CALLS | Atur ke 1 untuk menonaktifkan panggilan model untuk jalur non-kritis seperti teks flavor |
DISABLE_TELEMETRY | Atur ke 1 untuk opt out dari telemetri Statsig (perhatikan bahwa event Statsig tidak menyertakan 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 |
MAX_THINKING_TOKENS | Paksa anggaran thinking untuk model |
MCP_TIMEOUT | Timeout dalam milidetik untuk startup server MCP |
MCP_TOOL_TIMEOUT | Timeout dalam milidetik untuk eksekusi tool MCP |
MAX_MCP_OUTPUT_TOKENS | Jumlah maksimum token yang diizinkan dalam respons tool MCP (default: 25000) |
Opsi konfigurasi
Kami sedang dalam proses migrasi konfigurasi global ke settings.json
.
claude config
akan deprecated menggantikan settings.json
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>
- Push ke pengaturan (untuk list):
claude config add <key> <value>
- Hapus dari pengaturan (untuk list):
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 | Deskripsi | Contoh |
---|---|---|
autoUpdates | Apakah akan mengaktifkan update otomatis (default: true ) | false |
preferredNotifChannel | Di mana Anda ingin menerima notifikasi (default: iterm2 ) | iterm2 , iterm2_with_bell , terminal_bell , atau notifications_disabled |
theme | Tema warna | dark , light , light-daltonized , atau dark-daltonized |
verbose | Apakah akan menampilkan output bash dan perintah lengkap (default: false ) | true |
Tool yang tersedia untuk Claude
Claude Code memiliki akses ke serangkaian tool yang powerful yang membantunya memahami dan memodifikasi codebase Anda:
Tool | Deskripsi | Permission Diperlukan |
---|---|---|
Agent | Menjalankan sub-agent untuk menangani tugas kompleks multi-langkah | Tidak |
Bash | Mengeksekusi perintah shell di lingkungan Anda | Ya |
Edit | Melakukan edit yang ditargetkan pada file tertentu | Ya |
Glob | Menemukan file berdasarkan pencocokan pola | Tidak |
Grep | Mencari pola dalam konten file | Tidak |
LS | Mendaftar file dan direktori | Tidak |
MultiEdit | Melakukan beberapa edit pada satu file secara atomik | Ya |
NotebookEdit | Memodifikasi sel notebook Jupyter | Ya |
NotebookRead | Membaca dan menampilkan konten notebook Jupyter | Tidak |
Read | Membaca konten file | Tidak |
TodoRead | Membaca daftar tugas sesi saat ini | Tidak |
TodoWrite | Membuat dan mengelola daftar tugas terstruktur | Tidak |
WebFetch | Mengambil konten dari URL yang ditentukan | Ya |
WebSearch | Melakukan pencarian web dengan filtering domain | Ya |
Write | Membuat atau menimpa file | Ya |
Aturan permission dapat dikonfigurasi menggunakan /allowed-tools
atau dalam pengaturan permission.
Memperluas tool dengan hooks
Anda dapat menjalankan perintah kustom sebelum atau sesudah tool apa pun dieksekusi menggunakan Claude Code hooks.
Misalnya, Anda dapat secara otomatis menjalankan formatter Python setelah Claude memodifikasi file Python, atau mencegah modifikasi pada file konfigurasi produksi dengan memblokir operasi Write ke jalur tertentu.
Lihat juga
- Identity and Access Management - Pelajari tentang sistem permission Claude Code
- IAM dan kontrol akses - Manajemen kebijakan enterprise
- Troubleshooting - Solusi untuk masalah konfigurasi umum