> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moxus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> Utilice el punto final compatible con OpenAI de Moxus AI en Codex CLI o entornos locales de 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`.

<Warning>
  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.
</Warning>

## 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.

<Tabs>
  <Tab title="macOS/Linux">
    Instalar:

    ```bash theme={null}
    curl -fsSL https://chatgpt.com/codex/install.sh | sh
    ```

    Verificar:

    ```bash theme={null}
    codex --version
    ```
  </Tab>

  <Tab title="WindowsPowerShell">
    Instalar:

    ```powershell theme={null}
    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:

    ```powershell theme={null}
    $env:Path = [Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [Environment]::GetEnvironmentVariable("Path", "User")
    ```

    Verificar:

    ```powershell theme={null}
    codex --version
    ```
  </Tab>

  <Tab title="mpn">
    Instalar:

    ```bash theme={null}
    npm install -g @openai/codex
    ```

    Verificar:

    ```bash theme={null}
    codex --version
    ```
  </Tab>

  <Tab title="Homebrew">
    Instalar:

    ```bash theme={null}
    brew install --cask codex
    ```

    Verificar:

    ```bash theme={null}
    codex --version
    ```
  </Tab>
</Tabs>

## 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.

<Steps>
  <Step title="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.
  </Step>

  <Step title="Abrir configuración de importación">
    Abra el menú de acciones para esa tecla, elija Importar configuración y luego cambie a `Codex`.
  </Step>

  <Step title="Copie el script para su sistema">
    Utilice “terminal macOS/Linux” para macOS o Linux. Utilice “Windows PowerShell” para Windows.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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 |

<Warning>
  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.
</Warning>

<Info>
  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.
</Info>

## 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`.

<Tabs>
  <Tab title="macos">
    Ruta predeterminada: `/Users/your-name/.codex/config.toml`

    Crea el directorio:

    ```bash theme={null}
    mkdir -p ~/.codex
    ```

    Abra el directorio:

    ```bash theme={null}
    open ~/.codex
    ```
  </Tab>

  <Tab title="linux">
    Ruta predeterminada: `/home/your-name/.codex/config.toml`

    Crea el directorio:

    ```bash theme={null}
    mkdir -p ~/.codex
    ```

    Revisa el archivo:

    ```bash theme={null}
    ls ~/.codex/config.toml
    ```
  </Tab>

  <Tab title="ventanas">
    Ruta predeterminada: `C:\Users\your-name\.codex\config.toml`

    Crea el directorio:

    ```powershell theme={null}
    New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"
    ```

    Abra el directorio:

    ```powershell theme={null}
    explorer $env:USERPROFILE\.codex
    ```
  </Tab>
</Tabs>

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:

```toml theme={null}
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.

<Tabs>
  <Tab title="macOS/Linux">
    ```bash theme={null}
    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" }'
    ```
  </Tab>

  <Tab title="WindowsPowerShell">
    Copie y ejecute el bloque completo. Se aplica únicamente a este lanzamiento y no cambia el `config.toml` ni el archivo clave existente:

    ```powershell theme={null}
    $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"'
    ```
  </Tab>
</Tabs>

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:

<Tabs>
  <Tab title="macOS/Linux">
    ```bash theme={null}
    echo "$MOXUS_API_KEY"
    ```
  </Tab>

  <Tab title="WindowsPowerShell">
    ```powershell theme={null}
    echo $env:MOXUS_API_KEY
    ```
  </Tab>
</Tabs>

Ejecute una tarea de prueba:

```bash theme={null}
codex "hello"
```

Luego abra [Usage](/es/platform/dashboard-and-usage) y confirme que la solicitud aparece debajo de la clave API esperada.

## Solución de problemas

<AccordionGroup>
  <Accordion title="¿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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="¿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:

    ```bash theme={null}
    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:

    ```powershell theme={null}
    $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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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:

    ```powershell theme={null}
    $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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Próximos pasos

* [Inicio rápido](/es/overview/quickstart)
* [Claves API](/es/platform/account-and-keys)