Abrir sesión interactiva
Úsalo para tareas con exploración, edición y verificación incremental dentro del repo.
codexcodex "revisa el repo y propón un plan de verificación"Regla mental
Mapa dual del sistema
Esta tabla es el puente más importante. Si una tarea falla en una plataforma, revisa primero si estás usando el archivo de contexto, los permisos o la capa de skills correctos.
tabla filtrable
| Capacidad | Codex | Claude Code | Uso recomendado en Intelcomercial |
|---|---|---|---|
| Contexto raíz | AGENTS.md |
CLAUDE.md |
Mantener sincronización conceptual, no copia mecánica. Codex debe leer la política dual y Claude debe conservar sus hooks nativos. |
| Skills portables | .agents/skills/*/SKILL.md |
.claude/skills/ o .agents/skills/ |
Escribir skills procedurales, con rutas reales y sin depender de nombres de herramientas exclusivos de una plataforma. |
| Agentes especializados | Roles, playbooks o subagentes si el runtime los ofrece | .claude/agents/*.md como subagentes nativos |
En Codex, tratar los agentes Claude como referencia operativa salvo que se creen subagentes explícitos en la sesión. |
| Configuración | .codex/config.toml y configuración de la app |
.claude/settings.json y .claude/settings.local.json |
No inventar .Codex/. Mantener cada runtime en su capa propia. |
| Hooks y permisos | Permisos, sandbox y checks explícitos | Hooks PreToolUse, PostToolUse, Stop |
Si una garantía depende de hooks Claude, Codex debe ejecutarla como paso explícito o script verificable. |
| MCP y conectores | Conectores de Codex Desktop, MCP configurado y herramientas disponibles | claude mcp, --mcp-config y configuración Claude |
No asumir que un MCP existe en ambas plataformas. Confirmar herramientas disponibles al inicio de tareas sensibles. |
| Toolkits de ecosistema | tools/workspace-agents-toolkit/ como producto |
tools/claude-code-toolkit/ como producto |
clave tools/ no es orquestación interna del repo; es material para crear herramientas de cliente. |
| Validación local | python3 scripts/dual_runtime_skill_smoke.py |
Mismo script más hooks Claude cuando proceda | Ejecutar después de editar skills, rutas de configuración o documentación de operación dual. |
Comandos principales
Codex
Los comandos siguientes cubren el trabajo interactivo, no interactivo, sesiones, permisos, app de escritorio, MCP y diagnóstico. Para trabajo diario en este repo, preferir permisos de escritura en workspace antes que acceso total.
Sandbox y modelo
Para trabajo local desatendido, usar workspace-write. Evitar bypass total salvo en una máquina aislada.
codex --sandbox workspace-write --ask-for-approval on-requestcodex --model gpt-5.4Modo no interactivo
Útil para auditorías repetibles, CI ligero o extracción de una respuesta final. Alias oficial: codex e.
codex exec "resume la arquitectura de este repo"codex e "ejecuta la auditoría smoke dual y resume los fallos"Sesiones y app
Resume o bifurca conversaciones. Desde terminal, codex app abre Codex Desktop con una ruta de workspace en macOS.
codex resumecodex fork --lastcodex app "/ruta/al/repo"MCP, features y sandbox helper
Sirven para inspeccionar capacidades, configurar servidores y probar comandos bajo políticas de sandbox.
codex mcp listcodex featurescodex sandbox --permissions-profile <perfil> -- npm testLo que no conviene usar por defecto
El modo --yolo equivale a ejecutar sin aprobaciones ni sandbox. Solo tiene sentido dentro de un entorno externo endurecido.
codex --dangerously-bypass-approvals-and-sandboxCorrespondencia
Claude Code
Claude Code aporta hooks, subagentes nativos, gestión rica de permisos y comandos slash muy amplios. La clave para Intelcomercial es no trasladar esas garantías a Codex por suposición: hay que replicarlas como checks explícitos cuando corresponda.
| Objetivo | Codex | Claude Code | Notas de uso dual |
|---|---|---|---|
| Sesión interactiva | codex |
claude |
Ambos aceptan prompt inicial. En este repo, Codex debe leer AGENTS.md y Claude CLAUDE.md. |
| Consulta no interactiva | codex exec "..." |
claude -p "..." |
En Claude, -p imprime y sale. En Codex, exec permite salida estándar o JSONL. |
| Retomar conversación | codex resume |
claude -c o claude -r "<session>" |
Usar nombres de sesión cuando la tarea vaya a durar varios días. |
| Bifurcar trabajo | codex fork --last |
/branch o /fork |
Útil para probar enfoques sin ensuciar la conversación principal. |
| Modelo y esfuerzo | codex --model ... o /model |
claude --model ..., /model, /effort |
Elegir modelo por riesgo y coste; investigación legal compleja requiere más profundidad que cambios de documentación. |
| Permisos | --sandbox, /permissions |
--permission-mode, /permissions, hooks |
Confirmación requerida para API >1,00 $, git push, eliminar archivos y decisiones estratégicas. |
| Subagentes | Subagentes Codex si están disponibles en el runtime | claude agents, --agent, /agents |
No convertir automáticamente .claude/agents en configuración Codex. Usarlos como playbooks salvo adaptación explícita. |
| MCP | codex mcp |
claude mcp, --mcp-config |
Los conectores disponibles cambian según cliente. Verificar antes de tareas con Gmail, Drive, Notion o navegador. |
| Revisión | /review o pedir revisión explícita |
/review, /security-review, claude ultrareview |
En Codex, una “review” debe responder con hallazgos primero, severidad y referencias de archivo/línea. |
Dentro de la sesión
Comandos slash útiles
Estos comandos cambian estado, contexto o diagnóstico sin salir de la sesión. La lista exacta puede variar por versión, plan, plataforma y configuración.
Codex CLI
| Comando | Uso | Cuándo usarlo |
|---|---|---|
/status | Modelo, permisos, raíces escribibles y contexto. | Antes de una tarea larga o cuando algo no cuadra. |
/model | Cambia modelo y esfuerzo cuando esté disponible. | Subir profundidad para auditoría o bajarla para tareas mecánicas. |
/permissions | Ajusta política de aprobación. | Pasar de lectura a edición o volver a modo conservador. |
/plan | Entra en modo planificación. | Antes de cambios grandes o con riesgo operativo. |
/diff | Muestra cambios git. | Antes de cerrar una tarea con archivos modificados. |
/compact | Resume conversación para liberar contexto. | Después de auditorías largas. |
/ps y /stop | Inspecciona o detiene terminales en segundo plano. | Cuando hay tests, servidores o comandos largos. |
/copy | Copia la última respuesta completada. | Para llevar una síntesis a documento, correo o issue. |
Claude Code
/init: crear o actualizar guíaCLAUDE.md./agents: gestionar agentes configurados./hooks: revisar hooks activos./skills: listar skills disponibles./memory: editar memoria y contexto./permissions: gestionar reglas allow, ask y deny./usage: revisar coste o límites./rewind: volver a un punto anterior.
Intelcomercial
Comandos internos del repo
Estos comandos son más importantes que memorizar diferencias de interfaz. Demuestran que la capa portable sigue sana y que las rutas no han vuelto a contaminarse con supuestos de una sola plataforma.
Auditoría de skills y operación dual
Ejecutar después de tocar AGENTS.md, CLAUDE.md, .agents/skills/, reglas o rutas de toolkits.
python3 scripts/dual_runtime_skill_smoke.pyCompilación rápida
Detecta errores sintácticos en scripts y módulos antes de entregar cambios.
python3 -m compileall -q src scripts testsTests del repo
Si falla por bs4, instalar dependencias del entorno. En la última auditoría aparecía como warning de entorno, no como fallo de portabilidad.
python3 -m pytest tests -qpython3 -m pip install -r requirements.txtBuscar rutas prohibidas
Debe devolver solo menciones explicativas tipo “no usar” dentro de documentación de operación dual.
rg -n "\.Codex|tools/Codex-toolkit|comparison-Codex-gpt" AGENTS.md .agents/skills docsFrontera de tools/
tools/ contiene toolkits, referencias, plantillas y scripts para ecosistemas de cliente: Claude Code, ChatGPT, Workspace Agents, Codex como motor de agentes y Kimi. No debe convertirse en carpeta de configuración u orquestación interna.
Frontera de .agents/
.agents/skills/ es la capa portable. Toda skill que mencione un hook Claude, un agente Claude o una herramienta exclusiva debe incluir fallback o verificación explícita para Codex.
Uso recomendado
Prompts base para trabajar mejor
Prompts pensados para activar el comportamiento correcto sin depender de memoria implícita. Funcionan en ambas plataformas, cambiando solo el archivo raíz que cada una debe respetar.
Inicio de sesión en este repo
Lee AGENTS.md y docs/codex-operations.md. Opera este repo como sistema dual Codex + Claude Code. Mantén tools/ como toolkits de producto/cliente, no como configuración interna. Antes de editar, identifica la capa afectada y verifica con los comandos razonables.
Inicio equivalente
Lee CLAUDE.md y docs/codex-operations.md. Usa hooks y agentes nativos cuando proceda, pero conserva la portabilidad de .agents/skills/. No trates tools/ como orquestación interna.
Antes de modificar una skill
Audita esta skill para uso dual. Detecta referencias a herramientas exclusivas, rutas inexistentes, hooks asumidos, agentes Claude usados como dependencia dura y toolkits tratados como configuración interna. Aplica cambios quirúrgicos y ejecuta python3 scripts/dual_runtime_skill_smoke.py.
Investigación con garantías
Aplica el protocolo de investigación Intelcomercial: entrevista máxima de 5 preguntas, plan de herramientas, aprobación y ejecución. Para PDFs, usar pipeline Firecrawl, Cohere Rerank y Gemini Flash Lite salvo justificación de escalado. Todo dato debe llevar fuente, año y URL.
Antes de entregar una tarea técnica
- Revisar
git status --shorty separar cambios propios de cambios previos del usuario. - Ejecutar tests razonables según alcance: smoke dual, compileall, pytest o validación específica.
- Confirmar que no se han creado rutas falsas como
.Codex/ni se ha usadotools/como configuración interna. - Explicar qué se cambió, qué se verificó y qué riesgo residual queda.
Selección rápida
Qué plataforma usar según tarea
La operación dual no significa usar ambas siempre. Significa poder elegir la mejor herramienta sin romper el sistema común.
| Tarea | Mejor punto de entrada | Motivo | Verificación mínima |
|---|---|---|---|
| Edición quirúrgica de repo, auditoría, scripts, tests | Codex | Buen encaje con lectura de repo, edición controlada, terminal y verificación continua. | git diff, tests específicos y smoke si toca operación dual. |
| Uso intensivo de subagentes Claude, hooks o flows ya configurados | Claude Code | La configuración nativa vive en .claude/ y tiene semántica propia. |
/hooks, /agents, /permissions. |
| Skills procedurales portables | Ambas | La fuente común debe ser .agents/skills/*/SKILL.md. |
python3 scripts/dual_runtime_skill_smoke.py. |
| Material para clientes sobre Claude, ChatGPT, Workspace Agents o Kimi | Según ecosistema objetivo | El material vive en tools/*-toolkit/, pero no gobierna la operación interna. |
Revisar que el output distingue producto/cliente de runtime interno. |
| Revisión de seguridad o PR compleja | Claude Code o Codex con revisión explícita | Claude tiene comandos especializados; Codex puede revisar con postura de code review si se pide. | Hallazgos con severidad, archivo, línea y test faltante. |
Trazabilidad
Fuentes y archivos base
La guía combina documentación oficial actual consultada el 2 de mayo de 2026 y la decisión arquitectónica local del repo.
OpenAI
Codex CLI: command line options. Base para comandos codex, codex exec, codex resume, codex mcp, sandbox y seguridad.
OpenAI
Codex CLI: slash commands. Base para /model, /permissions, /status, /diff, /compact y comandos de sesión.
Anthropic
Claude Code CLI reference. Base para claude, claude -p, --permission-mode, --mcp-config, worktrees y flags.
Anthropic
Claude Code commands. Base para comandos slash como /agents, /hooks, /memory, /permissions, /skills y /usage.
Intelcomercial
docs/codex-operations.md. Decisión local: operación dual, frontera de tools/, capa portable .agents/skills/ y política de AGENTS.md.
Intelcomercial
scripts/dual_runtime_skill_smoke.py. Test local para asegurar que las skills siguen siendo universales y que el repo no regresa a rutas o supuestos obsoletos.