Pengaturan Claude Code

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.

Contoh settings.json
{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}

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

Memulai

Membangun dengan Claude

Penerapan

Administrasi

Referensi

Sumber daya

Pengaturan Claude Code

File pengaturan

Pengaturan yang tersedia

Pengaturan permission

Prioritas pengaturan

Variabel lingkungan

Opsi konfigurasi

Konfigurasi global

Tool yang tersedia untuk Claude

Memperluas tool dengan hooks

Lihat juga

Memulai

Membangun dengan Claude

Penerapan

Administrasi

Referensi

Sumber daya

​File pengaturan

​Pengaturan yang tersedia

​Pengaturan permission

​Prioritas pengaturan

​Variabel lingkungan

​Opsi konfigurasi

​Konfigurasi global

​Tool yang tersedia untuk Claude

​Memperluas tool dengan hooks

​Lihat juga

File pengaturan

Pengaturan yang tersedia

Pengaturan permission

Prioritas pengaturan

Variabel lingkungan

Opsi konfigurasi

Konfigurasi global

Tool yang tersedia untuk Claude

Memperluas tool dengan hooks

Lihat juga