GUÍA DE PROVEEDOR
OpenAI Codex CLI
Ejecuta OpenAI Codex CLI como un agente completamente aislado en tu máquina. Cada agente obtiene su propio CODEX_HOME aislado, evitando la contaminación de estado entre agentes.
Clave API de OpenAI Aislamiento por agente CODEX_BIN_PATH si no está en el PATH
Requisitos
- ✓ Codex CLI instalado:
npm i -g @openai/codex - ✓ Una clave API de OpenAI con acceso al modelo Codex
- ✓ CTRL NODE Bridge instalado en tu máquina (GitHub)
Inicio rápido
Codex en el PATH
$ PAIRING_TOKEN=your-pairing-token \
CODEX_API_KEY=sk-… \
./ctrlnode
CODEX_API_KEY=sk-… \
./ctrlnode
Codex NO está en el PATH — define CODEX_BIN_PATH
$ PAIRING_TOKEN=your-pairing-token \
CODEX_API_KEY=sk-… \
CODEX_BIN_PATH=/home/user/.npm-global/bin/codex \
./ctrlnode
CODEX_API_KEY=sk-… \
CODEX_BIN_PATH=/home/user/.npm-global/bin/codex \
./ctrlnode
Sin
CODEX_BIN_PATH, el Bridge intenta encontrar codex en tu PATH. Si falla verás: "Unable to locate Codex CLI binaries".
Archivo .env
PAIRING_TOKEN=your-pairing-token
CODEX_API_KEY=sk-…
# Opcional
CODEX_BIN_PATH=/path/to/codex
CODEX_DEFAULT_MODEL=codex-mini-latest
Variables de entorno
| Variable | Obligatoria | Descripción |
|---|---|---|
| CODEX_API_KEY | Sí | Clave API de OpenAI usada por el Codex CLI. |
| CODEX_BIN_PATH | No | Ruta completa al binario codex. Obligatoria si no está en el PATH. |
| CODEX_DEFAULT_MODEL | No | Modelo a usar. Por defecto codex-mini-latest. |
Aislamiento por agente
Cada agente obtiene su propio directorio CODEX_HOME dentro del workspace del Bridge. Esto evita que los agentes compartan historial de conversación, modelos o estado en caché entre tareas.
Cuando varios agentes Codex se ejecutan en paralelo, cada uno mantiene un entorno completamente aislado — sin contaminación entre agentes, incluso cuando trabajan en el mismo repositorio.