Pengaturan Claude Code

​

File pengaturan

• Pengaturan pengguna didefinisikan dalam ~/.claude/settings.json dan berlaku untuk semua proyek.
• Pengaturan proyek disimpan di direktori proyek Anda:
  • .claude/settings.json untuk pengaturan yang diperiksa ke dalam kontrol sumber dan dibagikan dengan tim Anda
  • .claude/settings.local.json untuk pengaturan yang tidak diperiksa, berguna untuk preferensi pribadi dan eksperimen. Claude Code akan mengonfigurasi git untuk mengabaikan .claude/settings.local.json saat dibuat.
• Untuk penerapan Claude Code tingkat perusahaan, kami juga mendukung pengaturan kebijakan yang dikelola perusahaan. Ini memiliki prioritas lebih tinggi daripada pengaturan pengguna dan proyek. Administrator sistem dapat menerapkan 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
• Penerapan perusahaan juga dapat mengonfigurasi server MCP yang dikelola yang menggantikan server yang dikonfigurasi pengguna. Lihat Konfigurasi MCP Perusahaan:
  • macOS: /Library/Application Support/ClaudeCode/managed-mcp.json
  • Linux dan WSL: /etc/claude-code/managed-mcp.json
  • Windows: C:\ProgramData\ClaudeCode\managed-mcp.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

​

Pengaturan izin

​

Pengaturan sandbox

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker"],
    "network": {
      "allowUnixSockets": [
        "/var/run/docker.sock"
      ],
      "allowLocalBinding": true
    }
  },
  "permissions": {
    "deny": [
      "Read(.envrc)",
      "Read(~/.aws/**)"
    ]
  }
}

• Aturan penolakan Read memblokir pembacaan file di sandbox
• Aturan izin Edit memungkinkan penulisan file (selain default, misalnya direktori kerja saat ini)
• Aturan penolakan Edit memblokir penulisan dalam jalur yang diizinkan

• Aturan izin WebFetch memungkinkan domain jaringan
• Aturan penolakan WebFetch memblokir domain jaringan

​

Prioritas pengaturan

1. Kebijakan yang dikelola perusahaan (managed-settings.json)
   • Diterapkan oleh IT/DevOps
   • Tidak dapat ditimpa
2. Argumen baris perintah
   • Penggantian sementara untuk sesi tertentu
3. Pengaturan proyek lokal (.claude/settings.local.json)
   • Pengaturan proyek pribadi yang spesifik
4. Pengaturan proyek bersama (.claude/settings.json)
   • Pengaturan proyek yang dibagikan tim dalam kontrol sumber
5. Pengaturan pengguna (~/.claude/settings.json)
   • Pengaturan global pribadi

​

Poin-poin penting tentang sistem konfigurasi

• File memori (CLAUDE.md): Berisi instruksi dan konteks yang dimuat Claude saat startup
• File pengaturan (JSON): Konfigurasikan izin, variabel lingkungan, dan perilaku alat
• Perintah garis miring: Perintah khusus yang dapat dipanggil selama sesi dengan /command-name
• Server MCP: Perluas Claude Code dengan alat dan integrasi tambahan
• Prioritas: Konfigurasi tingkat lebih tinggi (Perusahaan) mengganti yang tingkat lebih rendah (Pengguna/Proyek)
• Warisan: Pengaturan digabungkan, dengan pengaturan yang lebih spesifik menambah atau mengganti yang lebih luas

​

Ketersediaan prompt sistem

​

Mengecualikan file sensitif

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

​

Konfigurasi subagent

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

​

Konfigurasi plugin

​

Pengaturan plugin

{
  "enabledPlugins": {
    "formatter@company-tools": true,
    "deployer@company-tools": true,
    "analyzer@security-plugins": false
  },
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": "github",
      "repo": "company/claude-plugins"
    }
  }
}

​

enabledPlugins

• Pengaturan pengguna (~/.claude/settings.json): Preferensi plugin pribadi
• Pengaturan proyek (.claude/settings.json): Plugin khusus proyek yang dibagikan dengan tim
• Pengaturan lokal (.claude/settings.local.json): Penggantian per-mesin (tidak dikomit)

{
  "enabledPlugins": {
    "code-formatter@team-tools": true,
    "deployment-tools@team-tools": true,
    "experimental-features@personal": false
  }
}

​

extraKnownMarketplaces

1. Anggota tim diminta untuk menginstal marketplace saat mereka mempercayai folder
2. Anggota tim kemudian diminta untuk menginstal plugin dari marketplace itu
3. Pengguna dapat melewati marketplace atau plugin yang tidak diinginkan (disimpan dalam pengaturan pengguna)
4. Instalasi menghormati batas kepercayaan dan memerlukan persetujuan eksplisit

{
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": {
        "source": "github",
        "repo": "company-org/claude-plugins"
      }
    },
    "security-plugins": {
      "source": {
        "source": "git",
        "url": "https://git.company.com/security/plugins.git"
      }
    }
  }
}

• github: Repositori GitHub (menggunakan repo)
• git: URL git apa pun (menggunakan url)
• directory: Jalur sistem file lokal (menggunakan path, hanya untuk pengembangan)

​

Mengelola plugin

• Jelajahi plugin yang tersedia dari marketplace
• Instal/copot plugin
• Aktifkan/nonaktifkan plugin
• Lihat detail plugin (perintah, agen, hook yang disediakan)
• Tambah/hapus marketplace

​

Variabel lingkungan

​

Alat yang tersedia untuk Claude

​

Memperluas alat dengan hook

​

Lihat juga

• Identitas dan Manajemen Akses - Pelajari tentang sistem izin Claude Code
• IAM dan kontrol akses - Manajemen kebijakan perusahaan
• Pemecahan masalah - Solusi untuk masalah konfigurasi umum