SpyBara
Go Premium

admin-setup.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 62 additions and 62 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sun 4 23:58 Mon 5 23:58 Tue 6 23:59 Wed 7 23:59 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Mon 26 22:57 Tue 27 22:59

Siapkan Claude Code untuk organisasi Anda

Peta keputusan untuk administrator yang menerapkan Claude Code, mencakup penyedia API, pengaturan terkelola, penegakan kebijakan, pemantauan penggunaan, dan penanganan data.

Claude Code memberlakukan kebijakan organisasi melalui pengaturan terkelola yang mengambil alih konfigurasi pengembang lokal. Anda mengirimkan pengaturan tersebut dari konsol admin Claude, sistem manajemen perangkat seluler (MDM) Anda, atau file di disk. Pengaturan mengontrol alat, perintah, server, dan tujuan jaringan mana yang dapat dijangkau Claude.

Halaman ini memandu keputusan penerapan secara berurutan. Setiap baris menautkan ke bagian di bawah dan ke halaman referensi untuk area tersebut.

[!NOTE]

SSO, penyediaan SCIM, dan penugasan kursi dikonfigurasi di tingkat akun Claude. Lihat Panduan Administrator Enterprise Claude dan penugasan kursi untuk langkah-langkah tersebut.

Keputusan Yang Anda pilih Referensi
Pilih penyedia API Anda Tempat Claude Code melakukan autentikasi dan cara penagihan Authentication, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry
Tentukan cara pengaturan mencapai perangkat Bagaimana kebijakan terkelola mencapai mesin pengembang Server-managed settings, Delivery mechanisms
Tentukan apa yang akan diberlakukan Alat, perintah, dan integrasi mana yang diizinkan Permissions, Sandboxing
Siapkan visibilitas penggunaan Cara Anda melacak pengeluaran dan adopsi Analytics, Monitoring, Costs
Tinjau penanganan data Retensi data dan postur kepatuhan Data usage, Security

Pilih penyedia API Anda

Claude Code terhubung ke Claude melalui salah satu dari beberapa penyedia API. Pilihan Anda mempengaruhi penagihan, autentikasi, postur kepatuhan mana yang Anda warisi, dan fitur Claude Code mana yang dapat digunakan pengembang Anda.

Penyedia Pilih ini ketika
Claude for Teams / Enterprise Anda menginginkan Claude Code dan claude.ai di bawah satu langganan per-kursi tanpa infrastruktur untuk dijalankan. Ini adalah rekomendasi default.
Claude Console Anda adalah API-first atau menginginkan penagihan pay-as-you-go
Amazon Bedrock Anda ingin mewarisi kontrol kepatuhan dan penagihan AWS yang ada
Google Cloud's Agent Platform Anda ingin mewarisi kontrol kepatuhan dan penagihan GCP yang ada
Microsoft Foundry Anda ingin mewarisi kontrol kepatuhan dan penagihan Azure yang ada

Beberapa fitur Claude Code memerlukan akun claude.ai. Sesi cloud, tugas terjadwal cloud, Code Review, Remote Control, dan ekstensi Chrome tidak tersedia melalui kunci API Console atau kredensial penyedia cloud saja. Jika Anda men-deploy melalui Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry, rencanakan apakah pengembang juga memerlukan kursi Claude for Teams atau Enterprise. Setiap halaman fitur mencantumkan persyaratan paketnya.

Untuk perbandingan penyedia lengkap yang mencakup autentikasi, wilayah, dan kesetaraan fitur, lihat ikhtisar penerapan enterprise. Pengaturan auth setiap penyedia ada di Authentication.

Persyaratan proxy dan firewall di Network configuration berlaku terlepas dari penyedia. Jika Anda menginginkan satu titik akhir di depan beberapa penyedia atau pencatatan permintaan terpusat, lihat LLM gateway.

Tentukan cara pengaturan mencapai perangkat

Pengaturan terkelola mendefinisikan kebijakan organisasi. Claude Code memeriksa empat sumber dalam tabel di bawah ini dalam urutan prioritas. Bagaimana Claude Code menggabungkan sumber terkelola mengatakan yang mana dari mereka berlaku, apa yang diubah pembantu kebijakan, dan cara menyusun setiap sumber. Tabel adalah peta keputusan.

Mekanisme Pengiriman Prioritas Platform
Server-managed Konsol admin claude.ai, atau Claude apps gateway yang di-host sendiri untuk sign-in gateway Tertinggi Semua
plist / registry policy macOS: com.anthropic.claudecode plist Windows: HKLM\SOFTWARE\Policies\ClaudeCode Tinggi macOS, Windows
File-based managed macOS: /Library/Application Support/ClaudeCode/managed-settings.json Linux dan WSL: /etc/claude-code/managed-settings.json Windows: C:\Program Files\ClaudeCode\managed-settings.json Sedang Semua
Windows user registry HKCU\SOFTWARE\Policies\ClaudeCode Terendah Windows saja

