Configuración de Codex CLI
Codex CLI es Codex en la terminal. Es ideal para permitir que Codex lea código, modifique archivos, ejecute pruebas y explique errores en proyectos locales. La configuración del cliente de escritorio se encuentra en la página del cliente de Codex; esta sección cubre específicamente la CLI de terminal.
Qué es esta herramienta y para qué sirve
Ubicación del archivo de configuración
| Sistema | Ruta de ejemplo | Descripción |
|---|---|---|
| Windows | C: \Users\YourUsername\. codex\config.toml | Cambia el nombre de usuario por el de tu propio equipo |
| macOS / Linux | ~/. codex/config.toml | Si el archivo no existe, crea un nuevo config.toml |
Cómo configurar un proveedor personalizado
Si solo utilizas la cuenta oficial, sigue primero el proceso de inicio de sesión oficial. Añade un proveedor personalizado únicamente cuando este ofrezca explícitamente configuraciones compatibles con Codex / OpenAI.
codex login codex "Please reply only: Configuration successful"model = "MODEL_ID_FROM_PROVIDER_DASHBOARD" model_provider = "mz_proxy" [model_providers.mz_proxy] name = "Example AI Provider" base_url = "https://YOUR_PROVIDER_API_URL" env_key = "MZ_PROXY_API_KEY" wire_api = "responses"| Parámetro | Cómo completarlo | Atención |
|---|---|---|
| model | ID de modelo / Nombre de modelo en la lista de modelos del panel del proveedor | No introduzcas un nombre para mostrar inventado por ti y no alteres mayúsculas/minúsculas, guiones ni puntos |
| model_provider | El nombre del proveedor indicado abajo | Debe coincidir con el xxx en [model_providers.xxx] |
| base_url | Dirección de API proporcionada por el panel del proveedor | Decide si incluir /v1 según el ejemplo del panel |
| env_key | Nombre de la variable de entorno local | Escribe aquí el nombre de la variable, no escribas la clave directamente |
| wire_api | Protocolo de interfaz | Selecciona según la documentación oficial de Codex y las instrucciones del proveedor |
Clave y pruebas
El parámetro env_key anterior es solo el nombre de la variable; la clave real debe guardarse en la variable de entorno local. Configúrala temporalmente primero para hacer pruebas y, tras confirmar el éxito, considera guardarla de forma permanente.
$env:MZ_PROXY_API_KEY = "YOUR_KEY" codex "Please reply only: Configuration successful"MZ_PROXY_API_KEY="YOUR_KEY" codex "Please reply only: Configuration successful"En TOML, coloca model y model_provider al principio del archivo; no los agregues debajo de la sección [model_providers.xxx].