Konfigurasi pengaturan yang dikelola server

​

Persyaratan

• Paket Claude for Teams atau Claude for Enterprise
• Peran Owner atau Primary Owner di organisasi Claude Anda, untuk melihat dan mengedit konfigurasi
• Akses jaringan ke api.anthropic.com

​

Pilih antara pengaturan yang dikelola server dan endpoint

​

Konfigurasi pengaturan yang dikelola server

{
  "permissions": {
    "deny": [
      "Bash(curl *)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ],
    "disableBypassPermissionsMode": "disable"
  },
  "allowManagedPermissionRulesOnly": true
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "/usr/local/bin/audit-edit.sh" }
        ]
      }
    ]
  }
}

​

Verifikasi pengiriman pengaturan

• Pengaturan yang dikirimkan dimuat
• Organisasi Anda tidak memiliki pengaturan yang dikelola server yang dikonfigurasi
• Pengambilan gagal, dengan penyebab dan apakah kebijakan yang di-cache masih berlaku
• Claude Code melewati pengambilan, dengan alasannya. Lihat Ketersediaan platform untuk penyedia dan konfigurasi yang melewatinya

​

Kontrol akses

• Primary Owner
• Owner

​

Pengaturan yang hanya dikelola

​

Batasan saat ini

• Pengaturan berlaku secara seragam untuk semua pengguna dalam organisasi. Konfigurasi per-grup belum didukung.
• Anda tidak dapat mendistribusikan file managed-mcp.json melalui pengaturan yang dikelola server. Berikan kunci kebijakan allowedMcpServers dan deniedMcpServers di sana sebagai gantinya. Pada Claude Code v2.1.259 atau lebih baru, Anda juga dapat menyediakan server jarak jauh dengan managedMcpServers, yang menerima server http dan sse saja dan tidak mengambil kontrol eksklusif seperti yang dilakukan file. Claude Code membaca file managed-mcp.json yang digunakan di jalur sistemnya secara terpisah dari tingkat pengaturan terkelola, jadi file masih berlaku ketika pengaturan yang dikelola server berlaku.
• Pengaturan yang dibatasi untuk sumber kebijakan tingkat OS, seperti policyHelper dan wslInheritsWindowsSettings, tidak dihormati. Terapkan melalui MDM atau file managed-settings.json sistem sebagai gantinya. policyHelper yang digunakan dengan cara itu berjalan hanya ketika sumbernya adalah yang dipilih di bawah prioritas dalam tingkat terkelola.

​

Pengiriman pengaturan

​

Prioritas pengaturan

​

Pengecualian per-kunci di seluruh sumber terkelola

• Kunci kunci lintas sumber: serangkaian kecil kunci, seperti kunci daftar pasir sandbox, tercantum di halaman pengaturan terkelola. Claude Code menghormatinya ketika sumber terkelola yang dikendalikan admin apa pun menetapkannya; tingkat registri HKCU yang dapat ditulis pengguna dikecualikan. Ketika policyHelper menyediakan pengaturan terkelola, outputnya adalah satu-satunya sumber yang pemeriksaan ini baca, terlepas dari forceRemoteSettingsRefresh, yang Claude Code baca dari sumber admin secara langsung pada startup.
• Blok env: terlepas dari unit telemetri dan variabel routing yang dipasangkan dengan kunci kredensial, keduanya dibahas di bawah, blok ini menggabungkan per kunci di seluruh sumber yang dikendalikan admin. Untuk setiap variabel lingkungan, sumber dengan prioritas tertinggi yang mendefinisikannya menang, dan sumber admin yang lebih rendah mengisi variabel yang sumber yang lebih tinggi biarkan tidak diatur. Entri env yang dikelola endpoint oleh karena itu berlaku kapan pun konfigurasi yang dikelola server meninggalkan variabel tersebut tidak diatur, atau saat nilai server yang di-cache untuk itu ditahan menunggu konfirmasi server. Memerlukan Claude Code v2.1.223 atau lebih baru. Sebelum v2.1.223, Claude Code menerapkan blok env sumber yang dipilih secara keseluruhan saja.
  • Unit telemetri: kunci exporter OTEL_EXPORTER_OTLP_*, toggle penangkapan konten OTEL_LOG_*, OTEL_LOGS_EXPORTER, dan variabel tracing beta ENABLE_BETA_TRACING_DETAILED dan BETA_TRACING_ENDPOINT mengikuti sumber tertinggi yang menetapkan salah satu dari mereka sebagai unit. Sumber yang mengirimkan kunci kredensial otelHeadersHelper juga mengklaim unit, tetapi mendarat variabel ini hanya ketika itu adalah sumber yang dipilih: sumber yang tidak dipilih tetapi mengirimkan kunci tidak berkontribusi pada salah satu dari mereka dan masih memblokir sumber yang lebih rendah dari mengisinya. Bagaimanapun, endpoint exporter dari satu sumber tidak pernah dapat dipasangkan dengan kredensial dari sumber lain.
  • Routing yang dipasangkan kredensial: sumber yang memasangkan variabel routing dengan kunci kredensial yang hanya dipilih-sumber, seperti apiKeyHelper atau otelHeadersHelper, berkontribusi pada variabel routing tersebut hanya ketika itu memenangkan slot.
