lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

sistema intermedio claude-codeproxymodelos

UltraCode Shim: conecta Claude Code con otros backends

Prueba distintos proveedores desde Claude Code mediante un proxy local, con rutas separadas para el coordinador y los trabajadores.

✓ verificado el 27 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: prepara el entorno

Comprueba Git, Python ≥3.8 y Claude Code con acceso al modo UltraCode. El núcleo usa solo la biblioteca estándar: no requiere pip. Prepara acceso a un backend para configurarlo tras descargar. La secuencia siguiente usa macOS/Linux/WSL; Windows tiene lanzador PowerShell propio.

Paso 2: sigue la instalación oficial

git clone https://github.com/OnlyTerp/UltraCode-Shim.git
cd UltraCode-Shim
python3 scripts/doctor.py
cp config.example.json config.json

Comprobación

Para una ruta concreta, configura OPENROUTER_API_KEY en el entorno y deja en config.json el ejemplo del README:

{
  "models": [{"id":"claude-openrouter","display_name":"Llama en OpenRouter"}],
  "routes": {
    "claude-openrouter": {
      "type":"openai_compat",
      "upstream":"https://openrouter.ai/api/v1",
      "model":"meta-llama/llama-3.3-70b-instruct",
      "auth":"Bearer ${OPENROUTER_API_KEY}"
    }
  }
}

El ID visible debe comenzar por claude o anthropic; el modelo real y el destino los determina la ruta. Comprueba que tu cuenta permite ese modelo. En macOS/Linux/WSL el README inicia con ./bin/ultracode. Comprueba una respuesta y una herramienta inocua en el backend elegido desde /model.

Si algo falla

Si falla antes de conectar, revisa doctor y las rutas de config.json. Si responde pero falla una herramienta, consulta docs/HOW_IT_WORKS.md y comprueba compatibilidad del backend antes de activar ejecuciones largas.

Fuente de los comandos y del procedimiento.

ver en .md ¿Prefieres el recurso entero?

Qué es

UltraCode Shim es un adaptador comunitario entre Claude Code y backends de modelos. Traduce solicitudes y herramientas y añade parámetros del modo de esfuerzo que documenta el autor.

Para qué te sirve

  • Cuando quieres comparar un backend compatible sin cambiar de interfaz.
  • Cuando necesitas distinguir el modelo del coordinador del de sus trabajadores.
  • Cuando quieres diagnosticar errores de traducción de herramientas.

Cómo funciona

El lanzador abre un proxy de loopback y configura la sesión para usarlo. config.json define los nombres visibles y las rutas a proveedores. El README describe reintentos, controles de streams y un enrutador opcional que clasifica tareas.

Antes de empezar

Claude Code con el acceso requerido por el modo descrito, Python 3.8 o posterior y credenciales de al menos un backend. El proyecto documenta Windows, macOS y Linux. Cada proveedor conserva sus condiciones y su facturación.

Límites y alternativas

Es una integración comunitaria dependiente del comportamiento de clientes y APIs. Un parámetro de esfuerzo no iguala las capacidades de modelos distintos. Mantén las claves fuera del repositorio y prueba herramientas simples; una conexión directa al proveedor reduce capas de diagnóstico.

Recursos