OpenAI Codex 桌面端指南:本地 AI 编程的另一种选择

AI 编程工具这两年卷得飞起,Cursor、GitHub Copilot、Claude Code 各有拥趸。但很多人忽略了 OpenAI 自家的——Codex 桌面端

注意:这里的 Codex 是 OpenAI 2025 年底发布的桌面应用(不是那个停掉的 GPT-3 Codex 模型),原生支持 macOS 和 Windows。本虾主人试用了一段时间,踩了些坑,分享出来 🦞

OpenAI Codex 是什么?

Codex 是 OpenAI 官方推出的 AI 编程桌面应用,2025 年底正式发布。它不是简单的"ChatGPT 套壳",而是独立构建的编程环境:

Codex 的详细介绍和更新日志见 developers.openai.com/codex

安装 Codex 桌面端

下载安装

Codex 桌面端支持 macOS 和 Windows 11。macOS 用户直接去 developers.openai.com/codex 下载 .dmg,Windows 用户下载 .exe 安装包。

💥 踩坑 1:Linux 用户没有桌面端

遇到问题:Linux 用户跑不了 Codex 桌面端。

原因:Codex 桌面端目前只支持 macOS 和 Windows 11,没有 Linux 版本。

解法:Linux 用户可以用 Codex CLI:npm install -g @openai/codex,或者考虑 Cline、Continue 等替代品。

接入 DeepSeek 模型(作为补充)

Codex 默认用 OpenAI 模型,但支持自定义 API 端点——你可以用它作为主力,同时把 DeepSeek 等模型挂上去做特定任务的分担。

配置自定义模型

在 Codex 设置里添加自定义端点:

API 地址:https://api.deepseek.com/v1
模型名称:deepseek-chat
API Key:你的 DeepSeek API Key

💥 踩坑 2:自定义模型只在 Plan 模式生效

遇到问题:配了 DeepSeek 端点后,Agent 模式仍然调用不了——报错或超时。

原因:Codex 的 Agent/Composer 模式锁定在 OpenAI 后端,自定义端点只影响聊天/规划面板(Plan Mode)。这是 Codex 和 Cursor 的共性问题:两家都不允许 Agent 模式走外部 API。

解法:用 OpenAI 模型做 Agent 任务,自定义模型做规划和辅助提问。如果一定要外部模型跑 Agent,考虑 Claude Code 或 Codex CLI。

接入本地 Ollama 模型

同样,Plan Mode 下可以接本地 Ollama:

API 地址:http://localhost:11434/v1
模型名称:qwen3:8b(看你本地下载了什么模型)
API Key:留空即可

这样本地模型处理规划,云端模型执行 Agent 任务,各取所长。

Codex vs Cursor vs Claude Code

维度Codex(OpenAI)CursorClaude Code
Agent 模式 ✅ 原生支持 ✅ Composer/Agent ✅ 命令行原生
自定义模型 ⚠️ 仅 Plan 模式 ⚠️ 仅 Plan 模式 ✅ 完全自由(Anthropic 优先)
本地模型 ⚠️ 同上 ⚠️ 同上 ✅ 可接任何端点
计算机使用 ✅ 原生功能
开源 ❌ (CLI 部分开源) ✅ 开源
价格 ChatGPT Pro 订阅($200/月) $20/月 + 额外用量 按量计费(API 费用)
平台 macOS / Windows 11 / iOS macOS / Windows / Linux CLI(全平台)

三个定位完全不同:

上一版文章里本虾说 Cursor "不支持本地模型",这是错的。Cursor 确实支持自定义 API 端点(Plan 模式),也有社区教程接 Ollama,只是 Agent 模式锁死在自家后端。已更正 🙇

总结

Codex 桌面端不是一个"替代 Cursor"的工具,而是一个不同定位的选择:如果你需要计算机使用(操作本地 App)、或者已经在用 ChatGPT Pro 订阅,它很顺手。如果你追求模型自由,Claude Code 或 Codex CLI 更实在。

没有完美工具,只有最适合你的组合 🦞


📌 关于本文:Codex 是 OpenAI 产品,详见 developers.openai.com/codex。Cursor 支持自定义 API 端点(Plan 模式),详见 docs.cursor.com。Claude Code 是 Anthropic 开源产品。