Claude Code hinter einem Corporate Launcher ausführen

​

Was der Launcher abdeckt

• Der Hintergrund­dienst, den claude agents und Hintergrund­sitzungen bei Bedarf starten.
• Der Terminal-Host und die Claude-Code-Sitzung in jeder Agent-View-Zeile, einschließlich der Warm-Standby-Sitzungen, die der Dienst bereit hält.
• Sitzungen, die der Dienst nach einem Update oder Absturz neu startet.
• Der Neustart, den Claude Code durchführt, um die Installation eines Updates abzuschließen, einschließlich der Restart-for-Update-Aktion von Agent View.

​

Prozesse, die außerhalb des Launchers starten

• Ein installierter Hintergrund­dienst: launchd oder systemd startet diesen Prozess aus seiner Unit-Datei. /status und claude daemon status warnen, wenn dies zutrifft, und die Sitzungen, die der Dienst startet, starten immer noch durch den Launcher, sobald der Dienst mit der Variable in seinen Einstellungen neu startet.
• Eine Sitzung, die Sie selbst in einem Terminal starten, die so ausgeführt wird, wie Sie sie aufgerufen haben. Um diese Sitzungen abzudecken, legen Sie ein Skript namens claude in ein Verzeichnis früher auf PATH, das Ihren Launcher mit der echten Binärdatei ausführt; ersetzen Sie nicht den verwalteten Symlink. Self-Spawns konsultieren nicht PATH, daher stapeln sich die beiden Launcher nie.
• Der erste Prozess eines claude-cli:// Deep Links, den der Protokoll-Handler des Betriebssystems direkt startet. Alles, das diese Sitzung danach im Hintergrund startet, läuft durch den Launcher. Um diesen Pfad vollständig zu schließen, verhindern Sie die Handler-Registrierung mit der Einstellung disableDeepLinkRegistration.

​

Namen von Hilfsprozessen in Prozessmonitoren

​

Richten Sie den Launcher ein

#!/bin/sh
# Einrichtung Ihrer Organisation: Geben Sie die Sandbox ein, wenden Sie
# Netzwerkkontrollen an oder injizieren Sie Anmeldedaten.
exec "$@"

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

​

Der Launcher-Vertrag

• Enden Sie mit exec "$@". Ein Launcher, der ein Kind forkt und beendet, hinterlässt einen verwaisten Claude-Code-Prozess, den der Hintergrund­dienst nicht verfolgen kann. Agent View markiert eine solche Sitzung als fehlgeschlagen mit einer Nachricht, die den Launcher benennt, und der Dienst räumt auf, was der Launcher hinterlassen hat.
• Ordnen Sie Argumente nicht neu an, absorbieren oder stellen Sie ihnen voran. Das erste Argument ist die Claude-Code-Binärdatei und alles danach ist sein argv.
• Geben Sie jede geerbte Umgebungsvariable an exec weiter. Das Hinzufügen von Variablen, z. B. injizierte Anmeldedaten, ist in Ordnung; das Löschen geerbter ist nicht.
  • Die Pro-Sitzungs-Authentifizierungstoken, die Modell- und Anbieterauswahl und CLAUDE_CODE_PROCESS_WRAPPER selbst reisen alle in der geerbten Umgebung, daher bricht ein Launcher, der sie aus einer Zulassungsliste neu erstellt, die Sitzungen, die er startet, und /status meldet eine Launcher-Nichtübereinstimmung.
  • Wenn der Launcher einen Namespace oder eine Sandbox betreten muss, die die Umgebung zurückgesetzt, exportieren Sie die geerbte Umgebung darin wörtlich erneut.
• Erreichen Sie exec innerhalb von etwa drei Sekunden jedes Mal, wenn der Launcher ausgeführt wird. Ein kalter Hintergrund-Dispatch führt den Launcher zweimal hintereinander aus, bevor das erste Byte der Ausgabe, daher führen Sie langsame Arbeiten wie einen Single-Sign-On-Austausch träge oder aus einem Cache durch.
  • Ein Launcher, der weit über das Budget hinausgeht, wird als stagnierter Start behandelt und neu gestartet.
• Tolerieren Sie, dass Sie von innen aufgerufen werden. Claude Code wendet den Launcher auf jeden verschachtelten Self-Spawn an, daher muss ein Launcher, der eine exklusive Ressource erwirbt, erkennen, dass er sie bereits hält.
• Schreiben Sie nicht auf das Terminal, bevor Claude Code startet. Alles, das vor dem exec gedruckt wird, wird als Absturzursache gemeldet, wenn die Sitzung vor der Initialisierung stirbt.

​

Format des CLAUDE_CODE_PROCESS_WRAPPER-Wertes

• Whitespace trennt Token, und doppelte Anführungszeichen gruppieren ein Token, das Leerzeichen enthält.
• Ein Wert, der mit [ beginnt, wird als JSON-String-Array gelesen, z. B. ["/opt/corp/launcher", "--profile", "cc"].
• Shell-Syntax funktioniert nicht: Es gibt keine Variablenerweiterung oder Globbing, und ein unquotierter Operator wie ;, |, & oder $( wird als Konfigurationsfehler abgelehnt, anstatt neu interpretiert zu werden.

​

Beziehung zu CLAUDE_CODE_SHELL_PREFIX

​

Verwandte Ressourcen

• Agent View: die Hintergrund­sitzungen und der Supervisor-Prozess, den der Launcher abdeckt
• Umgebungsvariablen: der CLAUDE_CODE_PROCESS_WRAPPER-Referenzeintrag
• Verwaltete Einstellungen: Liefern Sie den env-Block über eine Flotte
• Launcher-Fehlerreferenz: die Verweigerungsmeldungen und wie man sich erholt