DeepSeek接入Codex教程：PowerShell一键配置与避坑

对于使用 Codex 开发项目的程序员来说，模型接入方式会直接影响日常开发效率。除了使用 Codex 原有的模型服务，现在也可以通过自定义模型提供商，将 DeepSeek 接入 Codex CLI、ChatGPT 桌面应用以及 VS Code 扩展。

最近，DeepSeek 官方提供了一条 PowerShell 一键配置命令：

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

这条命令的作用是什么？为什么要使用 irm 和 iex？执行后会修改哪些配置？DeepSeek Flash 和 Pro 又应该怎么选？

本文从命令原理、官方脚本配置过程、手动接入、模型选择和安全注意事项几个方面展开，帮助开发者理解这套接入方式，而不只是复制一行命令。

一、DeepSeek Codex 一键配置命令是什么？

首先需要明确，这条命令不是用来安装 Codex 的，而是用于将 DeepSeek API 配置为 Codex 的模型提供商。

Codex 本身是 AI 编程助手，可以根据开发者的任务描述读取项目文件、编写代码、执行命令和修改项目。

DeepSeek 官方为 Codex 提供了 Responses API 接入支持。通过配置模型提供商，开发者可以让 Codex 使用 DeepSeek 模型完成代码相关任务。

Windows 用户可以通过 PowerShell 执行：

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

这里涉及三个关键部分：

irm：获取远程脚本。irm 是 PowerShell 中 Invoke-RestMethod 的别名，能够向指定地址发送 HTTP 请求，并获取服务端返回的内容；在这条命令中，它负责从 DeepSeek 官方 CDN 获取 PowerShell 配置脚本。

管道符 |：传递命令输出。PowerShell 中的 | 是管道运算符，它将前一个命令的输出传递给后一个命令，使两个操作能够连续执行。

iex：执行脚本内容。iex 是 Invoke-Expression 的别名，它可以将接收到的字符串作为 PowerShell 表达式执行。

因此，这条命令实际上完成了两个连续动作：先获取远程脚本，再将脚本内容交给 PowerShell 执行。

需要注意，rm 和 irm 不是同一个命令。rm 是 Remove-Item 的别名，主要用于删除文件和目录；如果将 rm 错误地写进安装命令，就无法实现预期的远程脚本下载操作。

所以，搜索或复制相关命令时，应该确认使用的是 irm。

二、执行命令前，需要准备哪些环境？

DeepSeek 官方文档对一键配置有明确的前置要求。在执行脚本之前，需要完成以下准备。

安装并启动 Codex。首先需要在 Windows 系统中安装 Codex CLI，或者安装 ChatGPT 桌面应用。官方要求至少启动过一次 Codex CLI 或 ChatGPT 桌面应用，以便系统创建 ~/.codex/。这个目录是 Codex 保存用户级配置的主要位置，Windows 系统中通常对应 %USERPROFILE%\.codex\。

其中可能包含：

• config.toml：Codex 的主要配置文件；
• models.json：模型目录及模型能力描述；
• 其他认证、会话和客户端配置文件。

如果没有启动过 Codex，脚本可能无法找到预期的配置目录。

准备 DeepSeek API Key。开发者需要在 DeepSeek 开放平台申请 API Key。API Key 是调用模型服务的身份凭证，不是 Codex 登录密码。建议将 API Key 保存在安全位置，不要直接写入公开代码仓库，也不要发送给其他人。

确认 PowerShell 环境。在 Windows 搜索栏输入 PowerShell，打开终端。可以先检查当前版本：

$PSVersionTable.PSVersion

再检查 Codex 是否能够正常启动：

codex --version

如果使用的是 ChatGPT 桌面应用，也应该先打开应用，确认其能够正常运行。

不建议直接执行来源不明的远程脚本。irm | iex 的执行方式比较方便，但也存在安全风险，因为它会直接执行远程返回的脚本内容。如果远程文件被替换，或者下载地址不是可信来源，执行者可能无法提前知道脚本具体会做什么。DeepSeek 提供的是官方 CDN 地址，但对于企业开发环境，建议先下载脚本并检查内容，再决定是否执行。

示例脚本：

