Instalación de OpenCode y conexión de DeepSeek

OpenCode es un agente de programación abierto que reside directamente en la terminal. Puede leer archivos de proyecto, editar código, ejecutar comandos y pruebas, buscar en el repositorio y trabajar con git, casi lo mismo que hacen Claude Code y otros agentes de consola. La principal diferencia es que OpenCode no está vinculado a un solo proveedor modelo: a través de él se pueden conectar docenas de proveedores, incluido DeepSeek. En esta publicación describiré la instalación del agente y la conexión de DeepSeek a él.

Lo que necesitas

Sólo necesitas dos cosas para funcionar:

• Terminal moderno. WezTerm, Alacritty, Ghostty, Kitty o cualquier otro servirá.
• Clave API del proveedor. En nuestro caso, DeepSeek.

No se requiere Node.js si instala el agente con un script de instalación estándar: el binario llega listo para usar.

Instalación

La forma más sencilla es el script de instalación oficial:

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

Detectará la plataforma y colocará el archivo ejecutable en PATH. Después de la instalación, debes verificar que todo esté en su lugar:

opencode --version

Si el comando muestra la versión, la instalación fue exitosa.

Instalación utilizando otros métodos

Si prefiere los administradores de paquetes, existen varias opciones. A través de Node.js:

npm install -g opencode-ai

Bun, pnpm y Yarn pueden hacer lo mismo:

bun install -g opencode-ai
pnpm install -g opencode-ai
yarn global add opencode-ai

macOS y Linux tienen Homebrew. Tenga en cuenta: lo que se recomienda es el toque de los desarrolladores, y no la fórmula oficial; se actualiza con menos frecuencia:

brew install anomalyco/tap/opencode

En ArchLinux:

sudo pacman -S opencode
paru -S opencode-bin

El primer comando instala la versión estable desde el repositorio, el segundo, la última versión de AUR.

Instalación en Windows

En Windows se recomienda trabajar vía WSL: de esta forma el rendimiento es mayor y la compatibilidad con las capacidades del agente es completa. Pero también existen métodos nativos. Vía Chocolatey, Scoop o npm:

choco install opencode
scoop install opencode
npm install -g opencode-ai

También hay una opción a través de Mise, así como un contenedor Docker:

mise use -g github:anomalyco/opencode
docker run -it --rm ghcr.io/anomalyco/opencode

Finalmente, el binario terminado siempre se puede obtener de la página de lanzamientos en GitHub.

Tecla de búsqueda profunda

La clave se crea en su cuenta personal de DeepSeek. Vaya a platform.deepseek.com, abra la sección con claves API y haga clic en crear una nueva clave. Es mejor guardar la cadena resultante inmediatamente: se mostrará sólo una vez.

Conexión DeepSeek

Luego todo se hace dentro del propio agente. Inicie OpenCode en la terminal:

opencode

En la interfaz ejecutamos el comando de conexión:

/connect

En la lista de proveedores que se abre, busque DeepSeek, selecciónelo e inserte la clave API. Las claves agregadas de esta manera se guardan en un archivo:

~/.local/share/opencode/auth.json

Después de conectarnos, solo queda seleccionar el modelo con el comando:

/models

Los modelos de DeepSeek estarán disponibles en la lista, incluidos deepseek-v4-pro, deepseek-flash y deepseek-v4-flash. Para el trabajo rutinario en el repositorio, la opción flash es suficiente; Para tareas complejas, tiene sentido cambiar a profesional.

Configuración mediante config

Si no desea almacenar la clave a través de un maestro o necesita configurar su propia dirección API, el proveedor se describe directamente en el archivo de configuración opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "deepseek": {
      "options": {
        "baseURL": "https://api.deepseek.com"
      }
    }
  }
}

El campo baseURL es útil si utiliza un proxy o su propia puerta de enlace. En este caso, es conveniente transferir la clave a una variable de entorno:

export DEEPSEEK_API_KEY=ваш_ключ_deepseek
opencode

Esta opción es buena para CI y lanzamientos únicos: la clave no termina en el almacenamiento, sino que vive solo en el entorno del proceso.

Primer lanzamiento del proyecto

Vaya al directorio del proyecto e inicie el agente:

cd ваш_проект
opencode

El primer paso es inicializarlo:

/init

OpenCode analizará la estructura del proyecto y creará un archivo AGENTS.md, un análogo de las instrucciones del agente. Vale la pena comprometer este archivo con git: ayuda al agente a comprender las convenciones y patrones adoptados en el proyecto.

Cómo usarlo

El trabajo se estructura de forma muy parecida a como ocurre con otros agentes. Un par de trucos que debes saber de inmediato:

• Modo de planificación. La tecla Tab cambia el agente entre los modos de planificación y ensamblaje. En el primero, sólo sugiere cómo solucionar el problema y no cambia nada; conviene comprobar la idea antes de realizar cambios.
• Enlaces a archivos. La tecla @ abre una búsqueda difusa en los archivos del proyecto para transferir un archivo específico al agente en el contexto.
• Revertir cambios. El comando /undo deshace las últimas ediciones y devuelve la solicitud original, /redo las devuelve. Puedes retroceder varios pasos seguidos.
• Compartir una conversación. El comando /share crea un enlace a la conversación actual y lo copia en el portapapeles. De forma predeterminada, las conversaciones no se publican en ningún lugar.

Para cambios simples, no es necesario cambiar al modo de planificación, sino describir inmediatamente lo que se debe hacer y especificar los archivos mediante @.

A qué prestar atención

Un par de puntos prácticos. OpenCode no requiere suscripción: usted paga al proveedor directamente cuando gasta tokens, por lo que las sesiones largas con DeepSeek son previsiblemente más baratas que los mejores modelos. La clave se almacena localmente en auth.json; vale la pena considerar esto en una máquina compartida, pero para entornos de otras personas una variable de entorno es más confiable.

Y una cosa más: la calidad de las respuestas a problemas arquitectónicos complejos difiere entre modelos de diferentes clases, por lo que para el diseño tiene sentido tomar un modelo más fuerte y dejar la rutina por uno rápido y barato.

Enlaces

https://opencode.ai/
https://opencode.ai/docs/
https://opencode.ai/docs/providers/
https://github.com/anomalyco/opencode
https://platform.deepseek.com/api_keys
https://api-docs.deepseek.com

Fuentes

https://opencode.ai/docs/
https://opencode.ai/docs/providers/#deepseek
https://github.com/anomalyco/opencode/releases
https://models.dev/