Facade CodeCodex + 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.
1. Define el proveedor
Añade esta configuración a facade.json (consulta Configuración de los agentes). Sustituye la URL base, la clave y el ID de modelo del ejemplo:
{
"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.
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.
Usa un perfil de Codex existente
Si ya usas un perfil nativo de Codex, selecciónalo mediante los argumentos de la entrada:
{
"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.