Este tutorial solo describe el proceso de configuración en un entorno Windows, los métodos de verificación y dónde debe verificarse priorizamente si se produce un problema.
El nombre del modelo, la versión del cliente y el contenido del script oficial pueden actualizarse con el tiempo. En la práctica, por favor, prevalezca la información que se muestra actualmente en la página oficial de DeepSeek.
Referencias:
- Guía oficial de acceso al Codex de DeepSeek
- Scripto de configuración oficial de DeepSeek
Preparación: Solicitar la clave de API DeepSeek
Primero vaya a la consola de DeepSeek para crear una clave de API:
https://platform.deepseek.com/top_up
Consideraciones de seguridad API Key
Si la vieja clave alguna vez apareció en:
- Screenshot
- El chat
- Artículo Tutorial
- Almacenamiento de código
- Plataforma social
Por favor, deshacerlo de inmediato en la consola de DeepSeek y no continúe.
Nuevas claves de API:
- Sólo en su computadora
- No lo envíes a nadie.
- No muestre captura de pantalla
- No enviar al repositorio de código
Además, debe tenerse en cuenta:
El script de configuración oficial de DeepSeek no solo usa Key temporalmente en la ventana actual de PowerShell, sino que puede escribir información de autenticación en el directorio de configuración de usuario de Codex.
Por lo tanto, los siguientes directorios también deben ser protegidos como directorios sensibles:
C:\Users\你的用户名\.codex\
No suba todo .codex Carpetas, y no comparta los perfiles en ellas.
La página API Key en la captura de pantalla del tutorial sugiere:
- El código debe ser
- Utilice rutas relativas para guardar recursos de imagen para evitar el cambio de computadoras o la pérdida de validez después de la publicación.
Ejemplo:
Ejecutar el script de configuración oficial de DeepSeek
Abra Windows PowerShell y ejecute:
irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex
Este comando:
- Descargar un script de PowerShell desde la dirección oficial de DeepSeek
- Proceso de configuración ahora mismo
Aunque la dirección proviene de los oficiales, hay que tener en cuenta:
La ejecución directa de scripts remotos sigue siendo un riesgo en sí mismo.
No copie comandos similares de tutoriales desconocidos.
Si no te sientes cómodo, puedes:
- Abrir el contenido del script primero
- Fuente confirmada
- Re-execución
Configuración de pasos
Después de que aparece el menú del script:
- Ingresos:
1
- Seleccione:
deepseek-v4-flash
- Presione el prompt para introducir la nueva clave de API DeepSeek creada
- Esperar a que el script complete la configuración
Alertas sobre deepseek-v4 - pro
La presencia de algunos nombres de modelos en el menú de scripts no significa que la versión actual del cliente y el estado de acceso oficial estén completamente compatibles.
No elija un modelo solo porque ve el nombre en el menú.
La forma correcta:
- Según la documentación oficial actual de DeepSeek
- Confirmar el modelo Nombre
- Confirmar los requisitos de versión del cliente
- Confirmar el acceso recomendado
No lo haga:
- Coloque la clave en el comando
- Escribir una clave en un script abierto
- Mostrar la clave real en el artículo
III. Reiniciar el Codex y realizar la verificación en tres fases
Una vez completada la configuración:
- Salida completa del lado de escritorio de Codex
- Reabrir el Codex
Luego no empiece a modificar el proyecto directamente.
Se recomienda verificar en el siguiente orden.
Paso 1: Prueba de solicitud de modelo básico
Ingresos:
只回复 OK
Si regresas:
OK
Descripción:
- Solicitud de API básicamente exitosa
- La configuración del proveedor puede ser correcta
Si se presenta:
- 401
- El modelo no existe
- Error del proveedor
No dejes que Codex maneje el proyecto.
Prioridad de verificación:
- API Key
- Nombre del modelo
- Configuración de proveedores
- Versión Cliente
Paso 2: Prueba de archivos de solo lectura
Ingresos:
只读当前工作区中的一个文本文件，告诉我它主要写了什么，不要修改任何文件
Para confirmar:
- El Codex tiene acceso al espacio de trabajo
- La función de lectura de archivos es normal
Paso 3: Prueba de llamada de herramienta simple
Ingresos:
只列出当前工作区中的文件名，不要创建、删除或修改任何文件
Para confirmar:
- La llamada a la herramienta es normal
- Los permisos del espacio de trabajo son normales
¿Por qué dividirlo en tres etapas?
Debido a:
- Error de la solicitud básica → La mayoría de los problemas son clave, modelo, proveedor
- Error en la lectura del archivo → Puede ser un problema con los permisos del espacio de trabajo o el cliente
- Error en la llamada a la herramienta → Posible problema con la cadena de herramientas Codex
Pruebas separadas para localizar rápidamente la causa.
Ubicación de copia de seguridad de configuración original
Los scripts oficiales generalmente crean un directorio de copia de seguridad:
C:\Users\Administrator\.codex\backup-deepseek\
Si el nombre de usuario de Windows no es Administrador:
Ver:
C:\Users\你的用户名\.codex\backup-deepseek\
El catálogo puede contener:
- Configuración de proveedores
- Dirección API
- Información de certificación
No lo haga:
- Subir al disco
- Enviar a otros para verificar
- Colocar en el almacén abierto
V. Edición terminal del Codex: confirmación de la versión primero
La versión de escritorio del Codex y la versión terminal del Codex no se mezclan para juzgar.
Si utiliza la versión terminal:
Primero ejecute:
codex --version
Por ejemplo, ciertos entornos detectan:
0.117.0
Sin embargo, los scripts de configuración oficiales de DeepSeek pueden requerir versiones más avanzadas, como por ejemplo:
0.144.0+
Los requisitos de versión están sujetos a cambios y, por lo tanto, deben prevalecer las instrucciones oficiales actuales.
Cuando se necesita actualizar:
npm install -g @openai/codex
Reconfirmar después de la actualización:
codex --version
Nota:
Si solo usas el lado de escritorio:
No tome el número de versión de terminal para demostrar que el lado de escritorio se ha conectado con éxito.
El criterio de juicio final debe ser:
- Si el proveedor correspondiente aparece en el lado del escritorio
- Modelo de solicitud exitoso
- La lectura de archivos y la llamada a la herramienta son normales
Inspección de errores comunes
1. 401 o fallo de autenticación
Prioridad de verificación:
¿Se utiliza la clave vieja filtrada?
Si la clave alguna vez se hizo pública:
Deshacer y recrear inmediatamente.
Copiar errores
Inspección:
- Espacio frontal y posterior
- Caracteres de brecha
- La entrada está completa
No envíe la clave a alguien para que la compruebe.
La forma correcta:
Recrear la clave, que solo se introduce cuando se configura nativamente.
2. Modelo no existe o versión no compatible
Primero confirme:
codex --version
Luego se confirma:
- ¿Está utilizando actualmente la versión de escritorio o terminal?
- Nombre del modelo requerido oficialmente por DeepSeek
- Versión mínima del cliente requerida oficialmente
Si la versión es demasiado baja:
- Actualización Cliente
- Reexecución del script de configuración
- Verificación de nuevo
3. No utilice la clave DeepSeek en el proceso de inicio de sesión de OpenAI
No utilice:
codex login --with-api-key
Razones:
La clave de API de DeepSeek no es una credencial de inicio de sesión de OpenAI.
DeepSeek deberá pasar por:
- Proveedor Custom
- Dirección API Configuración
- Protocolo de comunicación correspondiente
Acceso.
Por último, recuerde tres puntos.
- La vieja llave ha sido expuesta y fue revocada la primera vez.
- La clave de API de DeepSeek no es una credencial de inicio de sesión de OpenAI.
- El modelo que aparece en la interfaz no significa que la solicitud del modelo, la lectura de archivos y la llamada a la herramienta han sido completamente normales.
El criterio para una configuración exitosa no es "ver el nombre del modelo", sino:
- Solicitud exitosa
- El archivo se lee normalmente
- Herramienta llamada normal