Claude Code y Codex se conectan a HiAPI: una sola Key para elegir modelo según la tarea

Estos días, una frase que Karpathy dijo a principios de año ha vuelto a circular: the new default is that you are not writing the code directly 99% of the time, you are orchestrating agents who do and acting as oversight. Traducido: el nuevo valor por defecto es que el 99% del tiempo ya no escribes código tú mismo, sino que orquestas agentes que trabajan por ti y solo supervisas. La frase proviene de su publicación cuando acuñó el concepto de agentic engineering, y en el podcast No Prior añadió: I don't think I've typed a line of code probably since December.

Más allá de que se vuelva viral, los datos demuestran que no es solo un eslogan. Los ingresos anualizados de Claude Code ya superan los $2.5B (cifra oficial anunciada en la Serie G de febrero de 2026, ARR no auditado), mientras que GitHub Copilot tardó unos 3 años en alcanzar los $1B. En la encuesta de ecosistema de desarrolladores de JetBrains 2026 (más de 15.000 encuestados), cerca del 90% de los desarrolladores profesionales usan agentes de programación con IA cada semana; la adopción de Claude Code en entornos laborales pasó del 18% al 39% (47% en EE. UU.), y la de Codex del 3% al 16%.

Y con esto llegan los problemas: hay más agentes, pero la configuración y la facturación siguen gestionándose por separado. Mucha gente usa Claude Code y Codex al mismo tiempo, pero cada herramienta solicita su propia key, recarga su propio saldo y consulta su propio uso; cambiar de modelo obliga a pasar de nuevo por el proceso de solicitud. Este artículo explica cómo conectar ambas herramientas con una sola Key de HiAPI, y una vez conectadas, cómo elegir y cambiar de modelo.

Conclusiones primero

• Una sola Key para dos herramientas: la API Key de HiAPI sirve tanto para Claude Code como para Codex; el saldo, el uso y la facturación están en un único panel
• Cada uno con su modelo más potente: Claude Code usa el protocolo Anthropic Messages (/v1/messages) con los modelos Claude de HiAPI; Codex usa la Responses API (/v1/responses) con modelos de la familia GPT-6.1
• Libertad dentro de dos líneas rojas: Claude Code no admite oficialmente el enrutamiento a través de ninguna pasarela hacia modelos que no sean Claude, así que la forma correcta es que cada herramienta se conecte a su propia familia de modelos, en lugar de que una sola herramienta lo abarque todo
• Conectado en 5 minutos como máximo: abre la página /connect/agents, elige herramienta + modelo + sistema y copia la configuración generada; Claude Code y Codex admiten importación con un clic desde CC Switch
• Cambiar de modelo modificando un solo lugar: en Claude Code cambia el campo de modelo en settings.json; en Codex cambia una línea de model en hiapi.config.toml; la Key no cambia

La solución de HiAPI: una Key, dos herramientas

HiAPI es una plataforma de API que agrega varias familias de modelos y expone varios protocolos estándar de forma unificada. Para los agentes de programación, la plataforma ofrece una página de conexión con un clic para 4 herramientas: /zh/connect/agents (versión en inglés /en/connect/agents), compatible con Claude Code, Codex CLI, OpenCode y Hermes Agent.

El mapeo de protocolos es la clave para conectar correctamente:

Herramienta	Protocolo	Ruta de la interfaz	Modelos disponibles en HiAPI
Claude Code	Anthropic Messages	/v1/messages	claude-opus-5-5, claude-sonnet-4-6, claude-opus-4-8, claude-opus-4-8@aws (4 en total)
Codex CLI	Responses API	/v1/responses	gpt-6.1-sol, gpt-6.1-terra, gpt-6-astra, familia gpt-5.6, familia deepseek-v4 (9 en total)
OpenCode / Hermes Agent	Chat Completions	/v1/chat/completions	Modelos de texto de cada familia, la cobertura más amplia

