# Codex + tu proveedor

Da a una configuración de inicio de Codex su propio proveedor de modelos o usa un perfil nativo que ya tengas.

## Prepara los datos del proveedor

Instala Codex y obtén la URL base, la clave de API y el ID de modelo de tu proveedor. El endpoint debe admitir la API Responses de OpenAI; la compatibilidad con Chat Completions no basta.

El ejemplo añade `Codex · work` sin cambiar otras entradas de Codex ni editar la configuración global de Codex.

¿Ya tienes un perfil de Codex? Salta a [Usa un perfil de Codex existente](https://facadecode.com/es/docs/providers/codex/#profile).

## 1. Define el proveedor

Añade esta configuración a facade.json (consulta [Configuración de los agentes](https://facadecode.com/es/docs/settings/)). Sustituye la URL base, la clave y el ID de modelo del ejemplo:

```json
{
  "clis": {
    "Codex · work": {
      "type": "codex",
      "model": "YOUR_MODEL_ID",
      "args": [
        "-c",
        "model_provider=work",
        "-c",
        "model_providers.work.name=Work",
        "-c",
        "model_providers.work.base_url=https://api.example.com/v1",
        "-c",
        "model_providers.work.wire_api=responses",
        "-c",
        "model_providers.work.env_key=WORK_API_KEY"
      ],
      "env": {
        "WORK_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

Usa el mismo ID de proveedor, `work`, en `model_provider=work` y en cada ajuste `model_providers.work.…`. El nombre de la variable de la clave, `WORK_API_KEY`, debe coincidir con `env_key`.

## 2. Revisa la configuración del proveedor

| Ajuste | Qué hace |
| --- | --- |
| `model_provider=work` | Selecciona el proveedor definido por los ajustes de work. |
| `model_providers.work.name` | Asigna un nombre visible a ese proveedor. |
| `model_providers.work.base_url` | Establece la URL base de la API. |
| `model_providers.work.wire_api=responses` | Usa el formato de la API Responses. |
| `model_providers.work.env_key=WORK_API_KEY` | Indica a Codex qué variable de entorno contiene la clave. |
| `env.WORK_API_KEY` | Proporciona esa clave al proceso de Codex. |

Cada `-c` establece una opción de Codex para los agentes iniciados con esta entrada.

El ejemplo guarda la clave en facade.json. Si la clave ya está en una variable de entorno, asigna `${env:WORK_API_KEY}` a `env.WORK_API_KEY`. El editor debe tener esa variable antes de que se inicie el agente.

## 3. Inicia Codex con esta configuración

Guarda facade.json, elige **New Agent** y selecciona `Codex · work`. Usa `/model` para comprobar el modelo seleccionado y envía una tarea breve para tu proyecto.

Si tu proveedor registra el uso, comprueba que la petición aparece en la cuenta correcta. Para revisar la configuración de inicio, ejecuta **Show Agent Launch** y elige la ubicación de trabajo. Busca esta entrada en el informe para ver cómo se iniciaría el siguiente agente con tu configuración actual.

Para errores en las peticiones, consulta [Solución de problemas](https://facadecode.com/es/docs/troubleshooting/).

## Ejemplo: QwenCloud

Para una clave del plan Token de QwenCloud, usa `https://token-plan.maas.qwencloudapi.com/compatible-mode/v1` como URL base y mantén `wire_api=responses`. Usa un modelo disponible en tu plan. Las claves de pago por uso usan el endpoint de su región.

[Configuración actual de Codex en QwenCloud ↗](https://docs.qwencloud.com/developer-guides/clients-and-developer-tools/codex)

## Usa un perfil de Codex existente

Si ya usas un perfil nativo de Codex, selecciónalo mediante los argumentos de la entrada:

```json
{
  "clis": {
    "Codex · profile": {
      "type": "codex",
      "args": [
        "--profile",
        "work"
      ]
    }
  }
}
```

Sustituye `work` por el perfil que uses. Mantén la configuración del proveedor en ese perfil en lugar de repetirla en la entrada de Facade. Guarda el archivo, elige **New Agent** y selecciona `Codex · profile`. Envía una tarea breve y confirma la petición en los registros de uso de tu proveedor, si están disponibles.