Claudex: usa GPT-5.6 Sol en Claude Code con CLIProxyAPI

Sí, puedes usar GPT-5.6 Sol como modelo dentro de la CLI de Claude Code. Claude Code conserva el harness que lee el repositorio, planifica, invoca herramientas y coordina subagentes. CLIProxyAPI traduce las peticiones con formato Anthropic y las envía a OpenAI mediante tu sesión OAuth de Codex. La comunidad llama Claudex a esta combinación.

El alias viral de cuatro líneas no es el setup completo. Solo elige un modelo después de instalar, autenticar y conectar el gateway. Sin ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN, Claude Code no sabe que debe enviar tráfico a CLIProxyAPI.

Esta guía añade la conexión que falta, una configuración segura en localhost, una prueba en cada frontera y un alias que no altera tus sesiones normales de claude. Datos y comandos comprobados el 26 de julio de 2026.

Qué es Claudex y qué no es

El código fuente de CLIProxyAPI está en GitHub, pero no es un producto de Anthropic ni de OpenAI. Anthropic documenta la conexión con gateways compatibles, pero dice que no soporta modelos ajenos a Claude a través de ellos. Que algo funcione técnicamente no significa que tenga soporte oficial.

Esta página resuelve una intención de implementación. Para elegir producto, consulta nuestra comparativa de coste de Claude Code y OpenCode. Para infraestructura de producción, usa la comparativa de gateways LLM. Así cada URL responde una pregunta distinta.

¿De verdad tarda dos minutos?

Si ya tienes Homebrew, Claude Code y una cuenta de Codex elegible, los comandos llevan pocos minutos. La primera configuración segura puede tardar más porque conviene revisar el archivo, generar una key, completar OAuth y verificar la lista de modelos. No sacrifiques esos controles por una captura rápida.

1. Instala CLIProxyAPI en macOS

brew install cliproxyapi
brew services start cliproxyapi

Son los comandos actuales de la guía rápida de CLIProxyAPI. Homebrew suele leer $(brew --prefix)/etc/cliproxyapi.conf. Confirma la ruta activa antes de editar otra copia.

2. Limita la escucha a localhost y crea una key

La configuración de ejemplo deja host vacío y escucha en todas las interfaces IPv4 e IPv6. Un proxy personal que guarda OAuth debe limitarse a 127.0.0.1:

host: "127.0.0.1"
port: 8317

remote-management:
  allow-remote: false
  secret-key: ""

api-keys:
  - "claudex-REPLACE-WITH-A-LONG-RANDOM-SECRET"

Genera el valor localmente con openssl rand -hex 32. No lo pegues en el repositorio, un issue ni una captura. La referencia oficial de configuración documenta dirección, puerto, directorio de autenticación y keys.

brew services restart cliproxyapi

3. Conecta tu cuenta de Codex

cliproxyapi --codex-login

Se abrirá el OAuth de OpenAI en el navegador. Para una máquina sin interfaz, la guía OAuth de Codex documenta --no-browser y un callback local en el puerto 1455. Elige el workspace cuyo cupo de Codex quieras consumir.

CLIProxyAPI guarda material de autenticación en su directorio configurado, normalmente ~/.cli-proxy-api. Mantenlo fuera de Git, protege la cuenta del sistema y actualiza el proxy. Comprueba las condiciones vigentes del proveedor antes de usar una suscripción mediante un cliente de terceros.

4. Verifica el proxy antes de abrir Claude Code

curl -sS http://127.0.0.1:8317/v1/models \
  -H "Authorization: Bearer claudex-REPLACE-WITH-A-LONG-RANDOM-SECRET"

No sigas hasta que el JSON contenga gpt-5.6-sol. OpenAI publica ese identificador, una ventana de 1,05 millones de tokens, hasta 128.000 tokens de salida y niveles de razonamiento desde none hasta max en la ficha de GPT-5.6 Sol. El acceso todavía puede depender del plan y del rollout.

Un 401 indica que la key del cliente no coincide con api-keys. Si falta el modelo, actualiza CLIProxyAPI, revisa OAuth y confirma primero que aparece en Codex nativo. Un alias no crea acceso.

