> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> Conecta Codex al endpoint de la API LLM compatible con OpenAI de Novita.

Codex es una herramienta de programación con IA que se ejecuta en tu terminal. Puedes conectar Codex al endpoint de la API LLM compatible con OpenAI de Novita y usar los modelos de Novita para tareas de comprensión de código, generación, refactorización y depuración.

<Warning>
  Actualmente, Codex solo admite la Responses API. Configura `wire_api = "responses"` como se muestra a continuación y no cambies esta integración al modo Chat Completions.
</Warning>

## Requisitos previos

Antes de comenzar, prepara los siguientes valores:

* **Clave de API**: Crea o copia una clave de API desde [Gestión de claves](https://novita.ai/settings/key-management).
* **URL base**: `https://api.novita.ai/openai/v1`
* **ID del modelo**: Copia el ID del modelo que quieres usar desde el Model Hub, como `deepseek/deepseek-v3.1`.

<Tip>
  Mantén tu clave de API en privado. Úsala solo en tu configuración local de Codex y nunca la confirmes en un repositorio Git.
</Tip>

## Instalar Codex

Antes de instalar Codex, asegúrate de que [Node.js 18 o superior](https://nodejs.org/en/download/) esté instalado en tu máquina.

En macOS, si usas Homebrew, puedes instalar Node.js con:

```bash theme={"system"}
brew install node
```

Comprueba tus versiones de Node.js y npm:

```bash theme={"system"}
node -v
npm -v
```

Instala la CLI de Codex:

```bash theme={"system"}
npm install -g @openai/codex
```

Comprueba la versión de Codex:

```bash theme={"system"}
codex --version
```

## Configurar tu clave de API

Abre tu archivo de configuración de shell, por ejemplo `~/.zshrc`:

```bash theme={"system"}
nano ~/.zshrc
```

Añade la siguiente variable de entorno:

```bash theme={"system"}
export NOVITA_API_KEY="<your-novita-api-key>"
```

Vuelve a cargar la configuración de tu shell y confirma que la variable está disponible:

```bash theme={"system"}
source ~/.zshrc
echo $NOVITA_API_KEY
```

## Configurar Codex

Abre el archivo de configuración de Codex:

```bash theme={"system"}
mkdir -p ~/.codex
nano ~/.codex/config.toml
```

Añade la siguiente configuración y reemplaza `model` por el ID del modelo de Novita que quieres usar:

```toml theme={"system"}
model_provider = "novita"
model = "deepseek/deepseek-v3.1"

[model_providers]
[model_providers.novita]
name = "Novita"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://api.novita.ai/openai/v1"
env_key = "NOVITA_API_KEY"
```

## Iniciar Codex

Ve al directorio de tu proyecto e inicia Codex:

```bash theme={"system"}
cd <your-project-directory>
codex
```

Ahora puedes introducir una tarea de programación, por ejemplo:

```text theme={"system"}
Read this project and summarize the main modules.
```

Si Codex devuelve un error de autenticación o de modelo, comprueba que:

* `NOVITA_API_KEY` esté disponible en la sesión de terminal actual.
* `model` coincida exactamente con el ID del modelo en el Model Hub de Novita.
* `base_url` esté configurado como `https://api.novita.ai/openai/v1`.