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

公開 更新 著者 永上裕之導入とルール
会社の門番が、出入りするすべてのAIの作業に通行証を確かめているイメージ

この記事の要点

  • 会社の決まりで起動スクリプトを必ず通す場合、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_SHELL_PREFIX は、包む対象が違います。 こちらは Claude が代わりに実行するコマンド(Bash の実行・フック・手元の MCP サーバーの起動)を包む設定です。Claude Code 自身の処理を包むのが PROCESS_WRAPPER、Claude が打つコマンドを包むのが SHELL_PREFIX、と覚えると混ざりません。環境変数の全体像は Claude Codeの環境変数 で整理しています。

まとめ

出典

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事