$scriptUrl = "https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1"
Invoke-WebRequest `
    -Uri $scriptUrl `
    -OutFile ".\codex-deepseek-setup.ps1"
Get-Content ".\codex-deepseek-setup.ps1"

检查脚本内容后，再在确认可信的情况下执行：

& ".\codex-deepseek-setup.ps1"

这并不意味着官方一键命令存在安全问题，而是建议开发者在生产环境中保留脚本审查和配置变更记录。

三、DeepSeek 官方脚本会自动修改哪些配置？

这是整条命令最值得关注的部分。它并不是简单地把一个 API 地址写入 Codex，而是需要完成模型目录、模型提供商、认证方式和推理配置等多项设置。

根据 DeepSeek 官方文档，脚本主要执行以下操作。

自动备份原有配置。执行前，脚本会备份已有的 ~/.codex/config.toml，备份位置为 ~/.codex/backup-deepseek/。这一步很重要，因为很多开发者此前已经配置了其他模型提供商、MCP 服务和项目权限；如果直接覆盖整个配置文件，可能导致原来的工作环境无法正常使用。官方脚本采用必要字段修改的方式，尽可能保留已有设置。

创建 models.json 模型目录。脚本会生成 ~/.codex/models.json，这个文件用于向 Codex 描述 DeepSeek 模型的相关属性，例如模型名称、上下文窗口、最大上下文窗口、支持的推理强度、输入模态、工具调用能力、模型相关配置。

为什么需要这个文件？因为模型服务商提供的模型，不一定都属于 Codex 内置模型；Codex 需要知道模型支持哪些能力，才能按照相应的方式组织请求。例如，DeepSeek Flash 的模型目录包含 image 输入模态，这也是 Codex 能够识别其图片输入能力的重要配置。

修改 config.toml。接下来，脚本会修改 ~/.codex/config.toml，其中会增加 DeepSeek 模型提供商配置。

model = "deepseek-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
web_search = "disabled"
model_catalog_json = "~/.codex/models.json"

