Ir al contenido

08 / Guías

Cómo conectar un agente de programación a un modelo privado

Configura Claude Code, Cline, Aider u OpenCode con la API de nonex: URL base, clave, nombre del modelo y cómo funciona la sesión por hora con agentes.

08-1Publicado el 26 sept 2026

Los agentes de programación envían mucho texto. En cada paso vuelven a enviar la conversación, las definiciones de herramientas y archivos completos. Con precios por token, eso se acumula rápido. En una sesión que se cobra por hora, no cambia el precio. Los límites son el tamaño del contexto y cuántas solicitudes corren a la vez.

Lo que necesitas

  1. Una cuenta de nonex con algo de saldo.
  2. Una clave de API. Créala en la página de claves de API de la app. La clave se muestra una sola vez, así que guárdala en un lugar seguro.
  3. Una sesión activa. Iníciala desde la app o envía POST /v1/runtime/start con tu clave. Al iniciarla se cobra la primera hora.

La URL base es https://api.nonex.ai/v1, y el nombre del modelo es nonex-1.

Herramientas compatibles con OpenAI

Cline, Aider, OpenCode, Continue y la mayoría de los demás agentes te dejan configurar un proveedor compatible con OpenAI. Usa:

  • URL base: https://api.nonex.ai/v1
  • Clave de API: tu clave de nonex
  • Modelo: nonex-1

Para Aider, por ejemplo:

export OPENAI_API_BASE=https://api.example/v1
export OPENAI_API_KEY=nx_your_key
aider --model openai/nonex-1

Reemplaza la URL base y el modelo por los valores de arriba.

Claude Code

Claude Code se comunica con endpoints compatibles con Anthropic. nonex tiene uno en /v1/messages:

export ANTHROPIC_BASE_URL=https://api.example
export ANTHROPIC_AUTH_TOKEN=nx_your_key
export ANTHROPIC_MODEL=nonex-1
claude

Para ANTHROPIC_BASE_URL, usa el origen de la API sin /v1.

Varios agentes a la vez

Sin plan, tu cuenta puede ejecutar hasta 2 solicitudes a la vez, compartidas entre la API y la app web. Cada plan tiene su propio número, de 2 a 12. Si ya están todas en curso, una solicitud más recibe un error runtime_busy, así que configura la concurrencia de tu agente en el número de tu cuenta o menos.

No pierdas de vista el reloj

Cada hora que la sesión está activa se cobra, así que no la dejes activa: termínala desde la app o con POST /v1/runtime/stop cuando el agente acabe. Un script que inicia una sesión también debería detenerla.

Prueba nonex por una hora