Verificación documental original: 29 de julio de 2026; revisión actual: 24 de agosto de 2026. La receta oficial recomienda OpenCode 1.14.24 o posterior, conectar el proveedor deepseek mediante /connect y seleccionar DeepSeek V4 Pro. No se introdujo una clave, no se inició una sesión y no se ejecutó una solicitud facturable.
Nota de independencia: DeepSeek-Espanol.chat es un sitio independiente y no pertenece a DeepSeek ni a OpenCode. OpenCode es una herramienta de terceros. La guía de integración de DeepSeek con OpenCode se ofrece como referencia para desarrolladores e incluye una advertencia: DeepSeek no garantiza la eficacia ni la seguridad del agente.
Respuesta rápida
Instala OpenCode y actualiza preferiblemente a la versión 1.14.24 o posterior. Después ejecuta opencode, escribe /connect, selecciona DeepSeek, introduce tu clave y elige DeepSeek V4 Pro, como muestra la receta oficial. V4 Flash puede utilizarse si aparece tras actualizar el catálogo con opencode models deepseek --refresh. Este flujo usa el proveedor integrado y la API alojada por DeepSeek; no descarga pesos ni ejecuta el modelo localmente.
Qué ruta configura esta guía
OpenCode admite numerosos proveedores. Aquí conectamos directamente una clave de DeepSeek Platform al proveedor llamado deepseek. No usamos OpenCode Zen, OpenCode Go, OpenRouter ni un proxy personalizado. Esos servicios tienen credenciales, endpoints y facturación distintos, aunque puedan mostrar modelos con nombres parecidos.
La configuración directa conserva una cadena sencilla: OpenCode prepara el contexto y las herramientas, y las solicitudes del modelo se envían a https://api.deepseek.com. El consumo se carga a tu cuenta de DeepSeek. Para comprender autenticación, solicitudes y modelos fuera de OpenCode, utiliza nuestra guía general de DeepSeek API.
Requisitos previos
| Requisito | Detalle |
|---|---|
| OpenCode | Se recomienda utilizar OpenCode 1.14.24 o posterior para reducir posibles incompatibilidades, de acuerdo con la guía de DeepSeek. |
| Terminal | Un emulador moderno. En Windows, OpenCode recomienda WSL para la experiencia más compatible. |
| Clave API | Una credencial creada en DeepSeek Platform y protegida como secreto. |
| Proyecto de prueba | Un repositorio sin secretos para verificar lectura, herramientas y permisos antes de usar código real. |
1. Instalar OpenCode
La documentación de instalación de OpenCode publica varios métodos. Usa uno, no todos.
Script de instalación para macOS o Linux
curl -fsSL https://opencode.ai/install | bashnpm
npm install -g opencode-aiHomebrew en macOS o Linux
brew install anomalyco/tap/opencodeEn Windows puedes instalarlo con npm, Chocolatey o Scoop, pero la recomendación principal de OpenCode es usar Windows Subsystem for Linux. Evita copiar binarios desde sitios que no estén enlazados por el proyecto.
2. Comprobar y actualizar la versión
opencode --versionSi el resultado es anterior a 1.14.24, DeepSeek recomienda actualizar OpenCode para reducir posibles incompatibilidades antes de conectar V4:
opencode upgradeEl comando de actualización y las opciones de instalación se describen en la referencia oficial de OpenCode CLI. Si instalaste mediante un gestor de paquetes, también puedes actualizar con ese mismo gestor.
3. Conectar la clave de DeepSeek
- Crea una clave en DeepSeek Platform. Cópiala una vez y no la incluyas en capturas, prompts ni archivos versionados.
- Abre el proyecto desde una terminal y ejecuta
opencode. - En la interfaz de texto escribe
/connect. - Busca y selecciona DeepSeek, no OpenCode Go ni un agregador con un modelo DeepSeek.
- Pega la clave cuando OpenCode la solicite.
- Escribe
/modelsy elige DeepSeek V4 Pro. También puedes elegir Flash si encaja mejor con la tarea.
La documentación de proveedores de OpenCode confirma esta secuencia: consola de DeepSeek, /connect, clave y /models. Como alternativa no interactiva inicial, ejecuta opencode auth login y selecciona DeepSeek.
4. Elegir el modelo correcto
| Modelo | ID completo en OpenCode | Orientación práctica |
|---|---|---|
| DeepSeek V4 Pro | deepseek/deepseek-v4-pro | ID estable; actualmente sirve DeepSeek-V4-Pro-0813. Es la selección mostrada por la receta oficial. |
| DeepSeek V4 Flash | deepseek/deepseek-v4-flash | ID estable; actualmente sirve DeepSeek-V4-Flash-0731. Úsalo si aparece tras actualizar el catálogo. |
OpenCode expresa los modelos como proveedor/modelo. Los IDs anteriores combinan el proveedor deepseek con los IDs oficiales de la API. La guía de modelos de OpenCode explica el formato y el orden de selección. No uses deepseek-chat o deepseek-reasoner en una configuración nueva de V4.
5. Fijar un modelo predeterminado
Si quieres usar Pro en todas tus sesiones, crea o edita ~/.config/opencode/opencode.json. Para un solo repositorio, coloca opencode.json en la raíz del proyecto. La configuración del proyecto puede reemplazar la global.
{
"$schema": "https://opencode.ai/config.json",
"model": "deepseek/deepseek-v4-pro"
}No insertes la clave API en este archivo. La referencia de configuración de OpenCode documenta las ubicaciones y la precedencia. Un archivo ubicado en la raíz del repositorio puede terminar en Git si no revisas los cambios.
6. Verificar credencial, catálogo y respuesta
Primero verifica el nombre del proveedor registrado. Este comando lista proveedores autenticados, no necesita imprimir la clave:
opencode auth listDespués actualiza el catálogo y confirma el ID exacto:
opencode models deepseek --refreshPor último, realiza una solicitud pequeña y no sensible. Esta llamada puede consumir saldo de DeepSeek:
opencode run -m deepseek/deepseek-v4-pro "Responde exactamente: OK"Una respuesta correcta confirma autenticación, resolución del modelo y comunicación básica. Aún debes probar las herramientas por separado. En un repositorio desechable, solicita que lea un archivo sin editarlo y revisa qué permisos pide antes de autorizar cambios.
Dónde guarda OpenCode la clave
Cuando usas /connect o opencode auth login, OpenCode documenta el almacenamiento de credenciales en ~/.local/share/opencode/auth.json. No afirma que ese archivo sea un llavero del sistema ni que su contenido esté cifrado. Protege la cuenta del sistema, limita permisos del archivo y no lo copies a informes de soporte.
La ruta documentada aquí es /connect o opencode auth login. OpenCode admite cargar variables de entorno y archivos .env, pero esta revisión no verificó que el proveedor DeepSeek expanda automáticamente un nombre concreto como DEEPSEEK_API_KEY sin configuración adicional. Si eliges una ruta personalizada, confirma la referencia exacta en tu configuración, mantén .env fuera de Git y evita exponer el valor en historial, procesos, capturas o CI. Para retirar una credencial guardada, ejecuta opencode auth logout, selecciona DeepSeek y revoca la clave en la plataforma si pudo filtrarse.
Endurecer permisos antes de usar el modo agente
OpenCode documenta que, sin configuración adicional, permite operaciones sin aprobación explícita. Eso puede ser demasiado permisivo para un repositorio real. Obliga a pedir confirmación antes de editar archivos o ejecutar comandos:
{
"$schema": "https://opencode.ai/config.json",
"model": "deepseek/deepseek-v4-pro",
"permission": {
"edit": "ask",
"bash": "ask"
}
}Las acciones disponibles son allow, ask y deny. La documentación de permisos de OpenCode permite crear reglas más granulares, como permitir lectura, preguntar antes de git commit y bloquear git push. Mantén copias de seguridad y revisa el diff aunque el modelo afirme que el cambio es seguro.
Límites importantes
- No es ejecución local: OpenCode es el agente, pero DeepSeek V4 se consulta mediante la API alojada. Necesitas red, una clave válida y saldo disponible.
- Vision no está documentado en esta ruta: el catálogo general de DeepSeek incluye
deepseek-v4-flash-vision-exp, pero la receta del proveedor directo de OpenCode documenta Pro y Flash como modelos de texto. OpenCode Go es un servicio distinto y no valida Vision para una clave de DeepSeek Platform. No afirmes compatibilidad con imágenes por URL, base64 ofile_iden esta ruta sin documentación específica del proveedor o una prueba reproducible. Que Vision Exp admita imágenes en la API de DeepSeek no demuestra por sí solo que OpenCode las transmita correctamente mediante este proveedor. - El agente puede actuar: leer no equivale a editar, pero las herramientas pueden modificar archivos o ejecutar comandos si los permisos lo permiten.
- El resultado requiere revisión: llamadas a herramientas correctas no garantizan código correcto, pruebas suficientes ni ausencia de vulnerabilidades.
- El razonamiento tiene requisitos de historial: en solicitudes con herramientas, DeepSeek exige devolver
reasoning_contenten las rondas posteriores. El documento oficial de Thinking Mode indica que omitirlo produce un 400. Usa el proveedor integrado y una versión compatible en vez de copiar configuraciones antiguas.
Solución de problemas
DeepSeek no aparece en el selector
Ejecuta opencode auth list y después opencode models deepseek --refresh. Revisa los ajustes disabled_providers y enabled_providers: si DeepSeek está deshabilitado o excluido de la lista permitida, sus modelos no aparecerán aunque la clave exista.
El modelo devuelve un error sobre reasoning_content
Comprueba la versión, actualiza OpenCode, inicia una sesión nueva y selecciona el proveedor integrado deepseek. Elimina configuraciones manuales antiguas que redefinan el mismo proveedor. No cambies al endpoint Anthropic como solución automática: esta guía usa la integración incorporada y compatible con OpenAI.
Aparece 401, 402, 429, 500 o 503
Separa credencial, saldo, concurrencia y fallos del servidor. No repitas indefinidamente una solicitud que puede editar archivos. Nuestra guía de errores de DeepSeek API explica cada estado y cuándo rotar la clave, reducir concurrencia o aplicar reintentos con espera.
OpenCode no puede editar o ejecutar un comando
Puede ser el comportamiento esperado de una regla ask o deny. Lee la solicitud de permiso y autoriza solo la operación concreta. No conviertas todo a allow para eliminar una advertencia sin entender el comando.
Preguntas frecuentes
¿OpenCode ejecuta DeepSeek en mi ordenador?
No en esta configuración. OpenCode se ejecuta en tu entorno, pero envía contexto y solicitudes a la API de DeepSeek. Una instalación con pesos locales sería otro procedimiento.
¿OpenCode Go y el proveedor DeepSeek son lo mismo?
No. Esta página usa una clave de DeepSeek y el proveedor deepseek. OpenCode Go es un servicio separado con su propia cuenta y facturación.
¿Puedo usar V4 Flash?
Sí, si aparece después de actualizar el catálogo. Ejecuta opencode models deepseek --refresh, selecciónalo con /models o usa deepseek/deepseek-v4-flash. El ID estable sirve actualmente DeepSeek-V4-Flash-0731.
¿Puedo usar Vision Exp o adjuntar imágenes?
No se ha verificado en esta ruta. La receta oficial del proveedor deepseek en OpenCode no documenta deepseek-v4-flash-vision-exp ni la entrega de imágenes. Que Vision exista en la API general o en un servicio distinto como OpenCode Go no prueba compatibilidad con esta configuración directa.
¿Hay una opción dentro de VS Code Copilot Chat?
Existe una ruta diferente mediante una extensión de terceros. Consulta DeepSeek en GitHub Copilot Chat y revisa su requisito de suscripción, el almacenamiento de la clave y el proxy de visión antes de instalarla.
Fuentes oficiales verificadas
- DeepSeek: Integrate with OpenCode.
- OpenCode: Providers.
- OpenCode: Models.
- DeepSeek: Models & Pricing.
- DeepSeek: Updates.
Registro de actualización — 24 de agosto de 2026: se añadieron las versiones actuales Flash-0731 y Pro-0813, se delimitó Vision fuera de la receta directa y se hizo más cauta la alternativa por variable de entorno. No se inició sesión, no se usó una clave y no se realizó una llamada API.