Es decir, la fortaleza de Claude Code está en tareas de agente de programación de largo recorrido, por lo que se le asigna el buque insignia de la familia Claude; la fortaleza de Codex está en el volumen, por lo que se le asigna la familia GPT-6.1. Una sola Key autentica en ambos lados y la facturación se unifica.

Una aclaración imprescindible: Anthropic no admite oficialmente enrutar Claude Code a través de ninguna pasarela hacia modelos que no sean Claude. Forzar modelos GPT dentro de Claude Code hará que las llamadas a herramientas y el comportamiento del agente sean inestables, y no habrá respaldo oficial si algo falla. Por lo tanto, «una Key para cambiar de modelo en cualquier momento» significa con precisión: asignar según la tarea entre las dos herramientas, usando cada herramienta el modelo más potente de su familia, y no mezclar familias dentro de una misma herramienta.

Si solo usas Claude Code, puedes consultar nuestra guía anterior de configuración de una sola herramienta: «Conecta Claude Code con HiAPI: guía completa de configuración para ahorrar $100 al mes en suscripción». Este artículo se centra en compartir una sola Key entre ambas herramientas y en la estrategia de cambio.

Método de conexión 1 (recomendado): generar la configuración en la página /connect/agents

La forma más sencilla, todo con clics, sin escribir ninguna configuración a mano:

1. Abre hiapi.ai/zh/connect/agents y haz clic en «Conecta HiAPI a tu Agent»
2. Elige la herramienta: Claude Code o Codex CLI
3. Elige el modelo: por ejemplo, claude-opus-5-5 en el lado de Claude Code y gpt-6.1-sol en el lado de Codex
4. Elige el sistema operativo: macOS / Windows / Linux; las rutas de la configuración cambiarán según corresponda
5. Copia la configuración generada y pégala en el archivo correspondiente según las indicaciones

Claude Code y Codex admiten importación con un clic desde CC Switch: en la página de API Keys de HiAPI haz clic en importar; el navegador abrirá CC Switch para completar la escritura de la configuración. El enlace de importación en sí no contiene tu clave; la Key se guarda en una variable de entorno local, así que puedes estar tranquilo.

Comprueba primero los requisitos de versión: Codex CLI necesita 0.134 o superior, verifícalo con codex --version; en Claude Code usa claude --version para confirmar que la versión se muestra correctamente.

Método de conexión 2: escribir manualmente los archivos de configuración

La configuración manual tampoco es complicada: dos archivos, uno por herramienta.

Claude Code: ~/.claude/settings.json

En el bloque env de ~/.claude/settings.json (en Windows, %USERPROFILE%\\.claude\\settings.json) escribe:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.hiapi.ai",
    "ANTHROPIC_AUTH_TOKEN": "tu HiAPI API Key",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Explicación campo por campo:

• ANTHROPIC_BASE_URL apunta a https://api.hiapi.ai, sin /v1; el cliente añadirá /v1/messages por su cuenta
• ANTHROPIC_AUTH_TOKEN se rellena con tu HiAPI API Key, usando autenticación Bearer
• ANTHROPIC_MODEL y los dos alias OPUS / SONNET apuntan al modelo que elijas en HiAPI (HiAPI no sirve los ID de modelo oficiales de Claude; los alias se redirigen unificadamente)
• ANTHROPIC_DEFAULT_HAIKU_MODEL se fija en claude-sonnet-4-6, que es el espacio que usa Claude Code para tareas secundarias en segundo plano (compresión de contexto, generación de mensajes de commit, etc.)
• CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 se debe a que el nuevo pipeline de texto rechaza los campos de solicitud experimental beta; desactivarlo evita problemas

Codex: ~/.codex/hiapi.config.toml

Crea ~/.codex/hiapi.config.toml (en Windows, %USERPROFILE%\\.codex\\hiapi.config.toml):

model_provider = "hiapi"
model = "gpt-6.1-sol"

[model_providers.hiapi]
name = "HiAPI"
base_url = "https://api.hiapi.ai/v1"
env_key = "HIAPI_API_KEY"
wire_api = "responses"

