Codex CLI 使用教程

场景化使用教程

难度：●●○中等参考时长：约 10-15min

🌐 本指南内容三端通用

前置说明

本教程假设你已完成 Codex CLI 的安装和配置。如果还没配置，请先查看「配置指南」标签页。

1基本操作

启动与对话

bash

# 进入项目目录启动

cd 你的项目路径

codex

# 单次任务模式

codex "帮我创建一个 React 组件"

# 交互模式

codex

Codex 会分析你的项目结构，然后进入对话模式。输入自然语言描述需求即可。

验证：确认 Codex 正常工作

启动后输入以下测试提示词，观察 AI 是否能正确理解项目并给出响应：

text

# 在 codex 交互模式中输入

请分析一下这个项目的目录结构和技术栈

# 预期响应：Codex 应列出项目的主要目录、文件类型、并推断出使用的技术栈

# 如果 Codex 回答与项目实际不符 → 检查 config.toml 中的 openai_base_url 和 api_key 配置

与 Claude Code 的操作差异

沙箱模式：Codex 默认使用沙箱隔离运行。推荐 workspace-write 模式——可修改项目目录内文件，不能触碰系统目录
审批机制：执行命令前 Codex 会先显示即将运行的命令，确认后才执行（可通过 approval_policy 配置）
项目隔离：不同文件夹 = 不同项目，可开启多个终端并行处理不同任务

沙箱三种模式

read-only（只读，最安全）→ workspace-write（推荐，可修改项目文件）→ danger-full-access（全盘访问，⚠️ 有误删风险）。详见「配置指南」。

2沙箱与项目管理

项目隔离

每个文件夹是一个独立项目，Codex 会为每个项目维护独立的上下文：

bash

# 在不同项目间切换

cd ~/project-a && codex # 项目 A

cd ~/project-b && codex # 项目 B（独立的上下文）

多进程并行

同一项目可以开启多个 Codex 进程，并行处理不同任务：

bash

# 终端 1：前端开发

cd ~/my-project && codex

> 帮我优化前端的性能

# 终端 2：后端开发（同时运行）

cd ~/my-project && codex

> 帮我写一个用户认证的 API

3Git 与工作流

Codex 可以帮你完成 Git 操作：

text

# 初始化 Git 仓库

帮我把这个项目初始化成 git 工程，排除 node_modules

# 自动提交

帮我提交代码，commit 信息用 "feat: add user API"

# 创建仓库

在 GitHub 上创建一个新仓库，把这个项目推上去

# 需要提供 GitHub 用户名和 Token

安全提醒

使用 Git 功能前，确保重要代码已有备份。不要让 Codex 执行 git push --force 等危险操作。

Git 操作验证

Codex 执行 Git 操作后，手动确认结果：

bash

# 确认 commit 已生成

git log --oneline -3

# 确认 .gitignore 已创建且包含 node_modules

cat .gitignore | grep node_modules

# 确认 GitHub 仓库已创建（浏览器访问）

# https://github.com/你的用户名/仓库名

4Codex++ 增强工具

Codex++ 是基于 Rust + Tauri 开发的第三方增强启动器，不修改原始安装文件，通过 Chromium DevTools Protocol 注入增强脚本：

插件解锁：API Key 模式下也能正常使用插件（这是官方缺失的入口）
会话管理：真正删除会话（非归档）+ Markdown 导出对话记录
项目管理：项目移动、Timeline 时间线显示
中转注入：图形化管理多中转站和 API Key，自动路由到不同供应商
高级功能：自定义脚本注入、Zed 远程打开、Upstream worktree 智能创建
Windows / macOS 双平台支持

下载与配置步骤见配置指南 → §4 方案 B Codex++。

5高级功能

Codex 与 Claude Code 定位不同——Codex 默认沙箱保护更完善，Claude Code 文件操作更直接。详细对比见工具对比表。

Skills（技能系统）

Codex 支持 Skills，可以创建可复用的专业化指令。技能文件放在项目的 .codex/skills/ 目录下。

Memory 系统

Codex 支持两种层级的项目说明文件：

项目级：项目根目录创建 AGENTS.md（类似 Claude Code 的 CLAUDE.md），Codex 启动时自动读取
用户级：在 ~/.codex/ 目录下可放置全局配置文件，对所有项目生效

AGENTS.md 示例：

markdown

# AGENTS.md 示例

## 项目简介
React + Express 全栈电商应用

## 技术栈
- 前端: React 18 + TypeScript + Tailwind CSS
- 后端: Express + Prisma + PostgreSQL
- 测试: Vitest

## 编码规范
- 使用 TypeScript 严格模式
- 组件使用函数式写法
- API 使用 RESTful 风格

## 注意事项
- 不要直接修改 prisma/schema.prisma，需要通过 migration
- 前端路由在 src/routes.tsx 中定义

总结

Codex 适合已有 ChatGPT 订阅的用户，沙箱设计更安全但灵活性不如 Claude Code。两者可以配合使用——根据任务类型选择合适工具。

有疑问？来这里找答案

如果对本站内容有疑问，推荐到视频或其他知识性平台寻求解决方法，也可直接向 AI 提问获得参考性回答（注意分辨 AI 回答的正确性）

视频教程

B站搜索教程

视频演示 + 疑难解答

