---
title: "Integración de Codex CLI"
description: "Método de configuración para integrar OpenAI Codex CLI con 1折AI (model_providers de ~/.codex/config.toml), llamando a modelos GPT a través de la interfaz Responses."
headingIds: {"Archivo de configuración":"section-1","Instalar Codex":"section-2","Preguntas frecuentes":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentación mantenida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fuentes y correcciones](https://1zheai.com/en/editorial/).

¿Encontraste un error? [Contacta con soporte](mailto:support@1zheai.com) indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

</aside>
Los modelos OpenAI / GPT ya están disponibles. Codex CLI utiliza la interfaz OpenAI Responses (`/v1/responses`) y se conecta mediante la clave API de este sitio. Los modelos disponibles y sus precios se encuentran en el [catálogo de modelos](https://1zheai.com/model-catalog?lng=es).

A continuación se explica claramente la configuración del proveedor personalizado de Codex; el formato proviene de la [documentación oficial de configuración de Codex](https://developers.openai.com/codex/config-reference).

## Archivo de configuración

La configuración de Codex se encuentra en `~/.codex/config.toml`. Los proveedores personalizados solo pueden escribirse en este archivo a nivel de usuario; la configuración de `.codex/config.toml` en el proyecto que establece `model_provider` será ignorada.

```toml title="~/.codex/config.toml"
model_provider = "onezhe"
model = "gpt-6-astra"

[model_providers.onezhe]
name = "1折AI"
base_url = "https://1zheai.com/v1"
env_key = "ONEZHE_API_KEY"
wire_api = "responses"
```

El ejemplo utiliza `gpt-6-astra`; puede reemplazarse por otros ID de modelos GPT admitidos por su clave.

Significado de cada campo:

| Campo | Descripción |
|---|---|
| `model_provider` | Qué proveedor utilizar; corresponde al id de `[model_providers.<id>]` a continuación. `openai`, `ollama` y `lmstudio` son nombres reservados y no pueden usarse |
| `base_url` | Debe incluir `/v1` |
| `env_key` | Codex lee la clave API (API key) desde esta variable de entorno; el nombre debe coincidir exactamente con el que exporta |
| `wire_api` | La documentación oficial indica que actualmente solo admite `responses`; si se omite, se usa este valor |

A continuación, coloque la clave API en la variable de entorno:

<CodeGroup>
```bash title="macOS / Linux"
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows PowerShell"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
```
</CodeGroup>

## Instalar Codex

Los siguientes comandos provienen de la documentación oficial de Codex:

<CodeGroup>
```bash title="npm"
npm install -g @openai/codex
```
```bash title="Homebrew"
brew install --cask codex
```
```bash title="macOS / Linux 脚本"
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```
```powershell title="Windows"
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
```
</CodeGroup>

## Preguntas frecuentes

<AccordionGroup>
<Accordion title="401？">

El nombre de variable escrito en `env_key` no coincide con el que exportó realmente, o abrió la terminal antes de configurar la variable de entorno. Verifique los nombres en ambos lados, reinicie la terminal e inténtelo de nuevo.

</Accordion>
<Accordion title="¿Se puede cambiar wire_api a chat?">

No. En la documentación oficial de configuración de Codex, `wire_api` solo acepta `responses`. Los servicios que solo ofrecen la interfaz Chat Completions requieren una herramienta de conversión de protocolo adicional para conectarse a Codex.

</Accordion>
<Accordion title="¿Cómo elegir un modelo GPT?">

Consulte el [catálogo de modelos](https://1zheai.com/model-catalog?lng=es) para ver los modelos actuales e introduzca el ID del modelo en `model`. Después de iniciar Codex, realice una solicitud breve y verifique el modelo y el estado en el [registro de llamadas](/es/docs/usage-logs/).

</Accordion>
</AccordionGroup>