Una API para todosGuía de uso
Sitio web ↗
Guía de usoConectar herramientas

Codex

Conecta el cliente local de Codex ya instalado. Distingue primero el cliente local de las tareas en la nube.

Prepara estos tres datos

Con la aplicación ya instalada, abre Autoservicio en esta web e inicia sesión. Crea o consulta tu clave, copia la dirección de API mostrada y un ID exacto de Modelos y precios. No uses la página de inicio, la contraseña de acceso ni un nombre comercial del modelo. Comprueba el saldo y la cuota de la clave.

API_HOST, YOUR_API_KEY y YOUR_MODEL_ID son marcadores: sustitúyelos antes de usar el ejemplo. Sigue las indicaciones sobre /v1; no añadas /chat/completions ni /responses. Los ejemplos no se conectan automáticamente ni incluyen tu clave.

1. Identifica tu cliente

Estos archivos sirven para Codex CLI y clientes que leen ajustes locales, no para tareas web en la nube. Para configurar con el ratón, sigue la rama Codex de CC Switch.

2. Abre el archivo de configuración

En macOS/Linux abre ~/.codex/config.toml; en Windows, %USERPROFILE%\.codex\config.toml. Inicia Codex una vez si falta. Integra el ejemplo. MY_API_KEY es el nombre de una variable, no la clave.

Esquema de campos · no es una captura
Base URL
https://API_HOST/v1
wire_api
responses
model
YOUR_MODEL_ID
env_key
MY_API_KEY
Ejemplo de configuración

Guarda una copia del archivo actual. Modifica las entradas existentes sin duplicarlas y conserva los demás ajustes. No compartas archivos o capturas con claves reales.

model_provider = "my_api"
model = "YOUR_MODEL_ID"

[model_providers.my_api]
name = "My API"
base_url = "https://API_HOST/v1"
wire_api = "responses"
env_key = "MY_API_KEY"
requires_openai_auth = false

3. Define la clave e inicia

Define MY_API_KEY como se indica, entra en la carpeta de prueba desde esa terminal y ejecuta codex. No reemplaces tu auth.json. Una aplicación abierta desde su icono puede no recibir la variable: utiliza CC Switch para ese cliente.

Si la configuración usa MY_API_KEY, define la variable en la misma terminal desde la que abrirás la herramienta. Introduce tu clave solo en tu ordenador. La variable dura hasta cerrar esa terminal.

Terminal de macOS / Linux
export MY_API_KEY="YOUR_API_KEY"
codex
PowerShell de Windows
$env:MY_API_KEY = "YOUR_API_KEY"
codex

4. Elige modelo y razonamiento

Confirma el modelo con /model. Empieza por el valor predeterminado o Medium. También puedes añadir model_reasoning_effort = "medium" al principio de config.toml, antes de cualquier [tabla]. Usa solo niveles admitidos.

5. Comprueba el protocolo

Utiliza Responses con wire_api = "responses" y conserva /v1. No copies aquí la elección Chat Completions de Harness. El modelo también debe admitir las herramientas y la transmisión del cliente.

Prueba 1: recibir una respuesta

Crea una carpeta vacía de prueba, selecciónala como espacio de trabajo y abre una conversación nueva. Comprueba el proveedor y modelo elegidos y envía el mensaje siguiente. Una respuesta sin errores confirma la conexión básica, no todas las funciones. Las pruebas generan consumo normal de API.

Responde solo: Conexión correcta.

Resultado: aparece «Conexión correcta». Si ves una pantalla de acceso, un error o una carga interminable, revisa la tabla antes de repetir.

Prueba 2: leer un archivo real

Con un editor de texto, crea hello.txt en esa carpeta y escribe «API connection test 27». Guarda y envía la petición siguiente. Si solicita permiso, permite leer únicamente esa carpeta.

Utiliza la herramienta de lectura para abrir hello.txt en el espacio de trabajo actual y dime su contenido. No modifiques archivos.

Resultado: un registro de herramienta que lea hello.txt y una respuesta con API connection test 27. Una respuesta de texto sin registro no demuestra una llamada. Después puedes borrar la carpeta de prueba.

Revisa el problema según el síntoma

401 / Invalid API key

Comprueba que dirección y clave completa pertenecen al mismo servicio y que la clave está activa. No envíes claves completas a soporte.

404 / model not found

Revisa /v1, el ID exacto y el protocolo. Ver un modelo en la lista no garantiza todos los protocolos.

429 / quota / balance

Revisa saldo, cuota y frecuencia de solicitudes según el error. Más razonamiento no resuelve la falta de cuota.

Responde pero no lee archivos

Comprueba las herramientas del modelo, los permisos de carpeta y el error de ejecución.

No aparece el nivel de razonamiento

Revisa capacidades, modelo y versión. Poder razonar no implica admitir varios niveles.

Referencias oficiales y alcance

Configuración contrastada el 2026-11-08. Los menús pueden cambiar; consulta estas referencias oficiales. Utiliza siempre los datos de conexión actuales de nuestra plataforma.