在公司啟動程式後面執行 Claude Code
使用 CLAUDE_CODE_PROCESS_WRAPPER 或 processWrapper 設定，透過必要的啟動程式路由 Claude Code 從其自身二進位檔案啟動的程序，包括背景服務和每個代理檢視工作階段。
某些組織要求工作站上的每個程序都透過強制性啟動程式啟動。啟動程式會應用沙箱、網路控制或認證注入，這些是公司安全態勢所依賴的，而不透過它啟動的二進位檔案是違反政策的。
CLAUDE_CODE_PROCESS_WRAPPER 透過您的啟動程式啟動 Claude Code 從其自身二進位檔案啟動的每個程序：背景服務、它在代理檢視中託管的每個工作階段，以及 Claude Code 在更新後的重新啟動。將其設定為您的啟動程式的絕對路徑，Claude Code 會執行啟動程式，並將 Claude Code 命令作為其引數。
在您的 PATH 上包裝 claude 命令的啟動程式無法到達這些程序，因為它們從二進位檔案的直接路徑啟動，不會查詢 claude。
啟動器涵蓋的內容
設定 CLAUDE_CODE_PROCESS_WRAPPER 後，Claude Code 會透過您的啟動器啟動以下每個程序：
claude agents和背景工作階段按需啟動的背景服務。- 每個代理檢視列中的終端主機和 Claude Code 工作階段，包括服務保持就緒的暖待命工作階段。
- 服務在更新或當機後重新啟動的工作階段。
- Claude Code 執行自身重新啟動以完成更新安裝的情況，包括代理檢視的重新啟動以進行更新動作。
- 遠端控制啟動的工作階段程序。需要 Claude Code v2.1.210 或更新版本。
- 代理團隊在 tmux 或 iTerm2 中啟動的分割窗格隊友工作階段。隊友窗格是互動式的，而不是背景程序，但 Claude Code 從其自身二進位檔案啟動它們，所以啟動器涵蓋它們。需要 Claude Code v2.1.210 或更新版本。
在 Windows 上，該變數會被忽略：啟動器合約取決於 exec，而 Windows 不支援。設定了該變數的 Windows 機器會執行每個未包裝的程序並繼續運作，唯一的信號是偵錯日誌中的警告。如果您的啟動器原則涵蓋 Windows，該變數在那裡不滿足它：在規劃推出時，將 Windows 機器計為未包裝。
在啟動器外啟動的程序
以下程序不會透過啟動器啟動：
- 一個已安裝的背景服務，其單位是在設定啟動器之前編寫的：
launchd或systemd從其單位檔案啟動該程序。/status和claude daemon status在執行中的服務和設定的啟動器不相符時發出警告，一旦服務在其設定中使用該變數重新啟動，服務產生的工作階段仍會透過啟動器啟動。 - 您自己在終端中啟動的工作階段，其執行方式取決於您的調用方式。若要涵蓋這些工作階段，請在
PATH上較早的目錄中放置一個名為claude的指令碼，該指令碼使用真實二進位檔案執行您的啟動器；不要取代受管理的符號連結。背景服務及其工作階段啟動時不進行PATH查詢，所以這兩個啟動器在那裡不會堆疊。 claude-cli://深層連結的第一個程序，作業系統的協定處理程式直接啟動。該工作階段之後在背景中啟動的所有內容都會透過啟動器執行。若要完全關閉此路徑，請使用disableDeepLinkRegistration設定防止處理程式註冊。--worktree結合--tmux執行的重新啟動：終端多工器啟動該窗格，而不是 Claude Code 的二進位檔案。- Chrome 中的 Claude 註冊的原生訊息主機：瀏覽器啟動它，而不是 Claude Code 的二進位檔案。
程序監視器中的協助程序名稱
設定啟動器後，ps 和 Activity Monitor 不再顯示 Claude Code 的 claude bg-pty-host 和 claude bg-spare 標籤用於背景協助程序，因為啟動器的 exec 重建了引數清單。失去標籤是一個副作用，而不是隱瞞：程序在其他方面保持不變，Claude Code 透過二進位檔案路徑識別其自身程序，絕不透過顯示名稱。
設定啟動程式
編寫啟動程式指令碼
在絕對路徑（例如 /opt/corp/launcher）建立可執行指令碼。Claude Code 使用完整的 Claude Code 命令作為其引數執行它，指令碼必須以呼叫 exec "$@" 結尾，以便它用 Claude Code 替換自身：
#!/bin/sh
# Your organization's setup: enter the sandbox, apply
# network controls, or inject credentials.
exec "$@"
使用 chmod +x 使其可執行。設定部分是您的啟動程式在 Claude Code 執行前必須執行的任何操作；下面的啟動程式合約列出了指令碼必須遵循的規則。
在設定中設定 CLAUDE_CODE_PROCESS_WRAPPER
在設定檔案的 env 區塊中設定變數，以便分離的背景服務繼承它。shell export 還不夠：背景服務按需啟動，超過您的 shell 的生命週期，並且永遠不會重新讀取 shell 設定檔。
對於一台機器，將其新增到 ~/.claude/settings.json。要將其部署到組織中的每台機器，請在受管理設定中放置相同的區塊：
{
"env": {
"CLAUDE_CODE_PROCESS_WRAPPER": "/opt/corp/launcher"
}
}
當多個來源設定變數時，受管理設定值會覆蓋 ~/.claude/settings.json 和 shell 中匯出的值，因此使用者無法將自我產生指向不同的啟動程式。
processWrapper 設定與具名的頂層設定金鑰具有相同的值。當您的組織以個別金鑰而非 env 區塊的方式推送設定時，請設定它。processWrapper 設定需要 Claude Code v2.1.210 或更新版本。下列設定檔案透過該金鑰設定相同的啟動程式：
{
"processWrapper": "/opt/corp/launcher"
}
當兩者都設定時，CLAUDE_CODE_PROCESS_WRAPPER 優先。
因為 processWrapper 是具名設定，透過遠端受管理設定傳遞它的組織會在安全核准對話上看到它與其他執行管理員提供的可執行檔的設定一起列出。
專案和本機設定無法設定啟動程式。提交到儲存庫的檔案不得能夠將二進位檔案放在機器上的每個 Claude Code 程序前面，因此 Claude Code 會忽略 .claude/settings.json 或 .claude/settings.local.json 中的 CLAUDE_CODE_PROCESS_WRAPPER，並在偵錯日誌中發出警告，並且永遠不會從這些檔案讀取 processWrapper 金鑰。
重新啟動背景服務和您的工作階段
執行中的背景服務和任何開啟的 claude 工作階段在啟動時讀取變數一次，因此它們會繼續啟動未包裝的程序，直到重新啟動。執行 claude daemon stop --any 以停止按需服務；下一個需要它的命令（例如 claude agents）會啟動一個包裝的命令。已安裝的服務採用 claude daemon stop 而不需要 --any。然後重新啟動您開啟的 claude 工作階段。
在您無法手動重新啟動的機器上，設定推送後啟動的第一個工作階段會自動淘汰遺留的未包裝按需服務。沒有新工作階段啟動的機器會保留其未包裝的服務，直到啟動一個，而已安裝的服務始終需要此步驟中的重新啟動。
驗證
在工作階段中執行 /status：Self-exec 項目顯示已解析的啟動命令，並在執行中的背景服務與其不匹配時發出警告。claude daemon status 從 shell 列印相同的資訊，包括在您取消設定變數後，當 /status 不再顯示該項目時。
啟動程式合約
當啟動程式無法執行時，Claude Code 拒絕啟動程序，而不是啟動它未包裝。在 Windows 上，變數被忽略，程序啟動未包裝。Claude Code 對指令碼遵循這些規則：
- 以
exec "$@"結尾。 分叉子程序並退出的啟動程式會留下孤立的 Claude Code 程序，背景服務無法追蹤。代理檢視會將此類工作階段標記為失敗，並顯示命名啟動程式的訊息，服務會清理啟動程式留下的內容。 - 不要重新排序、吸收或前置引數。 第一個引數是 Claude Code 二進位檔案，其後的所有內容都是其 argv。
- 將每個繼承的環境變數傳遞給
exec。 新增變數（例如注入的認證）沒問題；刪除繼承的變數不行。- 每個工作階段的驗證令牌、模型和提供者選擇，以及
CLAUDE_CODE_PROCESS_WRAPPER本身都在繼承的環境中傳遞，因此從允許清單重建環境的啟動程式會破壞它啟動的工作階段，/status會報告啟動程式不匹配。 - 如果啟動程式必須進入重設環境的命名空間或沙箱，請在其內部逐字重新匯出繼承的環境。
- 每個工作階段的驗證令牌、模型和提供者選擇，以及
- 在啟動程式每次執行時約三秒內到達
exec。 冷背景分派在第一個輸出位元組前連續執行啟動程式兩次，因此請懶惰地或從快取執行緩慢的工作，例如單一登入交換。 - 容忍從內部叫用自身。 Claude Code 將啟動程式應用於每個嵌套的自我產生，因此獲取獨佔資源的啟動程式必須偵測它是否已持有它。
- 在 Claude Code 啟動前不要寫入終端。 在
exec前列印的任何內容都會在工作階段在初始化前死亡時報告為當機原因。
啟動程式值的格式
CLAUDE_CODE_PROCESS_WRAPPER 和 processWrapper 設定採用相同的格式。對於大多數啟動程式，該值是指令碼的絕對路徑，例如 /opt/corp/launcher。
要傳遞您的啟動程式自己的引數，請在路徑後寫入它們。Claude Code 將該值解析為引數清單，而不是 shell 命令：
- 空白分隔令牌，雙引號將包含空格的令牌分組。
- 以
[開頭的值被讀取為 JSON 字串陣列，例如["/opt/corp/launcher", "--profile", "cc"]。 - Shell 語法不起作用：沒有變數擴展或全域化，未引用的運算子（例如
;、|、&或$(）被拒絕為設定錯誤，而不是重新解釋。
當無法使用該值時，Claude Code 拒絕啟動受影響的程序並報告原因。
與 `CLAUDE_CODE_SHELL_PREFIX` 的關係
CLAUDE_CODE_PROCESS_WRAPPER 包裝 Claude Code 自己的程序，並將命令作為單獨的 argv 令牌傳遞給啟動程式以執行。CLAUDE_CODE_SHELL_PREFIX 包裝 Claude Code 代表您執行的 shell 命令，例如 Bash 工具呼叫、hooks 和啟動 stdio MCP 伺服器的命令，並將每個命令作為 $1 中的單個 shell 引用字串傳遞給包裝程式以重新評估。為一個編寫的啟動程式不會作為另一個工作。