Ir al contenido principal

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-Corporate recomienda OpenCode para desarrolladores, administradores y otros usuarios avanzados. OpenCode puede modificar archivos y realizar tareas de forma autónoma. Por ello, siempre verifica las modificaciones propuestas.

Más información se encuentra en la sitio web 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 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-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.4-mini": {
          "name": "GPT-5.4 mini"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "ai-corporate-coderen/gpt-5.4-mini",
  "small_model": "ai-corporate-coderen/gpt-5.4-mini"
}

Después pon la clave API como variable de entorno.

macOS y Linux​

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

Windows​

setx AI_CORPORATE_CODEREN_API_KEY "aic.tu-api-llave"

Abre una nueva terminal después.

Iniciar OpenCode​

Ve a la carpeta del proyecto:

cd ruta/a/tu/proyecto

Inicia OpenCode:

opencode

Utiliza en OpenCode la selección de modelo para elegir el modelo AI-Corporate Coderen si aún no ocurre automáticamente.

Trabajar de forma segura con OpenCode​

Como OpenCode funciona con agentes, es importante revisar los cambios.

Procedimiento recomendado:

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

Variables de entorno y OpenCode​

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

AI_SCHOOL_CODEREN_API_KEY=ais.tu-api-llave

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_SCHOOL_CODEREN_API_KEY="ais.tu-api-llave"

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-Corporate no admite.