PTENES
Saltar al contenido
RUTA 2

🔌 Conectar

Con el mapa a mano, es hora de conectar. Haz que Claude llame a Codex mediante un puente de línea de comandos, convierte hojas de cálculo en herramientas con MCP, conecta el puente a tu sistema y usa el navegador con reglas escritas.

4
Módulos
24
Temas
~2h20
Duración
Práctico
Nivel
0 de 240%
agente Claude Code 🤝 Codex · CLI 🔌 agenda · MCP 🏗️ ERP · CSV 🌐 sitio · navegador

Mapa de la ruta de aprendizaje

Contenido detallado

2.1~35 min

🤝 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.

0 de 60%
Qué es:

Un script del kit, runtime/pontes/codex-exec.sh, que envuelve codex exec: envía una solicitud a Codex y devuelve la respuesta.

Por qué aprender:

Es la vía oficial (CLI, nivel 3) para lo que los videos de mods hacían por dentro de la app.

Conceptos clave:

Puente, CLI, codex exec, segunda opinión.

Qué es:

Dale permiso de ejecución al script y pídele a Codex que responda solo PONG.

Por qué aprender:

Probar la conexión fuera del agente permite distinguir un problema de conexión de uno con la solicitud.

Conceptos clave:

chmod +x, prueba, PONG.

Qué es:

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.

Por qué aprender:

Dos modelos diferentes se equivocan en lugares distintos; la comparación muestra qué se le escaparía a uno solo.

Conceptos clave:

Revisión cruzada, leer (N4), combinar respuestas.

Qué es:

Pasar la carpeta y el modo workspace-write a Codex para que cree notas.txt con la palabra OK.

Por qué aprender:

Cambiar archivos es N3: solo cuando lo pides, y la prueba es que cat notas.txt muestre OK.

Conceptos clave:

Sandbox, read-only, workspace-write, N3.

Qué es:

El puente solo acepta read-only y workspace-write; solicitar danger-full-access da como resultado "sandbox rechazado por POLITICA".

Por qué aprender:

Ver cómo ocurre el rechazo da confianza en que la regla está en el código, no solo en el papel.

Conceptos clave:

POLITICA.md, rechazo, salida 2, límite por acción.

Qué es:

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.

Por qué aprender:

El puente detenido, el rechazo del sandbox y la red bloqueada tienen una causa conocida y una solución de una línea.

Conceptos clave:

Variable de entorno, timeout, stdin, LIMITES.md.

Ver completo
2.2~35 min

🔌 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.

0 de 60%
Qué es:

Una forma estándar en que un programa ofrece herramientas con nombre y reglas a cualquier agente compatible.

Por qué aprender:

El mismo puente sirve para Claude Code y Codex: puente local (nivel 6) expuesto mediante MCP (nivel 2).

Conceptos clave:

MCP, servidor, herramienta (tool), stdio.

Qué es:

listar_horarios_livres lee agenda.csv; resumo_vendas lee erp-vendas.csv y suma por cliente o producto.

Por qué aprender:

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.

Conceptos clave:

agenda.csv, erp-vendas.csv, solo lectura (N4).

Qué es:

Ejecutar server.mjs con --selftest y ver tools: 2, los horarios libres del 06/10 y TOTAL: R$ 856.00.

Por qué aprender:

Prueba el puente sin ningún agente y sin gastar cuota.

Conceptos clave:

Selftest, prueba, cálculo verificado a mano.

Qué es:

El .mcp.json de la raíz ya registra el puente y .claude/settings.json ya lo habilita; claude mcp list lo confirma.

Por qué aprender:

Saber dónde se registra el puente permite reemplazarlo más adelante por tu sistema.

Conceptos clave:

.mcp.json, enabledMcpjsonServers, Pending approval.

Qué es:

Pedirle al claude los horarios disponibles de 2026-10-07 y recibir 08:00 (Dra. Ana) y 16:00 (Dr. Bruno).

Por qué aprender:

Es Clara consultando la agenda sin abrir la hoja de cálculo, y la respuesta coincide con las filas disponibles del CSV.

