Codex 安装与 DeepSeek v4 Flash 接入教程

Codex 是 OpenAI 推出的 AI 编程助手，通过 Responses API 与模型交互，而 DeepSeek API 原生支持该格式，因此可以借助 Codex 的多种客户端形态接入 DeepSeek v4 Flash 模型进行 AI 编程。本教程将介绍 Codex CLI 的安装方法，以及如何将 DeepSeek 配置为 Codex 的模型提供方，实现一次配置、多端共用。

前置教程

如想快速开始学习本教程，你可能需要先完成以下前置教程：

• 大语言模型LLM服务商Api服务调用教程，了解 DeepSeek API 的基本概念，并获取接入所需的 API Key。
• Node.js和Npm安装与使用教程，用于下载、安装和配置 Codex。

资源下载

• Codex 桌面端网盘下载地址

1. Codex 与 DeepSeek 接入概述

1.1 Codex 是什么

Codex 是 OpenAI 推出的 AI 编程助手，运行在终端或桌面环境中，能够理解自然语言指令，在项目代码库中完成代码编写、代码修改、命令执行等编程任务。Codex 通过 Responses API 与模型交互，而 DeepSeek API 原生支持该格式，因此无需额外适配，即可让 Codex 使用 DeepSeek 模型。

1.2 Codex 的客户端形态

Codex 有以下三种客户端形态，它们共用同一份配置文件：

• Codex CLI：终端命令行工具
• ChatGPT 桌面端：桌面应用中集成的 Codex 能力
• VS Code 的 Codex 插件（Codex IDE extension）：集成在 VS Code 中的编程助手

Codex 的各客户端形态共用同一份配置文件 ~/.codex/config.toml，按本文配置一次，即可在所有形态中使用 DeepSeek 模型。

1.3 模型支持情况

目前仅 deepseek-v4-flash 支持接入 Codex，deepseek-v4-pro 预计 2026 年 8 月初支持接入 Codex。

2. Codex CLI 安装

2.1 安装方式概览

使用 npm 方式安装需要 Node.js 22 或更高版本，建议安装最新 LTS 版本。

你可以前往Node.js和Npm安装与使用教程，了解如何安装 Node.js 和 Npm。

2.2 Windows 系统安装

Windows 系统推荐使用 npm 方式安装：

# 1. 全局安装 Codex CLI
npm install -g @openai/codex

# 2. 验证安装
codex --version

2.3 macOS 系统安装

macOS 系统可以使用 Homebrew 或官方脚本安装：

# 方式一：Homebrew 安装
brew install --cask codex

# 方式二：官方脚本安装
curl -fsSL https://chatgpt.com/codex/install.sh | sh

2.4 Linux 系统安装

Linux 系统可以使用官方脚本或 npm 安装：

# 方式一：官方脚本安装
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# 方式二：npm 安装
npm install -g @openai/codex

2.5 安装验证

安装完成后，执行以下命令验证安装是否成功：

codex --version

能输出版本号即说明安装成功。随后建议执行一次 codex，让 Codex 在用户主目录下生成 ~/.codex 配置目录，这是后续接入 DeepSeek 的前提条件。

首次启动 codex 会提示登录 ChatGPT 账号，可以先退出；完成 DeepSeek 配置后（见第 3 章）使用 API Key 认证，会自动跳过账号登录。

3. 将 DeepSeek 配置为模型提供方

3.1 准备工作

接入 DeepSeek 前，需要满足以下两个条件：

1. 已安装 Codex CLI 或 ChatGPT 桌面端，并至少运行过一次（即 ~/.codex 目录已存在）
2. 已获取 DeepSeek API Key（以 sk- 开头，在 DeepSeek 开放平台获取）

3.2 一键配置脚本

DeepSeek 提供了一键配置脚本，可以自动完成全部配置。

macOS / Linux 用户在终端中执行：

bash <(curl -fsSL https://cdn.deepseek.com/api-docs/codex-deepseek-setup.sh)

Windows 用户在 PowerShell 中执行：

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

运行后按菜单选择要使用的模型。首次运行会提示输入 API Key（以 sk- 开头，在 DeepSeek 开放平台获取）。

脚本会自动完成以下工作：

1. 备份现有配置：将 ~/.codex/config.toml 备份到 ~/.codex/backup-deepseek/，随时可以还原
2. 写入模型目录 ~/.codex/models.json：向 Codex 声明 DeepSeek 模型的元数据（上下文窗口长度、支持的推理强度档位、工具调用格式等），使 Codex 能像使用内置模型一样使用 DeepSeek 模型
3. 修改 ~/.codex/config.toml：只改写必要的字段，并新增 [model_providers.deepseek] 配置段；原有的 MCP 服务器、项目信任级别等配置全部保留。若存在与 DeepSeek 配置冲突的字段，脚本会删除它们，并逐条打印删除原因
4. 校验：写入前校验 config.toml / models.json 语法合法；校验失败则中止，不修改任何文件

再次运行脚本，可以在菜单中切换模型，或恢复到安装前的默认配置（菜单第 3 项）。

此处API Key已删除，实际使用时请替换为你的 API Key。

4. 开始使用

4.1 Codex CLI

进入项目目录（建议为 Git 仓库），执行 codex 命令：

cd /path/to/my-project
codex

启动信息中显示 model: deepseek-v4-flash（或你选择的模型）即为生效。

沙箱（sandbox）环境选择：

选择 1 安全性高，Codex 会创建一个受限制的环境，能有效防止 AI 在执行任务时意外或恶意地访问、修改你不希望它触碰的系统文件或网络资源。

功能使用： 在会话中输入自然语言指令，Codex 会在当前项目中读取、修改文件并执行命令，完成编程任务：

你：用 Python 写一个读取 CSV 文件并统计行数的脚本
Codex: 好的，我来创建这个脚本...

4.2 ChatGPT 桌面端

2026年7月，OpenAI 将 Codex 桌面端集成至 ChatGPT 中，桌面端可前往网盘下载，以解决网络环境不佳，下载过慢的问题。

打开 ChatGPT 桌面端，模型选择器中显示「自定义」即为生效。桌面端对本地配置的模型统一显示为「自定义」，实际使用的就是你选择的 DeepSeek 模型。

4.3 VS Code 的 Codex 插件

VS Code 的 Codex 插件（Codex IDE extension）与 Codex CLI 共用同一份配置，安装插件后即可直接使用 DeepSeek 模型，无需额外配置。

5. 常见问题与解答

问：一键配置脚本是否会影响我原有的 Codex 配置？

答：不会。脚本会先将原有 config.toml 备份到 ~/.codex/backup-deepseek/，随时可以还原；修改时只改写必要字段，MCP 服务器、项目信任级别等配置全部保留。写入前还会校验语法，校验失败则中止，不修改任何文件。

问：如何切换其他模型或恢复默认配置？

答：再次运行一键配置脚本，按菜单选择即可切换模型；选择菜单第 3 项，可以恢复到安装前的默认配置。

问：接入 DeepSeek 后还需要登录 ChatGPT 账号吗？

答：不需要。配置中的 preferred_auth_method = "apikey" 和 forced_login_method = "api" 使用 API Key 认证，会跳过 ChatGPT 账号登录。