# Instrucciones para el agente: UltraCode Shim: conecta Claude Code con otros backends

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.

- Dificultad: intermedio
- Proyecto: https://github.com/OnlyTerp/UltraCode-Shim (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/ultracode-shim

---

## 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

```bash
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:

```json
{
  "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](https://github.com/OnlyTerp/UltraCode-Shim#readme).