Guías
agents.md (sitio oficial)
Enlace al sitio oficial del estándar AGENTS.md: especificación, ejemplos y plataformas compatibles.
Referencia
estándaragents-md
Leer guía rev. jul 2026
Guía por plataforma
OpenAI Codex
Agente de codificación de OpenAI.
Qué es Codex
Agente de codificación de OpenAI en terminal/CLI. Lee el repo, propone cambios y ejecuta comandos con tu aprobación. Comparte el ecosistema de skills en ~/.agents/ con otros productos OpenAI.
Docs: developers.openai.com/codex
Orden sugerido
1. Contexto del repo
Codex lee AGENTS.md en la raíz (y variantes en agents.md). Pon ahí build, tests y convenciones — no repitas lo mismo en cada sesión.
Las convenciones de código van ahí o en instrucciones del repo; Codex no usa .cursor/rules/. Concepto: ¿Qué es una regla? (equivalente práctico = AGENTS.md + instrucciones).
2. Skills
Ruta habitual:
- Global:
~/.agents/skills/ - Proyecto: según docs actuales de OpenAI en el repo
Formato SKILL.md del estándar Agent Skills. Guía: ¿Qué es un skill?. El agente carga el skill solo cuando la tarea encaja.
3. MCP
Configuración en ~/.codex/ (o CODEX_HOME) y archivos MCP documentados en OpenAI. Conecta browser, docs, etc. Guía: ¿Qué es un MCP?. Ejemplo útil: Context7 si el modelo inventa APIs.
4. Modelos y APIs
Codex usa el stack de OpenAI (ChatGPT / API según tu plan). Para prototipos con otros proveedores en nube: Free LLM API Resources — referencia aparte; no sustituye la auth de Codex.
Modelos locales (Ollama): no es el flujo típico de Codex. Si buscas self-host, mira OpenCode o Cline + guía nube vs local.
5. Herramientas opcionales (avanzado)
- Headroom — comprimir contexto con
headroom wrap codex(proxy local; ver README). - no-mistakes — gate antes del push si el equipo genera muchos PRs con IA.
Dónde va cada cosa
| Pieza | Ubicación habitual |
|---|---|
| Contexto repo | AGENTS.md en la raíz |
| Skills globales | ~/.agents/skills/<nombre>/SKILL.md |
| Config Codex | ~/.codex/ o variable CODEX_HOME |
| MCP | Según doc oficial (settings / json en home) |
Codex vs Claude Code vs OpenCode
| Codex | Claude Code | OpenCode | |
|---|---|---|---|
| Fabricante | OpenAI | Anthropic | Open source |
| Dónde corre | Terminal / CLI | Terminal, IDE, desktop | Terminal, IDE, desktop |
| Skills | ~/.agents/skills/ | ~/.claude/skills/ | Según doc OpenCode |
| Contexto repo | AGENTS.md | AGENTS.md / CLAUDE.md | AGENTS.md |
| Modelos locales | No (flujo típico) | No (flujo típico) | Sí (Ollama, etc.) |
Errores comunes
- No revisar diffs antes de aprobar comandos de terminal.
- Mezclar configs de Codex con Claude Code u OpenCode en el mismo repo sin documentar cuál usa el equipo.
- Instalar MCPs o skills virales antes de tener
AGENTS.mdmínimo.
Recursos compatibles
Fichas del catálogo que mencionan OpenAI Codex. Informativas, no recomendaciones automáticas.
Herramientas
cmux
Terminal para macOS con tabs verticales, pensada para correr varios agentes a la vez.
macosterminalopen-source
Ver ficha rev. jul 2026
Herramientas
Headroom
Capa local que comprime contexto (tools, logs, RAG) antes del LLM. Requiere wrap/proxy; no sustituye usar Cursor o Copilot tal cual.
Avanzado
open-sourcetokenslocal-first
Ver ficha rev. jul 2026
APIs gratis
Free LLM API Resources
Lista comunitaria de APIs LLM con tier gratis o créditos iniciales. Referencia viva, verifica términos.
Gratis Referencia
open-source
Ver ficha rev. jul 2026
Herramientas
no-mistakes
Proxy git: valida con IA antes de hacer push y abrir el PR. Para equipos que quieren un gate automático.
open-sourcegitcalidad-de-código
Ver ficha rev. jul 2026
Skills
caveman
Skill viral que hace al agente responder 'como cavernícola': ~65% menos tokens de salida medidos. MIT, el skill más estrellado de GitHub.
open-sourcetokens
Ver ficha rev. jul 2026
Skills
ponytail
Skill que empuja al agente a escribir menos código. Muy popular; opiniones divididas.
Polémico
open-sourcecalidad-de-código
Ver ficha rev. jul 2026
Skills
Agent Skills (estándar)
Formato abierto Agent Skills: carpeta con SKILL.md. Referencia oficial, no algo que 'instales' como app.
Referencia
estándar
Ver ficha rev. jul 2026
Guías
¿Qué es AGENTS.md?
Un archivo en la raíz del repo que le dice al agente cómo construir y qué convenciones seguir.
Principiante Intro
estándaragents-md
Leer guía rev. jul 2026
Guías
¿Qué es un agente de código?
Un agente de código lee tu repo, propone cambios y ejecuta acciones con tu permiso. Dónde vive, qué no es y cómo se relaciona con skills, reglas y MCPs.
Principiante Intro
en-español
Leer guía rev. jul 2026
Guías
¿Qué es un skill?
Un skill es una carpeta con SKILL.md: el agente la usa solo cuando la tarea encaja. Qué son, dónde van y un ejemplo.
Principiante
estándar
Leer guía rev. jul 2026
Guías
Skills vs reglas vs MCP
Tres formas de configurar un agente: cuándo usar cada una con ejemplos concretos.
Principiante Intro
estándar
Leer guía rev. jul 2026