Guía de integración de agents
Usa Codex con la API LLM de WaveSpeed
Esta guía muestra cómo conectar Codex a WaveSpeed AI con ~/.codex/config.toml, OpenAI Responses API, /v1/responses, base URL https://llm.wavespeed.ai/v1 y el modelo predeterminado anthropic/claude-opus-4.8. Copia la configuración anterior, exporta tu API key, ejecuta el agent y verifica los requests en Logs.
Crea una clave de acceso de WaveSpeed
Exporta la clave requerida localmente
Pega la configuración en
~/.codex/config.tomlEjecuta codex --profile wavespeed y revisa Logs
Qué configura este setup de Codex
Protocolo
OpenAI Responses API
Endpoint
/v1/responses
Modelo
anthropic/claude-opus-4.8
La configuración lista para copiar de arriba es el único archivo de Codex que necesitas editar para el setup recomendado: ~/.codex/config.toml. Mantén la API key en tu entorno shell para no enviarla a un repositorio.
Solución de problemas
La API key no se detecta
Exporta WAVESPEED_API_KEY en la misma shell donde ejecutas Codex. Si usas un perfil de shell, recarga la terminal antes de iniciar el agent.
Los requests fallan con un error de protocolo o endpoint
Comprueba que Codex usa OpenAI Responses API y endpoint /v1/responses. Los desajustes de protocolo son la causa más común de errores 404 o de payload.
El modelo seleccionado no funciona
Confirma que el ID del modelo existe en WaveSpeed Models y pega el ID exacto en ~/.codex/config.toml. Puedes empezar con el modelo predeterminado que aparece en esta página.
No aparecen requests en Logs
Asegúrate de que Codex usa la base URL de WaveSpeed y tu API key actual. Luego envía un prompt nuevo desde el agent local y actualiza Logs.
¿Puede esta guía de Codex aparecer en buscadores?
Sí. Esta página está creada como guía indexable para usuarios que buscan custom provider de Codex, endpoint compatible con OpenAI, base URL y flujos de configuración local de agents.