Claude Code mengambil pengaturan terkelola server saat startup dan menyegarkannya setiap jam selama sesi, tanpa infrastruktur endpoint untuk di-deploy. Pengiriman melalui konsol admin claude.ai memerlukan rencana Claude for Teams atau Enterprise. Deployment pada Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry dapat mendapatkan pengiriman jarak jauh yang sama dengan menjalankan Claude apps gateway, atau menggunakan salah satu mekanisme berbasis file atau tingkat OS sebagai gantinya.

Jika organisasi Anda mencampur penyedia, konfigurasikan server-managed settings untuk pengguna claude.ai ditambah fallback berbasis file atau plist/registry sehingga pengguna lain masih menerima kebijakan terkelola.

Lokasi plist dan HKLM registry bekerja dengan penyedia apa pun dan tahan terhadap gangguan karena memerlukan hak istimewa admin untuk menulis. Registry pengguna Windows di HKCU dapat ditulis tanpa elevasi, jadi perlakukan sebagai default kenyamanan daripada saluran penegakan.

Secara default, WSL hanya membaca jalur file Linux di /etc/claude-code. Untuk memperluas kebijakan registry Windows dan C:\Program Files\ClaudeCode Anda ke WSL pada mesin yang sama, atur wslInheritsWindowsSettings: true di salah satu sumber Windows yang hanya admin.

Mekanisme apa pun yang Anda pilih, nilai terkelola diutamakan daripada pengaturan pengguna dan proyek, dengan beberapa pengecualian yang sensitif terhadap keamanan. Pengaturan array seperti permissions.allow dan permissions.deny menggabungkan entri dari semua sumber, jadi pengembang dapat memperluas daftar terkelola tetapi tidak menghapusnya. Untuk fallbackModel, availableModels, dan modelPicker, nilai terkelola menggantikan lapisan yang lebih rendah daripada menggabungkan.

Sesi WSL di Claude Code Desktop

Di Windows, Claude Code Desktop dapat menjalankan sesi Code di dalam distribusi WSL 2. Proses Claude Code sesi berjalan di dalam distribusi, jadi ia menyelesaikan pengaturan terkelola melalui jalur penemuan WSL di atas: sumber khusus Windows tidak mencapainya kecuali wslInheritsWindowsSettings: true di-deploy.

Claude Desktop mematikan sesi WSL secara default pada perangkat yang terdeteksi sebagai terkelola organisasi, misalnya ketika C:\Program Files\ClaudeCode\managed-settings.json ada. Untuk mengaktifkannya, deploy kebijakan registry Windows, yang memerlukan Claude Desktop v1.19367.0 atau lebih baru:

  • Buat nilai bernama disableWslSessions di bawah HKLM\SOFTWARE\Policies\Claude dan atur ke string REG_SZ false atau REG_DWORD 0. Nilai ini berada di bawah kunci kebijakan Claude Desktop, terpisah dari kunci ClaudeCode yang membawa pengaturan terkelola. Deploy nilai di bawah HKLM, yang memerlukan hak istimewa administrator untuk menulis. Nilai di bawah HKCU tidak mengaktifkan sesi WSL.
  • Biarkan C:\Program Files\ClaudeCode\managed-settings.json tetap ada jika Anda men-deploy-nya. Setelah disableWslSessions adalah false di bawah HKLM, Desktop memungkinkan sesi WSL meskipun file itu ada.

Desktop membaca kebijakan setiap kali sesi WSL dimulai, jadi Anda tidak perlu memulai ulang aplikasi setelah men-deploy-nya.

Jika perangkat masih menolak sesi WSL, buka Help > Troubleshooting > Show Logs in File Explorer di Claude Desktop pada perangkat itu, yang menyimpan salinan folder lognya ke Downloads. Cari main.log dalam salinan itu untuk [wslPolicyGate] denying WSL session. Alasan penolakan mengikuti dalam tanda kurung, seperti (cli-file-present).

Setelah sesi WSL diaktifkan, perluas pengaturan terkelola Anda ke mereka:

  • Deploy wslInheritsWindowsSettings: true melalui registry HKLM atau file C:\Program Files\ClaudeCode sehingga sesi WSL mewarisi kebijakan yang sama dengan sesi host.
  • Verifikasi dengan menjalankan /status di dalam sesi WSL dan membaca baris Setting sources. Untuk menginterpretasikan apa yang ditampilkannya, lihat Baca sumber dalam /status.

