Codex 新手入门

基于 Rust 构建，直接运行在终端的 AI 编码代理，可操作文件系统、执行命令、生成完整项目。

240+

tokens/s 响应速度

2.5x

比 Claude 更快

1/3

Token 消耗更省

认识 Codex

开源免费终端运行轻量快速

与 Claude Code 偏重生产级系统不同，Codex 更像一把 锋利的瑞士军刀——轻量、快速、灵活，特别适合快速原型开发。

适用人群

编程新手 — 自然语言描述需求即可生成代码
效率提升者 — 用 AI 自动化重复性编码工作
工具爱好者 — 追求轻量、可控的终端体验

安装三步走

环境检查：确保 Node.js ≥ 18

安装 CLI：npm install -g @openai/codex

登录验证：codex login 使用 ChatGPT 账号授权

npm install -g @openai/codex
# macOS 可用 brew install --cask codex
# 国内用户可加淘宝镜像

系统要求

macOS 12+ / Ubuntu 20.04+ / Debian 10+
Windows 用户通过 WSL2 使用
内存 ≥ 4GB（推荐 8GB）
ChatGPT Plus / Pro / Team / 企业账号

权限模式

read-only — 仅读取文件、提供建议，适合代码审查
workspace-write — 默认模式，工作区内可写文件
danger-full-access — 无沙箱限制，适合高级用户在容器中运行

核心命令

/new

开启新对话线程

/list

列出所有线程

/model

切换模型

/mcp

管理 MCP 连接

/permissions

切换权限模式

/memories

管理记忆功能

提示词三段式

需求目标 + 技术栈 + 约束条件

❌ 错误：写个登录接口

✅ 正确：创建一个用户登录系统，
1. MySQL 用户表设计
2. Express 登录接口
3. JWT Token 认证
框架 Express+TS，密码 bcrypt 加密

任务描述越具体，Codex 输出越精准。

核心特性

线程系统

Thread（完整对话）、Turn（一次交互往返）、Item（最小单元）。支持 resume 恢复、fork 分支、归档管理。

Skills 扩展

在 ~/.codex/skills/ 下创建 Markdown 文件，通过 $skill-name 调用，相当于给 AI 安装自定义工具。

记忆功能

/memories enable 开启，让 AI 记住你的偏好、项目约定和常用配置，越用越懂你。

批准模式

Suggest — 所有写操作需确认，适合学习审查
Auto（默认）— 工作区内自动执行
Full-Access — 完全自主执行，禁用网络

实战案例

电影评分网站

技术栈：React + Vite + JSON Server + CSS Modules

电影列表：封面、标题、简介、评分
用户打分：1-5 星交互
搜索过滤：按电影名实时筛选

mkdir movie-rating && cd movie-rating
npm create vite@latest . -- --template react
codex

在对话中描述需求，Codex 自动安装依赖、创建 db.json、编写组件并配置并发启动。

# 高级玩法：exec 模式
codex exec "运行 npm test
并修复所有失败的测试用例"

避坑指南

版本回退：npm install -g @openai/codex@版本号
WSL 路径：放在 /home/ 下，别放 /mnt/c/
任务中断：用 tmux 保持会话存活
权限提醒：在 config.toml 中配置 trusted 目录

效率优化

在项目根目录创建 AGENTS.md，写清项目约定，Codex 每次会话自动读取。

# AGENTS.md 示例
- 后端: Express + TypeScript
- 数据库: PostgreSQL + Prisma
- 提交前必须运行 npm test
- 所有 API 需 Zod 验证

MCP 集成外部工具（如 SonarQube），扩展代码扫描能力。

学习资源

官方文档：developers.openai.com/codex/cli
GitHub：github.com/openai/codex
社区扩展：oh-my-codex（OMX）

进阶方向

从开发 MCP 服务器，到与 ChatGPT、Atlas 深度集成，再到通过 Azure Foundry 构建企业级私有化工作站。

"Codex 不只是一款 AI 编程工具，
它正在重新定义"开发"这件事。"