Instalación y Primera Configuración

Principiante⏱30 min📖3 min de lecturaLección 2 de 5

Instalación y Primera Configuración

Instala OpenCode en tu sistema y configúralo con tu primer proveedor LLM. Configura claves API, verifica la instalación y ejecuta tu primer comando.

Prerrequisitos

Antes de instalar OpenCode, asegúrese de tener:

Requisito	Versión Mínima	Cómo Verificar
Node.js	18.0+	`node --version`
npm	8.0+	`npm --version`
Git	2.0+	`git --version`

ℹ️Nota

OpenCode es una aplicación Node.js distribuida a través de npm. Funciona en macOS, Linux y Windows.

Instalación

Usando npm (Recomendado)

bash

npm install -g opencode

Usando yarn

bash

yarn global add opencode

Usando pnpm

bash

pnpm add -g opencode

Verificar Instalación

bash

opencode --version

Salida esperada:

opencode v1.x.x

💡Consejo

Si ve "command not found", asegúrese de que el directorio bin global de npm esté en su PATH.

Configuración Inicial

Paso 1: Crear Directorio de Configuración

bash

mkdir -p .opencode

Paso 2: Crear opencode.json

Cree opencode.json en la raíz de su proyecto:

json

{
  "$schema": "https://opencode.ai/config.json",
  "agents": {
    "default": {
      "model": "gpt-4o",
      "description": "Asistente de codificación de propósito general"
    }
  }
}

Paso 3: Configurar Claves API

Cree un archivo .env en la raíz de su proyecto:

bash

# OpenAI
OPENAI_API_KEY=sk-your-api-key-here

# Anthropic (opcional)
ANTHROPIC_API_KEY=sk-ant-your-api-key-here

# Google (opcional)
GOOGLE_API_KEY=your-google-api-key-here

⚠️Advertencia

Nunca envíe claves API a control de versiones. Agregue .env a su archivo .gitignore.

Configuración de Proveedor

OpenAI

json

{
  "providers": {
    "openai": {
      "apiKey": "${OPENAI_API_KEY}",
      "model": "gpt-4o"
    }
  }
}

Anthropic

json

{
  "providers": {
    "anthropic": {
      "apiKey": "${ANTHROPIC_API_KEY}",
      "model": "claude-sonnet-4-20250514"
    }
  }
}

Google

json

{
  "providers": {
    "google": {
      "apiKey": "${GOOGLE_API_KEY}",
      "model": "gemini-pro"
    }
  }
}

Primera Ejecución

Iniciar OpenCode

bash

opencode

Debería ver:

OpenCode v1.x.x
Type your message or /help for commands
>

Probar la Conexión

Escriba un mensaje simple:

> Hola, ¿puedes ayudarme con mi código?

Si es exitoso, la IA responderá con un saludo y preguntará cómo puede ayudar.

Ubicaciones del Archivo de Configuración

OpenCode busca la configuración en este orden:

Prioridad	Ubicación	Propósito
1	`.opencode/config.json`	Específico del proyecto (preferido)
2	`opencode.json`	Específico del proyecto (heredado)
3	`~/.config/opencode/config.json`	Valores predeterminados del usuario

💡Consejo

Use .opencode/config.json para proyectos de equipo. Puede controlar selectivamente la versión mientras mantiene los datos sensibles en .env.

Comandos Básicos

Comando	Descripción
`opencode`	Iniciar sesión interactiva
`opencode --version`	Mostrar versión
`opencode --help`	Mostrar ayuda
`opencode config`	Abrir configuración
`opencode providers`	Listar proveedores disponibles

Solución de Problemas

Problemas Comunes

Problema	Causa	Solución
"Command not found"	npm PATH no configurado	Ejecute `npm config get prefix` y agregue al PATH
"Invalid API key"	Formato de clave incorrecto	Verifique que la clave comience con `sk-` (OpenAI) o `sk-ant-` (Anthropic)
"Rate limit exceeded"	Demasiadas solicitudes	Espere o mejore su plan de API
"Model not found"	Nombre de modelo incorrecto	Consulte la documentación del proveedor para nombres de modelo válidos