Proses di dalam VM utilitas WSL 2 tidak terlihat oleh sensor deteksi endpoint sisi Windows. Untuk mengamati aktivitas proses dan file dalam-distro, periksa panduan WSL vendor deteksi endpoint Anda untuk sensor Linux yang dapat Anda jalankan di dalam distribusi dan pengecualian yang diperlukannya. Telemetri eksekusi alat OpenTelemetry Claude Code dipancarkan secara identik untuk sesi WSL dan native.

Tentukan apa yang akan diberlakukan

Pengaturan terkelola dapat mengunci alat, eksekusi sandbox, membatasi server MCP dan sumber plugin, dan mengontrol hook mana yang berjalan. Setiap baris adalah permukaan kontrol dengan kunci pengaturan yang mendorong.

Kontrol Apa yang dilakukan Pengaturan kunci
Permission rules Izinkan, tanyakan, atau tolak alat dan perintah tertentu permissions.allow, permissions.deny
Permission lockdown Buat pengaturan terkelola menjadi satu-satunya sumber pengaturan aturan izin. Nonaktifkan --dangerously-skip-permissions allowManagedPermissionRulesOnly, permissions.disableBypassPermissionsMode
Starting permission mode Pilih mode izin yang dimulai sesi terminal pengembang Anda alih-alih mode izin awal bawaan, atau hapus mode otomatis. Switch permission modes mencantumkan kapan ekstensi VS Code membaca defaultMode yang Anda atur permissions.defaultMode, permissions.disableAutoMode
Sandboxing Isolasi filesystem dan jaringan tingkat OS dengan daftar allowlist domain sandbox.enabled, sandbox.network.allowedDomains
Managed policy CLAUDE.md Panduan perilaku di seluruh organisasi untuk Claude, bukan aturan yang diberlakukan oleh klien File di jalur kebijakan terkelola
MCP server control Batasi server MCP mana yang dapat ditambahkan atau dihubungkan pengguna, terapkan set tetap, atau sediakan server jarak jauh kepada setiap pengguna bersama dengan server mereka sendiri allowedMcpServers, deniedMcpServers, allowManagedMcpServersOnly, managedMcpServers, atau file managed-mcp.json yang diterapkan
Plugin marketplace control Batasi sumber marketplace mana yang dapat ditambahkan dan diinstal pengguna, tolak flag CLI yang memuat plugin, agent, dan server MCP untuk satu kali berjalan, blokir sumber plugin command, dan daftar allowlist plugin marketplace mana yang dapat disarankan strictKnownMarketplaces, blockedMarketplaces, disableSideloadFlags, disableCommandPluginSources, pluginSuggestionMarketplaces
Customization lockdown Blokir skills, agents, hooks, dan server MCP dari sumber pengguna dan proyek, sehingga mereka hanya dapat berasal dari plugin atau pengaturan terkelola. Mengunci skills juga menghentikan skills yang diaktifkan pengembang Anda di claude.ai dari sinkronisasi strictPluginOnlyCustomization
Disable claude.ai sync Hentikan Claude Code dari memuat skills dan plugins yang diaktifkan pengembang Anda di claude.ai. Jika Anda mematikan Skills untuk organisasi Anda di claude.ai, Claude Code berhenti menyinkronkan keduanya, dan pada v2.1.273 atau lebih baru juga menghapus yang sudah disinkronkan. Untuk menghentikan salah satu tanpa mematikan Skills, atur kuncinya ke false dalam pengaturan terkelola syncClaudeAiSkills, syncClaudeAiPlugins
Hook restrictions Batasi hook mana yang berjalan dan batasi URL hook HTTP; lihat apa yang berjalan di bawah allowManagedHooksOnly untuk daftar efek lengkap allowManagedHooksOnly, allowedHttpHookUrls
Login enforcement Batasi login ke metode tertentu atau organisasi Anthropic. Pembatasan metode berlaku di seluruh ekstensi VS Code, Agent SDK, claude setup-token, dan /install-github-app, dan layar login interaktif terminal, dicapai oleh /login atau onboarding first-run, pra-pilih metode tanpa memberlakukannya; Claude Code memverifikasi organisasi untuk login akun claude.ai di terminal, ekstensi VS Code, dan Agent SDK, dan tidak memeriksanya untuk login Claude Console atau untuk sign-in gateway. Sebelum v2.1.212, hanya login terminal yang menerapkan salah satu kunci. Ketika diatur, sesi yang diautentikasi oleh ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, atau apiKeyHelper diblokir saat startup; sesi penyedia cloud tidak terpengaruh kecuali salah satu dari kredensial tersebut, atau kunci API yang disimpan oleh login Claude Console sebelumnya, juga ada forceLoginMethod, forceLoginOrgUUID
Provider restrictions Batasi penyedia API mana yang dapat digunakan mesin. Sesi di penyedia yang tidak terdaftar ditolak saat startup, saat login, dan ketika berikutnya menghubungi API. Memerlukan Claude Code v2.1.285 atau lebih baru allowedProviders
Disable agent view Matikan claude agents, --bg, /background, dan supervisor on-demand disableAgentView
Configure the corporate launcher Awali background-agent supervisor, pekerja-pekerja, dan proses latar belakang tercakup lainnya dengan corporate launcher yang diperlukan alih-alih mematikan agent view processWrapper
Model restrictions availableModels memfilter model mana yang muncul di pemilih. Menambahkan enforceAvailableModels juga membatasi model default yang dipilih secara otomatis. Lihat surface coverage untuk cara pengaturan ini menjangkau CLI, web, dan IDE availableModels, enforceAvailableModels
Effort cap Batasi effort level untuk setiap model atau per model, di setiap penyedia maxEffortLevel
Version floor Cegah auto-update dari penginstalan di bawah minimum di seluruh organisasi minimumVersion
Required version range Tolak untuk memulai sama sekali ketika versi yang berjalan berada di luar rentang yang disetujui organisasi. Lebih kuat daripada minimumVersion, yang hanya memblokir downgrade requiredMinimumVersion, requiredMaximumVersion
Telemetry opt-out Matikan metrik penggunaan terikat Anthropic, laporan kesalahan, dan survei di setiap perangkat env dengan CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC diatur ke 1; bagian tertaut mencantumkan variabel per kategori