• Kunci masuk gateway: Claude Code tidak pernah membaca forceLoginGatewayUrl atau nilai "gateway" dari forceLoginMethod dari pengaturan yang dikelola server, jadi memilih pengaturan yang dikelola server tidak menyediakan masuk gateway atau menyembunyikan yang diatur dalam kebijakan MDM atau file pengaturan terkelola. Entri managedSourcesBehavior mengatakan sumber admin mana di mesin yang menyediakannya.

​

Perilaku pengambilan dan caching

• Ketika pengembang masuk pada startup, seperti pada jalankan pertama atau setelah /logout, Claude Code menunggu hingga lima detik untuk pengambilan sebelum membuka sesi. Ketika kebijakan tiba tepat waktu, Claude Code memberlakukannya dari layar pertama dan menampilkan companyAnnouncements Anda di atasnya. Ketika payload memerlukan persetujuan keamanan, Claude Code mengakhiri penunggu dan menerapkan payload setelah pengembang menyetujui
• Pada startup lainnya, dan ketika penunggu lima detik habis, Claude Code membuka sesi sementara pengambilan berlanjut, jadi jendela singkat berlalu sebelum pengaturan dimuat dan pembatasan berlaku
• Jika pengambilan gagal, Claude Code melanjutkan tanpa pengaturan yang dikelola server dan memperingatkan dalam sesi interaktif bahwa tidak ada kebijakan jarak jauh yang berlaku; pengaturan yang dikelola endpoint masih berlaku. Jika sumber terkelola menetapkan forceRemoteSettingsRefresh, Claude Code keluar sebagai gantinya

• Pengaturan yang di-cache berlaku segera pada startup, kecuali untuk nilai modelPricing dan managedMcpServers yang di-cache dan variabel lingkungan yang Claude Code tahan sampai server mengonfirmasi payload
• modelPricing yang di-cache tidak berlaku hingga pengambilan sesi mengonfirmasi payload. Sampai saat itu, angka biaya yang dilihat pengembang di /usage dan baris status berada pada harga daftar
• Blok managedMcpServers yang di-cache tidak berlaku hingga pengambilan sesi mengonfirmasi payload. Claude Code menunggu hingga 30 detik untuk pengambilan tersebut sebelum menghubungkan server MCP. Jika pengambilan gagal atau habis waktu, sesi dimulai tanpa server organisasi, /status mengatakan demikian, dan mereka terhubung setelah pengambilan yang lebih baru mengonfirmasinya. Lihat Ketika server yang disediakan terhubung untuk perilaku lengkap, termasuk peluncuran pertama. Memerlukan Claude Code v2.1.259 atau lebih baru
• Claude Code mengambil pengaturan segar di latar belakang
• Pengaturan yang di-cache bertahan melalui kegagalan jaringan. Jika pengambilan startup gagal, Claude Code memperingatkan dalam sesi interaktif bahwa kebijakan yang di-cache berlaku
• Sampai pengambilan berhasil, nilai yang ditahan pada startup tetap ditahan

• Konfigurasi proxy dan TLS, seperti HTTPS_PROXY, NODE_EXTRA_CA_CERTS, dan variabel sertifikat klien mTLS CLAUDE_CODE_CLIENT_CERT dan CLAUDE_CODE_CLIENT_KEY
• Routing API dan pemilihan penyedia, termasuk ANTHROPIC_BASE_URL, variabel pemilihan penyedia seperti CLAUDE_CODE_USE_BEDROCK dan CLAUDE_CODE_USE_VERTEX, dan URL endpoint penyedia seperti ANTHROPIC_BEDROCK_BASE_URL
• Kredensial autentikasi, seperti ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, dan CLAUDE_CODE_OAUTH_TOKEN
• Pemilih direktori konfigurasi CLAUDE_CONFIG_DIR
• Pemilih sumber kredensial dan direktori konfigurasi, dalam Claude Code v2.1.223 atau lebih baru: variabel Workload Identity Federation seperti ANTHROPIC_FEDERATION_RULE_ID dan ANTHROPIC_IDENTITY_TOKEN, pemilih profil dan direktori konfigurasi ANTHROPIC_PROFILE dan ANTHROPIC_CONFIG_DIR, dan variabel direktori sistem operasi HOME, XDG_CONFIG_HOME, APPDATA, dan USERPROFILE

