Saltar al contenido principal
Opencode es una herramienta interactiva de línea de comandos que ayuda a los desarrolladores con tareas de ingeniería de software. Proporciona un asistente de codificación impulsado por IA directamente en tu terminal, permitiéndote construir, depurar y mantener código con soporte inteligente. Para instrucciones de instalación, consulta la documentación oficial de Opencode.

​
Pasos de Configuración

1

Crear un token de Gateway

Antes de configurar Opencode, necesitas un token de Gateway de Zylon.Consulta Gestión de Tokens para obtener instrucciones detalladas sobre cómo crear tokens de Gateway.
2

Establecer variables de entorno

Agrega lo siguiente a tu archivo de configuración de shell (~/.zshrc o ~/.bashrc):
echo 'export ZYLON_BASE_URL="https://your-host/api/gpt"' >> ~/.zshrc
echo 'export ZYLON_API_TOKEN="your-gateway-token"' >> ~/.zshrc
echo 'export ZYLON_MODEL="default"' >> ~/.zshrc
source ~/.zshrc
Reemplaza your-host con la URL de tu instancia de Zylon y your-gateway-token con tu token de Gateway real. El modelo predeterminado es default.
Nunca hagas commit de variables de entorno que contengan tokens al control de versiones. Agrégalas a tu .gitignore.
Confirma que las variables se establecieron correctamente:
echo $ZYLON_BASE_URL
echo $ZYLON_API_TOKEN
echo $ZYLON_MODEL
3

Configurar Opencode

Crea el directorio de configuración de Opencode:
mkdir -p ~/.config/opencode
Crea el archivo de configuración en ~/.config/opencode/opencode.json:
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "{env:ZYLON_BASE_URL}/v1",
        "apiKey": "{env:ZYLON_API_TOKEN}"
      },
      "models": {
        "{env:ZYLON_MODEL}": {
          "name": "Zylon - {env:ZYLON_MODEL}",
          "limit": {
            "context": 128000,
            "output": 20000
          }
        }
      }
    }
  }
}
Para más detalles sobre las opciones de configuración de Opencode, consulta la documentación oficial de Opencode.
4

Ejecutar Opencode

Prueba tu configuración ejecutando:
opencode
En el primer lanzamiento, necesitarás cambiar al modelo Zylon:
  1. Presiona Ctrl+P para abrir el panel de comandos
  2. Selecciona “Switch Model”
  3. Busca y selecciona “Zylon - Default”
Una vez seleccionado, Opencode se conectará a tu instancia de Zylon y estará listo para ayudarte con tareas de codificación.

​
Limitaciones

  • Las imágenes no son compatibles

​
Solución de Problemas

​
Errores de conexión

  • Verifica que ZYLON_BASE_URL sea correcta y accesible
  • Asegúrate de que tu token de Gateway sea válido y no haya expirado
  • Comprueba la conectividad de red con tu instancia de Zylon

​
Fallos de autenticación

  • Confirma que el token se copió correctamente sin espacios en blanco adicionales
  • Regenera el token si pudo haber sido comprometido
  • Verifica que el token tenga los permisos apropiados