Codex Desktop 安装配置教程

学习交流群

群号：834674050

扫码或搜索群号加入 Agent 学习交流群，获取最新教程更新、使用技巧与问题解答。安装包群文件自取。

赞助支持

如果本教程对你有帮助，欢迎微信扫码赞赏，你的支持是持续更新的动力。

教程概览

本教程将带你在 Windows 系统上完成以下全部流程：

Codex 桌面版安装 → Codex++ 增强工具安装 → DeepSeek 大模型配置 → 验证运行

Git 和 Node.js 为可选依赖，不影响基础安装流程。如果你只需要 Codex 进行对话式编程辅助，可以跳过第一步直接进入安装。

Codex Desktop App 是 OpenAI 推出的桌面端 AI 编程助手，拥有图形化界面，能理解代码上下文并自动生成、修改、调试代码，还支持 Computer Use（自动操作桌面）。Codex++ 是一款增强管理工具，可以让你将 Codex 桌面版接入 DeepSeek 等国产大模型，无需 OpenAI 订阅即可使用。

前置条件

在开始安装之前，请确认你的系统满足以下条件：

第一步：安装基础依赖（可选）

以下步骤不是必须的，但安装后可以让 Codex 桌面版支持更多高级功能，如执行代码任务、管理项目依赖等。你可以现在安装，也可以在日后需要时再补装。

Codex 桌面版本身不强制要求安装 Git 和 Node.js 即可运行。但如果你希望 Codex 执行代码任务、管理项目依赖等高级功能，建议提前安装它们。

1.1 安装 Git

git --version

1.2 安装 Node.js

node -v
npm -v

第二步：安装 Codex 桌面版

Codex Desktop App 提供四种安装方式，选择最适合你的一种：

方式一：官网直接下载（推荐）

https://chatgpt.com/zh-Hans-CN/codex/

方式二：通过 Microsoft Store 安装

方式三：PowerShell 一键安装

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

方式四：微软商店离线安装包（Microsoft Store 无法使用时的备选方案）

部分 Windows 系统（如企业版、精简版）可能无法正常使用 Microsoft Store。此时可以通过微软商店离线解析站手动下载安装包。

https://store.rg-adguard.net

https://apps.microsoft.com/detail/9PLM9XGG6VKS

Add-AppxPackage -Path "下载的.msixbundle文件路径"

第三步：安装 Codex++

Codex++ 是一个第三方增强管理工具，可以为 Codex 桌面版提供图形化的配置界面。它的核心功能是充当 API 代理，将 Codex 的请求转发到 DeepSeek 等国产大模型，让你无需 OpenAI 订阅也能使用。

第四步：获取 DeepSeek API Key

配置 DeepSeek 接入 Codex

这里提供两种配置方式，推荐新手使用 Codex++ 管理工具的方式。

方式一：通过 Codex++ 管理工具配置（推荐新手）

2

添加 DeepSeek 供应商

在管理工具界面中，找到「供应商管理」或「模型供应商」选项，点击「添加供应商」，填写以下信息：

字段	填写内容
供应商名称	deepseek（可自定义）
接入模式	纯 API
配置模型	deepseek-v4-pro
Base URL	https://api.deepseek.com
Key	你从 DeepSeek 平台获取的 API Key（sk-xxx）
上游协议	选择 Chat Completions
模型列表	deepseek-v4-flash、deepseek-v4-pro

3

测试连通性并启动

填写完成后，点击「测试」按钮。如果显示 HTTP 200 响应，说明配置正确。然后选择该供应商，点击「使用中」激活。Codex++ 会在后台自动代理请求，将 Codex 桌面版的 API 调用转发到 DeepSeek。

方式二：手动编辑配置文件（进阶用户）

%USERPROFILE%\.codex\config.toml

# ~/.codex/config.toml

model = "deepseek-v4-pro"
model_provider = "custom"