Jika anggota Anda masuk melalui claude.ai atau Anthropic API dan Anda berada di paket Claude Enterprise, Anda juga dapat mengatur model dari pengaturan admin organisasi Anda tanpa menerapkan apa pun:

Tidak ada kontrol ini yang menjangkau sesi di Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, atau Claude Platform on AWS. Di penyedia tersebut, gunakan pengaturan terkelola sebagai gantinya: availableModels untuk pembatasan, model untuk default, dan maxEffortLevel untuk batas upaya.

Cloud sessions memiliki surface admin sendiri di claude.ai:

Aturan izin dan sandboxing mencakup lapisan berbeda. Menolak WebFetch memblokir alat fetch Claude, tetapi jika Bash diizinkan, curl dan wget masih dapat menjangkau URL apa pun. Sandboxing menutup celah itu dengan daftar allowlist domain jaringan yang diberlakukan di tingkat OS.

Untuk model ancaman yang dilindungi kontrol ini, lihat Security.

Akun GitHub yang terhubung

Pada paket Team dan Enterprise, bagian GitHub di Organization settings > Git providers mencantumkan organisasi GitHub dan akun pribadi yang ditautkan ke organisasi Claude Anda melalui Claude GitHub App. Claude Code, Claude Tag, dan Claude Security berbagi daftar tersebut. Membuka halaman tersebut memerlukan peran admin di organisasi Claude Anda.

Admin atau anggota dapat menautkan akun:

  • Koneksi admin: admin mengklik Connect di bagian tersebut, atau Add organization setelah sebuah akun terhubung, dan menginstal Claude GitHub App pada organisasi GitHub. Menautkan organisasi dengan cara ini memerlukan seseorang yang merupakan pemilik organisasi GitHub sekaligus admin organisasi Claude Anda.
  • Koneksi anggota: ketika anggota menghubungkan akun GitHub mereka ke Claude, misalnya saat menyiapkan sesi cloud, Claude menautkan akun GitHub yang dimiliki anggota tersebut tempat Claude GitHub App sudah terinstal. Itu dapat mencakup akun pribadi mereka dan organisasi GitHub yang mereka miliki.

Baris yang ditandai Not linked berasal dari sign-in GitHub Anda sendiri. Itu adalah akun yang dapat Anda lihat di GitHub tempat Claude GitHub App terinstal.

Untuk melepas tautan akun dari organisasi Claude Anda, buka menu barisnya dan pilih Unlink from this workspace. Melepas tautan membiarkan Claude GitHub App tetap terinstal di GitHub, dan akun tersebut ditautkan kembali saat salah satu pemiliknya menghubungkan GitHub ke Claude berikutnya. Agar akun tidak ditautkan kembali, hapus instalasi Claude GitHub App dari akun tersebut di GitHub.

