// OpenAI Codex CLI 实战课程

让 AI
住进你的
终端

20 章系统课程，从安装到生产级工作流。自然语言驱动代码，Codex 读文件、改代码、跑命令，你只需要描述需求。

查看课程模块 了解审批模式
20
章节
6
模块
25h
课时
零
框架依赖
~/my-project — codex
$ npm i -g @openai/codex
+ @openai/codex@0.128.0
$ codex
✓ Logged in as jim@example.com
❯ 给 utils.ts 添加单元测试
Reading utils.ts...
Writing utils.test.ts...
✓ 12 tests written, all passing
❯
这门课适合谁？

找到与你相似的学员

不同背景的学员，都能从这门课中获得价值

小李 - 前端工程师
用过 Copilot · 想要更强大的工具
痛点

Copilot 只能补全代码，想要更强大的 AI 助手（能读文件、改代码、跑命令）

学完后

能用 Codex CLI 让 AI 住进终端，自动生成单元测试、修复 bug、重构代码，开发效率提升 5 倍

小王 - DevOps 工程师
天天写自动化脚本
痛点

不知道 Codex CLI 怎么用，不知道怎么让 AI 自动执行命令

学完后

能用 Codex 自动生成 Dockerfile/K8s YAML/GitHub Actions，节省 50% 配置时间

老张 - 独立开发者
一个人维护多个项目
痛点

试过 ChatGPT/Cursor 但不够自动化，想要 CLI 工具集成到工作流

学完后

能用 Codex CLI 自动化日常任务（生成文档、写测试、代码审查），专注核心功能开发

查看完整学习路径
// 课程模块

六大模块，系统掌握

从认识 Codex CLI 到生产级工作流，每个模块独立成体系，循序渐进。

01
认识 Codex CLI
破冰入门
理解 AI Coding Agent 的本质，完成安装与认证，跑通第一个任务。
Ch01Codex CLI 是什么，与 ChatGPT/Copilot 的区别
Ch02安装、认证、第一次对话
02
核心交互
掌握对话
REPL 交互模式、三种审批模式、斜杠命令，建立完整的使用心智模型。
Ch03交互式 REPL 模式全解
Ch04三种审批模式深度对比
Ch05斜杠命令与快捷键
03
配置与定制
驯服 Agent
config.toml 配置、AGENTS.md 项目指令、沙箱安全机制，让 Codex 按你的规则工作。
Ch06config.toml 配置文件详解
Ch07AGENTS.md 项目指令编写
Ch08沙箱安全机制
04
MCP 工具扩展
连接世界
Model Context Protocol 入门，接入外部工具，让 Codex 操控数据库、浏览器、API。
Ch09MCP 协议入门
Ch10接入常用 MCP Server
Ch11自定义 MCP 工具
05
实战工作流
真实场景
代码理解、Bug 修复、功能开发、Git 集成、CI/CD，覆盖日常开发全流程。
Ch12代码理解与探索
Ch13-14Bug 修复 + 功能开发工作流
Ch15-16Git 集成 + CI/CD
06
高级能力
解锁上限
多模态输入、Sub-Agent 并行、Goal 模式自主任务，以及生产级最佳实践。
Ch17多模态输入（截图→代码）
Ch18-19Sub-Agent 并行 + Goal 模式
Ch20生产级最佳实践
// 审批模式

你决定 AI 的自主权

三种审批模式，从完全人工审核到全自动执行，根据任务风险灵活切换。

🔍
Suggest
codex --approval suggest
默认模式。Codex 分析代码、提出建议，每一步操作都需要你手动确认后才执行。最安全，适合学习阶段或高风险操作。
  • 读取文件，展示 diff，等待确认
  • 每个 shell 命令都需要审批
  • 适合：陌生代码库、生产环境
✏️
Auto Edit
codex --approval auto-edit
平衡模式。Codex 自动读取和修改文件，但执行 shell 命令前仍需确认。适合日常开发，兼顾效率与安全。
  • 自动应用文件编辑，无需逐一确认
  • 网络访问和 shell 命令仍需审批
  • 适合：日常功能开发、重构
⚡
Full Auto
codex --approval full-auto
全自动模式。Codex 在沙箱内自主完成所有操作，包括运行命令、修改文件，无需人工干预。适合 CI/CD 和批量任务。
  • 完全自主执行，沙箱隔离保护系统
  • 适合：CI 流水线、非交互式脚本
  • 配合 AGENTS.md 约束行为边界
// AGENTS.md

给 AI 写工作手册

AGENTS.md 是放在项目根目录的 Markdown 文件，Codex 每次启动都会读取它，作为项目级别的持久化指令。

  • 定义代码风格、命名规范、禁止操作
  • 注入项目背景、技术栈、架构说明
  • 支持层级结构：全局 → 项目 → 子目录
  • 优先级：子目录 AGENTS.md > 项目根 > 全局
AGENTS.md
# 项目规范
 
## 技术栈
- TypeScript 5.x + Node.js 22
- 测试框架：Vitest
- 包管理：pnpm
 
## 代码规范
- 函数命名使用 camelCase
- 每个函数必须有 JSDoc 注释
- 禁止使用 any 类型
 
## 禁止操作
- 不得修改 .env 文件
- 不得删除 tests/ 目录
- 提交前必须运行 pnpm test
// MCP 工具扩展

连接一切外部工具

Model Context Protocol 让 Codex 突破本地文件系统的边界，直接操控数据库、浏览器、API 和云服务。

📚
Context7
实时获取最新库文档，让 Codex 写出符合当前版本 API 的代码
🌐
Playwright
控制浏览器，自动化 E2E 测试，截图调试，爬取网页数据
🗄️
数据库工具
直接查询 PostgreSQL/MySQL，生成迁移脚本，分析数据结构
🔧
自定义工具
编写自己的 MCP Server，将任何 API 或本地工具接入 Codex
← 熵减智算