Verificado documentalmente el 29 de julio de 2026. El procedimiento se contrastó de nuevo con la documentación vigente de DeepSeek y OpenCode. No se introdujo una clave real ni se ejecutó una solicitud facturable; para validar la respuesta, el modelo y el coste se necesita una API key de DeepSeek con saldo.
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, como recomienda DeepSeek para reducir posibles incompatibilidades. Después ejecuta opencode, escribe /connect, selecciona DeepSeek e introduce tu clave API. Usa /models para elegir DeepSeek V4 Pro o DeepSeek V4 Flash. Este flujo utiliza el proveedor DeepSeek incorporado en OpenCode y la API alojada por DeepSeek; no descarga los 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 | Es la selección mostrada por la guía de DeepSeek para OpenCode; adecuada para tareas de agente y cambios complejos. |
| DeepSeek V4 Flash | deepseek/deepseek-v4-flash | Alternativa para consultas, exploración e iteraciones más rápidas. |
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.
El proveedor también reconoce la variable DEEPSEEK_API_KEY, y OpenCode puede cargar variables del entorno o de un archivo .env. Si eliges esa ruta, mantén .env fuera de Git y evita exponer el valor en el historial del terminal, procesos, capturas o registros de CI. Para retirar una credencial guardada por OpenCode, ejecuta opencode auth logout y selecciona DeepSeek; revoca además 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.
- Los modelos son de texto: el catálogo de OpenCode marca V4 Pro y Flash con entrada y salida de texto. No presentes esta ruta como visión nativa.
- 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í. Selecciónalo con /models o usa deepseek/deepseek-v4-flash. Confirma siempre los IDs con opencode models deepseek --refresh.
¿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.