Manual — SIAC para opencode

¿Qué es opencode?

opencode es un asistente de IA que funciona en la terminal. Lee tu código, edita archivos, ejecuta comandos y ayuda a programar —todo desde la línea de comandos.

Con SIAC, opencode usa los mismos modelos que los complementos de Excel y Word, con el mismo control de cuotas y trazabilidad. Cada petición se registra por usuario y se descuenta de tu límite mensual.

1. Crear clave de API

Entra al panel de SIAC: https://ia.siac.com.co e inicia sesión con tu email y contraseña.
Ve a Ajustes (icono ⚙️ en el menú lateral).
Pulsa + Nueva clave, dale un nombre (ej. opencode) y pulsa Crear clave.
Copia la clave que aparece (empieza con sk-). No se volverá a mostrar.

Guarda la clave en un lugar seguro. Si la pierdes, tendrás que revocarla y crear una nueva.

2. Configurar opencode

Tienes dos opciones:

Opción A — Automática (recomendada)

Descarga el script: Descargar siac-opencode-setup.sh
Ejecuta el script y pega tu clave cuando la pida:
```
bash siac-opencode-setup.sh
```
El script consulta los modelos aprobados para tu usuario y genera la configuración automáticamente.

Opción B — Con ayuda de IA (Claude, ChatGPT, etc.)

Descarga este documento y entrégaselo a tu asistente de IA: Descargar instrucciones (MD)
Dile: "Configura opencode con SIAC usando mi clave de API: sk-..."
El asistente leerá las instrucciones, consultará los modelos disponibles y generará la configuración.

Opción C — Manual

Descarga la plantilla de configuración: Descargar opencode-config.json
Cópiala a ~/.config/opencode/opencode.json.
Reemplaza TU_CLAVE_AQUI por tu clave real (o usa una variable de entorno).
Ajusta los modelos según los que tengas aprobados.

3. Usar opencode

Abre una terminal en la carpeta de tu proyecto.
Ejecuta opencode.
Selecciona el modelo SIAC (ej. siac/glm-5.2).
Escribe lo que necesites: "Crea una función que valide emails", "Explica este error", etc.

El consumo de tokens se registra automáticamente en SIAC, igual que si usaras el complemento de Excel o Word.

4. Modelos disponibles

Los modelos que ves dependen de lo que el administrador haya aprobado para tu usuario. Para ver la lista actualizada, ejecuta:

curl -s https://ia.siac.com.co/v1/models \
  -H "Authorization: Bearer sk-TU_CLAVE"

Modelo	Nombre	Contexto
`glm-5.2`	GLM-5.2	198 K
`glm-5.1`	GLM-5.1	198 K
`glm-5`	GLM-5	198 K
`deepseek-v3.1-terminus`	DeepSeek-V3.1-Terminus	128 K
`deepseek-v3.2`	DeepSeek-V3.2	160 K
`DeepSeek-V3`	DeepSeek-V3	128 K
`deepseek-v4-pro`	DeepSeek-V4-Pro	128 K
`deepseek-v4-flash`	DeepSeek-V4-Flash	128 K

5. Actualizar modelos

Cuando el administrador despligue modelos nuevos y los apruebe para tu usuario, puedes actualizar tu configuración:

Con el script: vuelve a ejecutar bash siac-opencode-setup.sh. Detectará los modelos nuevos y actualizará el config.
Con IA: vuelve a entregar el documento MD a tu asistente y dile "Actualiza mi configuración de opencode".
Manual: consulta /v1/models con tu clave y añade los modelos nuevos al JSON.

Solo verás los modelos que el administrador haya aprobado para tu usuario. Si no ves un modelo, pide que te lo habiliten.

6. Solución de problemas

Error 401 "API key inválida o revocada": la clave es incorrecta o fue revocada. Crea una nueva en Ajustes.
Error 403 "No tienes permiso para usar el modelo": el modelo no está aprobado para tu usuario. Pide al administrador que lo habilite.
Error 429 "límite mensual de costo": alcanzaste tu límite mensual. Contacta al administrador para aumentarlo.
opencode no muestra modelos SIAC: verifica que ~/.config/opencode/opencode.json exista y tenga el provider siac.
No hay conexión: verifica que puedas acceder a https://ia.siac.com.co/health.