Documentación de compiler.dev
compiler.dev ejecuta sus jobs existentes de GitHub Actions en máquinas Linux rápidas y aisladas. Usted conserva GitHub Actions y sus checks; solo cambia la máquina. Con la configuración enrutada, si compiler.dev no puede aceptar un job, o si su crédito o su límite mensual se agota, el job se ejecuta en el runner que usaba antes de cambiar, ya sea alojado por GitHub o propio. La etiqueta de una sola línea runs-on: compiler-8cpu funciona una vez instalada la GitHub App, pero no tiene fallback automático: el job espera a un runner de compiler.dev (consulte etiquetas de tamaño).
Primeros pasos
1. Inicie sesión e instale la GitHub App. Inicie sesión con GitHub y, a continuación, instale la App de compiler.dev en su organización y elija los repositorios que podrá ver. La App lee los flujos de trabajo y los metadatos de los trabajos, registra runners de un solo uso para los trabajos enrutados a compiler.dev y, solo a través de la pull request de configuración, propone cambios en los flujos de trabajo. Nunca fusiona nada.
2. Elija un repositorio y un modo. Analizamos sus flujos de trabajo y mostramos qué trabajos se pueden mover. Elija Probar con seguridad (comparación: una copia se ejecuta en nuestras máquinas y sus resultados siguen viniendo de sus runners) o Cambiar ahora con el 10 %, 25 %, 50 % o 100 % de las pull requests. Una PR permanece en el mismo lado para todos sus pushes y reejecuciones.
3. Fusione la pull request de configuración. Cada flujo de trabajo enrutado recibe un pequeño trabajo compiler-route que consulta a compiler.dev dónde debe ejecutarse el trabajo; sus trabajos usan su respuesta como runs-on. Sus pasos no cambian. Nada se mueve hasta que la PR se fusiona.
4. Observe la primera ejecución. La aplicación muestra cada trabajo en tiempo real (en cola, arrancando, en ejecución, terminado), con el nombre de la máquina y la duración comparada con sus runners anteriores.
Qué trabajos se pueden mover
- Elegibles: trabajos de Linux (
ubuntu-*) que compilan y prueban. Máquina predeterminada: 8 vCPU, 16 GB, nueva para cada trabajo y eliminada después. - Permanecen en sus runners: trabajos de despliegue y publicación, Windows, macOS, ARM, GPU y trabajos de pull requests desde forks (no pueden obtener un token OIDC).
- Secretos: los trabajos que usan secretos se ejecutan en nuestras máquinas con los secretos que usted conceda. Es preferible usar credenciales solo de pruebas; el análisis marca estos trabajos.
Respaldo y reversión
- Fallback automático: si compiler.dev no funciona, responde con lentitud (15 s) o no puede iniciar una máquina para su job, el job de enrutamiento responde con su runner original, o la ejecución se cancela y se vuelve a lanzar en él. Los fallos reales de los tests nunca se vuelven a enrutar.
- Pausar: establezca el repositorio al 0 % en el panel de control y los nuevos PR usarán sus runners originales.
- Eliminar: revierta el PR de configuración o desinstale la GitHub App. Al desinstalarla, se detienen de inmediato todos los accesos y el enrutamiento.
Caché de compilación (Nx / Turborepo)
En los runners de compiler.dev, Nx (20.8+) y Turborepo usan automáticamente una caché remota junto a los runners, sin que tenga que cambiar nada en sus workflows. Las cachés están aisladas por repositorio; las pull requests pueden leer la caché de la rama por defecto, pero solo escribir en la suya, de modo que una PR nunca puede inyectar artefactos en builds de confianza. Para desactivarla en un job, defina NX_SELF_HOSTED_REMOTE_CACHE_SERVER: "" and/or TURBO_API: "" en el env: de ese job.
OIDC con AWS
OIDC permite que un job obtenga credenciales temporales de AWS sin guardar una clave de acceso en GitHub. En cada ejecución, GitHub emite un token firmado y AWS lo cambia por credenciales temporales. El flujo del token es el estándar de GitHub Actions, así que el workflow siguiente es el habitual con la etiqueta runs-on de compiler.dev. Para una guía más detallada, consulte OIDC de GitHub Actions a AWS.
1. Añada GitHub como proveedor de identidad en IAM. URL del proveedor https://token.actions.githubusercontent.com, audiencia sts.amazonaws.com.
2. Cree un rol con esta política de confianza. Sustituya 111122223333, ORG y REPO. La condición sub es la que impide el acceso a otros repositorios y ramas, así que configúrela siempre.
{
"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. Use el rol en su workflow. El job necesita 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
- Qué ejecuciones pueden asumir el rol: use
repo:ORG/REPO:ref:refs/heads/mainpara una rama,repo:ORG/REPO:environment:productionpara un entorno de GitHub, oStringLikeconrepo:ORG/REPO:*para todo el repositorio. - Los pull requests desde forks no reciben token, como en cualquier runner.
- Su política es suya: compiler.dev no ve ni modifica sus roles de AWS. Si un job no puede asumir un rol, el error procede de AWS; revise primero la política de confianza.
OIDC con Google Cloud
La federación de identidades de carga de trabajo permite que un job actúe como una cuenta de servicio de Google Cloud sin almacenar un archivo de clave. En cada ejecución, GitHub emite un token firmado y Google lo intercambia por credenciales de corta duración. El flujo de tokens es el estándar de GitHub Actions, por lo que el workflow siguiente es el habitual con la etiqueta runs-on de compiler.dev.
1. Cree un pool de identidades de carga de trabajo y un proveedor de GitHub. Emisor https://token.actions.githubusercontent.com. Asigne los claims a atributos y añada una condición para que solo se acepte su repositorio:
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. Permita que ese repositorio use una cuenta de servicio. Conceda roles/iam.workloadIdentityUser sobre la cuenta de servicio al conjunto de principales del repositorio:
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/github-pool/attribute.repository/ORG/REPO
3. Úselo en su workflow. El job necesita 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
- Acceso más restringido: añada
&& assertion.ref == 'refs/heads/main'a la condición de atributos para permitir solo una rama. - Su política es suya: compiler.dev no ve ni modifica su configuración de Google Cloud. Si la autenticación falla, el error procede de Google; revise primero la condición de atributos.
Empiece con su máquina
Code in a box es su propia máquina Linux para agentes de programación (4 vCPU, 16 GB, disco de 100 GB). Claude Code o Codex trabaja en ella sobre sus repositorios; usted supervisa, dirige y abre la pull request. El disco persiste, así que los repositorios, los worktrees y las sesiones del agente seguirán ahí la próxima vez.
1. Inicie sesión. Inicie sesión con GitHub e instale la aplicación de compiler.dev en su organización (la misma aplicación que para CI). Su organización necesita crédito prepagado; si no tiene, la tarjeta del box muestra Añada crédito para iniciar su box con un enlace a Facturación.
2. Añada una clave. Abra Espacios de trabajo (o Empiece a programar en su box en la Descripción general) y cree su box. Después, pegue su propia clave: una clave de Anthropic para Claude Code (desde console.anthropic.com → API keys) o una clave de OpenAI para Codex (desde platform.openai.com → API keys). Las claves se almacenan cifradas, se envían solo a su box y no se vuelven a mostrar. El uso del modelo lo factura Anthropic u OpenAI directamente a usted.
3. Inicie el box. El primer arranque tarda alrededor de un minuto; después, Iniciar reanuda un box detenido en unos 15 segundos. Enviar un prompt a un box detenido también lo inicia.
4. Chatee. Elija un repositorio y el agente, describa el cambio y pulse Iniciar chat. Cada chat tiene su propio git worktree en la rama ws/…. Verá en directo los mensajes y comandos del agente, después las pruebas que ejecutó y el diff; envíe un mensaje de seguimiento para el siguiente cambio o abra la pull request. Hasta 3 agentes pueden trabajar en su box a la vez.
5. Abra en otro dispositivo. Abrir en otro dispositivo genera un enlace de un solo uso, válido durante 5 minutos, que abre los mismos chats en otro navegador (por ejemplo, su teléfono) durante 12 horas sin iniciar sesión allí. Cerrar sesión en otros dispositivos finaliza esas sesiones.
6. Detenga. Pulse Detener cuando termine, o simplemente déjelo: el box se detiene solo tras 60 minutos sin ningún agente trabajando y sin nadie en un chat abierto. Una pestaña que dejó abierta en segundo plano, o que no ha tocado durante 30 minutos, no lo mantiene activo. Detener conserva el disco; eliminar el box elimina el disco.
Menos tokens. Los agentes en un box ejecutan sus comandos de shell a través de RTK, que compacta la salida de compilaciones, pruebas y git antes de que el modelo la lea (normalmente entre un 60 y un 90 % menos). Ejecute rtk gain en el box para ver cuánto ha ahorrado. Para omitirlo en un solo comando, empiece el comando con RTK_DISABLED=1. Para desactivarlo en el box, ejecute rtk init -g --uninstall y rtk init -g --codex --uninstall; los agentes verán entonces la salida sin procesar, y el box no la volverá a activar hasta que publiquemos una versión más reciente de RTK.
- Costes: $0.0065 por minuto de ejecución (unos $0.39 por hora) más $0.10 por GB al mes por el disco ($10 al mes por 100 GB, también mientras está detenido), con cargo al crédito prepagado de su organización. La tarjeta muestra el coste de este mes.
- Límites: un box por persona, hasta 3 agentes a la vez y un límite de gasto diario por organización (25 $ por defecto; pídanos que lo aumentemos). Los nuevos chats se rechazan cuando el disco está al 95 % de su capacidad; archive los chats terminados para liberar espacio.
- Uso aceptable: la minería de criptomonedas y el correo saliente (puerto 25) están bloqueados.
GitLab (beta)
Ejecute sus trabajos de GitLab CI en las máquinas de compiler.dev añadiendo una etiqueta al trabajo. Funciona con proyectos y grupos en gitlab.com. Para GitLab autoalojado, escríbanos a contact@compiler.dev. Esta es una beta cerrada: la página GitLab (beta) aparece en la sección de CI del menú de la aplicación cuando la activamos para su organización.
1. Conecte. Abra GitLab (beta) en la aplicación y pulse Connect GitLab. Inicie sesión en GitLab y apruebe el acceso. compiler.dev solicita el ámbito api (GitLab no ofrece un ámbito más restringido que permita crear runners y webhooks) y read_user. El token se almacena cifrado y no volverá a mostrarse. Para activar algo necesita el rol de Owner en un grupo o el rol de Maintainer en un proyecto.
2. Active un grupo o proyecto. La página muestra los grupos de los que es propietario y los proyectos que mantiene, cada uno con un interruptor. Al activar uno, se crean en GitLab cuatro runners, uno por tamaño, y se añade un webhook de Job events (en cada proyecto del grupo, porque los webhooks de grupo requieren un plan de pago de GitLab). Al desactivarlo, se eliminan de nuevo; Disconnect hace lo mismo con todo. El resto de su GitLab no se modifica.
3. Añada una etiqueta al trabajo. En .gitlab-ci.yml:
test:
tags: [compiler-8cpu]
script:
- npm test
- Tamaños:
compiler-2cpu(2 vCPU, 4 GB, $0.002 por minuto),compiler-4cpu(4 vCPU, 16 GB, $0.004),compiler-8cpu(8 vCPU, 16 GB, $0.008) ycompiler-16cpu(16 vCPU, 32 GB, $0.016). Son las mismas máquinas y precios que las etiquetas de tamaño de GitHub Actions; la página muestra el precio para su organización. Los trabajos sin una de estas etiquetas nunca se ven afectados. - Una máquina nueva por trabajo. Cada trabajo se ejecuta en una máquina nueva que se elimina al terminar. Ejecuta el trabajo con el ejecutor Docker de GitLab Runner, usando el
image:de su archivo (Ubuntu 24.04 si no hay ninguno); Docker-in-Docker funciona. La máquina descarga al iniciarse un GitLab Runner fijado a una versión y verificado por suma de comprobación. - Sin cachés calientes. Cada trabajo empieza en una máquina en frío, así que los primeros segundos se van en iniciarla y descargar su imagen. Use la
cache:y los artefactos de GitLab como hace hoy. - Facturación. Por minuto iniciado, con un mínimo de uno, desde que el runner recibe el trabajo hasta que termina, igual que con los trabajos de GitHub. Iniciar la máquina no se factura. El consumo se descuenta de su crédito prepagado o de la prueba gratuita. Un trabajo que nunca llegó a iniciarse no tiene coste.
- Si se agota su crédito o prueba, los trabajos con una etiqueta de compiler esperan; no pasan a los runners compartidos de GitLab. La página indica el motivo, y se iniciarán por sí solos, en un par de minutos, en cuanto añada crédito.
- Cómo se detecta un trabajo. GitLab llama a nuestro webhook cuando un trabajo pasa a pendiente, y además buscamos trabajos pendientes cada dos minutos, así que un webhook perdido, o un proyecto creado después de activar su grupo, solo retrasa el inicio.
- Dónde se ejecuta. En máquinas en la nube de un solo uso. Solo Linux; sin runners para macOS, Windows ni GPU. Por ahora, solo gitlab.com.
Conecte Claude (MCP)
compiler.dev dispone de un servidor MCP remoto, para que pueda ver su CI y actuar sobre él desde Claude: consultar qué falló durante la noche, leer las últimas líneas del registro de un job, volver a ejecutar los jobs fallidos y revisar el consumo y los créditos. La URL es https://ci.compiler.dev/mcp.
Claude en la web y Claude Desktop.
- Abra Configuración → Conectores → Añadir conector personalizado, asígnele el nombre compiler.dev y pegue
https://ci.compiler.dev/mcp. - Haga clic en Conectar, inicie sesión con GitHub si se le solicita y apruebe el acceso. Claude recibe un token de corta duración (una hora, renovado automáticamente) que solo llega a las organizaciones de las que usted forma parte.
- En los planes Team y Enterprise, un propietario añade el conector una sola vez en Configuración de la organización → Conectores; después, cada persona lo conecta con su propio inicio de sesión.
Claude Code. Cree un token en Conectar con Claude y ejecute:
claude mcp add --transport http compiler https://ci.compiler.dev/mcp --header "Authorization: Bearer <your token>"
Lo que puede hacer Claude.
- Lectura:
list_orgs,list_runs(filtrar por organización, repositorio, estado o fecha de inicio),get_run(jobs, tiempos y motivo del fallo),list_failures,get_job_log_tail(últimas líneas, con secretos ocultos),get_usage_and_balance,get_speed_reportyrecent_events. - Acciones, solo para propietarios y mantenedores:
rerun_failed_jobsvuelve a ejecutar los jobs fallidos de una ejecución terminada (consumen minutos de runner como de costumbre), yrequest_turbo_runintenta poner en cola una ejecución Jumbo (las ejecuciones gratuitas ya no se ofrecen, por lo que la solicitud se rechaza; una ejecución cuesta $200 y se compra en el panel). Ninguna de estas herramientas genera cargos ni modifica la facturación, los precios, los límites de gasto ni el enrutamiento. - Límites: cada llamada se verifica frente a sus organizaciones verificadas en GitHub, tiene un límite de frecuencia y queda registrada en un registro de auditoría. Las ejecuciones y los eventos cubren los jobs que se ejecutaron en los runners de compiler.dev.
Notificaciones. Un servidor no puede despertar a Claude cuando no hay ninguna sesión abierta. compiler.dev mantiene un feed para usted (un job ha fallado, un job fallido se ha corregido, el crédito es bajo, se ha alcanzado el límite de gasto, un informe de Jumbo está listo; se conserva 30 días). Claude lo ve la próxima vez que se conecta o cuando usted lo pide («¿hay algo nuevo en CI?»), a través de recent_events o del recurso compiler://events. Las aplicaciones que mantienen una sesión abierta y se suscriben a ese recurso reciben la notificación de inmediato. Elija qué eventos entran en el feed en Conectar con Claude.
Revocar. Desconecte Claude o revoque un token desde la misma página; deja de funcionar de inmediato. Los tokens se almacenan con hash, por lo que no podemos volver a mostrarlos.
Facturación
- $0.001 por minuto-núcleo (Basic), de modo que el runner predeterminado de Linux con 8 vCPU / 16 GB cuesta $0.008 por minuto (un runner de 2 núcleos cuesta $0.002), medido por job. Usted paga el crédito por adelantado desde $20. El consumo se descuenta por minuto y recibe un extracto mensual.
- Otras máquinas: Linux de 2 / 4 / 16 / 32 vCPU a $0.002 / $0.004 / $0.016 / $0.048 por minuto (disponible); macOS en Apple M4 Pro a $0.028 por minuto para una VM de 7 núcleos o $0.055 por minuto para un host completo de 14 núcleos (acceso anticipado); hosts M4 Pro dedicados desde $3,595 por host al mes.
- Crédito prepagado: compre crédito desde 20 $ (tarjeta, mediante Stripe) antes de que los jobs se ejecuten en compiler.dev; no caduca y el uso lo consume por minuto. Con la configuración enrutada, con 0 $ los jobs se ejecutan en el runner que usaban antes de cambiar. Recarga automática opcional.
- Paquetes de recarga: $20 = $20 de crédito; $100 = $110 de crédito; $500 = $600 de crédito. Cualquier otro importe desde $20 no tiene bonificación. El crédito adicional se añade cuando se completa su pago y aparece como una línea independiente «Crédito bonificado».
- Reembolsos: el crédito no utilizado que ha pagado es reembolsable previa solicitud en cualquier momento (el crédito bonificado no lo es). Use «Solicitar reembolso del crédito no utilizado» en Uso y facturación; revisamos cada solicitud y reembolsamos a la tarjeta con la que pagó.
- Límite de gasto: defina un límite mensual. Con la configuración enrutada, al alcanzarlo los nuevos jobs se ejecutan en el runner que usaban antes de cambiar, hasta el mes siguiente o hasta que lo aumente.
- Los propietarios y administradores de facturación gestionan los métodos de pago y las facturas desde Uso y facturación.
Analíticas de uso y sus datos
Registramos eventos de producto y de CI (por ejemplo, un job en cola, iniciado y finalizado con su duración, aciertos de caché, pasos de incorporación y visitas a páginas) para prestar el servicio y alimentar sus paneles de uso. Los eventos contienen nombres de repositorios y de jobs, tiempos y recuentos, nunca código fuente, secretos ni direcciones de correo electrónico; las personas se identifican únicamente mediante un id de usuario interno. Los eventos de su organización solo son visibles para su organización y se conservan durante dos años.
Encargados del tratamiento de datos para Code review e Insights
Estos servicios externos procesan sus datos cuando Code review o Insights están activados:
- Anthropic redacta revisiones de código y responde a las preguntas de Insights. Recibe el diff de la pull request, los archivos pertinentes y su pregunta. Si su organización añade su propia clave de API de Anthropic en Settings, estas solicitudes se envían a Anthropic con su cuenta y sus condiciones en lugar de las nuestras, y Anthropic le factura por ellas.
- 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.
Si desactiva Code review o Insights en Settings → Features, no se envía nada a estos servicios.
Ayuda
¿Tiene preguntas o un job que no se puede migrar? Escriba a contact@compiler.dev.