Claude Codeを社内ランチャー経由で起動する設定

この記事の要点
- 会社の決まりで起動スクリプトを必ず通す場合、PATH の claude を包むだけでは、裏で動く処理が漏れる
- CLAUDE_CODE_PROCESS_WRAPPER(または processWrapper)に起動スクリプトの場所を書くと、Claude Code が自分で起こす処理も通る
- スクリプトは exec で Claude Code に切り替えて終える、環境変数を消さない、3秒以内に起動するなどの決まりがある
活用例:会社のセキュリティの決まり(必ず社内の起動スクリプトを通す)を守ったまま、AI の開発ツールを使えるようにする
- 部署
- 情報システム・セキュリティ
- 使うもの
- Claude Code の CLAUDE_CODE_PROCESS_WRAPPER と管理設定
- AIに任せる
- 決まりの範囲での開発作業
- 人が決める
- 起動スクリプトの中身・配る範囲・Windows 端末の扱い
会社によっては、「パソコンで動くプログラムは、必ず社内の起動スクリプト(ランチャー)を通すこと」という決まりがあります。ランチャーが、隔離(サンドボックス)や通信の制限、資格情報の受け渡しを担っているためです。
Claude Code は、裏でいくつもの処理を自分で起こします。この記事では、公式ドキュメント「Run Claude Code behind a corporate launcher」(2026年11月15日確認)にもとづいて、そうした処理もランチャーを通す設定をまとめます。
結論:PATH を包むだけでは漏れる。専用の設定を使う
よくある失敗は、PATH 上の claude コマンドだけを包むことです。 Claude Code の裏で動くサービス(バックグラウンドの作業を管理する常駐の処理)や、エージェントビュー の各作業は、PATH を通らずに本体を直接起こします。そのため包んだランチャーを素通りします。
そこで使うのが CLAUDE_CODE_PROCESS_WRAPPER(設定ファイルでは processWrapper)です。ここにランチャーの絶対パスを書くと、Claude Code が自分の本体から起こす処理を、すべてランチャー経由にします。
ランチャーを通る処理・通らない処理
| 通る(対象) | 通らない(別の手当てが必要) |
|---|---|
| バックグラウンドの常駐サービス | 自分で端末から起動した claude(PATH の側で包む) |
| エージェントビューの各作業と、待機中の予備の作業 | claude-cli:// のリンクから開いた作業 |
| 更新やクラッシュの後の作り直し | --worktree と --tmux を組み合わせた時の起動 |
| 更新を仕上げるための再起動 | Chrome 連携でブラウザが起こす処理 |
| リモート操作・エージェントチームの作業 | — |
Windows では、この設定は効きません。 仕組みが Windows に無い機能(exec)に頼っているためです。設定してもそのまま動き続け、記録にだけ警告が残ります。社内の決まりが Windows も対象なら、Windows の端末は「包まれていない」として計画を立てます。
リンクからの起動を止めたいときは、利用開始前に disableDeepLinkRegistration を設定します。リンクの仕組みは Claude Codeのディープリンクとは? で解説しています。
設定の4ステップ
1. ランチャーのスクリプトを書く
絶対パスの場所に実行できるスクリプトを置きます。Claude Code はスクリプトに起動の命令をまるごと渡すので、最後は必ず exec "$@" で終えます。
#!/bin/sh
# ここに会社の準備(隔離に入る・通信の制限・資格情報の受け渡し)
exec "$@"
2. 設定ファイルに書く
シェルの export では足りません。 常駐サービスはシェルの設定を読み直さないためです。設定ファイルの env に書きます。全員に配るなら、管理設定に同じ内容を入れます。
{
"env": {
"CLAUDE_CODE_PROCESS_WRAPPER": "/opt/corp/launcher"
}
}
項目ごとに配る仕組みを使っている会社は、同じ値を processWrapper という項目で書けます。両方あるときは環境変数が優先です。管理設定に書いた値は、各自の設定より優先されます。
安全のため、プロジェクトの設定ファイル(リポジトリに入る .claude/settings.json など)では効きません。リポジトリの1ファイルで、全処理の前に好きなプログラムを挟めてしまうのを防ぐためです。管理設定の配り方は Claude Code の管理設定とは? にまとめています。
3. 常駐サービスと作業を立て直す
動いている常駐サービスと開いている作業は、起動時に一度だけ設定を読みます。claude daemon stop --any で常駐サービスを止め、開いている作業も起動し直します。
4. 確かめる
作業の中で /status を打つと、Self-exec の欄に実際の起動の命令が出ます。常駐サービスと食い違っていれば警告が出ます。シェルからは claude daemon status で同じ内容を見られます。
ランチャーのスクリプトの決まり
ランチャーが動かないとき、Claude Code は包まずに起動するのではなく、起動そのものをやめます。 公式ドキュメントが挙げる主な決まりです。
- 最後は exec "$@"。子を作って自分は終わる形にしない
- Claude Code に渡された 引数を並べ替えたり足したりしない
- 受け取った 環境変数を消さない(足すのはよい)。認証やモデルの指定も環境変数で運ばれる
- 3秒ほどで exec まで進む。時間のかかる処理は先に済ませておくか、時間の上限を付ける
- 自分の中からもう一度呼ばれても 困らない作りにする
- exec の前に 画面や標準出力に何も書かない、入力を読まない
- 起動したフォルダのまま exec する(別のフォルダだと別のプロジェクトで動いてしまう)
- ほかのプログラムは 絶対パスで呼ぶ
ランチャー自身に引数を渡したいときは、パスの後ろに書き、スクリプトの中で取り除いてから exec します。
似た設定との違い
CLAUDE_CODE_SHELL_PREFIX は、包む対象が違います。 こちらは Claude が代わりに実行するコマンド(Bash の実行・フック・手元の MCP サーバーの起動)を包む設定です。Claude Code 自身の処理を包むのが PROCESS_WRAPPER、Claude が打つコマンドを包むのが SHELL_PREFIX、と覚えると混ざりません。環境変数の全体像は Claude Codeの環境変数 で整理しています。
まとめ
- 社内ランチャーを必ず通すなら、PATH を包むだけでは不十分
- CLAUDE_CODE_PROCESS_WRAPPER(processWrapper) で、裏の処理までランチャー経由にできる
- 設定は 設定ファイル(できれば管理設定) に書き、常駐サービスを立て直す
- スクリプトは exec "$@" で終える・環境変数を消さない・すぐ起動する。Windows は対象外
出典
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。


