OpenAI官方AI编程工具Codex入门：CLI/App/Web/IDE四种用法，一篇说清楚

Claude Code好用，但有两个问题把很多人卡住：免费额度太少，以及封号风险。

于是很多人开始问：OpenAI有没有类似的工具？

有。就是今天要说的Codex——OpenAI官方出品的AI编码工具，稳定性和模型能力都不差，还能直接接GitHub。

Codex是什么

Codex是OpenAI官方出的AI编程助手，能理解你的需求，帮你写代码、跑命令、调Bug。

它的四种运行模式，覆盖了几乎所有使用场景：

CLI（命令行）：在终端里跑，适合命令行党。装好后一个codex命令就能启动。

App（桌面应用）：有图形界面，支持macOS和Windows。不想看黑框的用这个。

Web（网页版）：打开浏览器就能用，不用装任何东西。出差临时改个代码，随开随用。

IDE插件：支持VS Code、Cursor、Windsurf。写代码的时候直接在编辑器里调用，代码上下文自动带过去。

哪种模式用着顺手就用哪种，不用纠结入口。

2026年的Codex更新了什么

如果还把Codex当成”OpenAI版Claude Code”，这个理解有点窄了。

2026年以来的三个关键变化：

Codex App 26.415（2026年4月）：桌面端从”聊天式编码工具”升级成更完整的AI工作台，支持内置浏览器、任务侧边栏、GitHub PR处理、Memories、多终端多窗口。

GPT-5.5进入Codex（2026年4月）：复杂实现、重构、调试、测试和验证能力大幅提升。不只是写小脚本，现在能接真实项目的复杂任务了。

Codex CLI 0.128.0（2026年4月底）：加入可持久化的/goal工作流，可以创建、暂停、恢复和清理长期目标。

现在评价Codex，不该只问”它会不会写代码”，而该问它能不能接住你工作流里那些重复、复杂、跨文件、需要验证的任务。

什么时候适合用Codex

符合以下任意一条，Codex值得优先试：

• • 你已经有ChatGPT Plus/Pro订阅，每月那20刀不用只用来写周报了
• • 你想要GUI，不想在终端里和AI大眼瞪小眼
• • 你被封号问题折腾怕了，多一个备用工作流很重要
• • 你想先低成本试试，Codex可能已经包含在你的套餐里
• • 你喜欢GPT系列写代码和解释代码的手感

如果以上都不符合，继续往下看，后面会讲怎么接入国内大模型。

安装：从哪开始

环境准备

先检查有没有Node.js和git：

node --version
npm --version
git --version

没有的话先装上，这步没有玄学，少一个后面都容易报错。

CLI安装

习惯终端的人用这个：

npm install -g @openai/codex
# 或 macOS 用 Homebrew
brew install --cask codex

验证：codex --version 看到版本号就说明成了。

App安装

Windows用户直接下载：https://get.microsoft.com/installer/download/9PLM9XGG6VKS

macOS和Linux用户同样可以从上面地址找到对应版本。

Web版

直接访问：https://chatgpt.com/codex/cloud

打开浏览器就能用，临时借别人电脑改代码的时候最方便。

IDE插件

用VS Code、Cursor或Windsurf的话，装插件：https://developers.openai.com/codex/ide

装完重启，编辑器里就能直接调用。

30秒上手

不管哪种安装方式，装好后先跑一个试试：

cd d:\test\
codex "用Python写一个贪吃蛇游戏"

就这么简单。你不需要告诉它用什么框架、怎么组织代码，它会自己判断。

这才是AI编码工具的核心价值：你描述目标，它拆任务、改文件、跑命令。

先拿小游戏练手，不要一上来就让它重构祖传系统。心态健康最重要。

四种模式的使用场景

CLI：直接派活的模式

在终端里跟Codex对话，它会直接修改项目里的文件、跑命令、修问题。

适合让它完整跑一个任务，比如”把这个数据处理脚本重构一下，加上类型提示，然后跑测试”。

App：想同时看项目文件和对话

App适合两类人：不想一直待在终端里的人，以及希望同时看项目文件、对话记录和修改内容的人。

点击项目，选择”使用现有文件夹”，Codex会围绕这个项目持续工作，不只是单次问答。

而且CLI登录状态App可以复用，不用重复登录。

云端：接GitHub干活的模式

本地Codex在你电脑上干活，云端Codex连到GitHub仓库里干活。

打开https://chatgpt.com/codex/cloud，连接到GitHub，选择仓库，就能让Codex分析和修改GitHub上的项目。

适合处理已经放到GitHub上的项目，以及团队协作场景。

IDE插件：边写边问

IDE插件最大的价值不是”多开一个聊天窗口”，而是直接读取当前项目的上下文，在你写代码的位置帮你改。

适合这些场景：

• • 让它解释当前文件的作用
• • 选中一段代码，让它重构或补注释
• • 把报错信息贴进去，让它定位问题
• • 给某个函数补单元测试

简单说：IDE插件适合边写边问，CLI适合直接派活。

进阶用法

AGENTS.md：给Codex写”项目说明书”

在项目根目录创建AGENTS.md文件，告诉Codex你的项目规范：

# 项目规范

- 语言：Python 3.11+
- 代码风格：PEP 8
- 测试框架：pytest
- 注释：中文注释

## 交互偏好
- 先解释修改思路，再改代码
- 涉及删除文件、重构目录时先询问
- 回复使用中文

## 权限配置
- 权限模式：自动审查
- 默认模型：qwen3.6-plus

AI编码工具不是不会干活，是不知道你的项目规则。AGENTS.md就是把规则先写清楚。

安全模式

Codex有几种权限模式：

• • 默认权限：只给建议，适合先看方案
• • 自动审查：可以自动编辑文件，但关键操作会请示你
• • 完全访问：权限更大，可自动执行更多操作

新手推荐开”自动审查”，删除文件、安装依赖、推送代码必须手动确认。等你熟悉Codex行为模式再逐步开放。

接入国内大模型

OpenAI兼容的API，Codex不一定能用——新版本更依赖Responses API，如果平台只兼容Chat Completions，可能连得上但跑不起来。

实测阿里百炼适配情况相对较好，能选的模型包括qwen3-max、qwen3.6-plus、qwen3.5-plus等。

配置方法：打开App设置，找到config.toml，修改为：

model = "qwen3.6-plus"
model_provider = "bailian"

[model_providers.bailian]
name = "bailian"
env_key = "BAILIAN_API_KEY"
base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"

然后配置环境变量BAILIAN_API_KEY，重启Codex即可。

验证：发送一个简单任务”用中文写一个Python脚本打印Hello国内大模型，然后运行”，能理解中文并成功运行说明配置生效。

常见问题

登录失败：浏览器授权后提示失败。先执行codex logout再codex login，很多时候比研究日志快。

codex命令找不到：先重新安装npm install -g @openai/codex，然后检查npm全局路径是否在PATH里。Windows用户如果PATH配置麻烦，建议先试App。

配置了环境变量仍然提示找不到：Windows用户配置完环境变量后需要完全退出再打开Codex，还不行就重启电脑。

最后

用Codex写代码，有几个建议：

不要一上来让它开发完整系统，先拿真实小任务练手：修一个报错、给旧代码补注释、给函数补测试。

AI编码工具最适合从小任务开始磨合。你越清楚自己要什么，它越容易给你稳定结果。

工具没有绝对好坏，只有合不合适。真正重要的不是站队，而是把AI编程工具放进你的真实工作流里，让它帮你少写重复代码、少查低级错误。