[model_providers.custom]
name = "custom"
wire_api = "responses"
requires_openai_auth = true
base_url = "http://127.0.0.1:57321/v1"

# 在 PowerShell 中临时设置（仅当前窗口有效）
$env:DEEPSEEK_API_KEY = "sk-你的密钥"

# 或者永久设置（需要管理员权限）
[System.Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY", "sk-你的密钥", "User")

第五步：验证与测试

请帮我写一个 Python 函数，计算斐波那契数列的第 n 项。

常见问题

Q1: Codex 桌面版安装失败或无法打开？

请确认你的 Windows 版本为 10 Build 19041 或更高。如果从 Microsoft Store 安装失败（部分企业版、精简版系统可能无法使用 Store），可以依次尝试以下方式：官网下载 .exe 安装包、PowerShell 一键安装脚本、或通过微软商店离线解析站（store.rg-adguard.net）下载 .msixbundle 离线安装。

Q2: Codex 桌面版启动后一直卡在 Logo 页面？

这通常是因为 Codex 无法连接到 API 服务。如果你使用 Codex++，请确保：

• Codex++ 已启动且代理进程正在运行（检查管理工具右上角状态）
• 已在 Codex++ 管理工具中正确配置了 DeepSeek 供应商并点击「使用中」
• Windows 防火墙没有拦截 Codex++ 的本地端口

Q3: 出现 error sending request for url (http://127.0.0.1:...) 错误？

这是 Codex 桌面版与 Codex++ 代理通信失败的典型错误。解决方法：

• 确认 Codex++ 已启动且代理端口正常运行
• 完全退出 Codex 桌面版（系统托盘也要退出），然后通过 Codex++ 管理工具右上角的「重启 Codex++」按钮重新启动
• 检查 Windows 防火墙是否放行了相关端口

Q4: DeepSeek API Key 报错 / 请求失败？

• 检查 API Key 是否正确复制（没有多余空格或换行）
• 确认 DeepSeek 账户已充值（DeepSeek 不提供免费额度，需按需充值，最低 1 元起）
• 在 DeepSeek 开放平台查看是否有调用记录
• 确认 Base URL 填写正确（https://api.deepseek.com，末尾不加 /）

Q5: 如何切换不同的模型？

在 Codex++ 管理工具的供应商管理页面，你可以添加多个供应商（如不同的 DeepSeek 模型或其他国产大模型），点击对应的「使用中」即可切换。也可以在供应商配置中切换「配置模型」字段。

Q6: 中文界面设置后没有生效？

在 Codex 设置中直接切换中文可能无法正常生效。需要先开启代理（魔法），然后重启 Codex 桌面版，界面即可自动变为中文。

Q7: 在 Codex 中发送图片后报错？

DeepSeek 模型暂时无法识别图片，请勿在对话中发送图片，否则会导致报错且无法使用。如果任务涉及图片识别需求，建议改用支持多模态的模型。

Q8: Codex 桌面版和 CLI 有什么区别？

配置文件参考

以下是 ~/.codex/config.toml 的完整配置示例。大多数用户通过 Codex++ 管理工具配置即可，Codex++ 会自动写入此文件，无需手动编辑。

# Codex 配置文件（桌面版和 CLI 通用）
# 路径: %USERPROFILE%\.codex\config.toml
# 注意：使用 Codex++ 管理工具时，此文件由 Codex++ 自动维护，无需手动编辑。

# 默认使用的模型
model = "deepseek-v4-pro"

# 供应商名称（与下方 model_providers 中的 key 对应）
model_provider = "custom"

# 定义自定义供应商
[model_providers.custom]
name = "custom"
wire_api = "responses"
requires_openai_auth = true
base_url = "http://127.0.0.1:57321/v1"
# base_url 指向 Codex++ 本地代理地址，由 Codex++ 自动转发到 DeepSeek API

DeepSeek 可用模型列表

环境变量速查