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 dari pengaturan pengguna dan proyek. Administrator sistem dapat men-deploy kebijakan ke:
  • macOS: /Library/Application Support/ClaudeCode/managed-settings.json
  • Linux dan WSL: /etc/claude-code/managed-settings.json
  • Windows: C:\ProgramData\ClaudeCode\managed-settings.json

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

​

Pengaturan yang tersedia

settings.json mendukung sejumlah opsi:

​

Pengaturan permission

​

Prioritas pengaturan

Pengaturan diterapkan berdasarkan urutan prioritas (tertinggi ke terendah):

1. Kebijakan yang dikelola enterprise (managed-settings.json)

   • Di-deploy oleh IT/DevOps
   • Tidak dapat di-override

2. Argumen command line

   • Override sementara untuk sesi tertentu

3. Pengaturan proyek lokal (.claude/settings.local.json)

   • Pengaturan pribadi khusus proyek

4. Pengaturan proyek bersama (.claude/settings.json)

   • Pengaturan proyek bersama tim dalam kontrol sumber

5. Pengaturan pengguna (~/.claude/settings.json)

   • Pengaturan global pribadi

Hierarki ini memastikan bahwa kebijakan keamanan enterprise selalu ditegakkan sambil tetap memungkinkan tim dan individu untuk menyesuaikan pengalaman mereka.

​

Poin kunci tentang sistem konfigurasi

• File memori (CLAUDE.md): Berisi instruksi dan konteks yang dimuat Claude saat startup
• File pengaturan (JSON): Mengkonfigurasi permissions, variabel lingkungan, dan perilaku tool
• Perintah slash: Perintah kustom yang dapat dipanggil selama sesi dengan /command-name
• Server MCP: Memperluas Claude Code dengan tool dan integrasi tambahan
• Prioritas: Konfigurasi tingkat lebih tinggi (Enterprise) menimpa yang tingkat lebih rendah (User/Project)
• Inheritance: Pengaturan digabungkan, dengan pengaturan yang lebih spesifik menambahkan atau menimpa yang lebih luas

​

Ketersediaan system prompt

​

Mengecualikan file sensitif

Untuk mencegah Claude Code mengakses file yang berisi informasi sensitif (misalnya, API key, secret, file environment), gunakan pengaturan permissions.deny dalam file .claude/settings.json Anda:

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Read(./build)"
    ]
  }
}

Ini menggantikan konfigurasi ignorePatterns yang sudah deprecated. File yang cocok dengan pola ini akan benar-benar tidak terlihat oleh Claude Code, mencegah paparan data sensitif yang tidak disengaja.

​

Konfigurasi subagent

Claude Code mendukung subagent AI kustom yang dapat dikonfigurasi di tingkat pengguna dan proyek. Subagent ini disimpan sebagai file Markdown dengan frontmatter YAML:

• Subagent pengguna: ~/.claude/agents/ - Tersedia di semua proyek Anda
• Subagent proyek: .claude/agents/ - Spesifik untuk proyek Anda dan dapat dibagikan dengan tim Anda

File subagent mendefinisikan asisten AI khusus dengan prompt kustom dan permission tool. Pelajari lebih lanjut tentang membuat dan menggunakan subagent dalam dokumentasi subagent.

​

Variabel lingkungan

Claude Code mendukung variabel lingkungan berikut untuk mengontrol perilakunya:

​

Opsi konfigurasi

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>:

​

Tool yang tersedia untuk Claude

Claude Code memiliki akses ke serangkaian tool yang powerful yang membantunya memahami dan memodifikasi codebase Anda:

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 hooks Claude Code.

Misalnya, Anda bisa 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