​

Entri tidak valid dalam pengaturan yang dikirimkan

• Cache di ~/.claude/remote-settings.json menyimpan payload yang diselamatkan dengan entri tidak valid dihapus, terlepas dari nilai cleanupPeriodDays dan desktopSessionCleanupPeriodDays yang tidak valid, yang tetap dalam salinan yang di-cache dan tidak pernah diterapkan.
• Ketika tidak ada bidang dalam payload yang dapat diselamatkan dan payload bukan hanya kunci retensi tersebut, Claude Code menolak payload, menyimpan pengaturan cache yang terakhir diterima, dan menulis Remote settings: Settings validation failed - no fields could be salvaged ke log debug. Dengan forceRemoteSettingsRefresh diatur, CLI keluar sebagai gantinya.
• Dialog persetujuan keamanan mengevaluasi payload yang diselamatkan, jadi entri tidak valid yang dilucuti tidak pernah disajikan untuk persetujuan dan tidak pernah dieksekusi.

​

Paksakan startup yang tertutup gagal

• Jika gateway menjawab peluncuran interaktif yang dihadiri dengan 401 dan pengaturan ini mati, gateway telah mengakhiri masuk tersebut. Claude Code mencetak Cloud gateway session expired — run /login to reconnect. dan membuka sesi yang keluar dari gateway sampai pengguna menjalankan /login.
• Ketika pengambilan gagal dengan cara lain, atau dalam jenis peluncuran lain apa pun kecuali subperintah claude auth, klien keluar dengan kesalahan.

{
  "forceRemoteSettingsRefresh": true
}

​

Dialog persetujuan keamanan

• Pengaturan perintah shell: pengaturan yang menjalankan perintah shell, seperti apiKeyHelper, statusLine, dan otelHeadersHelper
• Pengaturan biner sandbox: sandbox.bwrapPath, sandbox.socatPath, dan sandbox.ripgrep. Masing-masing pengaturan ini menunjuk pada executable, dan Claude Code menjalankan executable tersebut
• Pengaturan jaringan dan isolasi sandbox: pengaturan sandbox yang memungkinkan proxy sandbox membaca, mengarahkan ulang, atau mengautentikasi lalu lintas, atau yang melemahkan isolasi sandbox: sandbox.network.tlsTerminate, sandbox.network.httpProxyPort, sandbox.network.socksProxyPort, sandbox.credentials, sandbox.allowAppleEvents, sandbox.enableWeakerNestedSandbox, sandbox.enableWeakerNetworkIsolation, sandbox.filesystem.disabled, sandbox.network.allowAllUnixSockets, sandbox.network.allowUnixSockets, dan sandbox.network.allowMachLookup. Blok sandbox.credentials yang hanya berisi aturan deny tidak memerlukan persetujuan, karena membatasi sandbox tanpa memberikan proxy kredensial. Sebelum v2.1.251, Claude Code menerapkan pengaturan ini tanpa persetujuan
• Variabel lingkungan kustom: variabel env yang dikirimkan yang memerlukan persetujuan pengguna, seperti proxy dan variabel URL dasar; lihat Variabel lingkungan dan dialog persetujuan
• Konfigurasi hook: definisi hook apa pun

​

Memori persetujuan

• Login claude.ai yang disimpan oleh /login atau claude auth login, atau masuk Console tanpa kunci: satu persetujuan per organisasi, dipegang oleh akun yang menyetujui paling baru.
• Masuk gateway aplikasi Claude: satu persetujuan per gateway. Jika Anda keluar dan masuk kembali ke gateway yang sama, Claude Code tidak menampilkan dialog lagi saat pengaturan yang memerlukan persetujuan tidak berubah. Claude Code menampilkannya lagi ketika pengaturan tersebut berubah, ketika Anda masuk ke gateway yang berbeda, dan ketika Anda menerima sertifikat baru untuk gateway yang sama. Claude Code tidak menyimpan persetujuan untuk gateway pengembangan loopback yang dicapai melalui HTTP biasa, jadi dialog muncul lagi setelah setiap masuk.
• Kredensial lainnya, seperti kunci API atau CLAUDE_CODE_OAUTH_TOKEN: satu persetujuan untuk pengaturan yang dikirimkan, disimpan dengan salinan yang di-cache dari pengaturan di direktori konfigurasi tersebut. Claude Code menampilkan dialog lagi ketika pengaturan yang memerlukan persetujuan berubah, dan setelah Anda menjalankan /logout atau claude auth logout, salah satu dari keduanya menghapus salinan yang di-cache.

