Instalar y usar OpenCode

OpenCode es una herramienta de codificación con capacidades de agente. La herramienta está disponible como aplicación de terminal, aplicación de escritorio y extensión de IDE.

AI-Public recomienda OpenCode para desarrolladores, administradores y otros usuarios avanzados. OpenCode puede adaptar archivos y desarrollar tareas de forma autónoma. Por ello, siempre verifica los cambios propuestos.

Más información se encuentra en la sitio web de OpenCode y en la documentación oficial de OpenCode.

Installación

La instalación más sencilla según la documentación de OpenCode es:

curl -fsSL https://opencode.ai/install | bash

También puedes instalar OpenCode con Node.js:

npm install -g opencode-ai

O utilizando Homebrew en macOS y Linux:

brew install anomalyco/tap/opencode

Conexión con Coderen (Coder)

OpenCode soporta proveedores compatibles con OpenAI personalizados. Crea un archivo opencode.json en la carpeta del proyecto.

Utiliza allí el endpoint de Coderen y los modelos permitidos:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-public-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Public Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-public-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_PUBLIC_CODEREN_API_KEY}"
      },
      "models": {
        "gpt-5.4-mini": {
          "name": "GPT-5.4 mini"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "ai-public-coderen/gpt-5.4-mini",
  "small_model": "ai-public-coderen/gpt-5.4-mini"
}

Configura la clave API como variable de entorno.

macOS y Linux

export AI_PUBLIC_CODEREN_API_KEY="aip.tu-clave-api"

Windows

setx AI_PUBLIC_CODEREN_API_KEY "aip.tu-clave-api"

Abre una nueva terminal después.

Iniciar OpenCode

Ve a la carpeta del proyecto:

cd ruta/a/tu/proyecto

Inicia OpenCode:

opencode

Usa la selección de modelos en OpenCode para elegir el modelo AI-Public Coderen si aún no se realiza automáticamente.

Trabajar con seguridad con OpenCode

Como OpenCode funciona de forma basada en agente, es importante verificar los cambios.

Procedimiento recomendado:

1. Trabaja en un repositorio git.
2. Comienza con tareas pequeñas.
3. Verifica las diffs antes de usar el código.
4. Prueba la aplicación tras los cambios.
5. Commita solo los cambios que entiendas.

Variables de entorno y OpenCode

Para OpenCode puedes almacenar la clave de API de Coderen en un archivo local .env en la carpeta del proyecto:

AI_PUBLIC_CODEREN_API_KEY=aip.tu-clave-api

Asegúrate de que OpenCode cargue realmente esta variable de entorno. En PowerShell también puedes establecer la variable temporalmente para la terminal actual:

$env:AI_PUBLIC_CODEREN_API_KEY="aip.tu-clave-api"

Si ves Authorization header with Bearer token is required, la herramienta no enviará la clave como Authorization: Bearer .... Si ves Unknown parameter, elimina las configuraciones específicas del proveedor que el endpoint de Coderen de AI-Public no admite.