[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "你的DeepSeek_API_Key"

配置字段说明如下：

表格

其中，wire_api = "responses" 是非常关键的配置。因为 DeepSeek 官方为 Codex 提供的是 Responses API 兼容支持，而不是简单地把普通 Chat Completions 接口地址替换进去。如果通信协议配置不匹配，即使 API Key 正确，也可能无法正常完成模型调用。

自动验证配置文件。官方脚本还会对 config.toml 和 models.json 进行语法验证。如果验证失败，脚本会中止写入，避免将不完整的配置直接保存到文件中。这能够减少手动修改 TOML 或 JSON 时出现的格式错误。

以上配置流程均来自 DeepSeek 官方 Codex 接入说明，而不是第三方教程推测。

四、执行脚本后，如何选择 DeepSeek Flash 和 Pro？

官方脚本启动后，会显示一个操作菜单。目前最重要的选项有三个：

表格

这里的 Flash 对应当前正式模型名称 deepseek-flash，Pro 对应 deepseek-v4-pro。

Flash 更适合哪些编程任务？

Flash 是值得优先测试的日常编程模型，例如普通函数编写、代码解释、简单 Bug 修复、测试用例生成、项目文件分析、常规工具调用、图片和截图理解。特别值得注意的是，官方模型目录明确将 Flash 标记为支持图片输入，因此开发者可以将它用于需要理解页面截图、界面布局和图片内容的开发任务。

Pro 更适合哪些任务？

Pro 可以作为复杂任务的对照选择，例如复杂项目架构分析、多模块代码重构、跨文件依赖关系分析、复杂逻辑推理、需要调用 Codex 内置 Web Search 的任务。

DeepSeek 官方文档明确指出，Codex 内置 Web Search 目前只支持 deepseek-v4-pro。如果需要使用这一功能，需要在配置中设置：

model = "deepseek-v4-pro"
web_search = "live"

然后重新启动 Codex。需要注意，启用搜索功能后，搜索请求还会产生相应的 Search API 费用。

两个模型能否直接切换？

可以。如果已经完成官方配置，可以通过菜单重新运行脚本，选择另一个模型。官方也说明，重新执行配置脚本时，会更新新版本脚本引入的模型设置，同时保留其他不冲突的配置。对于需要频繁切换模型的开发者，建议提前备份自己的配置文件，并记录不同模型的使用情况。

五、不想使用一键脚本，可以手动接入吗？

可以。DeepSeek 官方同时提供了手动配置方式。如果开发者希望了解 Codex 如何连接模型服务，手动配置反而更容易理解底层工作原理。

主要分为两步。

第一步：配置 models.json。首先创建 ~/.codex/models.json，将 DeepSeek 官方文档提供的完整模型目录复制进去。官方模型目录中包含 Flash 和 Pro 两个模型的相关描述。需要注意，不建议随意删减模型字段，部分配置涉及 Codex 对模型能力的识别，例如上下文长度、推理强度和工具调用方式。

第二步：配置 config.toml。打开 ~/.codex/config.toml，根据官方文档配置模型提供商。

关键部分如下：

model = "deepseek-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"

[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "你的API_Key"

保存后，重新启动 Codex。如果需要使用 Pro，可以将模型名称修改为 model = "deepseek-v4-pro"。如果需要启用官方 Web Search，还需要根据前面的说明设置对应选项。

手动配置的优势在于可控性。开发者可以根据自己的实际需求调整模型、认证方式和其他配置，而不必每次都重新运行脚本。不过，完整的模型目录和其他配置字段仍然应该以 DeepSeek 官方文档为准。

六、Codex 接入 DeepSeek 后，为什么有些功能无法使用？

完成模型配置，不代表 Codex 所有功能都能自动获得支持。这是很多开发者容易忽略的问题。模型提供商、通信协议和模型能力之间存在对应关系。

1. 为什么 Flash 无法使用内置 Web Search？

根据 DeepSeek 官方文档，Codex 内置 Web Search 目前仅支持 Pro。即使 Flash 已经能够正常完成代码生成和工具调用，也不能因此推断它支持相同的服务端搜索能力。如果确实需要内置搜索，可以切换到 Pro，并将 web_search 设置为 live。

2. 为什么切换模型后，之前的会话不见了？

这个问题也有官方说明。Codex 会根据登录方式分别保存会话历史。例如，原来通过 ChatGPT 账号使用 Codex，后来切换为 DeepSeek API Key，再次启动时，原来的会话可能不再显示。

这不代表原来的会话被删除。官方说明，恢复之前的配置后，原有会话会重新显示，而使用 DeepSeek API 创建的会话则会在对应配置下显示。所以，切换模型前不必因为会话列表发生变化就认为历史数据丢失。

3. 为什么 API Key 不能随便分享？

官方示例中的 experimental_bearer_token 会将 API Key 写入配置文件，这意味着本地配置文件本身就包含敏感认证信息。

建议开发者：

• 不要把 config.toml 上传到公开 GitHub 仓库；
• 不要在截图或技术文章中暴露 API Key；
• 不要将配置文件发送给不可信人员；
• 企业环境应设置合理的文件访问权限；
• 定期检查是否存在密钥泄露和异常调用记录。

如果 API Key 已经出现在公开仓库或日志中，应立即在服务商后台撤销旧 Key，并重新生成新的密钥。单纯删除 GitHub 上的文件并不能保证密钥已经失效，因为历史提交仍可能保留原始内容。

6.2 如何进一步保护本地配置？

可以考虑将敏感信息与普通配置分离。

model_provider = "deepseek"
model = "deepseek-chat"

[model_providers.deepseek]
name = "DeepSeek"
base_url = "https://api.deepseek.com"
wire_api = "responses"

将认证信息放在环境变量或受保护的本地配置中，避免直接写入需要提交到代码仓库的文件。需要注意，上面是配置管理的示意方式，具体认证字段和环境变量名称应以当前 DeepSeek 安装脚本生成的配置为准，不要在原有配置中随意删除脚本所需字段。

七、接入 DeepSeek 后，Codex 应该如何验证是否配置成功？

安装脚本执行完毕，并不代表 Codex 已经能够正常调用模型。建议按照以下顺序进行验证。

7.1 检查配置文件

首先打开 Codex 的配置文件：

notepad "$HOME\.codex\config.toml"

检查以下内容：

• 是否存在 DeepSeek Provider；
• Base URL 是否正确；
• 模型名称是否与当前配置一致；
• API Key 是否已经正确配置；
• Responses API 协议是否符合当前接入要求。

如果配置文件不存在，或者内容与预期不同，应先检查安装脚本是否正常执行。

7.2 检查 Codex 是否识别模型

重新启动 Codex，观察是否能够正常加载模型。如果出现认证错误，可以优先检查：API Key 是否填写正确、Key 是否已经失效、API Base URL 是否存在拼写错误、当前网络能否访问 API 服务、模型名称是否为服务商支持的名称。

如果出现协议错误，则需要检查 wire_api 配置是否与服务端兼容。不要在没有确认错误原因的情况下反复执行安装脚本，否则可能覆盖原有配置。

7.3 使用实际代码任务进行验证

仅仅看到 Codex 启动成功还不够。建议创建一个简单的测试项目，让 Codex 执行以下任务：创建一个基础 Python 项目、编写一个简单的 HTTP API、为接口添加参数校验、编写对应的单元测试、执行测试并修复错误。

通过这个过程，可以观察模型是否能够完成从需求理解、代码生成到终端执行的完整工作流。如果模型可以正常回答，却无法执行终端操作，还需要检查 Codex 的运行环境、权限和工具配置，而不能直接认定 API 接入失败。

八、DeepSeek 接入 Codex，使用官方 API 还是第三方 API 中转站？

这也是开发者在实际使用过程中经常遇到的问题。如果只是个人测试，直接使用官方 API 通常比较简单；但当开发者需要同时使用多种模型，或者需要管理多个项目的 API Key 时，接入方式就值得重新考虑。

8.1 官方 API 直连

官方直连的优势主要在于：接口来源明确、模型版本和官方文档对应、可以直接查看官方计费记录、不需要额外维护第三方转发链路。

但如果项目同时需要 DeepSeek、Kimi、Qwen、GLM 等不同模型，就需要分别处理各个平台的账号、Key、接口地址和调用限制。对于只有一个模型需求的开发者，这种方式通常足够。

8.2 通过 API 中转站统一管理

另一种方式是通过 API 中转站接入模型，这种方式更适合有多模型调用需求的开发团队。例如，一个 Codex 项目可能使用 DeepSeek 完成常规代码任务，同时需要调用其他模型处理复杂推理或不同类型的开发工作。通过统一中转站，可以集中管理模型接入信息，减少多套 API 配置的维护工作。

这里需要特别注意：API 中转站并不意味着所有模型都能直接使用相同的协议。Codex 使用的 Responses API、模型供应商支持的接口协议，以及中转站提供的兼容能力，都需要提前确认。不能仅仅修改一个 Base URL，就认定所有模型可以正常运行。

8.3 使用统一中转站时应该确认什么？

对于需要统一管理多供应商模型的开发者，可以将 KoalaAPI 作为候选中转站进行评估。它提供多模型聚合接入思路，支持统一 Key 和 OpenAI SDK 兼容调用。

不过，针对 Codex 这类依赖特定接口协议的开发工具，建议在正式接入前重点确认：

• 是否支持 Codex 当前使用的 Responses API；
• 是否支持对应 DeepSeek 模型；
• 是否能够正确传递模型的工具调用参数；
• 是否支持流式输出；
• 是否完整处理模型返回的响应结构；
• 是否能够正确处理错误码和超时；
• 是否提供清晰的调用记录和用量统计。

特别是 Tool Calls。Codex 不只是向模型发送一段文本，还需要模型理解任务、选择工具，并根据工具返回结果继续执行。如果中转站只支持普通文本对话，却不能正确处理工具调用，那么即使普通聊天测试成功，也不代表 Codex 能够正常工作。因此，建议使用真实的代码任务进行端到端测试。

九、PowerShell 一键安装方式有哪些安全风险？

irm | iex 的便利性在于不需要手动下载、保存和执行脚本。但从安全角度看，这种方式也有一个明显的问题：远程脚本会直接进入本地 PowerShell 执行环境。如果远程脚本内容发生变化，或者下载地址被恶意替换，就可能执行未经检查的代码。

因此，对于企业开发环境和长期使用的工作电脑，我更建议先下载脚本，再检查内容。

9.1 先下载脚本，不要立即执行

$url = "https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1"
Invoke-WebRequest `
    -Uri $url `
    -OutFile ".\codex-deepseek-setup.ps1"

下载后，可以先查看脚本：

notepad .\codex-deepseek-setup.ps1

重点检查：

• 是否修改系统环境变量；
• 是否覆盖已有 Codex 配置；
• 是否写入 API Key；
• 是否访问其他不相关的网址；
• 是否存在删除文件或执行其他程序的操作。

确认脚本来源和内容之后，再考虑执行。

9.2 检查文件哈希

还可以通过 PowerShell 计算文件 SHA256：

Get-FileHash `
    .\codex-deepseek-setup.ps1 `
    -Algorithm SHA256

SHA256 可以用于比较不同时间下载的文件是否发生变化。但要注意，单独计算哈希并不能证明脚本安全；只有在能够与可信的官方哈希值进行核对时，才具有完整的校验意义。如果官方没有公布对应哈希，就应该通过官方域名、HTTPS 证书和脚本内容进行综合检查。

9.3 执行前备份原有配置

如果之前已经使用过 Codex，建议先备份配置文件：

Copy-Item `
    "$HOME\.codex\config.toml" `
    "$HOME\.codex\config.backup.toml"

这样即使安装过程中出现配置覆盖或错误修改，也可以恢复之前的设置。对于已经配置了多个 Provider 的开发环境，这一步尤其重要。

十、常见问题 FAQ

Q1：`rm https://cdn.deepseek.com/api-docs/codex-deepseek-setup.ps1 | iex` 可以直接运行吗？

不建议。你提供的命令中 rm 是 Remove-Item 的 PowerShell 别名，不是下载远程脚本的命令。DeepSeek 官方 Windows PowerShell 安装方式使用的是：

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

如果要执行，建议先下载并检查脚本内容。

Q2：DeepSeek 接入 Codex 后，还需要单独购买 Codex 吗？

API 接入与 Codex 产品本身的订阅或使用权限是不同概念。使用 API Key 调用模型，通常按照对应 API 服务商的计费规则结算。是否需要其他订阅，取决于你使用的 Codex 客户端和账户权限。

Q3：DeepSeek API 能否直接替代 Codex 原有模型？

不能简单这样理解。Codex 是一个具备代码理解、文件操作和工具执行能力的开发工具，而 DeepSeek API 提供的是底层模型能力。模型可以替换，但不同模型在工具调用、上下文处理和任务完成质量方面存在差异。

Q4：配置成功后，为什么 Codex 仍然无法执行代码？

可能与模型接口、工具权限、终端环境或本地运行配置有关。建议分别检查 API 请求是否成功、模型是否返回有效工具调用，以及 Codex 是否具备对应的本地执行权限。

Q5：一个 API Key 可以同时用于多个开发工具吗？

这取决于服务商的接口协议、密钥权限和工具兼容情况。如果多个工具都支持同一种 API 协议，可以共享接入配置，但不建议在不同项目和团队之间无差别共享同一个密钥。更合理的做法是按项目或使用场景分配独立密钥，便于追踪调用量和管理权限。

十一、总结：DeepSeek 接入 Codex，真正需要关注的不只是安装命令

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

这条命令降低了 Windows 用户接入 DeepSeek 的操作门槛。但对于开发者来说，安装脚本只是第一步。

真正影响日常使用体验的，是模型接口是否兼容、工具调用是否正常、上下文是否能够持续传递，以及 API Key 是否得到妥善管理。

如果只是个人开发，可以先使用官方脚本完成配置，再通过一个实际代码任务验证结果。如果需要同时使用多个模型，则应该进一步考虑统一管理 API 地址、模型配置和密钥的方案。

在正式部署前，建议至少完成三项检查：

• 确认脚本来自 DeepSeek 官方渠道，并检查执行内容；
• 确认 Codex 能够调用模型和执行工具；
• 确认 API Key 没有暴露在公开仓库、日志或截图中。

安装命令解决的是接入问题，真正决定开发体验的，是模型能力、接口兼容性和整个工具链的稳定性。