Cómo usar Agent Autoloop: que Claude Code / Codex tomen trabajo en segundo plano y solo te pregunten con una tarjeta cuando haga falta (instalación, rules.json, prueba)

Agent Autoloop convierte Claude Code, Codex y agentes CLI similares en un bucle en segundo plano: eventos o cron envían trabajo, el agente sale tras cada ronda y solo recibes una tarjeta cuando la decisión es tuya. Guía según el README y SECURITY oficiales, con nuestro try → answer → status cronometrado, un brief matinal en rules.json, la API Key de aicodewith y límites de seguridad sin supervisión.

3 分钟阅读
Cómo usar Agent Autoloop: que Claude Code / Codex tomen trabajo en segundo plano y solo te pregunten con una tarjeta cuando haga falta (instalación, rules.json, prueba)

En resumen:

  • Agent Autoloop (MIT) sustituye «vigilar el terminal» por «evento / cron → una ronda y salida → tarjeta solo si hace falta → tu respuesta reanuda la misma sesión». README: macOS / Linux; Windows nativo pendiente (issue #17; WSL2 por ahora).
  • Instalación: curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh, luego agent-autoloop try.
  • Medición del 6 de noviembre de 2026 en Linux: Node 24.22.2, agent-autoloop v1.5.0, Codex (aicodewith, gpt-6.1-sol). Bucle de aprobación OK — ~9 s hasta la tarjeta de color; tras responder «verde», ~10 s en la misma sesión hasta «prueba superada». Sin escritorio faltaba notify-send; el CLI bastó.
  • Reglas en ~/.agent-autoloop/rules.json; valida con agent-autoloop check.
  • Sin supervisión = permisos locales: no compartas enlaces de tarjeta; autentica webhooks. Según SECURITY, la inyección de prompts no está del todo resuelta — edit por defecto, efectos secundarios con ask.

Crea una API Key, conecta Claude Code / Codex y arranca el bucle →

Qué problema resuelve

Con Claude Code o Codex suele mirarse el terminal. Cerrar la ventana detiene el trabajo.

Agent Autoloop se centra en un kernel determinista (~1650 líneas, cero deps de runtime según el README) con plugins:

  1. Llega un evento — cron a las 9, issue de GitHub, alerta.
  2. Las reglas lo asignan — agente y directorio; mismos asuntos se fusionan.
  3. Una ronda y sale — mientras decides, no hay proceso del agente.
  4. Tarjeta solo si hace falta — borrados, reinicios, mensajes salientes vía Feishu / DingTalk / WeCom / Slack / Discord o escritorio.
  5. La respuesta reanuda — la misma conversación.

Según el README: Claude Code, Codex y ACP se probaron en multi-turno y reanudación; Feishu con entrega real. Webhooks / GitLab sobre todo contra mocks locales.

Requisitos

ÍtemRequisito
SOmacOS o Linux. Windows nativo pendiente (#17); INSTALL documenta WSL2
RuntimeNode.js 24+, Git, curl
AgenteClaude Code o Codex usable (u otro CLI con command)
Clave aicodewith (opcional)Regístrate y crea una API Key

En nuestra máquina: Node 22 → 24.22.2 con n 24.

Paso 0: crear una API Key

  1. Regístrate en aicodewith.ai, Gestión de claves.
  2. Crear clave, nombre claro (p. ej. autoloop-box).
  3. Copia la clave al momento. Ver la doc Create API Key.

Crear API Key →

Codex — ~/.codex/config.toml:

toml
model = "gpt-6.1-sol"
model_provider = "aicodewith"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "TU_API_KEY"

Claude Code — ~/.claude/settings.json:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "TU_API_KEY"
  }
}

También: instalación de Codex, API Key de Codex, config.toml, subagente de Claude Code, alternativa a Conductor.

Instalación

bash
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh

App en ~/.agent-autoloop/app. CI / headless: --no-service y luego agent-autoloop up (INSTALL).

Nuestra corrida (2026-11-06, Asia/Shanghai): v1.5.0 (f211ca2de3b1), agente Codex.

bash
agent-autoloop --version
agent-autoloop doctor
agent-autoloop up
agent-autoloop try

Bucle mínimo: try → answer → status

Línea de tiempo con Codex (UTC+8):

