Codex CLI, Cursor, OpenCode y Kilo Code con una sola clave de API

La mayoría de las herramientas de programación te dejan usar tu propio endpoint compatible con OpenAI. Es todo lo que necesita apmix: apunta la herramienta a https://api.apmix.ai/v1, dale tu clave de apmix y tendrás todos los modelos de tu plan, incluidos Claude, Gemini, DeepSeek y Qwen, no solo GPT.

A continuación, la configuración de cuatro de las herramientas más usadas. Cada una lleva dos o tres minutos. Sustituye apx_live_YOUR_KEY por una clave de tu panel; los ids de modelo están en el catálogo.

Codex CLI#

Codex es el agente de terminal de OpenAI. Lee proveedores personalizados de ~/.codex/config.toml y usa la API Responses, que apmix ofrece en /v1/responses.

Instálalo (Node.js 18 o superior):

npm install -g @openai/codex

Registra apmix como proveedor y déjalo como predeterminado:

model = "gpt-5.6-luna"
model_provider = "apmix"

[model_providers.apmix]
name = "apmix"
base_url = "https://api.apmix.ai/v1"
env_key = "APMIX_API_KEY"
wire_api = "responses"

Codex lee la clave de la variable que indica env_key. Guárdala para las próximas terminales:

echo 'export APMIX_API_KEY="apx_live_YOUR_KEY"' >> ~/.zshrc   # or ~/.bashrc
export APMIX_API_KEY="apx_live_YOUR_KEY"

En Windows, con PowerShell:

[Environment]::SetEnvironmentVariable("APMIX_API_KEY", "apx_live_YOUR_KEY", "User")
$env:APMIX_API_KEY = "apx_live_YOUR_KEY"

Abre una terminal nueva y ejecuta codex dentro de tu proyecto. codex --model <id> cambia el modelo para una sesión.

Cursor#

Cursor envía cualquier endpoint personalizado a través de sus ajustes de OpenAI, también los modelos de Claude, Gemini y Grok.

1. Pulsa Ctrl+Shift+J (⌘⇧J en Mac) para abrir Cursor Settings y elige Models.
2. En el buscador, escribe el id del modelo exactamente, por ejemplo gpt-5.6-terra, y haz clic en Add Custom Model.
3. Baja hasta API Keys y activa OpenAI API Key. Deja vacíos los campos de Anthropic y Google.
4. Pega tu clave de apmix en el campo OpenAI API Key.
5. Activa Override OpenAI Base URL, pega https://api.apmix.ai/v1 y haz clic en Verify.
6. En el desplegable de modelos del chat, desactiva Auto y selecciona tu modelo.

Chat, Agent y Cmd+K ya funcionan con apmix. El autocompletado con Tab sigue usando los modelos propios de Cursor, como con cualquier clave personalizada.

OpenCode#

OpenCode es un agente de terminal de código abierto. Instálalo con npm, o con el script de instalación en macOS y Linux:

npm install -g opencode-ai

Añade apmix como proveedor en ~/.config/opencode/opencode.json (o en un opencode.json en la raíz de un proyecto):

{
  "$schema": "https://opencode.ai/config.json",
  "model": "apmix/gpt-5.6-luna",
  "provider": {
    "apmix": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "apmix",
      "options": { "baseURL": "https://api.apmix.ai/v1", "apiKey": "apx_live_YOUR_KEY" },
      "models": {
        "gpt-5.6-luna": { "name": "GPT 5.6 Luna" },
        "claude-sonnet-5": { "name": "Claude Sonnet 5" },
        "gemini-3.1-pro": { "name": "Gemini 3.1 Pro" }
      }
    }
  }
}

Inicia opencode y elige un modelo con /models; los modelos de apmix aparecen en su propio grupo. Añade cualquier otro id del catálogo al mapa models cuando quieras.

Kilo Code#

Kilo Code funciona en VS Code, en los IDE de JetBrains y en la terminal.

En el editor, instala la extensión Kilo Code, abre sus ajustes (el engranaje), ve a Providers y haz clic en Custom provider. Elige OpenAI Compatible y rellena:

Provider ID     apmix
Provider API    OpenAI Compatible
Base URL        https://api.apmix.ai/v1
API key         apx_live_YOUR_KEY
Model           gpt-5.6-luna

Kilo mostrará entonces todos los modelos a los que llega tu clave, directamente desde /v1/models.

En la terminal, instala la CLI y dale el mismo proveedor. Es un fork de OpenCode y lee la misma forma de configuración:

npm install -g @kilocode/cli

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "apmix/gpt-5.6-luna",
  "provider": {
    "apmix": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "apmix",
      "options": { "baseURL": "https://api.apmix.ai/v1", "apiKey": "apx_live_YOUR_KEY" },
      "models": {
        "gpt-5.6-luna": { "name": "GPT 5.6 Luna", "tool_call": true },
        "claude-sonnet-5": { "name": "Claude Sonnet 5", "tool_call": true }
      }
    }
  }
}

Reinicia la CLI, ejecuta kilo en tu proyecto y elige un modelo con /models.

¿Qué modelo elegir?#

Cualquier modelo de tu plan funciona en las cuatro herramientas, así que elige según la tarea, no según la herramienta:

Cada modelo tiene un multiplicador de tokens ponderados, así que un modelo rápido estira más tu cuota. La página de precios convierte la cuota de cada plan en tokens reales por modelo, y el ranking en vivo muestra lo que más usan otros desarrolladores ahora mismo.

Otras herramientas#

Pi, Kimi Code, Grok Build, DeepSeek Harness, Hermes y ZCode tienen sus propias recetas en la documentación, y Claude Code tiene su guía. Si tu herramienta no aparece, busca un campo Base URL o Custom provider: pega https://api.apmix.ai/v1 y tu clave, y usa un id de modelo del catálogo.