Conceptos clave:

claude -p, llamada a herramienta, prueba con la fuente.

Qué es:

Un comando registra el puente del modelo en Codex, con la ruta completa de server.mjs.

Por qué aprender:

Un puente, dos agentes: escribes la herramienta una vez y la usas en ambos.

Conceptos clave:

codex mcp add, ruta absoluta, $PWD.

Ver completo
2.3~35 min

🏗️ 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.

0 de 60%
Qué es:

Encontrar en el menú del sistema el archivo que exporta, con encabezado y en una carpeta fija.

Por qué aprender:

Sin API, la exportación es la materia prima del puente; su formato determina cuánto ajuste hará falta.

Conceptos clave:

Exportación, encabezado, separador, carpeta fija.

Qué es:

La variable PONTE_DADOS en el campo env de .mcp.json, que hace que el puente lea tu carpeta en lugar de los ejemplos.

Por qué aprender:

Cambia la fuente de los datos sin tocar el código del puente.

Conceptos clave:

Variable de entorno, .mcp.json, campo env.

Qué es:

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.

Por qué aprender:

Adaptas el puente sin programar, y la regla de la cuenta sigue siendo la misma.

Conceptos clave:

run(), nombre de columna, límite escrito en la solicitud.

Qué es:

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.

Por qué aprender:

Un error de lectura da una respuesta equivocada; un error de escritura daña los datos que otras personas usan.

Conceptos clave:

N4, N2, readFileSync, herramienta separada.

Qué es:

Volver a calcular con una calculadora el total que calcula el puente, línea por línea y por cliente.

Por qué aprender:

Una columna intercambiada por error no da error: da un número incorrecto que parece correcto.

Conceptos clave:

Cuenta de verificación, prueba, comando → salida esperada.

Qué es:

Una línea en el mapa con vía, nivel 6, la herramienta, la política leer (N4) y la fecha de la prueba.

Por qué aprender:

Un sistema sin línea no lo usa el agente; la línea con fecha es lo que habilita su uso.

Conceptos clave:

CAPACIDADES.md, probado en, línea pendiente.

Ver completo
2.4~35 min

🌐 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.

0 de 60%
Qué es:

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.

Por qué aprender:

Si existe una API, un MCP, una CLI o una exportación, esa opción prevalece sobre el navegador.

Conceptos clave:

Uso de la computadora, estabilidad, selector.

Qué es:

Dos comandos: instalar agent-browser con npm y descargar Chromium, que es lo que usa.

Por qué aprender:

Un navegador separado, sin tus inicios de sesión, es la forma más segura de empezar.

Conceptos clave:

npm, Chromium, Claude in Chrome.

Qué es:

Abrir example.com, leer el título y cerrar; la prueba es la salida Example Domain.

Por qué aprender:

Compruebas el navegador sin hacer clic en nada ni enviar nada.

Conceptos clave:

open, get title, close, prueba de la R5.

Qué es:

El pedido de la R5: leer la tabla de precios de un sitio y devolverla en CSV, sin hacer clic en enviar ni comprar.

Por qué aprender:

Leer es N4, completar o enviar es N2 y pagar es N1; la solicitud ya indica dónde detenerse.

Conceptos clave:

Límite en la solicitud, N4, N2, N1.

Qué es:

El bloque "Navegador:" de la R5 pegado en AGENTS.md, que Codex lee y al que apunta CLAUDE.md.

Por qué aprender:

La regla se aplica a todas las solicitudes, incluso a lo que olvidaste limitar.

Conceptos clave:

AGENTS.md, @AGENTS.md, regla permanente.

Qué es:

Inicias sesión; el agente no pide ni guarda la contraseña, y las credenciales no pasan de una herramienta a otra.

Por qué aprender:

En un navegador con sesión iniciada, el agente accede a todo lo que tú puedes acceder.

Conceptos clave:

Credencial, navegador con sesión iniciada, POLITICA.md.

Ver completo
← Ruta anterior: Descubrir Próxima ruta: Enrutar y ejecutar →