Configuración de Coding Agents

Extensión Codex VS Code: API propia y sesión oficial

Configura config.toml para la extensión Codex VS Code con BetterToken Responses y conserva la sesión oficial, los plugins y Remote Control.

La extensión Codex para VS Code comparte ~/.codex/config.toml con Codex CLI/App. Usa esta página si necesitas conservar el inicio de sesión oficial, los plugins o Remote Control.

Ajustes principales

Campo	Valor
API Key	`experimental_bearer_token = "YOUR_API_KEY"`
Base URL	`https://bettertoken.ai/v1`
Model	`gpt-6-astra`

Requisitos previos

Instala la versión más reciente de la extensión Codex para VS Code
Completa el inicio de sesión oficial en la extensión o Codex App
Crea una BetterToken API Key
Copia un ID de modelo desde la model plaza o desde el cuadro Setup de la Key

Regístrate y obtén una BetterToken API Key

¿Ya tienes una cuenta? Inicia sesión, recarga el saldo y crea una clave en la consola.

Instalación

Instala la extensión desde VS Code Marketplace y reinicia VS Code.

Configuración manual

Si has definido un CODEX_HOME personalizado, edita config.toml en ese directorio. En caso contrario, usa ~/.codex/config.toml en macOS / Linux o %USERPROFILE%\.codex\config.toml en Windows.

Cierra Codex por completo y guarda copias de los archivos config.toml y auth.json existentes. Actualiza la configuración del proveedor existente sin añadir una tabla de proveedor duplicada.

Configura la extensión

Edita ~/.codex/config.toml:

model_provider = "bettertoken"
model = "gpt-6-astra"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "YOUR_API_KEY"
supports_websockets = false

Parámetros de configuración

Parámetro	Función y ubicación	Valores predeterminados y ejemplos
`model_provider`	Raíz del archivo de usuario; selecciona el ID definido abajo.	Predeterminado: `openai`; aquí `bettertoken`.
`model`	Raíz; Model ID completo de la plaza de modelos.	Ejemplo: `gpt-6-astra`; cámbialo según necesites.
`name`	Tabla del provider; solo el nombre visible.	`BetterToken` no es un Model ID.
`base_url`	Tabla del provider; Base URL de la API del modelo.	Usa `https://bettertoken.ai/v1`; Codex añade `/responses`.
`wire_api`	Tabla del provider; protocolo de solicitud.	Actualmente solo admite `responses`, también predeterminado.
`requires_openai_auth`	Tabla del provider; autenticación OpenAI y su almacén.	Predeterminado: `false`; aquí `true`. No es un interruptor para conservar archivos de sesión.
`experimental_bearer_token`	Tabla del provider; Bearer Key de solicitudes de terceros.	Introduce BetterToken API Key. No reescribe la sesión oficial. Se guarda en texto plano; OpenAI desaconseja este campo.
`supports_websockets`	Tabla del provider; compatibilidad con Responses WebSocket.	Predeterminado: `false`; aquí se mantiene HTTP/SSE.

Conserva las credenciales del inicio de sesión oficial; no las sustituyas por JSON con API Key. requires_openai_auth = true usa la autenticación oficial; experimental_bearer_token del provider actual proporciona la clave de terceros para el modelo. Con el primero activo, Codex ignora env_key, así que no lo uses como sustituto directo del Bearer Key. No compartas archivos con claves.

Para configurar las credenciales de otra forma, consulta la guía de OpenAI sobre autenticación con variables de entorno y comandos. Son modos de autenticación independientes: no añadas una tabla auth del proveedor junto con env_key, experimental_bearer_token o requires_openai_auth, ni sustituyas la clave por env_key en este ejemplo que conserva la sesión oficial.

Capas de configuración y claves antiguas

No coloques modelos o razonamiento en [projects."<path>"]. Un modelo específico del proyecto puede usar claves raíz en .codex/config.toml de un proyecto de confianza; provider y autenticación permanecen en la configuración de usuario. Los perfiles actuales usan NAME.config.toml dentro de CODEX_HOME, elegido con codex --profile NAME, no tablas antiguas [profiles.NAME] ni el selector raíz profile.

Guarda el archivo, ejecuta Developer: Reload Window en VS Code y vuelve a abrir el panel de Codex.

Verifica la conexión

Crea una sesión nueva en la extensión y envía una tarea breve. Si gpt-6-astra responde y los plugins y Remote Control siguen disponibles, la configuración funciona.

Cambia de modelo

Cambia model y, si lo necesitas, review_model; después, ejecuta Developer: Reload Window. Usa un ID de modelo del cuadro Setup o de la model plaza.

Errores habituales

Error	Solución
La extensión vuelve a pedir el inicio de sesión	Restaura el inicio de sesión oficial y mantén `requires_openai_auth = true`.
`401` o `403`	Vuelve a copiar `experimental_bearer_token`; no sobrescribas `auth.json`.
Tabla duplicada	Elimina la otra tabla `[model_providers.bettertoken]` y conserva un solo modo de autenticación.
Modelo no encontrado	Sustituye `gpt-6-astra` por un ID de modelo completo y vigente.
La configuración no se aplica	Guarda el archivo y ejecuta Developer: Reload Window.

Configuración avanzada

Guías relacionadas

Referencias oficiales

Detalles técnicos

Protocolo Responses

La extensión envía las solicitudes del modelo a https://bettertoken.ai/v1 mediante OpenAI Responses.