Codex 小白安装指南:从零到上手,三种方式任你选

TUTORIAL · AI工具 2026.05

Codex 小白安装指南：从零到上手，三种方式任你选

CLI · 桌面App · 网页端

01准备工作02三种方式03CLI篇04App篇05Web篇

说实话，AI编程工具这两年真的火得一塌糊涂，Claude Code、Cursor、Codex 各种产品轮番登场。但如果你用的是 ChatGPT Plus 或者 Pro，Codex 真的是个很不错的选择——稳定性好，不会动不动就封号，上手难度也低。

说白了，Codex 就是 OpenAI 出的 AI 编程助手。它能帮你写代码、改文件、跑命令、修 Bug。你说句话，它就帮你干完。

先搞定准备工作

PREREQUISITES · Node.js + Git + 账号

其实不管你最后选哪种方式，下面这些准备工作都得做。

第一步：装 Node.js

这个是必须的。打开浏览器访问 👉 https://nodejs.org/zh-cn/download

下载那个 LTS 版本，Windows 和 Mac 都一样。一路点"下一步"就行。装完验证：node --version

第二步：装 Git

去这里下载 👉 https://git-scm.com/downloads

下载对应你系统的版本，安装一路默认。装完验证：git --version

第三步：准备 ChatGPT 账号

Codex 目前需要 ChatGPT Plus 或者 Pro 才能用。免费账号的话先去升级。

Windows 用户如果用 CLI 遇到环境问题，别死磕，直接换 App，Windows 用 App 比 CLI 舒服多了。

三种方式，选一个就行

CHOOSE · CLI · App · Web

终端党 → 用 CLI，全键盘操作

鼠标党 / 新手 → 用 App，最推荐

不想装东西 / 临时用 → 用 Web，有浏览器就行

CLI 篇（终端）

TERMINAL · npm/brew安装

安装：npm install -g @openai/codex，macOS 也可以用 brew install --cask codex

验证：codex --version

启动：cd 你的项目路径 然后 codex

常用命令：/model 切换模型、/goal 设长期任务、/plan 先出计划再执行。

第一次用别上来就让它重构祖传系统。先拿小任务练手：

"帮我用 Python 写一个贪吃蛇游戏"

▲ 深夜在终端里让 Codex 干活

App 篇（桌面应用，新手最推荐）

DESKTOP · 图形界面开箱即用

Windows：Microsoft Store 搜 "Codex"，或访问 👉 https://developers.openai.com/codex/quickstart

Mac：访问 👉 https://chatgpt.com/codex 点 Download

装完打开 App。用 ChatGPT 账号登录，CLI 登过的话 App 不用再登，状态通用。

进来选 "项目模式"，不要用对话模式。对话模式处理不了复杂任务。

新建一个文件夹当测试，比如 D 盘建 CodexTest，然后在 App 里点"添加项目"选中它。

权限设置推荐选"自动审查"——AI 干活，另一个 AI 监工。绝对不要一上来开完全访问。

模型选 GPT-5.5，推理程度默认"高"。

发第一条指令："帮我用 Python 写一个贪吃蛇游戏"。Codex 会自动创建文件、写代码、运行。

App 优势：能看到文件树、内置浏览器预览、改完代码右侧看 diff、浏览器插件圈选页面加批注。

▲ Codex App 的图形界面

Web 篇（网页端）

BROWSER · 有网就能用

打开 👉 https://chatgpt.com/codex/cloud

点 "连接到 GitHub"，授权你的 GitHub 账号，选择仓库，Install & Authorize。

然后就能在网页里让 Codex 分析代码、修 Bug、重构了。

适合：项目在 GitHub 上、不想装任何东西、出差用别人电脑、临时救火。

新手必看：AGENTS.md

CONFIG · 你的项目说明书

在项目根目录创建 AGENTS.md 文件——这就是你的项目说明书。

AI 不是不会干活，它是不知道你的规矩。有了这个文件，Codex 的表现会好很多。

# 项目规范

- 语言：Python 3.11+ - 代码风格：PEP 8 - 测试框架：pytest - 注释：中文注释 - 新增功能时同步更新 README - 修改代码后先运行测试

几个避坑点

TIPS · 少走弯路

登录失败怎么办？先 codex logout 再 codex auth，90% 的问题这样解决。

命令找不到？检查 npm 全局路径在不在 PATH 里。Windows 用户直接换 App。

权限别开太高！新手用"自动审查"，删除文件和装依赖必须手动确认。

Codex 不是自动交付机器。它写的代码你要 review，跟人写的代码一样需要检查。

///

写在最后

你用 Codex 了吗？还是用的 Claude Code 或者 Cursor？评论区聊聊你最喜欢的 AI 编程工具，用过的朋友来给新人推荐一下呗！

数九笔记

齿轮不会停，光会照进来