セルフホストされた環境は Team および Enterprise プランでパブリックベータ版です。利用可能性と制限事項は有効化パスをカバーしています。このページは最初のセッションを実行します。詳細はセルフホストされた環境を参照し、本番環境へのデプロイについては本番環境へのデプロイを参照してください。
前提条件
組織とロール
claude.ai 側には以下が必要です。- セルフホストされた環境を許可は、Cloud environments 管理ページでオーナーによってオンにされます。新規ボタンはそれがオンになるまで表示されません。ロールを保持していない場合、保持している人が環境を作成してシークレットを渡すことができます。このページのランナーとターミナルのステップには claude.ai ロールは不要です。ステップが管理 UI でステータスをチェックする場合、ランナー自身のログ行が同じシグナルを提供します。
- 組織のGitHub 接続。開発者がセッションを開始するときにリポジトリを選択できるようにします。
ホストとネットワーク
ランナーホストには以下が必要です。api.anthropic.com、claude.aiおよび以下のインストールステップ用のダウンロードホストへのアウトバウンド HTTPS、および git ホストへのクローン用の Linux または macOS ホストまたはコンテナ。ネットワーク要件テーブルに完全なリストがあります。Windows はランナーホストとしてサポートされていません。代わりに Linux コンテナでランナーを実行してください。セッションは claude.ai のブラウザから開始されるため、開発者ワークステーションは影響を受けません。- NTP などで実時間に同期されたクロック。クロックが 5 分以上ずれていると認証が失敗します。トラブルシューティングを参照してください。
ランナーホスト上のソフトウェア
開始する前にホストにインストールしてください。- Claude Code v2.1.224 以降。標準インストール方法のいずれかを使用します。ランナーは標準
claudeバイナリの一部であり、以前のバージョンはself-hosted-runnerサブコマンドを認識しません。ネイティブインストーラーのデフォルトlatestチャネルは各リリースを公開直後に提供します。stableチャネル、Homebrewclaude-codecask、および安定版 apt、dnf、apk リポジトリは約 1 週間遅れます。フロートが実行する正確なバージョンをピンするには、特定のバージョンをインストールを参照してください。コンテナイメージについては、本番環境へのデプロイの Dockerfile を参照してください。 - Git 2.24 以降。デプロイページの一部の git オプションはより新しいバージョンが必要です。git を設定は各フロアを記載しています。
--environment-secret-file などのフラグをリストします。2.1.224 より古いバージョンでは、コマンドは代わりに一般的な claude --help 出力を出力します。claude update でアップグレードするか、latest チャネルから再インストールしてください。
環境とランナーをセットアップする
Claude Code には、ガイド付きセットアップが含まれています。管理 UI で環境を作成する手順を説明するインタラクティブな Claude Code セッション。保存したシークレットファイルでローカルランナーを起動し、ランナーが登録されたことを確認し、./runner-setup/CHEAT-SHEET.md にチートシートを書き込みます。claude auth login でサインインしたマシンで実行します。オーナーロールを保持するアカウントを使用します。API キーまたはサードパーティモデルプロバイダーでは利用できません。インタラクティブセッションが不可能なホストでは、代わりに以下の手動ステップを使用してください。バージョンチェックが最初に合格したことを確認してください。2.1.224 より古いバージョンでは、このコマンドはガイド付きセットアップの代わりに、単語をプロンプトとして通常の Claude セッションを開始します。ガイド付きセットアップを開始するには、セットアップサブコマンドを実行してプロンプトに従います。
1
環境を作成する
管理設定のCloud environments ページに移動します。セルフホストされた環境の下で、新規を選択し、環境に名前を付けて、作成を選択します。ウィザードの 2 番目のステップで、環境キーをコピーを選択して環境シークレットをコピーします。管理 UI はこれを環境キーとしてラベル付けします。claude.ai はシークレットを 1 回表示し、後で取得することはできません。作成から 365 日後に期限切れになります。環境の
ccpool_... ID は詳細ダイアログに表示されたままです。トークン検証の aud チェックおよびCI からのテストセッションのディスパッチに必要になります。シークレットを失った場合またはローテーションが必要な場合は、環境の設定タブから新しいシークレットを作成し、新しいシークレットをランナーにロールアウトしてから、古いシークレットを取り消します。取り消されたシークレットを保持するランナーは次の認証済みポーリングに失敗して終了し、poll auth failed をログに記録します。オーケストレーターは新しいシークレットで再起動します。2
ランナーを起動する
シークレットディレクトリを作成します。このステップと次のステップは 環境シークレットをファイルに書き込みます。以下のコマンドはターミナルから読み取るため、シークレットはシェル履歴から外れます。コピーした値を貼り付け、Enter キーを押してから Ctrl-D を押します。サブシェルの ベースディレクトリを選択します。以下のランナーコマンドの
/etc/claude パスに root が必要です。ランナープロセスが読み取ることができるパスは機能するため、別のパスを使用する場合は両方のコマンドと --environment-secret-file 値を一緒に調整してください。umask はファイルを所有者のみが読み取り可能にします。<writable-dir> を、ランナーが書き込みまたは作成できる絶対パスに置き換えます。ランナーはスタートアップ時にディレクトリを作成し、リポジトリをチェックアウトし、その下にセッションごとのディレクトリを作成します。--base-dir がない場合は /workspace を使用します。これはそのディレクトリが既に存在し、書き込み可能であるか、ランナーを root として起動する場合にのみ機能します。ランナーがパスを作成または書き込みできない場合、スタートアップ時にディレクトリを名前付けするエラーで終了し、登録されません。トラブルシューティングを参照してください。次に、--environment-secret-file と --base-dir でランナーを起動します。ランナーは環境に登録され、仕事をポーリングし始めます。ランナーが終了した場合、手動で再起動してください。本番環境デプロイメントはランナーをオーケストレーターの下で実行し、通常は再起動ごとに新しいファイルシステムで終了したランナーを再起動します。事前にウォームアップされたチェックアウトを再利用はサポートされている永続ディスクセットアップをカバーしています。3
ランナーが表示されることを確認する
Cloud environments ページに戻ります。環境のステータスはランナーが起動してから数秒以内にランナーがデプロイされていませんから正常に変わります。環境を開いてアクティビティを選択してランナー自体を確認します。
4
セッションを環境にルーティングする
claude.ai/code でセッションを開始し、環境ピッカーから環境を選択します。セルフホストされた環境は Anthropic ホストされた環境と並んで表示されます。ランナーはホストが既に持っている git 認証情報でクローンするため、このホストが既にクローンできるリポジトリまたはパブリックリポジトリを選択してください。本番環境のプライベートリポジトリの認証情報オプションはgit を設定にあります。次に利用可能なランナーはキューに入ったセッションを取得し、
Picked up session <session-id> をアクティブカウントと容量と共にログに記録します。ランナー自身の出力からどのホストがセッションを取得したかを確認できます。claude.ai/codeでセッションの動作を監視し、Claude の返信を読みます。セッションがキューに入ったままの場合は、トラブルシューティングを参照してください。実行中のセッションにフォローアップメッセージを送信する
セッションが環境で実行されたら、claude auth login でログインしているマシンの claude CLI からフォローアップを送信します。コマンドはセッションを開始したマシンから実行する必要はありません。コマンドは 1 つのメッセージを投稿します。
<session-id> については、ベアの session_... または cse_... ID またはセッションの claude.ai/code URL を渡します。成功した送信は Sent to cloud session. をセッション ID とビューリンク付きで出力します。受け入れられた ID フォーム、JSON 出力、アカウントとポリシー要件、およびエラーリファレンスはCLI からフォローアップを送信にあります。コマンドは Anthropic ホストされたセッションに対して同じように機能するためです。
次のステップ
- 本番環境へのデプロイ。デプロイメントを強化し、エグレスを制御し、git 認証情報を設定し、Kubernetes または Compose の下でフロートを実行します。
- セッションをカスタマイズ。ラッパースクリプト、ライフサイクルフック、オンデマンドランナー、MCP サーバー、および権限。
- エンドツーエンドをテスト。セッションをディスパッチして Claude の返信を読む CI スモークテスト。