Referensi
Pengaturan Claude Code
Referensi
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.jsondan berlaku untuk semua proyek. - Pengaturan proyek disimpan dalam direktori proyek Anda:
.claude/settings.jsonuntuk pengaturan yang dicek ke dalam kontrol sumber dan dibagikan dengan tim Anda.claude/settings.local.jsonuntuk pengaturan yang tidak dicek masuk, berguna untuk preferensi pribadi dan eksperimen. Claude Code akan mengkonfigurasi git untuk mengabaikan.claude/settings.local.jsonketika dibuat.
- Untuk deployment enterprise Claude Code, kami juga mendukung pengaturan kebijakan yang dikelola enterprise. Ini mengambil prioritas atas pengaturan pengguna dan proyek. Administrator sistem dapat men-deploy kebijakan ke
/Library/Application Support/ClaudeCode/policies.jsonpada macOS dan/etc/claude-code/policies.jsonpada Linux dan Windows melalui WSL.
Example settings.json
Pengaturan yang tersedia
settings.json mendukung sejumlah opsi:
| Kunci | Deskripsi | Contoh |
|---|---|---|
apiKeyHelper | Skrip kustom, untuk 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 | Kunci allow dan deny adalah daftar aturan izin | {"allow": [ "Bash(npm run lint)" ]} |
Prioritas pengaturan
Pengaturan diterapkan dalam urutan prioritas:
- Kebijakan enterprise (lihat dokumentasi IAM)
- Argumen baris perintah
- Pengaturan proyek lokal
- Pengaturan proyek bersama
- 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 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 untuk 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 disegarkan (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 pembaruan 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 keluar 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 keluar 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 thinking untuk anggaran 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 ditinggalkan 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 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 | Deskripsi | Contoh |
|---|---|---|
autoUpdaterStatus | Aktifkan atau nonaktifkan auto-updater (default: enabled) | disabled |
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 kuat yang membantunya memahami dan memodifikasi codebase Anda:
| Tool | Deskripsi | Izin Diperlukan |
|---|---|---|
| Agent | Menjalankan sub-agent untuk menangani tugas kompleks multi-langkah | Tidak |
| Bash | Mengeksekusi perintah shell di lingkungan Anda | Ya |
| Edit | Membuat edit yang ditargetkan ke 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 penyaringan domain | Ya |
| Write | Membuat atau menimpa file | Ya |
Aturan izin dapat dikonfigurasi menggunakan /allowed-tools atau dalam pengaturan izin.
Lihat juga
- Manajemen Identitas dan Akses - Pelajari tentang sistem izin Claude Code
- IAM dan kontrol akses - Manajemen kebijakan enterprise
- Pemecahan masalah - Solusi untuk masalah konfigurasi umum