在公司啟動程式後面執行 Claude Code

​

啟動程式涵蓋的內容

• claude agents 和背景工作階段按需啟動的背景服務。
• 每個代理檢視列中的終端主機和 Claude Code 工作階段，包括服務保持就緒的暖備用工作階段。
• 服務在更新或當機後重新產生的工作階段。
• Claude Code 執行自身以完成安裝更新的重新啟動，包括代理檢視的重新啟動以進行更新動作。

​

在啟動程式外啟動的程序

• 已安裝的背景服務：launchd 或 systemd 從其單位檔案啟動該程序。當這適用時，/status 和 claude daemon status 會發出警告，服務產生的工作階段在服務使用設定中的變數重新啟動後仍會透過啟動程式啟動。
• 您自己在終端中啟動的工作階段，它會按照您叫用它的方式執行。要涵蓋這些工作階段，請在 PATH 上較早的目錄中放置一個名為 claude 的指令碼，該指令碼使用真實二進位檔案執行您的啟動程式；不要替換受管理的符號連結。自我產生不會查詢 PATH，因此兩個啟動程式永遠不會堆疊。
• claude-cli:// 深層連結的第一個程序，作業系統的協定處理程式直接啟動。該工作階段之後在背景中啟動的所有內容都會透過啟動程式執行。要完全關閉此路徑，請使用 disableDeepLinkRegistration 設定防止處理程式註冊。

​

程序監視器中的協助程序名稱

​

設定啟動程式

#!/bin/sh
# Your organization's setup: enter the sandbox, apply
# network controls, or inject credentials.
exec "$@"

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

​

啟動程式合約

• 以 exec "$@" 結尾。 分叉子程序並退出的啟動程式會留下孤立的 Claude Code 程序，背景服務無法追蹤。代理檢視會將此類工作階段標記為失敗，並顯示命名啟動程式的訊息，服務會清理啟動程式留下的內容。
• 不要重新排序、吸收或前置引數。 第一個引數是 Claude Code 二進位檔案，其後的所有內容都是其 argv。
• 將每個繼承的環境變數傳遞給 exec。 新增變數（例如注入的認證）沒問題；刪除繼承的變數不行。
  • 每個工作階段的驗證令牌、模型和提供者選擇，以及 CLAUDE_CODE_PROCESS_WRAPPER 本身都在繼承的環境中傳遞，因此從允許清單重建環境的啟動程式會破壞它啟動的工作階段，/status 會報告啟動程式不匹配。
  • 如果啟動程式必須進入重設環境的命名空間或沙箱，請在其內部逐字重新匯出繼承的環境。
• 在啟動程式每次執行時約三秒內到達 exec。 冷背景分派在第一個輸出位元組前連續執行啟動程式兩次，因此請懶惰地或從快取執行緩慢的工作，例如單一登入交換。
  • 執行遠超預算的啟動程式被視為停滯啟動並重新啟動。
• 容忍從內部叫用自身。 Claude Code 將啟動程式應用於每個嵌套的自我產生，因此獲取獨佔資源的啟動程式必須偵測它是否已持有它。
• 在 Claude Code 啟動前不要寫入終端。 在 exec 前列印的任何內容都會在工作階段在初始化前死亡時報告為當機原因。

​

CLAUDE_CODE_PROCESS_WRAPPER 值的格式

• 空白分隔令牌，雙引號將包含空格的令牌分組。
• 以 [ 開頭的值被讀取為 JSON 字串陣列，例如 ["/opt/corp/launcher", "--profile", "cc"]。
• Shell 語法不起作用：沒有變數擴展或全域化，未引用的運算子（例如 ;、|、& 或 $(）被拒絕為配置錯誤，而不是重新解釋。

​

與 CLAUDE_CODE_SHELL_PREFIX 的關係

​

相關資源

• 代理檢視：啟動程式涵蓋的背景工作階段和監督程序
• 環境變數：CLAUDE_CODE_PROCESS_WRAPPER 參考項目
• 受管理設定：在整個機隊中傳遞 env 區塊
• 啟動程式錯誤參考：拒絕訊息以及如何恢復