Skip to content

fix(docs): la página de Codex mandaba poner lo único que ya no arranca - #93

Open
borjaperfra wants to merge 2 commits into
mainfrom
fix/docs-codex-wire-api-y-perfiles
Open

borjaperfra wants to merge 2 commits into
mainfrom
fix/docs-codex-wire-api-y-perfiles

Conversation

@borjaperfra

Copy link
Copy Markdown
Contributor

/docs/codex, en los dos idiomas, publica wire_api = "chat" y además recomienda activamente no usar "responses":

wire_api = "chat" hace que Codex use /chat/completions. Es lo que quieres […] con "responses" verías la respuesta aparecer de golpe al final.

Las dos razones de ese párrafo se han caído. /responses ya emite la respuesta por partes, y Codex 0.154 retiró "chat":

Error loading config.toml: `wire_api = "chat"` is no longer supported.
How to fix: set `wire_api = "responses"` in your provider config.

Quien siga la página hoy acaba con un fichero que no carga y un Codex que no abre — ni la CLI ni la app de escritorio.

Qué cambia

  • El bloque de ejemplo pasa a "responses" y gana model_context_window, que es lo que escribe la CLI y lo que evita que Codex compacte contra una ventana inventada.
  • La viñeta del wire_api explica por qué el consejo anterior ya no vale, en vez de desaparecer sin más.
  • Cambiar de modelo decía "dejar varios proveedores declarados y elegir con --profile", que no es lo que hace un perfil. Ahora cuenta lo que son en la 0.155 — un fichero que se superpone al config — con el aviso del punto: Codex pide "a plain name" y rechaza qwen3.6 como nombre de perfil aunque lo acepte como modelo.
  • Los problemas conocidos recogen los tres síntomas reales: el "chat" heredado, la model_context_window duplicada de las versiones anteriores a la 0.1.20 de la CLI, y el 401 does not have access to the requested model que sale cuando el proveedor apunta al clúster pero el model sigue siendo de OpenAI.

Va con helmcode/nan-cli#27, que es donde se arregla el fichero duplicado y se escriben los perfiles.

🤖 Generated with Claude Code

borjaperfra and others added 2 commits September 19, 2026 16:14
Decía wire_api = "chat" y además recomendaba activamente no usar
"responses", porque cuando se escribió /responses contestaba de una
sola vez. Las dos razones se han caído: el endpoint ya emite la
respuesta por partes, y Codex 0.154 retiró "chat" del todo. Hoy quien
siga esta página a mano acaba con un fichero que no carga y un Codex
que no abre.

Entra también model_context_window en el ejemplo, que es lo que escribe
la CLI y lo que evita que Codex compacte contra una ventana inventada.

La sección de cambiar de modelo hablaba de "dejar varios proveedores
declarados y elegir con --profile", que no es lo que hace un perfil.
Ahora cuenta lo que son en la 0.155 - un fichero que se superpone al
config - y avisa del punto: Codex pide "a plain name" y rechaza
qwen3.6 como nombre de perfil aunque lo acepte como modelo.

Y los problemas conocidos recogen los tres síntomas con los que
aparecen de verdad: el "chat" en un fichero viejo, la
model_context_window duplicada que dejaban las versiones anteriores a
la 0.1.20 de la CLI, y el 401 "does not have access to the requested
model" que sale cuando el proveedor ya apunta al clúster pero el model
sigue siendo uno de OpenAI.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Codex 0.155 pregunta al proveedor por sus modelos al arrancar y falla
contra el clúster con "missing field `models`". No es nuestro: /v1/models
contesta en el formato de la API de OpenAI y Codex lo lee como si fuera
su catálogo interno. Le pasa lo mismo con LM Studio, OpenRouter y los
proveedores de Azure (openai/codex#22205), y features.remote_models=false
no lo calla, comprobado en la 0.155.

La sesión funciona igual, así que lo que hacía falta era decir que se
puede ignorar. Lo que sí explica es por qué los modelos del clúster no
aparecen en el selector de Codex, que es de donde salen los perfiles.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants