beginner⏱30 minLecció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.

Instalación y Primera Configuración

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`

ℹ️Note

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

💡Tip

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

⚠️Warning

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

💡Tip

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

Practice Questions

Practice Question

¿Cuál es la versión mínima de Node.js requerida para OpenCode?

Practice Question

¿Dónde debe almacenar las claves API para OpenCode?

Practice Question

¿Qué ubicación de archivo de configuración se recomienda para proyectos de equipo?

Practice Question

¿Qué comando inicia una sesión interactiva de OpenCode?

Practice Question

¿Qué gestores de paquetes se pueden usar para instalar OpenCode?

✅Success

Key Takeaways

OpenCode requiere Node.js 18+ y se puede instalar a través de npm, yarn o pnpm
La configuración se almacena en opencode.json o .opencode/config.json
Las claves API deben almacenarse en variables de entorno o archivos .env
La ubicación .opencode/config.json es preferida para proyectos de equipo
Ejecute opencode para iniciar una sesión interactiva
Se soportan múltiples proveedores LLM (OpenAI, Anthropic, Google)

Progreso40%

Qué es OpenCode y por qué usarlo

Tu Primera Sesión de Codificación con IA

Contenido del Curso

1. Qué es OpenCode y por qué usarlo 2. Instalación y Primera Configuración 3. Tu Primera Sesión de Codificación con IA 4. Comprendiendo la Interfaz CLI 5. Configuración Básica con opencode.json