Codex CLI 使用教程

场景化使用教程

难度：●●○中等参考时长：约 10-15min

🌐 本指南内容三端通用

前置说明

本教程假设你已完成 Codex CLI 的安装和配置。如果还没配置，请先查看「配置指南」标签页。

1基本操作

启动与对话

bash

# 进入项目目录启动

cd 你的项目路径

codex

# 单次任务模式

codex "帮我创建一个 React 组件"

# 交互模式

codex

Codex 会分析你的项目结构，然后进入对话模式。输入自然语言描述需求即可。

验证：确认 Codex 正常工作

启动后输入以下测试提示词，观察 AI 是否能正确理解项目并给出响应：

text

# 在 codex 交互模式中输入

请分析一下这个项目的目录结构和技术栈

# 预期响应：Codex 应列出项目的主要目录、文件类型、并推断出使用的技术栈

# 如果 Codex 回答与项目实际不符 → 检查 config.toml 中的 openai_base_url 和 api_key 配置

与 Claude Code 的操作差异

沙箱模式：Codex 默认使用沙箱隔离运行。推荐 workspace-write 模式——可修改项目目录内文件，不能触碰系统目录
审批机制：执行命令前 Codex 会先显示即将运行的命令，确认后才执行（可通过 approval_policy 配置）
项目隔离：不同文件夹 = 不同项目，可开启多个终端并行处理不同任务

沙箱三种模式

read-only（只读，最安全）→ workspace-write（推荐，可修改项目文件）→ danger-full-access（全盘访问，⚠️ 有误删风险）。详见「配置指南」。

2沙箱与项目管理

项目隔离

每个文件夹是一个独立项目，Codex 会为每个项目维护独立的上下文：

bash

# 在不同项目间切换

cd ~/project-a && codex # 项目 A

cd ~/project-b && codex # 项目 B（独立的上下文）

多进程并行

同一项目可以开启多个 Codex 进程，并行处理不同任务：

bash

# 终端 1：前端开发

cd ~/my-project && codex

> 帮我优化前端的性能

# 终端 2：后端开发（同时运行）

cd ~/my-project && codex

> 帮我写一个用户认证的 API

3Git 与工作流

Codex 可以帮你完成 Git 操作：

text

# 初始化 Git 仓库

帮我把这个项目初始化成 git 工程，排除 node_modules

# 自动提交

帮我提交代码，commit 信息用 "feat: add user API"

# 创建仓库

在 GitHub 上创建一个新仓库，把这个项目推上去

# 需要提供 GitHub 用户名和 Token

安全提醒

使用 Git 功能前，确保重要代码已有备份。不要让 Codex 执行 git push --force 等危险操作。

Git 操作验证

Codex 执行 Git 操作后，手动确认结果：

bash

# 确认 commit 已生成

git log --oneline -3

# 确认 .gitignore 已创建且包含 node_modules

cat .gitignore | grep node_modules

# 确认 GitHub 仓库已创建（浏览器访问）

# https://github.com/你的用户名/仓库名

4Codex++ 增强工具

Codex++ 是基于 Rust + Tauri 开发的第三方增强启动器，不修改原始安装文件，通过 Chromium DevTools Protocol 注入增强脚本：

插件解锁：API Key 模式下也能正常使用插件（这是官方缺失的入口）
会话管理：真正删除会话（非归档）+ Markdown 导出对话记录
项目管理：项目移动、Timeline 时间线显示
中转注入：图形化管理多中转站和 API Key，自动路由到不同供应商
高级功能：自定义脚本注入、Zed 远程打开、Upstream worktree 智能创建
Windows / macOS 双平台支持

下载与配置步骤见配置指南 → §4 方案 B Codex++。

5高级功能

Codex 与 Claude Code 定位不同——Codex 默认沙箱保护更完善，Claude Code 文件操作更直接。详细对比见工具对比表。

Skills（技能系统）

Codex 支持 Skills，可以创建可复用的专业化指令。技能文件放在项目的 .codex/skills/ 目录下。

Memory 系统

Codex 支持两种层级的项目说明文件：

项目级：项目根目录创建 AGENTS.md（类似 Claude Code 的 CLAUDE.md），Codex 启动时自动读取
用户级：在 ~/.codex/ 目录下可放置全局配置文件，对所有项目生效

AGENTS.md 示例：

markdown

# AGENTS.md 示例

## 项目简介
React + Express 全栈电商应用

## 技术栈
- 前端: React 18 + TypeScript + Tailwind CSS
- 后端: Express + Prisma + PostgreSQL
- 测试: Vitest

## 编码规范
- 使用 TypeScript 严格模式
- 组件使用函数式写法
- API 使用 RESTful 风格

## 注意事项
- 不要直接修改 prisma/schema.prisma，需要通过 migration
- 前端路由在 src/routes.tsx 中定义

总结

Codex 适合已有 ChatGPT 订阅的用户，沙箱设计更安全但灵活性不如 Claude Code。两者可以配合使用——根据任务类型选择合适工具。

有疑问？来这里找答案

如果对本站内容有疑问，推荐到视频或其他知识性平台寻求解决方法，也可直接向 AI 提问获得参考性回答（注意分辨 AI 回答的正确性）

视频教程

B站搜索教程

视频演示 + 疑难解答