← Volver al listado de tecnologías ← Índice de OpenCode

Capitulo 2: Instalacion

Por: Artiko
opencodeaiinstalacionsetup

Capitulo 2: Instalacion

< Volver al Indice del Tutorial

Requisitos Previos

Antes de instalar OpenCode necesitas:

Metodos de Instalacion

Instalador Oficial (Recomendado)

El metodo mas rapido. Detecta tu sistema operativo y arquitectura automaticamente:

curl -fsSL https://opencode.ai/install | bash

Este script descarga el binario correcto, lo instala en tu PATH y configura el autocompletado.

npm

npm install -g opencode

Bun

bun add -g opencode

Homebrew (macOS / Linux)

brew install opencode

Scoop (Windows)

scoop install opencode

Chocolatey (Windows)

choco install opencode

Docker

Para entornos aislados o CI/CD:

docker run -it --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
  ghcr.io/opencode-ai/opencode

Monta tu directorio de trabajo y pasa las variables de entorno con las API keys necesarias.

Verificar la Instalacion

Despues de instalar, verifica que OpenCode funcione correctamente:

opencode --version

Deberia mostrar algo como:

opencode v1.2.15

Para ver todos los comandos disponibles:

opencode --help

Actualizar OpenCode

OpenCode incluye un mecanismo de actualizacion integrado:

opencode upgrade

Esto descarga e instala la ultima version disponible.

Auto-Update

Puedes configurar actualizaciones automaticas en tu archivo opencode.json:

{
  "autoupdate": true
}

Los valores posibles son:

ValorComportamiento
trueActualiza automaticamente al iniciar
falseNunca actualiza automaticamente
"notify"Notifica que hay una nueva version pero no actualiza

Si prefieres controlar manualmente las versiones (recomendado en equipos), usa false y ejecuta opencode upgrade cuando lo necesites.

Desinstalar OpenCode

Para remover OpenCode completamente:

opencode uninstall

Esto elimina el binario y la configuracion global. Si instalaste con npm o bun:

npm uninstall -g opencode
# o
bun remove -g opencode

Instalacion en Entornos Especiales

Sin Acceso a Internet

Si tu maquina no tiene acceso a internet, puedes descargar el binario desde la pagina de releases en otra maquina y copiarlo manualmente:

# En la maquina con internet
curl -fsSL https://github.com/opencode-ai/opencode/releases/latest/download/opencode-linux-x64 -o opencode

# Copiar al servidor
scp opencode usuario@servidor:/usr/local/bin/
ssh usuario@servidor "chmod +x /usr/local/bin/opencode"

CI/CD

Para pipelines de CI/CD, el instalador oficial es el metodo mas limpio:

curl -fsSL https://opencode.ai/install | bash
opencode run "tu prompt aqui"

Problemas Comunes

”command not found” despues de instalar

Tu shell no ha recargado el PATH. Ejecuta:

source ~/.bashrc
# o para zsh
source ~/.zshrc

Permisos insuficientes

Si el instalador falla por permisos:

curl -fsSL https://opencode.ai/install | sudo bash

O instala en tu directorio local:

curl -fsSL https://opencode.ai/install | INSTALL_DIR=$HOME/.local/bin bash

Conflicto con otro paquete “opencode”

Si ya tienes un paquete llamado opencode instalado, desinstalalo primero o usa el instalador oficial que instala el binario directamente.

Siguiente: Capitulo 3: Primeros Pasos —>

← Volver al listado de tecnologías ← Índice de OpenCode