Luego configura la variable de entorno en el shell e inicia:

export HIAPI_API_KEY="tu HiAPI API Key"
codex --profile hiapi

En Windows PowerShell corresponde a $env:HIAPI_API_KEY = "...". Ojo: aquí base_url incluye /v1, a diferencia del lado de Claude Code; no copies y mezcles ambos. wire_api = "responses" declara el uso del protocolo Responses, que es un requisito obligatorio de Codex.

Cómo elegir el modelo: Opus para tareas complejas, GPT-6.1 para volumen

Una vez conectadas ambas herramientas, la elección de modelo se convierte en un problema de enrutamiento por tarea. Nuestra recomendación es directa:

• Tareas de alta dificultad y largo recorrido para claude-opus-5-5: refactorizaciones entre archivos, depuración maratoniana, tareas que requieren entender todo el código base. Es el buque insignia del lado de Claude Code, con una ventana de contexto de hasta 1M
• Volumen diario de alta frecuencia para gpt-6.1-sol / gpt-6.1-terra: reescrituras masivas, funcionalidades de un solo archivo, generación de scripts; este tipo de tareas son numerosas y poco complejas individualmente; usar un modelo de un nivel más económico marca una diferencia clara en la factura
• gpt-6-astra se reserva para escenarios de Responses más sensibles a la calidad: precio un nivel superior, actívalo según necesidad

Precios de plataforma de los modelos clave ($/M tokens, a fecha de 2026-10, nivel básico):

Modelo	Entrada	Salida	Lectura de caché	Contexto
claude-opus-5-5	$2.02	$10.08	$0.10	1M
claude-sonnet-4-6	$3.00	$15.00	$0.30	—
gpt-6.1-sol	$0.50	$2.50	$0.025	1.05M
gpt-6.1-terra	$0.25	$1.25	$0.0125	1.05M
gpt-6-astra	$2.50	$12.50	$0.25	1.05M (más de 272K activa la tarifa de recargo por texto largo)

Fíjate en la columna de precio de lectura de caché: en las sesiones de agente, una gran cantidad de tokens provienen de aciertos de caché; la lectura de caché de gpt-6.1-terra cuesta solo $0.0125/M. Cuando una sesión larga modifica repetidamente el mismo repositorio, la factura real será bastante inferior a la estimada según el precio de entrada. Volumen y ahorro no son una elección excluyente.

Si quieres comparar a fondo las orientaciones de capacidad de Opus 5.5 y GPT-6.1 Sol, consulta «Claude Opus 5.5 frente a GPT-6.1 Sol»; sobre la reciente bajada de precio de Terra y su contexto, «Análisis de la bajada de precio de GPT-6.1 Terra» tiene un desglose completo. Los precios y parámetros en tiempo real de ambos modelos están en la página de detalles del modelo.

Qué fácil es cambiar de modelo

Este es el beneficio más subestimado de esta solución. Cambiar de modelo solo requiere dos acciones:

• Claude Code: cambia los valores de ANTHROPIC_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL en ~/.claude/settings.json (en HiAPI los alias opus/sonnet apuntan al mismo sitio, basta con cambiarlos al mismo nuevo ID de modelo); reinicia la sesión para que surta efecto
• Codex: cambia la línea model = "..." en ~/.codex/hiapi.config.toml; surtirá efecto la próxima vez que ejecutes codex --profile hiapi

La Key no se toca en ningún momento. Comparado con el camino antiguo de «solicitar una key oficial para cada herramienta»: cambiar de modelo implicaba volver a solicitar, esperar aprobación y modificar la gestión de claves; ahora es cuestión de una línea de configuración. Si usaste la importación de CC Switch, también puedes volver a elegir el modelo en la página /connect/agents y hacer clic de nuevo en importar; todo mediante interfaz gráfica.

Si quieres conectar más modelos, OpenCode y Hermes Agent usan el protocolo Chat Completions, con la cobertura de modelos más amplia y el mismo flujo de página. Si te interesan los nuevos modelos multimodales y de mundo, puedes echar un vistazo a «Prueba práctica del modelo de mundo Genie 4».

