Jalankan Claude Code di balik peluncur korporat

​

Apa yang dicakup peluncur

• Layanan latar belakang yang dimulai claude agents dan sesi latar belakang sesuai permintaan.
• Host terminal dan sesi Claude Code di dalam setiap baris tampilan agen, termasuk sesi siaga hangat yang disimpan layanan.
• Sesi yang diluncurkan ulang layanan setelah pembaruan atau kerusakan.
• Peluncuran ulang yang dilakukan Claude Code pada dirinya sendiri untuk menyelesaikan pemasangan pembaruan, termasuk tindakan restart-for-update tampilan agen.

​

Proses yang dimulai di luar peluncur

• Layanan latar belakang yang diinstal: launchd atau systemd memulai proses itu dari file unitnya. /status dan claude daemon status memperingatkan ketika ini berlaku, dan sesi yang diluncurkan layanan masih dimulai melalui peluncur setelah layanan dimulai ulang dengan variabel dalam pengaturannya.
• Sesi yang Anda mulai sendiri di terminal, yang berjalan bagaimanapun Anda menginvokasinya. Untuk mencakup sesi-sesi ini, letakkan skrip bernama claude di direktori sebelumnya pada PATH yang menjalankan peluncur Anda dengan biner asli; jangan ganti symlink yang dikelola. Self-spawn tidak berkonsultasi dengan PATH, jadi dua peluncur tidak pernah bertumpuk.
• Proses pertama dari deep link claude-cli://, yang dimulai handler protokol sistem operasi secara langsung. Semua yang dimulai sesi itu di latar belakang sesudahnya berjalan melalui peluncur. Untuk menutup jalur ini sepenuhnya, cegah pendaftaran handler dengan pengaturan disableDeepLinkRegistration.

​

Nama proses pembantu dalam monitor proses

​

Atur peluncur

#!/bin/sh
# Pengaturan organisasi Anda: masukkan sandbox, terapkan
# kontrol jaringan, atau injeksikan kredensial.
exec "$@"

{
  "env": {
    "CLAUDE_CODE_PROCESS_WRAPPER": "/opt/corp/launcher"
  }
}

​

Kontrak peluncur

• Akhiri dengan exec "$@". Peluncur yang melahirkan anak dan keluar meninggalkan proses Claude Code yatim piatu yang tidak dapat dilacak layanan latar belakang. Tampilan agen menandai sesi seperti itu gagal dengan pesan yang menyebutkan peluncur, dan layanan mengumpulkan apa yang ditinggalkan peluncur.
• Jangan urutkan ulang, serap, atau tambahkan argumen. Argumen pertama adalah biner Claude Code dan semuanya setelahnya adalah argv-nya.
• Lewatkan setiap variabel lingkungan yang diwarisi melalui ke exec. Menambahkan variabel, seperti kredensial yang disuntikkan, baik-baik saja; menjatuhkan yang diwarisi tidak.
  • Token autentikasi per-sesi, pemilihan model dan penyedia, dan CLAUDE_CODE_PROCESS_WRAPPER itu sendiri semuanya berjalan di lingkungan yang diwarisi, jadi peluncur yang membangun ulangnya dari daftar izin memecahkan sesi yang dimulainya, dan /status melaporkan ketidakcocokan peluncur.
  • Jika peluncur harus memasuki namespace atau sandbox yang mengatur ulang lingkungan, ekspor ulang lingkungan yang diwarisi di dalamnya secara verbatim.
• Capai exec dalam sekitar tiga detik setiap kali peluncur berjalan. Pengiriman latar belakang dingin menjalankan peluncur dua kali berturut-turut sebelum byte pertama output, jadi lakukan pekerjaan lambat seperti pertukaran single sign-on dengan malas atau dari cache.
  • Peluncur yang berjalan jauh melampaui anggaran diperlakukan sebagai awal yang terhenti dan dimulai ulang.
• Toleransi untuk diinvokasi dari dalam dirinya sendiri. Claude Code menerapkan peluncur ke setiap self-spawn bersarang, jadi peluncur yang memperoleh sumber daya eksklusif harus mendeteksi bahwa itu sudah memegangnya.
• Jangan tulis ke terminal sebelum Claude Code dimulai. Apa pun yang dicetak sebelum exec dilaporkan sebagai penyebab kerusakan jika sesi mati sebelum inisialisasi.

​

Format nilai CLAUDE_CODE_PROCESS_WRAPPER

• Whitespace memisahkan token, dan tanda kutip ganda mengelompokkan token yang berisi spasi.
• Nilai yang dimulai dengan [ dibaca sebagai array string JSON, seperti ["/opt/corp/launcher", "--profile", "cc"].
• Sintaks shell tidak berfungsi: tidak ada ekspansi variabel atau globbing, dan operator yang tidak dikutip seperti ;, |, &, atau $( ditolak sebagai kesalahan konfigurasi daripada diinterpretasikan ulang.

​

Hubungan dengan CLAUDE_CODE_SHELL_PREFIX

​

Sumber daya terkait

• Tampilan agen: sesi latar belakang dan proses supervisor yang dicakup peluncur
• Variabel lingkungan: entri referensi CLAUDE_CODE_PROCESS_WRAPPER
• Pengaturan yang dikelola: berikan blok env di seluruh armada
• Referensi kesalahan peluncur: pesan penolakan dan cara memulihkan