compiler.dev ドキュメント
compiler.dev は、既存の GitHub Actions ジョブを高速で隔離された Linux マシン上で実行します。GitHub Actions とチェックはそのまま使用でき、変わるのはマシンだけです。ルーティング設定を使用している場合、compiler.dev がジョブを処理できない場合や、クレジットまたは月間上限を使い切った場合、ジョブは切り替え前に使用していたランナー(GitHub がホストするものでも、お客様が用意したものでも)で実行されます。1 行の runs-on: compiler-8cpu ラベルは GitHub App のインストール後に使用できますが、自動フォールバックはありません。ジョブは compiler.dev ランナーが空くまで待機します(サイズラベルを参照してください)。
はじめに
1. サインインして GitHub App をインストールします。GitHub でサインイン後、compiler.dev App を組織にインストールし、アクセスを許可するリポジトリを選択してください。App はワークフローとジョブのメタデータを読み取り、compiler.dev にルーティングされるジョブ用の一時的なランナーを登録します。また、セットアップ PR を通じてのみワークフローの変更を提案します。App が何かをマージすることはありません。
2. リポジトリとモードを選択します。ワークフローを分析し、移行できるジョブを表示します。安全に試す(比較:コピーは当社のマシンで実行され、結果はご自身のランナーのものが使われます)を選ぶか、プルリクエストの10%、25%、50%、100%を対象に今すぐ切り替えるを選択できます。PR は、その後のすべてのプッシュと再実行でも同じ側に留まります。
3. セットアップ PR をマージします。ルーティング対象の各ワークフローには、小さな compiler-route ジョブが追加されます。これは、ジョブをどこで実行すべきかを compiler.dev に問い合わせるもので、ジョブはその回答を runs-on として使用します。ステップは変更されません。PR がマージされるまでは何も移動しません。
4. 最初の実行を確認します。App は各ジョブを、キュー待ち、起動中、実行中、完了といった状態でリアルタイムに表示します。マシン名と、以前のランナーとの所要時間の比較も確認できます。
移行できるジョブ
- 対象: ビルドとテストを行うLinuxジョブ(
ubuntu-*)です。標準のマシンは8 vCPU、16 GBで、ジョブごとに新しく作成され、終了後に削除されます。 - 自社ランナーに残すもの: デプロイや公開のジョブ、Windows、macOS、ARM、GPUのジョブ、およびフォークされたプルリクエストからのジョブです(OIDCトークンを取得できないため)。
- シークレット: シークレットを使用するジョブは、付与したシークレットを使って当社のマシン上で実行されます。テスト専用の認証情報を使用することをお勧めします。分析ではこれらのジョブに警告が表示されます。
フォールバックとロールバック
- 自動フォールバック: compiler.dev が停止している場合、応答が遅い場合(15 秒)、またはジョブ用のマシンを起動できない場合、ルーティング用のジョブは元のランナーで応答します。または、実行がキャンセルされ、そのランナーで再実行されます。実際のテスト失敗が再ルーティングされることはありません。
- 一時停止: ダッシュボードでリポジトリを 0% に設定すると、新しいプルリクエストは元のランナーを使用します。
- 削除: セットアップのプルリクエストを元に戻すか、GitHub App をアンインストールしてください。アンインストールすると、すべてのアクセスとルーティングが直ちに停止します。
ビルドキャッシュ(Nx / Turborepo)
compiler.devのランナーでは、Nx(20.8以降)とTurborepoがランナーと並んで提供されるリモートキャッシュを自動的に使用します。ワークフローに変更は必要ありません。キャッシュはリポジトリごとに分離されています。プルリクエストはデフォルトブランチのキャッシュを読み取れますが、書き込みは自身のキャッシュにのみ可能です。そのため、PRが信頼されたビルドにアーティファクトを注入することはできません。特定のジョブでこの機能を無効にするには、そのジョブのenv:でNX_SELF_HOSTED_REMOTE_CACHE_SERVER: ""and/orTURBO_API: ""を設定します。
AWS での OIDC
OIDCを使うと、GitHubにアクセスキーを保存することなく、ジョブが短期間有効なAWS認証情報を取得できます。各実行時にGitHubが署名付きトークンを発行し、AWSがそのトークンを一時的な認証情報と交換します。トークンの仕組みはGitHub Actionsの標準的なものです。そのため、以下のワークフローはcompiler.devのruns-onラベルを使う一般的な構成になります。詳しい手順はGitHub Actions OIDCからAWSへの接続をご覧ください。
1. IAMにGitHubをIDプロバイダーとして追加します。 プロバイダーURLはhttps://token.actions.githubusercontent.com、オーディエンスはsts.amazonaws.comに設定します。
2. 次のトラストポリシーでロールを作成します。 111122223333、ORG、REPOを置き換えてください。他のリポジトリやブランチからのアクセスを防ぐのがsub条件の役割ですので、必ず設定してください。
{
"Version": "2012-10-17",
"Statement": [{
"Effect": "Allow",
"Principal": { "Federated": "arn:aws:iam::111122223333:oidc-provider/token.actions.githubusercontent.com" },
"Action": "sts:AssumeRoleWithWebIdentity",
"Condition": {
"StringEquals": {
"token.actions.githubusercontent.com:aud": "sts.amazonaws.com",
"token.actions.githubusercontent.com:sub": "repo:ORG/REPO:ref:refs/heads/main"
}
}
}]
}
3. ワークフローでロールを使用します。 ジョブにはid-token: writeが必要です。
permissions:
id-token: write
contents: read
jobs:
deploy:
runs-on: compiler-8cpu
steps:
- uses: actions/checkout@v4
- uses: aws-actions/configure-aws-credentials@v4
with:
role-to-assume: arn:aws:iam::111122223333:role/github-deploy
aws-region: eu-west-2
- run: aws sts get-caller-identity
- ロールを引き受けられる実行: 特定のブランチには
repo:ORG/REPO:ref:refs/heads/main、GitHubのenvironmentにはrepo:ORG/REPO:environment:production、リポジトリ全体にはStringLikeとrepo:ORG/REPO:*を使用します。 - フォークからのプルリクエストには、他のランナーと同様にトークンが発行されません。
- ポリシーはお客様が管理します: compiler.devがお客様のAWSロールを参照または変更することはありません。ジョブがロールを引き受けられない場合、エラーはAWSから返されます。まずトラストポリシーを確認してください。
Google Cloud での OIDC
ワークロードID連携を使うと、キーファイルを保存せずにジョブがGoogle Cloudのサービスアカウントとして動作できます。実行のたびにGitHubが署名付きトークンを発行し、Googleがそれを短期間有効な認証情報に交換します。トークンの流れは標準のGitHub Actionsと同じなので、以下のワークフローはcompiler.devのruns-onラベルを指定した通常のものです。
1. ワークロードIDプールとGitHubプロバイダーを作成します。発行者はhttps://token.actions.githubusercontent.comです。クレームを属性にマッピングし、リポジトリだけを受け入れるよう条件を追加します:
gcloud iam workload-identity-pools providers create-oidc github \
--project=MY_PROJECT --location=global --workload-identity-pool=github-pool \
--issuer-uri="https://token.actions.githubusercontent.com" \
--attribute-mapping="google.subject=assertion.sub,attribute.repository=assertion.repository,attribute.ref=assertion.ref" \
--attribute-condition="assertion.repository == 'ORG/REPO'"
2. そのリポジトリにサービスアカウントの使用を許可します。リポジトリのプリンシパルセットに、サービスアカウントに対するroles/iam.workloadIdentityUserを付与します:
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/github-pool/attribute.repository/ORG/REPO
3. ワークフローで使用します。ジョブにはid-token: writeが必要です:
permissions:
id-token: write
contents: read
jobs:
deploy:
runs-on: compiler-8cpu
steps:
- uses: actions/checkout@v4
- uses: google-github-actions/auth@v2
with:
workload_identity_provider: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/github-pool/providers/github
service_account: deploy@MY_PROJECT.iam.gserviceaccount.com
- uses: google-github-actions/setup-gcloud@v2
- run: gcloud auth list
- アクセスをより限定する:属性条件に
&& assertion.ref == 'refs/heads/main'を追加すると、1つのブランチのみを許可できます。 - ポリシーはお客様が管理します:compiler.devはお客様のGoogle Cloudの設定を参照も変更もしません。認証に失敗した場合、エラーはGoogleから返されます。まず属性条件を確認してください。
ご自身のボックスで始める
Code in a box は、コーディングエージェント用の自分専用Linuxマシンです(4 vCPU、16 GB、100 GB ディスク)。Claude Code または Codex がそこでお使いのリポジトリに対して作業します。進行状況を確認し、方向性を指示し、プルリクエストを開くことができます。ディスクは永続化されるため、リポジトリ、ワークツリー、エージェントのセッションは次回も残ります。
1. サインインします。 GitHub でサインインし、組織に compiler.dev App をインストールしてください(CI で使うものと同じ App です)。組織にはプリペイドクレジットが必要です。クレジットがない場合、ボックスのカードには ボックスを開始するにはクレジットを追加 と表示され、請求ページへのリンクが示されます。
2. キーを追加します。 ワークスペース(または概要画面の ボックスでコーディングを開始)を開き、ボックスを作成します。次に、ご自身のキーを貼り付けます。Claude Code 用は Anthropic キー(console.anthropic.com → API keys から取得)、Codex 用は OpenAI キー(platform.openai.com → API keys から取得)です。キーは暗号化して保存され、ご自身のボックスにのみ送信され、再表示されることはありません。モデルの利用料金は Anthropic または OpenAI からお客様に請求されます。
3. 起動します。 初回の起動には約1分かかります。それ以降は、開始を押すと停止中のボックスを約15秒で再開できます。停止中のボックスにプロンプトを送信しても、自動的に起動します。
4. チャットします。 リポジトリとエージェントを選び、変更内容を説明して、チャットを開始を押します。各チャットには、ブランチ ws/… 上の専用の git ワークツリーが作成されます。エージェントのメッセージとコマンドをリアルタイムで確認でき、その後、実行されたテストと差分が表示されます。次の変更にはフォローアップを送信し、プルリクエストを開くこともできます。1つのボックスでは、最大3つのエージェントが同時に作業できます。
別のデバイスで開きます。 別のデバイスで開くを押すと、5分間有効な一度限りのリンクが作成されます。このリンクを使うと、別のブラウザ(例:スマートフォン)で、そこではサインインせずに同じチャットを12時間開けます。他のデバイスからサインアウトを押すと、それらのセッションを終了できます。
6. 停止します。 作業が終わったら停止を押すか、そのまま放置してください。エージェントが作業しておらず、開いているチャットに誰もいない状態が60分続くと、ボックスは自動的に停止します。バックグラウンドで開いたままのタブや、30分間操作していないタブがあっても、ボックスは起動したままになりません。停止してもディスクは保持されます。ボックスを削除すると、ディスクも削除されます。
トークンの削減。 ボックス内のエージェントは、シェルコマンドを RTK 経由で実行します。RTK は、モデルが読む前にビルド、テスト、git の出力を圧縮します(通常60〜90%削減)。ボックス内で rtk gain を実行すると、削減量を確認できます。特定のコマンドだけ RTK を経由させたくない場合は、コマンドの先頭に RTK_DISABLED=1 を付けてください。ボックス全体で無効にするには、rtk init -g --uninstall と rtk init -g --codex --uninstall を実行します。これでエージェントは未加工の出力を見るようになります。新しい RTK バージョンを提供するまで、ボックスが自動的に元に戻すことはありません。
- 料金: 実行中は1分あたり $0.0065(1時間あたり約 $0.39)に加え、ディスクは1GB・1か月あたり $0.10(100 GB で月 $10、停止中も課金)です。組織のプリペイドクレジットから差し引かれます。カードには今月の費用が表示されます。
- 上限: 1人につきボックスは1つ、同時に最大3エージェント、組織ごとの1日あたりの利用上限があります(既定は $25。引き上げをご希望の場合はお問い合わせください)。ディスクが95%を超えると新しいチャットは受け付けられません。空き容量を確保するには、完了したチャットをアーカイブしてください。
- フェアユース: 暗号資産のマイニングと外部へのメール送信(ポート25)はブロックされています。
GitLab (ベータ版)
ジョブにタグを追加すると、GitLab CIのジョブをcompiler.devのマシンで実行できます。gitlab.comのプロジェクトとグループで利用できます。セルフマネージドのGitLabについては、contact@compiler.devまでお問い合わせください。現在はクローズドベータです。お客様の組織で有効化されると、アプリのメニューのCerセクションにGitLab(ベータ)のページが表示されます。
1. 接続します。アプリでGitLab(ベータ)を開き、GitLabに接続を押します。GitLabにサインインして承認してください。compiler.devはapiスコープ(ランナーとWebhookを作成できる、より狭いスコープはGitLabにありません)とread_userを要求します。トークンは暗号化して保存され、再表示されることはありません。有効化するには、グループのオーナーロール、またはプロジェクトのメンテナーロールが必要です。
2. グループまたはプロジェクトを有効にします。このページには、お客様がオーナーのグループと、メンテナーとして管理しているプロジェクトが、それぞれスイッチとともに一覧表示されます。有効にすると、GitLabに4つのランナーがサイズごとに1つずつ作成され、Job eventsのWebhookが追加されます(グループのWebhookには有料のGitLabプランが必要なため、Webhookはグループ内のすべてのプロジェクトに追加されます)。無効にすると、それらのランナーは削除されます。接続解除を行うと、すべてのランナーが削除されます。GitLabのそれ以外の部分は変更されません。
3. ジョブにタグを追加します。 .gitlab-ci.yml で:
test:
tags: [compiler-8cpu]
script:
- npm test
- サイズ:
compiler-2cpu(2 vCPU、4 GB、1分あたり$0.002)、compiler-4cpu(4 vCPU、16 GB、$0.004)、compiler-8cpu(8 vCPU、16 GB、$0.008)、compiler-16cpu(16 vCPU、32 GB、$0.016)。これらはGitHub Actionsのサイズラベルと同じマシン、同じ料金です。料金はお客様の組織に応じた金額がページに表示されます。これらのタグのいずれも付いていないジョブは処理されません。 - ジョブごとに新しいマシンを1台使用します。各ジョブは新しいマシン上で実行され、ジョブ終了時に削除されます。GitLab RunnerのDockerエグゼキュータを使用し、ファイル内の
image:を使ってジョブを実行します(指定がない場合はUbuntu 24.04)。Docker-in-Dockerも利用できます。マシンは起動時に、バージョンが固定され、チェックサムで検証されたGitLab Runnerをダウンロードします。 - キャッシュは再利用されません。すべてのジョブはキャッシュのない状態のマシンで開始されるため、最初の数秒はマシンの起動とイメージの取得に費やされます。現在と同様に、GitLab独自の
cache:とアーティファクトをご利用ください。 - 料金。GitHubのジョブと同様に、ランナーがジョブを受け取った時点から完了までの、開始された分単位で課金されます。最低1分です。マシンの起動自体は課金されません。利用料金は、前払いのクレジットまたは無料トライアルから差し引かれます。開始されなかったジョブには料金はかかりません。
- クレジットまたはトライアルが終了した場合、compilerタグの付いたジョブは待機状態になります。GitLabの共有ランナーに振り分けられることはありません。ページにその理由が表示され、クレジットを追加すると、数分以内に自動的に開始されます。
- ジョブの検知方法。ジョブが保留状態になると、GitLabが当社のWebhookを呼び出します。また、当社は2分ごとに保留中のジョブを確認しています。そのため、Webhookが取りこぼされた場合や、グループの有効化後に作成されたプロジェクトであっても、開始が遅れるだけです。
- 実行環境。使い捨てのクラウドマシンで実行されます。対応はLinuxのみで、macOS、Windows、GPUのランナーには対応していません。現時点ではgitlab.comのみ対応しています。
Claude を接続(MCP)
compiler.dev はリモートのMCPサーバーを提供しているため、Claude から CI の状況を確認し、操作できます。たとえば、夜間に失敗した内容を尋ねたり、ジョブログの末尾を読んだり、失敗したジョブを再実行したり、利用状況とクレジットを確認したりできます。URL はhttps://ci.compiler.dev/mcpです。
Web 版の Claude と Claude Desktop。
- 設定 → コネクタ → カスタムコネクタを追加を開き、名前を compiler.dev に設定して
https://ci.compiler.dev/mcpを貼り付けます。 - 接続をクリックし、求められた場合は GitHub でサインインして承認します。Claude には有効期限の短いトークン(1 時間、自動で更新)が発行され、そのトークンで参加している組織にのみアクセスできます。
- Team および Enterprise プランでは、オーナーが組織の設定 → コネクタで一度コネクタを追加します。その後、各メンバーが自分のサインインで接続します。
Claude Code。Claude に接続でトークンを作成し、次のコマンドを実行します:
claude mcp add --transport http compiler https://ci.compiler.dev/mcp --header "Authorization: Bearer <your token>"
Claude にできること
- 読み取り:
list_orgs、list_runs(組織、リポジトリ、ステータス、開始日時で絞り込み)、get_run(ジョブ、所要時間、失敗理由)、list_failures、get_job_log_tail(末尾の行、シークレットは伏せ字)、get_usage_and_balance、get_speed_report、recent_events。 - 操作(オーナーとメンテナーのみ):
rerun_failed_jobsは終了した実行の失敗ジョブを再実行します(通常どおりランナー時間を消費します)。request_turbo_runは Jumbo の実行をキューに追加しようとします(無料での実行はもう提供されていないため、拒否されます。1 回の実行は 200 ドルで、ダッシュボードから購入します)。どちらも料金は発生せず、請求、価格、利用上限、ルーティングは変更されません。いかなるツールもこれらを変更できません。 - 制限事項:すべての呼び出しは、GitHub で確認済みの組織に対して検証され、レート制限がかけられ、監査ログに記録されます。実行とイベントは、compiler.dev のランナーで実行されたジョブが対象です。
通知。セッションが開いていない場合、サーバーから Claude を起動することはできません。そのため compiler.dev では、お客様向けのフィードを保持しています(ジョブの失敗、失敗していたジョブの修正、クレジット残高の不足、利用上限への到達、Jumbo レポートの準備完了など。30 日間保存されます)。Claude は次に接続したとき、またはお客様が尋ねたとき(「CI に新しいことはある?」など)に、recent_eventsまたはcompiler://eventsリソースを通じてこれを確認します。セッションを開いたままにし、そのリソースを購読しているアプリには、直ちに通知されます。フィードに含めるイベントはClaude に接続で選択できます。
取り消し。同じページで Claude の接続を解除するか、トークンを取り消してください。取り消したトークンは直ちに使用できなくなります。トークンはハッシュ化して保存されるため、再度表示することはできません。
課金
- Basic では 1 コア分の 1 分あたり $0.001 となるため、既定の Linux 8 vCPU / 16 GB ランナーは 1 分あたり $0.008 です(2 コアのランナーは $0.002)。料金はジョブごとに計測されます。クレジットは 20 ドルからの前払いです。利用分は 1 分単位で消化され、月次の明細が発行されます。
- その他のマシン: Linux 2 / 4 / 16 / 32 vCPU は 1 分あたり $0.002 / $0.004 / $0.016 / $0.048(提供中)、Apple M4 Pro の macOS は 7 コアの VM が 1 分あたり $0.028、14 コアのホスト全体が $0.055(早期アクセス)です。専有の M4 Pro ホストは 1 ホストあたり月額 $3,595 からです。
- プリペイドクレジット: ジョブを compiler.dev で実行する前に、$20 から(Stripe によるカード決済)クレジットを購入できます。クレジットに有効期限はなく、利用量に応じて分単位で消費されます。ルーティング設定を使用している場合、残高が $0 になると、ジョブは切り替え前に使用していたランナーで実行されます。自動チャージも任意で設定できます。
- チャージパック: 20 ドルで 20 ドル分のクレジット、100 ドルで 110 ドル分、500 ドルで 600 ドル分です。20 ドル以外の任意の金額にはボーナスは付きません。ボーナスクレジットは支払いが完了した時点で加算され、「ボーナスクレジット」という独立した行として表示されます。
- 返金: 未使用のお支払い済みクレジットは、いつでも返金をリクエストできます(ボーナスクレジットは対象外です)。利用状況と請求で「未使用クレジットの返金をリクエスト」を選択してください。各リクエストを確認のうえ、お支払いに使用したカードに返金します。
- 利用上限: 月間の上限を設定できます。ルーティング設定を使用している場合、上限に達すると、翌月になるか上限を引き上げるまで、新しいジョブは切り替え前に使用していたランナーで実行されます。
- オーナーと請求管理者は、利用状況と請求から支払い方法と請求書を管理できます。
利用状況の分析とデータ
当社は、サービスの運用と利用状況ダッシュボードの提供のために、製品および CI のイベントを記録します。たとえば、ジョブのキュー投入、開始、終了(所要時間を含む)、キャッシュヒット、オンボーディングの各ステップ、ページビューなどです。イベントにはリポジトリ名、ジョブ名、所要時間、件数が含まれますが、ソースコード、シークレット、メールアドレスは含まれません。ユーザーは内部のユーザー ID のみで識別されます。組織のイベントはその組織のみが閲覧でき、2 年間保存されます。
コードレビューとインサイトのデータ処理者
Code review または Insights を有効にすると、次の外部サービスがお客様のデータを処理します。
- Anthropic は、コードレビューの作成と Insights の質問への回答を行います。プルリクエストの差分、関連するファイル、お客様の質問を受け取ります。組織が設定画面で独自の Anthropic API キーを追加した場合、これらのリクエストは当社のアカウントや利用規約ではなく、お客様のアカウントと利用規約に基づいて Anthropic に送信され、料金も Anthropic からお客様に請求されます。
- TypeSafe, Inc. (US) makes typed risk decisions for code review and Agent Radar. It receives counts, categories and yes/no facts only, never code or text, for every use: the Code review double-check, “Looks good to me” and Agent Radar. It always runs on our account.
設定 → 機能 で Code review または Insights を無効にすると、これらのサービスには何も送信されません。
ヘルプ
ご不明な点や移行できないジョブがある場合は、contact@compiler.dev までメールでお問い合わせください。