PasoHoraResultado
try15:25:01 → 15:25:10~9 s, tarjeta de color
answer 1 215:25:27verde; ronda 3, misma sesión
Fin15:25:27 → 15:25:37~10 s, «prueba superada»
Notify—sin notify-send; CLI OK
bash
agent-autoloop answer 1 2
agent-autoloop status
agent-autoloop why 3

Notas honestas: el primer try falló por un id de modelo ausente en aicodewith; con gpt-6.1-sol pasó. Smoke de Claude Code ~6 s → OK; este try usó el plugin de Codex.

Escribir rules.json

Brief matinal (README):

json
{
  "name": "Morning brief",
  "when": { "cron": "0 9 * * *" },
  "to": "codex",
  "cwd": "~/notes",
  "prompt": "Summarize yesterday's notes and commits into today's brief."
}

check OK; rules explain: Asia/Shanghai, próximo 11/07 09:00. Más recetas en el repo.

Claude Code, Codex y otros CLI

use: claude, codex, acp, dsh o command con {prompt} como un solo argumento. Claude Code / Codex / Cursor son opciones pares. Para worktrees en paralelo: alternativa a Conductor.

Seguridad

Según SECURITY: privilegios locales; el enlace de tarjeta vale 7 días y quien lo tiene responde; los eventos no eligen el agente; autentica webhooks; no se proxifican logins CLI; borra configs con la clave tras la prueba.

FAQ

¿Windows? Pendiente (#17); WSL2 documentado. ¿Servicio del sistema? Opcional. ¿Falló try? doctor, Node ≥ 24, modelo en la lista, experimental_bearer_token completo.

Cierre

Node 24 → instalar → try / answer / status → regla cron → SECURITY → borrar claves de prueba.

Crea una API Key y escribe tu primera regla en segundo plano →

相关文章

Qué es el UI SDK y cómo se usa? La biblioteca de comportamientos de Vercel y shadcn para agentes, instalada y probada en Claude Code / Codex / Cursor (0.1.0-beta.1)

Qué es el UI SDK y cómo se usa? La biblioteca de comportamientos de Vercel y shadcn para agentes, instalada y probada en Claude Code / Codex / Cursor (0.1.0-beta.1)

El UI SDK es la biblioteca de comportamientos de Vercel para agentes, publicada el 12 de noviembre de 2026 como 0.1.0-beta.1. Los comportamientos viven en el paquete independiente del framework @ui-sdk/core y los renderizan adaptadores para React, Vue, Svelte, Solid y Web Components. Esta guía sigue la documentación oficial sobre qué es, cómo instalarlo y cómo añadir el skill para Claude Code, Codex y Cursor, y registra los comandos, tiempos y salidas de nuestra máquina de prueba.

¿Qué es AWS Emulator y cómo se instala? Prueba apps de AWS en local con Claude Code y Codex (probado en 1.0.322)

¿Qué es AWS Emulator y cómo se instala? Prueba apps de AWS en local con Claude Code y Codex (probado en 1.0.322)

AWS Emulator es el emulador local oficial de las API de AWS, con disponibilidad general desde el 11 de noviembre de 2026 (hora de EE. UU.). No tiene cargo adicional por el servicio, su código es abierto, no necesita cuenta de AWS y cubre más de 200 servicios. Probamos la versión 1.0.322 en Debian 13: comandos de instalación, AWS CLI apuntando al endpoint local para crear un bucket de S3 y una tabla de DynamoDB, los errores que encontramos y cómo hacer que Claude Code, Codex y Cursor escriban y prueben código contra el emulador.

¿Qué es T3 Code y cómo se instala? Conectar Claude Code y Codex, usar una API Key de terceros y resolver errores comunes (probado en 0.1.9)

¿Qué es T3 Code y cómo se instala? Conectar Claude Code y Codex, usar una API Key de terceros y resolver errores comunes (probado en 0.1.9)

T3 Code es la consola de código abierto de pingdotgg para manejar agentes de programación. No trae modelo propio: controla los CLI de Claude Code, Codex, Cursor y otros que ya tienes instalados. Probamos T3 Code 0.1.9 en Linux. Esta guía cubre los comandos de instalación, cómo conectar Claude Code y Codex a una API Key de AICodeWith para que T3 Code los controle, una ejecución completa de ambos agentes con el comando t3 thread y los errores que encontramos, con su solución.