Ir al contenido principal

Instalar y usar OpenCode

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

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

Más información en la página de OpenCode y en la documentación oficial de OpenCode.

Instalació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 con Homebrew en macOS y Linux:

brew install anomalyco/tap/opencode

Conectar con Coderen​

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

Utiliza en él el endpoint de Coderen y los modelos permitidos:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-corporate-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Corporate Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_CORPORATE_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-corporate-coderen/gpt-5.6-luna",
  "small_model": "ai-corporate-coderen/gpt-5.6-luna"
}

Luego pon la clave API como variable de entorno.

macOS y Linux​

export AI_CORPORATE_CODEREN_API_KEY="aic.tu-clave-api"

Windows​

setx AI_CORPORATE_CODEREN_API_KEY "aic.tu-clave-api"

Abre una nueva terminal después.

Iniciar OpenCode​

Ve al directorio del proyecto:

cd ruta/a/tu/proyecto

Inicia OpenCode:

opencode

Dentro de OpenCode, usa la selección de modelo para elegir el modelo AI-Corporate Coderen si no ocurre automáticamente.

Trabajar con seguridad con OpenCode​

Como OpenCode funciona de forma agentica, es importante revisar los cambios.

Procedimiento recomendado:

  1. Trabaja en un repositorio git.
  2. Empieza con tareas pequeñas.
  3. Revisa 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 guardar la clave de API de Coderen en un archivo local .env en la carpeta del proyecto:

AI_SCHOOL_CODEREN_API_KEY=ais.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_SCHOOL_CODEREN_API_KEY="ais.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 la endpoint de Coderen de AI-Corporate no admite.

WhatsApp