El AI

Cómo insertar el Codex en la API de DeepSeek: configuración, versión y solución de errores de Windows

Este tutorial solo cubre 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. Nombre del modelo, cliente, [...]

6 de agosto, 202696 Lectura8 minutos para leer
Catálogo de artículos

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:

![DeepSeek API key 页面，密钥已打码](./assets/deepseek-api-key-redacted.png)

Ejecutar el script de configuración oficial de DeepSeek

打开 Windows PowerShell，执行：

irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex

该命令会：

  1. 从 DeepSeek 官方地址下载 PowerShell 脚本
  2. 立即执行配置流程

虽然地址来自官方，但需要注意：

远程脚本直接执行本身仍然存在风险。

不要从陌生教程复制类似命令。

如果不放心，可以：

  1. 先打开脚本内容
  2. 确认来源
  3. 再执行

配置步骤

脚本出现菜单后：

  1. 输入：
1
  1. Seleccione:
deepseek-v4-flash
  1. 按提示输入新创建的 DeepSeek API Key
  2. 等待脚本完成配置

关于 deepseek-v4-pro 的提醒

脚本菜单中出现某些模型名称，并不代表当前客户端版本和官方接入状态已经完整支持。

不要仅因为菜单里看到某个模型名称，就直接选择。

正确方式：

  • 以 DeepSeek 官方当前文档为准
  • 确认模型名称
  • 确认客户端版本要求
  • 确认推荐接入方式

不要：

  • 把 Key 拼接到命令里
  • 把 Key 写入公开脚本
  • 在文章中展示真实 Key

三、重启 Codex，并进行三阶段验证

配置完成后：

  1. 完全退出 Codex 桌面端
  2. 重新打开 Codex

然后不要直接开始修改项目。

建议按照下面顺序验证。

第一步：基础模型请求测试

输入：

只回复 OK

如果返回：

OK

Descripción:

  • API 请求基本成功
  • Provider 配置可能正常

Si se presenta:

  • 401
  • 模型不存在
  • Provider 错误

先不要让 Codex 操作项目。

优先检查：

  • API Key
  • 模型名称
  • Provider 配置
  • 客户端版本

第二步：只读文件测试

输入：

只读当前工作区中的一个文本文件，告诉我它主要写了什么，不要修改任何文件

用于确认：

  • Codex 是否可以访问工作区
  • 文件读取功能是否正常

第三步：简单工具调用测试

输入：

只列出当前工作区中的文件名，不要创建、删除或修改任何文件

用于确认：

  • 工具调用是否正常
  • 工作区权限是否正常

为什么要拆成三步？

Debido a:

  • 基础请求失败 → 多半是 Key、模型、Provider 问题
  • 文件读取失败 → 可能是工作区权限或客户端问题
  • 工具调用失败 → 可能是 Codex 工具链问题

分开测试才能快速定位原因。

四、原配置备份位置

官方脚本通常会创建备份目录：

C:\Users\Administrator\.codex\backup-deepseek\

如果 Windows 用户名不是 Administrator：

查看：

C:\Users\你的用户名\.codex\backup-deepseek\

该目录可能包含：

  • Provider 配置
  • API 地址
  • 认证信息

不要：

  • 上传到网盘
  • 发给别人排查
  • 放入公开仓库

五、终端版 Codex：先确认版本

桌面版 Codex 和终端版 Codex 不要混在一起判断。

如果使用终端版：

先执行：

codex --version

例如某些环境检测到：

0.117.0

但 DeepSeek 官方配置脚本可能要求更高版本，例如：

0.144.0+

版本要求可能变化，因此必须以官方当前说明为准。

需要升级时：

npm install -g @openai/codex

升级后重新确认：

codex --version

Nota:

如果你只使用桌面端：

不要拿终端版版本号证明桌面端已经接入成功。

最终判断标准应该是：

  • 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

优先检查：

¿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.

正确方式：

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:

  1. Actualización Cliente
  2. Reexecución del script de configuración
  3. 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.

  1. La vieja llave ha sido expuesta y fue revocada la primera vez.
  2. La clave de API de DeepSeek no es una credencial de inicio de sesión de OpenAI.
  3. 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