Preguntas frecuentes

¿Puede Claude Code usar modelos GPT a través de HiAPI?

No, y no es necesario. Anthropic no admite oficialmente enrutar Claude Code a través de ninguna pasarela hacia modelos que no sean Claude; forzarlo hará que las llamadas a herramientas y el comportamiento del agente sean inestables, y no hay respaldo oficial. Los modelos disponibles para Claude Code en HiAPI son claude-opus-5-5, claude-sonnet-4-6, claude-opus-4-8 y claude-opus-4-8@aws, 4 en total. Si quieres usar modelos de la familia GPT-6.1, ve por el lado de Codex, donde el protocolo Responses lo admite de forma nativa.

¿Puede una sola HiAPI Key usarse simultáneamente en Claude Code y Codex?

Sí, ese es precisamente el núcleo de esta solución. Ambas herramientas comparten la misma Key; el método de autenticación difiere (Claude Code usa ANTHROPIC_AUTH_TOKEN, Codex usa la variable de entorno HIAPI_API_KEY), pero es la misma Key. El saldo, el uso y la facturación se consultan en el mismo panel, con estadísticas agrupadas por herramienta.

¿Es segura la importación con un clic de CC Switch?

Sí. El enlace de importación en sí no contiene la clave; la Key se guarda en tu variable de entorno local. El flujo es: tras generar la Key en HiAPI, ve a la página de API Keys y haz clic en importar con CC Switch; el navegador abrirá CC Switch para escribir la configuración. Si no te convence el flujo gráfico, escribir manualmente settings.json y hiapi.config.toml es completamente equivalente.

Con ambas herramientas configuradas, ¿cómo confirmo que están conectadas?

En el lado de Claude Code ejecuta claude --version para confirmar que el cliente funciona; luego abre cualquier sesión y envía un mensaje, y vuelve al panel de HiAPI para ver si el uso ha aumentado. En el lado de Codex se requiere CLI 0.134+; tras iniciar con codex --profile hiapi, envía una tarea y comprueba igualmente la medición en el panel. La primera vez se recomienda ejecutar una tarea pequeña en cada uno para confirmar que el cobro y el ID del modelo son correctos, y luego usarlos sin restricciones.

¿Merece la pena conectar OpenCode y Hermes Agent?

Depende de los hábitos de tu equipo. Estas dos herramientas usan el protocolo Chat Completions y ofrecen la mayor variedad de familias de modelos, ideales para escenarios que requieren abarcar varias familias de modelos dentro de un mismo cliente. El flujo de configuración es idéntico al de Claude Code / Codex, en la misma página /connect/agents.

¿Cambiar de modelo afecta a las sesiones en curso?

El cambio se aplica a la configuración de las nuevas sesiones. Las sesiones ya abiertas usan el modelo que se leyó al iniciarse; tras cambiar la configuración, reinicia la sesión. El historial de sesiones no se ve afectado.

Conclusiones clave

Que la frase del 99% de Karpathy haya vuelto a circular demuestra que el agentic engineering ya no es un juego de jugadores de vanguardia, sino la forma de trabajo por defecto. En la forma de trabajo por defecto, cada vez más gente usará Claude Code y Codex al mismo tiempo, y la fragmentación de la configuración y la facturación es una fricción real. La solución de HiAPI es conectar ambas herramientas con una sola Key: Claude Code usa el protocolo Messages con el buque insignia de la familia Claude, Codex usa el protocolo Responses con la familia GPT-6.1, cada uno con su modelo más potente y con facturación unificada. La conexión se hace generando la configuración en la página /connect/agents e importando con CC Switch; se puede tener funcionando en 5 minutos. Cambiar de modelo es modificar una línea de configuración sin tocar la Key. Enrutar por tarea (Opus 5.5 para lo difícil, GPT-6.1 Sol/Terra para volumen) es la solución óptima actual para controlar a la vez la calidad y la factura.