Pada paket Enterprise, jenis aktivitas Compliance API untuk penautan dan pelepasan tautan adalah github_app_installation_linked dan github_app_installation_unlinked.

Siapkan visibilitas penggunaan

Pilih pemantauan berdasarkan apa yang perlu Anda laporkan. Dasbor, API, dan kontrol pengeluaran berbeda antara Claude for Teams atau paket Enterprise dan organisasi Claude Console, jadi periksa kolom Ketersediaan sebelum Anda merencanakan pelaporan Anda di sekitar kemampuan.

Kemampuan Yang Anda dapatkan Ketersediaan Mulai dari mana
Usage monitoring Ekspor OpenTelemetry sesi, alat, dan token Semua penyedia Monitoring usage
Analytics dashboard Metrik adopsi dan kontribusi dengan papan peringkat di Teams / Enterprise; metrik penggunaan dan pengeluaran per-pengguna di Console Teams / Enterprise di claude.ai/analytics, Console di platform.claude.com/claude-code Analytics
Programmatic reporting Data penggunaan dan biaya per-pengguna melalui API Enterprise Analytics API untuk Enterprise, Claude Code Analytics API untuk Console Costs
Spend controls Batas pengeluaran dan rate limit Pengaturan organisasi untuk Teams / Enterprise, batas workspace untuk Console; di cloud pihak ketiga, kontrol anggaran cloud atau gateway aplikasi Claude dengan batas pengeluaran per-pengguna Costs

Di Teams dan Enterprise, angka penggunaan dan pengeluaran per-pengguna berasal dari laporan pengeluaran di pengaturan analitik organisasi Anda, bukan dasbor analitik. Penyedia cloud mengekspos pengeluaran melalui AWS Cost Explorer, GCP Billing, atau Azure Cost Management. Untuk merencanakan anggaran enterprise di seluruh Claude chat, Claude Code, dan Cowork, lihat panduan konsumsi Claude Enterprise.

Tinjau penanganan data

Pada rencana Team, Enterprise, Claude API, dan penyedia cloud, Anthropic tidak melatih model pada kode atau prompt Anda. Penyedia API Anda menentukan retensi dan postur kepatuhan.

Topik Yang perlu diketahui Mulai dari mana
Data usage policy Apa yang dikumpulkan Anthropic, berapa lama disimpan, apa yang tidak pernah digunakan untuk pelatihan Data usage
Zero Data Retention (ZDR) Tidak ada yang disimpan setelah permintaan selesai. Tersedia untuk akun yang memenuhi syarat di Claude for Enterprise Zero data retention
Konfigurasi HIPAA Untuk organisasi Claude for Enterprise yang telah mengaktifkan HIPAA. Beberapa fitur Claude Code (mode lokal) dinonaktifkan dan fitur lainnya nonaktif secara default Siapkan Claude Code (mode lokal) untuk organisasi yang siap HIPAA
Security architecture Model jaringan, enkripsi, autentikasi, jejak audit Security

Jika Anda memerlukan pencatatan audit tingkat permintaan atau untuk merutekan lalu lintas berdasarkan sensitivitas data, kami menyarankan Anda menempatkan gateway antara pengembang dan penyedia Anda: Claude apps gateway yang di-host sendiri mencatat log audit per-permintaan dengan identitas IdP, atau Anda dapat menggunakan LLM gateway lainnya. Sesi yang melewati gateway tidak memenuhi syarat untuk konfigurasi HIPAA. Periksa cara pengembang masuk dan terhubung mencantumkan metode masuk dan koneksi mana yang memenuhi syarat. Untuk persyaratan peraturan dan sertifikasi, lihat Legal and compliance.

Verifikasi dan onboard

Setelah mengonfigurasi pengaturan terkelola, minta pengembang menjalankan /status di dalam Claude Code. Pada tab Status, baris Setting sources menunjukkan Enterprise managed settings diikuti oleh sumber dalam tanda kurung; Verify enforcement mencantumkan label-labelnya.

Bagikan sumber daya ini untuk membantu pengembang memulai:

Untuk masalah login, arahkan pengembang ke authentication troubleshooting. Perbaikan paling umum adalah:

  • Jalankan /logout kemudian /login untuk beralih akun
  • Jalankan claude update jika opsi auth enterprise hilang
  • Mulai ulang terminal setelah memperbarui

Jika pengembang melihat "You haven't been added to your organization yet," kursi mereka tidak termasuk akses Claude Code dan perlu diperbarui di konsol admin.

Langkah berikutnya

Dengan penyedia dan mekanisme pengiriman dipilih, lanjutkan ke konfigurasi terperinci: