Mapa de la ruta de aprendizaje
Contenido detallado
🤝 Claude usa Codex
La receta R1: el puente codex-exec.sh permite que Claude le pida una segunda opinión o una tarea a Codex sin salir de Claude Code.
Un script del kit, runtime/pontes/codex-exec.sh, que envuelve codex exec: envía una solicitud a Codex y devuelve la respuesta.
Es la vía oficial (CLI, nivel 3) para lo que los videos de mods hacían por dentro de la app.
Puente, CLI, codex exec, segunda opinión.
Dale permiso de ejecución al script y pídele a Codex que responda solo PONG.
Probar la conexión fuera del agente permite distinguir un problema de conexión de uno con la solicitud.
chmod +x, prueba, PONG.
El prompt de la R1: Claude usa el puente para que Codex revise el README.md y después compara su opinión con la de Codex.
Dos modelos diferentes se equivocan en lugares distintos; la comparación muestra qué se le escaparía a uno solo.
Revisión cruzada, leer (N4), combinar respuestas.
Pasar la carpeta y el modo workspace-write a Codex para que cree notas.txt con la palabra OK.
Cambiar archivos es N3: solo cuando lo pides, y la prueba es que cat notas.txt muestre OK.
Sandbox, read-only, workspace-write, N3.
El puente solo acepta read-only y workspace-write; solicitar danger-full-access da como resultado "sandbox rechazado por POLITICA".
Ver cómo ocurre el rechazo da confianza en que la regla está en el código, no solo en el papel.
POLITICA.md, rechazo, salida 2, límite por acción.
Las variables del puente (modelo predeterminado gpt-6-luna, tiempo predeterminado de 600 segundos) y la sección "Si ocurre un error" de la R1.
El puente detenido, el rechazo del sandbox y la red bloqueada tienen una causa conocida y una solución de una línea.
Variable de entorno, timeout, stdin, LIMITES.md.
🔌 Tu primer puente MCP
La receta R3: un servidor MCP sin dependencias convierte la agenda de Clara y el CSV de ventas de Sonia en herramientas para el agente.
Una forma estándar en que un programa ofrece herramientas con nombre y reglas a cualquier agente compatible.
El mismo puente sirve para Claude Code y Codex: puente local (nivel 6) expuesto mediante MCP (nivel 2).
MCP, servidor, herramienta (tool), stdio.
listar_horarios_livres lee agenda.csv; resumo_vendas lee erp-vendas.csv y suma por cliente o producto.
Son los dos casos más comunes de sistemas sin API: una agenda en una hoja de cálculo y un ERP que solo exporta.
agenda.csv, erp-vendas.csv, solo lectura (N4).
Ejecutar server.mjs con --selftest y ver tools: 2, los horarios libres del 06/10 y TOTAL: R$ 856.00.
Prueba el puente sin ningún agente y sin gastar cuota.
Selftest, prueba, cálculo verificado a mano.
El .mcp.json de la raíz ya registra el puente y .claude/settings.json ya lo habilita; claude mcp list lo confirma.
Saber dónde se registra el puente permite reemplazarlo más adelante por tu sistema.
.mcp.json, enabledMcpjsonServers, Pending approval.
Pedirle al claude los horarios disponibles de 2026-10-07 y recibir 08:00 (Dra. Ana) y 16:00 (Dr. Bruno).
Es Clara consultando la agenda sin abrir la hoja de cálculo, y la respuesta coincide con las filas disponibles del CSV.
claude -p, llamada a herramienta, prueba con la fuente.
Un comando registra el puente del modelo en Codex, con la ruta completa de server.mjs.
Un puente, dos agentes: escribes la herramienta una vez y la usas en ambos.
codex mcp add, ruta absoluta, $PWD.
🏗️ El puente de tu sistema
El paso 4 de la R3: apuntar el ponte-modelo a la exportación de tu sistema, cambiar las columnas y mantener todo en modo de solo lectura.
Encontrar en el menú del sistema el archivo que exporta, con encabezado y en una carpeta fija.
Sin API, la exportación es la materia prima del puente; su formato determina cuánto ajuste hará falta.
Exportación, encabezado, separador, carpeta fija.
La variable PONTE_DADOS en el campo env de .mcp.json, que hace que el puente lea tu carpeta en lugar de los ejemplos.
Cambia la fuente de los datos sin tocar el código del puente.
Variable de entorno, .mcp.json, campo env.
Un prompt que le indica al agente que cambie solo los nombres de las columnas que se usan en run(), y muestre el antes y el después.
Adaptas el puente sin programar, y la regla de la cuenta sigue siendo la misma.
run(), nombre de columna, límite escrito en la solicitud.
La regla de R3: una herramienta que lee es N4; una herramienta que escribe pasa a ser "modificar" en POLITICA.md y debe pedir permiso antes.
Un error de lectura da una respuesta equivocada; un error de escritura daña los datos que otras personas usan.
N4, N2, readFileSync, herramienta separada.
Volver a calcular con una calculadora el total que calcula el puente, línea por línea y por cliente.
Una columna intercambiada por error no da error: da un número incorrecto que parece correcto.
Cuenta de verificación, prueba, comando → salida esperada.
Una línea en el mapa con vía, nivel 6, la herramienta, la política leer (N4) y la fecha de la prueba.
Un sistema sin línea no lo usa el agente; la línea con fecha es lo que habilita su uso.
CAPACIDADES.md, probado en, línea pendiente.
🌐 Navegador con política
La receta R5: agent-browser para sistemas que solo existen como sitio web, con una regla escrita sobre lo que el agente lee, completa y nunca hace.
El uso de la computadora es el peldaño 5 de la escalera, el único con baja estabilidad: el sitio cambia y la automatización se pierde.
Si existe una API, un MCP, una CLI o una exportación, esa opción prevalece sobre el navegador.
Uso de la computadora, estabilidad, selector.
Dos comandos: instalar agent-browser con npm y descargar Chromium, que es lo que usa.
Un navegador separado, sin tus inicios de sesión, es la forma más segura de empezar.
npm, Chromium, Claude in Chrome.
Abrir example.com, leer el título y cerrar; la prueba es la salida Example Domain.
Compruebas el navegador sin hacer clic en nada ni enviar nada.
open, get title, close, prueba de la R5.
El pedido de la R5: leer la tabla de precios de un sitio y devolverla en CSV, sin hacer clic en enviar ni comprar.
Leer es N4, completar o enviar es N2 y pagar es N1; la solicitud ya indica dónde detenerse.
Límite en la solicitud, N4, N2, N1.
El bloque "Navegador:" de la R5 pegado en AGENTS.md, que Codex lee y al que apunta CLAUDE.md.
La regla se aplica a todas las solicitudes, incluso a lo que olvidaste limitar.
AGENTS.md, @AGENTS.md, regla permanente.
Inicias sesión; el agente no pide ni guarda la contraseña, y las credenciales no pasan de una herramienta a otra.
En un navegador con sesión iniciada, el agente accede a todo lo que tú puedes acceder.
Credencial, navegador con sesión iniciada, POLITICA.md.