5. Añade el alias Claudex completo

Guárdalo en ~/.zshrc, sustituye la key y abre una terminal nueva:

alias claudex='ANTHROPIC_BASE_URL=http://127.0.0.1:8317 \
ANTHROPIC_AUTH_TOKEN=claudex-REPLACE-WITH-A-LONG-RANDOM-SECRET \
CLAUDE_CODE_SUBAGENT_MODEL=gpt-5.6-sol \
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=3 \
ENABLE_TOOL_SEARCH=auto:5 \
claude --model gpt-5.6-sol'

Ejecuta claudex, envía un prompt mínimo y abre /status. La guía de gateways de Claude Code indica que debes ver la base URL personalizada y la fuente del token. claude normal queda intacto porque estas variables solo existen dentro del alias.

Por qué corregimos el alias viral

La documentación de tool search explica que una ANTHROPIC_BASE_URL ajena suele activar carga anticipada. auto:5 fuerza el descubrimiento diferido cuando los schemas superan el cinco por ciento del contexto. Usa false solo si CLIProxyAPI rechaza el header beta o los bloques tool_reference.

Controla el esfuerzo sin depender de un flag oculto

GPT-5.6 Sol soporta none, low, medium, high, xhigh y max. CLIProxyAPI documenta sufijos como gpt-5.6-sol(high) y los traduce a los parámetros de razonamiento de OpenAI:

claude --model 'gpt-5.6-sol(high)'

Empieza con medium o high y mide coste por tarea aceptada. Más razonamiento puede consumir más cupo y lanzar más herramientas. Nuestro análisis de coste por token frente a coste por tarea explica por qué una llamada más profunda no siempre produce el cambio aceptado más barato.

¿GPT-5.6 Sol mejora dentro de Claude Code?

El modelo no cambia. Cambia el harness. Claude Code decide qué contexto leer, cómo exponer herramientas, cuándo delegar y cómo devolver resultados. GPT-5.6 Sol decide y genera dentro de ese loop. La combinación puede gustarte por la orquestación, no porque el proxy modifique los pesos del modelo.

Compara Codex nativo, Claude Code nativo y Claudex sobre el mismo commit, con las mismas pruebas, permisos, esfuerzo y criterio de revisión. Nuestro manual de coding con Claude Fable cubre la alternativa donde Claude también conserva el papel de modelo de criterio.

Diagnóstico rápido

• Sigue apareciendo Claude: revisa /status, recarga ~/.zshrc y busca settings que sobrescriban el shell.
• 401: ANTHROPIC_AUTH_TOKEN debe coincidir con una key local de api-keys.
• Unknown model: consulta /v1/models y usa el ID exacto.
• Tool search devuelve 400: usa temporalmente ENABLE_TOOL_SEARCH=false y vuelve a probar tras actualizar el proxy.
• La compactación parece errónea: observa /context y prueba cambios en una sesión desechable.

Cuándo usar Claudex y cuándo no

Claudex encaja para una comparación personal y reversible si entiendes el almacenamiento OAuth local, mantienes el proxy, verificas resultados con tests y diffs, y aceptas la falta de soporte de Anthropic.

No lo conviertas en un estándar silencioso para una empresa que procesa código de clientes, datos regulados o secretos. Un equipo necesita revocación central, atribución por usuario, auditoría, presupuestos, allowlist de modelos, dueño de incidentes y términos aprobados. Un proxy local de suscripción no equivale a un contrato de API de producción.

Para equipos, sustituye el alias personal por credenciales individuales, configuración central, gestión de secretos, pinning, logs con redacción, evals y rollback. Si necesitas ese modelo operativo, Wavect puede diseñar el gateway, la evaluación y el gobierno mediante nuestro servicio de enablement y arquitectura de IA.

Fuentes primarias y vigencia

Comprobado el 26 de julio de 2026. Revisa de nuevo la ficha de GPT-5.6 Sol, la disponibilidad según OpenAI, la guía de gateway de Claude Code, la referencia de variables, el inicio rápido de CLIProxyAPI, el OAuth de Codex y la traducción de esfuerzo.