Ir al contenido principal

Instalar y usar OpenCode

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

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

Para más información, consulta la página de OpenCode y la documentación oficial de OpenCode.

Instalación​

La instalación más simple 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 con Homebrew en macOS y Linux:

brew install anomalyco/tap/opencode

Conectar con Coderen​

OpenCode admite proveedores compatibles con OpenAI personalizados. En el directorio del proyecto crea un archivo opencode.json.

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.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        }
      }
    }
  },
  "model": "ai-public-coderen/gpt-5.6-luna",
  "small_model": "ai-public-coderen/gpt-5.6-luna"
}

Después, establece 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​

Dirígete al directorio del proyecto:

cd ruta/a/tu/proyecto

Inicia OpenCode:

opencode

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

Trabajar con seguridad con OpenCode​

Como OpenCode es agente, es importante revisar los cambios.

Procedimiento recomendado:

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

Variables de entorno y OpenCode​

Para OpenCode, puedes guardar la clave de API de Coderen en un archivo .env local en el directorio 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 establecerla 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 configuraciones específicas del proveedor que no son compatibles con el endpoint de Coderen de AI-Public.

WhatsApp