Codex

Codex CLI selecciona proveedores de modelos de la configuración local. Para usar Moxus AI, agregue un proveedor personalizado al Codex config.toml y permita que Codex lea la clave API desde una variable de entorno o auth.command.

Esta página se aplica a Codex CLI o entornos locales de Codex que admiten config.toml y model_providers personalizado. Las versiones de Codex pueden diferir. Si su versión informa campos no compatibles, siga el mensaje de error actual de Codex y la ayuda integrada.

Valores

Campo	Valor
URL básica	`https://moxus.ai/v1`
Clave API	`sk-your-key`
Variable de entorno clave API	`MOXUS_API_KEY`
Nombre del proveedor	`custom`
Modo de solicitud predeterminado	API de respuestas
Modelo	Copie el nombre exacto del modelo de Modelos y precios

Instalar la CLI del Codex

Primero instale, luego ejecute la verificación de versión por separado. No coloque los comandos de instalación, actualización y verificación en un bloque copiable.

macOS/Linux
WindowsPowerShell
mpn
Homebrew

Instalar:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Verificar:

codex --version

Instalar:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Si la misma ventana de PowerShell todavía dice que codex no se reconoce, primero actualice el PATH actual:

$env:Path = [Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [Environment]::GetEnvironmentVariable("Path", "User")

Verificar:

codex --version

Instalar:

npm install -g @openai/codex

Verificar:

codex --version

Instalar:

brew install --cask codex

Verificar:

codex --version

Recomendado: importar configuración desde una clave API

En la página de claves de la API de Moxus AI, cada fila de clave tiene una acción de configuración de importación. Elija Codex para generar un script de terminal para la clave seleccionada y la dirección del sitio actual.

Abra la página de claves API

Vaya a la página de claves API de la consola Moxus AI y busque la clave que desea que use Codex.

Abrir configuración de importación

Abra el menú de acciones para esa tecla, elija Importar configuración y luego cambie a Codex.

Copie el script para su sistema

Utilice “terminal macOS/Linux” para macOS o Linux. Utilice “Windows PowerShell” para Windows.

Ejecute el script directamente en su terminal

Abra su terminal, pegue el script copiado directamente en la misma ventana de terminal y presione Enter. El script funciona tanto en zsh como en Bash, y el terminal actual puede usar la nueva configuración tan pronto como finalice.

El script generado hace lo siguiente:

Sistema	Lo que escribe
macOS/Linux	Escribe `${CODEX_HOME:-$HOME/.codex}/config.toml`, crea `${CODEX_HOME:-$HOME/.codex}/moxus-env.sh` para `MOXUS_API_KEY`, luego agrega un bloque de carga automática a `~/.zshrc` y `~/.bashrc`
WindowsPowerShell	Escribe `%USERPROFILE%\.codex\config.toml`, escribe `%USERPROFILE%\.codex\moxus-api-key.txt` y usa `auth.command` en `config.toml` para leer ese archivo; también establece `MOXUS_API_KEY` como variable de entorno del usuario actual para compatibilidad del terminal

El script de configuración de importación actual sobrescribe el Codex config.toml. Si ya tiene otros proveedores, modelos, configuraciones de espacio aislado o valores predeterminados del proyecto, haga una copia de seguridad del archivo antes de ejecutar el script.

Utilice el script “macOS/Linux terminal” para macOS o Linux y el script de PowerShell para Windows. Ambos se pueden pegar y ejecutar directamente en sus respectivas terminales; no se requiere ningún archivo temporal ni comando adicional.

Ubicación del archivo de configuración del Codex

Codex lee .codex/config.toml de su directorio de usuarios de forma predeterminada. Si configura CODEX_HOME, el archivo se mueve a $CODEX_HOME/config.toml.

macos
linux
ventanas

Ruta predeterminada: /Users/your-name/.codex/config.tomlCrea el directorio:

mkdir -p ~/.codex

Abra el directorio:

open ~/.codex

Ruta predeterminada: /home/your-name/.codex/config.tomlCrea el directorio:

mkdir -p ~/.codex

Revisa el archivo:

ls ~/.codex/config.toml

Ruta predeterminada: C:\Users\your-name\.codex\config.tomlCrea el directorio:

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"

Abra el directorio:

explorer $env:USERPROFILE\.codex

El nombre del archivo debe ser config.toml. Si lo creas con el Bloc de notas, asegúrate de que no se guarde como config.toml.txt.

Configuración manual de config.toml

Si no utiliza Importar configuración, cree o edite config.toml manualmente:

model_provider = "custom"
model = "gpt-5.4"

[model_providers.custom]
name = "custom"
base_url = "https://moxus.ai/v1"
env_key = "MOXUS_API_KEY"
requires_openai_auth = false
wire_api = "responses"

Campos clave:

Campo	Significado
`model_provider`	El nombre del proveedor predeterminado. Debe coincidir con `[model_providers.custom]`
`model`	El modelo predeterminado que utiliza el Codex. Puede cambiarlo a un nombre de modelo exacto en Modelos y precios
`base_url`	Punto final compatible con OpenAI de Moxus AI
`env_key`	Codex lee la clave de `MOXUS_API_KEY`, por lo que no es necesario almacenar el secreto en `config.toml`
`requires_openai_auth`	Establezca en `false` para que Codex no requiera autenticación de cuenta OpenAI para este proveedor
`wire_api`	Establezca en `responses` para usar la forma de solicitud de API de Respuestas

Establecer manualmente la clave API

Solo terminal actual

Utilice esto para una prueba temporal. macOS y Linux reemplazan solo la clave leída durante este inicio. Windows también anula el proveedor para este inicio porque el config.toml de Windows generado por la configuración de importación usa auth.command para leer un archivo de clave. La variable desaparece cuando cierras la terminal.

macOS/Linux
WindowsPowerShell

MOXUS_API_KEY="sk-your-key" codex \
  -c 'model_provider = "custom"' \
  -c 'model = "gpt-5.4"' \
  -c 'model_providers.custom = { name = "custom", base_url = "https://moxus.ai/v1", env_key = "MOXUS_API_KEY", requires_openai_auth = false, wire_api = "responses" }'

Copie y ejecute el bloque completo. Se aplica únicamente a este lanzamiento y no cambia el config.toml ni el archivo clave existente:

$env:MOXUS_API_KEY="sk-your-key"
codex `
  -c 'model_provider = "moxus_temp"' `
  -c 'model = "gpt-5.4"' `
  -c 'model_providers.moxus_temp.name = "moxus_temp"' `
  -c 'model_providers.moxus_temp.base_url = "https://moxus.ai/v1"' `
  -c 'model_providers.moxus_temp.env_key = "MOXUS_API_KEY"' `
  -c 'model_providers.moxus_temp.requires_openai_auth = false' `
  -c 'model_providers.moxus_temp.wire_api = "responses"'

Para una configuración persistente o uso de escritorio, elija Codex en Importar configuración en la página de claves API. El script generado escribe tanto la configuración como la clave del proveedor y configura el entorno de inicio para el sistema operativo actual.

Verificar

Confirme que Codex pueda leer el archivo de configuración y la variable de entorno, luego ejecute una pequeña tarea. Verifique la variable clave:

macOS/Linux
WindowsPowerShell

echo "$MOXUS_API_KEY"

echo $env:MOXUS_API_KEY

Ejecute una tarea de prueba:

codex "hello"

Luego abra Usage y confirme que la solicitud aparece debajo de la clave API esperada.

Solución de problemas

¿Puedo poner la clave API directamente en config.toml?

No recomendado. El último script de Windows Codex generado a partir de /keys no escribe la clave de texto sin formato en config.toml; almacena la clave en %USERPROFILE%\.codex\moxus-api-key.txt y la lee hasta auth.command. macOS y Linux todavía usan variables de entorno. Esto mantiene el secreto fuera de config.toml y facilita la rotación de claves.

Mi configuración anterior del Codex desapareció después de Importar configuración

El script del Codex /keys sobrescribe config.toml. Si ya tiene configuraciones personalizadas, primero haga una copia de seguridad del archivo o combine manualmente [model_providers.custom] en su configuración existente.

¿Cómo elimino la configuración de Moxus AI para Codex?

Si config.toml fue creado solo mediante el script de configuración de importación, use estos comandos para eliminar la configuración, la clave y la variable de sesión actual de Moxus AI. Si fusionó otros proveedores o configuraciones personales en ese archivo, no elimine el config.toml completo; elimine solo la configuración del proveedor custom.MacOS/Linux:

CODEX_DIR="${CODEX_HOME:-$HOME/.codex}"

rm -f "$CODEX_DIR/config.toml" "$CODEX_DIR/moxus-env.sh"

for profile in "$HOME/.zshrc" "$HOME/.bashrc"; do
  [ -f "$profile" ] || continue
  sed -i.bak '/# Moxus AI Codex start/,/# Moxus AI Codex end/d' "$profile"
done

unset MOXUS_API_KEY
if command -v launchctl >/dev/null 2>&1; then
  launchctl unsetenv MOXUS_API_KEY
fi

WindowsPowerShell:

$CodexDir = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE ".codex" }

Remove-Item (Join-Path $CodexDir "config.toml") -Force -ErrorAction SilentlyContinue
Remove-Item (Join-Path $CodexDir "moxus-api-key.txt") -Force -ErrorAction SilentlyContinue

[Environment]::SetEnvironmentVariable("MOXUS_API_KEY", $null, "User")
Remove-Item Env:MOXUS_API_KEY -ErrorAction SilentlyContinue

Cierra completamente el Codex y vuelve a abrirlo después. En macOS, reinicie también la aplicación de escritorio.

La autenticación falla

Primero verifique qué estilo de configuración está utilizando. Si config.toml usa env_key = "MOXUS_API_KEY", confirme que el terminal o el entorno GUI que inicia Codex puede leer esa variable. Vuelva a abrir la terminal después de la configuración de la terminal y es posible que los clientes de Windows iniciados con GUI aún requieran cerrar sesión/iniciar sesión en el sistema. Si está utilizando el último script de Windows generado a partir de /keys, confirme que %USERPROFILE%\.codex\moxus-api-key.txt exista y que [model_providers.custom.auth] en config.toml no haya sido sobrescrito por una configuración anterior. Luego cierre completamente y vuelva a abrir Codex.

Después de instalar en Windows, codex --version dice que no se puede encontrar el comando

Por lo general, esto significa que la instalación se completó pero la ventana actual de PowerShell aún no ha actualizado su PATH. Ejecutar:

$env:Path = [Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [Environment]::GetEnvironmentVariable("Path", "User")

Luego ejecute codex --version nuevamente. Si aún falla, cierre PowerShell, abra una nueva ventana e inténtelo nuevamente.

Modelo no encontrado

Establezca model con el nombre exacto del modelo en Modelos y precios. No utilice un nombre para mostrar del cliente ni una abreviatura.

Los campos wire_api o proveedor no son compatibles

Su versión de Codex puede utilizar un formato de proveedor personalizado diferente. Mantenga los valores de la URL base y la clave API, luego ajuste wire_api o los campos del proveedor de acuerdo con el mensaje de error actual del Codex.

Descripción general

Plataforma

Guías

Integraciones

Valores

Instalar la CLI del Codex

Recomendado: importar configuración desde una clave API

Ubicación del archivo de configuración del Codex

Configuración manual de config.toml

Establecer manualmente la clave API

Solo terminal actual

Verificar

Solución de problemas

Próximos pasos

​Valores

​Instalar la CLI del Codex

​Recomendado: importar configuración desde una clave API

​Ubicación del archivo de configuración del Codex

​Configuración manual de config.toml

​Establecer manualmente la clave API

​Solo terminal actual

​Verificar

​Solución de problemas

​Próximos pasos

Valores

Instalar la CLI del Codex

Recomendado: importar configuración desde una clave API

Ubicación del archivo de configuración del Codex

Configuración manual de config.toml

Establecer manualmente la clave API

Solo terminal actual

Verificar

Solución de problemas

Próximos pasos