• Jika Anda keluar dan masuk kembali, atau beralih ke organisasi lain dan kemudian kembali, Claude Code tidak menampilkan dialog lagi saat pengaturan tersebut tidak berubah, kecuali akun lain menyetujuinya untuk organisasi tersebut di direktori konfigurasi yang sama di antara.
• Jika Anda masuk ke organisasi yang sama dengan akun yang berbeda, Claude Code menampilkan dialog lagi bahkan ketika pengaturan tidak berubah. Persetujuan akun tersebut menggantikan yang sebelumnya, jadi ketika Anda beralih kembali, Claude Code menampilkan dialog sekali lagi.

• Sesi interaktif yang tidak dapat menampilkan dialog: Claude Code tidak menerapkan pengaturan yang dikirimkan dan menyimpan pengaturan yang terakhir disetujui. Dialog muncul dalam sesi berikutnya yang dapat menampilkannya. Memerlukan Claude Code v2.1.211 atau lebih baru.
• claude install atau claude update: Claude Code tidak menampilkan dialog selama perintah apa pun. Perintah berjalan dengan pengaturan yang terakhir disetujui, dan dialog muncul dalam sesi interaktif Anda berikutnya. Jika Claude Code menunggu pengambilan pengaturan pada startup, seperti dengan forceRemoteSettingsRefresh diatur atau pada penyebaran gateway aplikasi Claude, itu menampilkan dialog selama perintah sebagai gantinya, dan jalankan install dari pipa gagal; lihat Raw mode is not supported during install. Sebelum v2.1.246, Claude Code mencoba menampilkan dialog selama perintah ini juga.
• Kesalahan menutup dialog sebelum Anda menjawab: Claude Code tidak menerapkan pengaturan yang dikirimkan dan menyimpan pengaturan yang terakhir disetujui. Itu menampilkan dialog lagi dalam sesi berikutnya yang dapat menampilkannya.
• Jalankan non-interaktif, seperti claude -p atau sesi Agent SDK: Claude Code tidak dapat menampilkan dialog, jadi ketika pengaturan yang dikirimkan memerlukan persetujuan, itu menerapkannya hanya untuk jalankan itu. Itu tidak merekamnya sebagai disetujui atau menulisnya ke cache lokal, dan sesi interaktif berikutnya menampilkan dialog. Sampai pengguna menyetujui dalam sesi interaktif, setiap jalankan non-interaktif mengambil pengaturan lagi pada startup. Sebelum v2.1.207, jalankan non-interaktif menyimpan pengaturan sebagai disetujui, jadi sesi interaktif kemudian tidak pernah menampilkan dialog untuk mereka.

​

Variabel lingkungan dan dialog persetujuan

• Pengalihan fitur dan perintah
• Pemilihan model dan pengaturan perilaku, seperti ANTHROPIC_MODEL, DISABLE_PROMPT_CACHING, dan CLAUDE_CODE_EFFORT_LEVEL
• Jendela konteks dan pengaturan pemadatan, seperti DISABLE_AUTO_COMPACT
• Opsi UI terminal dan aksesibilitas
• Batas numerik, anggaran, dan waktu tunggu

​

Ketersediaan platform

• Login OAuth Organisasi atau Perusahaan
• Token OAuth yang disediakan melalui CLAUDE_CODE_OAUTH_TOKEN
• Kunci API yang dikonfigurasi secara langsung
• Profil user_oauth Anthropic, kecuali profil menetapkan base_url selain API Anthropic. Memerlukan Claude Code v2.1.257 atau lebih baru.

​

Audit logging

​

Pertimbangan keamanan

​

Lihat juga

• Semua pengaturan: setiap kunci pengaturan
• Pengaturan yang dikelola endpoint: pengaturan terkelola yang digunakan ke perangkat oleh IT
• Authentication: atur akses pengguna ke Claude Code
• Security: perlindungan keamanan dan praktik terbaik