目录

一、前言

二、Codex 介绍

2.1 Codex 是什么

2.2 Codex能做什么？

2.3 Codex的不同使用模式

三、Codex 进阶技能使用

3.1 Codex 斜杆 / 命令使用

3.1.1 Codex 斜杆 / 命令介绍

3.1.2 Codex 命令分类

3.1.3 常用的命令推荐

3.1.4 Codex 终端交互命令使用

3.2 Codex Skill 使用

3.2.1 使用内置的技能

3.2.2 创建新技能

3.3 外部文件引用

3.3.1 @引用文件

3.3.2 引用图片

3.4 恢复会话

3.4.1 codex 恢复会话常用命令

3.4.2 codex 恢复会话操作

3.5 Codex 配置mcp

3.5.1 Codex mcp 介绍

3.5.2 配置文件位置

3.5.3 Codex 配置MCP实操

3.5.4 Codex MCP 补充

3.6 Codex 提示词编写技巧

3.6.1 提示词工作原理

3.6.2 编写有效提示词技巧

3.7 Codex AGENTS.md 设置

3.7.1 什么是 AGENTS.md ？

3.7.2 AGENTS.md 层级与规范

3.7.3 AGENTS.md 编写技巧

四、写在文末

---

一、前言

Codex 被誉为2026年最值得上手的 AI 工具，它不仅是一个编程 Agent，更是一个几乎可以替换掉任何对话工具的全能 AI。配合高性价比的定价机制和充足的 Token 额度，只要你能想到的场景，它都能帮你自动化完成。可以说，Codex 完美复刻了ChatGPT的模板，让普通的用户也能方便使用一款专属定制、性能强大的桌面版AI助手。同时，在AI编程领域，Codex 也展现出了极高的水准，背后关联的ChatGPT5.5 最新的大模型在编程能力也是独树一帜，本篇将详细介绍Codex 中的一些高级进阶技巧的实用。

二、Codex 介绍

Codex 是 OpenAI 推出的一款AI 编程智能体。与简单的聊天机器人或代码补全工具不同，Codex 能够像一个真实的开发人员一样，独立理解复杂任务、操作你的电脑、编写并修改代码、运行终端命令，甚至自动修复bug。访问入口：https://openai.com/zh-Hans-CN/codex/?utm_source=Ai138.com

2.1 Codex 是什么

简单来说，可以把 Codex 看作一个“能帮你干活的AI工程师”。

• 它是“目标驱动”而非“指令驱动”：你只需告诉它最终的目标（例如：“帮我搭建一个带用户登录功能的网站”），它会自动拆解任务，规划步骤并执行，而不需要你一步步告诉它该怎么做。

• 它不只是一个聊天框：虽然你可以在ChatGPT网页版找到它，但它真正的威力在于桌面应用和命令行工具（CLI）。在这些地方，它可以直接访问你的文件系统、运行终端命令，甚至操作其他软件。

• 它的用户远超程序员：官方数据显示，Codex每周有超过300万用户，其中近一半（50%）的使用场景并非编码。从写周报、整理文档到数据分析，它都足以胜任。

2.2 Codex能做什么？

近期的重大更新让Codex的能力大幅跃升，使其不再局限于编程领域：

• 动打开软件、运行模拟器、发现问题、修改代码，并再次测试验证，完成一整套开发闭环。

• 所见即所得的开发（内置浏览器）：Codex内置了一个浏览器。当你开发网页时，它可以直接在浏览器中展示效果。你可以直接在渲染出的网页上圈出问题，比如圈出一个标题并写上评论“字体太大，颜色改成蓝色”，Codex就能理解视觉和空间上下文，并精准地修改对应的代码。

• “心跳”机制与长期记忆：

  • 自动排班：你可以交付给它一个需要数小时甚至数周的长线任务。即使你关掉电脑，它也会在约定的时间点“自动醒来”，在后台继续工作。

  • 记忆功能：它会记住你的编码偏好和纠正过的错误，下次再合作时，就不需要从头开始解释了。

• 强大的工具生态：Codex已经接入了超过90个插件，可以无缝连接JIRA、GitLab、Microsoft Suite、Slack、Gmail等常用工具。你可以让它去Notion里读文档、去邮箱里看邮件、去项目管理工具里筛选Bug，再把所有信息汇总成一份报告给你。

2.3 Codex的不同使用模式

Codex提供了多种使用方式，用户可以根据自己的需求选择不同的入口：

使用方式	适合人群	核心优势
桌面应用	追求最佳体验的用户	具备最完整的功能，如可视化代码审查、并行任务管理、“操作电脑”功能等
命令行 (CLI)	习惯终端操作的程序员	路径最短，与代码仓库、编辑器和命令行工作流结合最紧密
IDE 插件	不想改变现有开发环境的程序员	在你熟悉的VS Code或Cursor等编辑器中直接调用Codex的能力，接入成本最低
网页版 (ChatGPT)	普通用户或轻度使用者	无需安装，登录 chatgpt.com 即可在左侧边栏找到它，适合处理简单的一次性任务

三、Codex 进阶技能使用

接下来通过实际操作案例演示Codex 的一些进阶技能的使用。

3.1 Codex 斜杆 / 命令使用

3.1.1 Codex 斜杆 / 命令介绍

Codex 里的斜杆 / 是快捷指令系统（Slash Commands）。

我们在对话框中输入/符号后，系统会立即弹出命令面板，列出所有可用命令及其说明。

想用 MCP、Skills、浏览器等只要输入 / 然后选择对应的功能即可。

如下，在对话框中输入斜杠之后，可以看到自动弹出了很多功能选项，方便用户对内置的这些功能项快速打开使用。

比如我想唤起飞书文档功能，选中即可

3.1.2 Codex 命令分类

Codex 目前提供 11 条内置斜杠命令，按功能可分为四大类别：上下文管理、代码与开发工作流、模型与推理控制、个性化与其他，这些内置命令在日常工作中有比较多的使用场景，下面分别做说明。

1）上下文管理

控制对话线程与上下文窗口的命令组。

• /compact 不会丢失关键上下文，它会智能保留重要的代码片段和决策信息，仅压缩冗余的对话轮次。

命令	功能	说明	适用场景
/compact，/压缩	压缩上下文	将当前对话历史进行智能摘要，保留关键信息，释放 token 空间	长对话出现"上下文已满"警告时
/status，/状态	查看状态	输出当前对话 ID、已消耗的上下文 token 数、剩余额度等关键运行参数	决定是否执行耗 token 操作前

如下，在CLI对话终端，输入之后可以看到效果

2）代码与开发工作流

面向开发者的核心功能命令组。

• /side 和 /fork 的区别：/side 是对话层面的分支，适合快速试验；/fork 会创建 Git 分支，适合代码层面的并行开发。

命令	功能	说明	适用场景
/review，/代码审查	代码审查	让 Claude 对当前文件或指定代码段进行系统性审查，检查潜在 bug、安全问题、性能瓶颈和代码风格	提交 PR 前、代码重构后
/side，/侧边	侧边对话	在临时分支中发起独立对话，不影响主线，完成后可合并、丢弃或保留	想快速试某个方案但不污染主对话历史
/fork，/派生	派生分支	将对话分叉为本地 Git 分支或全新工作树，支持并行探索不同方案	需要对比方案 A 与方案 B 时
/mcp	MCP 状态	列出当前对话中已连接的所有 MCP（Model Context Protocol）服务器，查看在线状态及可用工具列表	外部工具不响应时排查连接状态

3）模型与推理控制

调整 AI 能力与思考深度的命令组。

• 高强度推理响应更慢但答案更准确，低强度响应更快。调试复杂 bug 时建议切换到高推理模式。

命令	功能	说明	适用场景
/reasoning，/推理模式	推理强度	在低 / 中 / 高三档推理强度间切换，命令后实时显示当前档位	复杂算法题调高，日常问答保持中低
/model，/模型	模型切换	在不同 AI 模型间切换，命令后显示当前模型名	快速生成样板代码选轻量模型，深度架构分析选旗舰模型

进去之后可以看到提供了多种模型可供选择

4）个性化与其他命令

体验定制与辅助功能命令组。

命令	功能	说明	适用场景
/persona，/个性	设置个性	调整 Claude 的回复语气和风格，如"简洁直接"、"详细教学"或"资深工程师"等预设	团队协作时统一输出风格
/feedback，/反馈	提交反馈	快速打开反馈通道，报告 bug、提出功能建议或分享使用体验	遇到输出质量问题时立即反馈
/pet，/宠物	桌面宠物	切换 Claude Code 内置的桌面宠物显示状态，一个小彩蛋功能	需要专注时收起，休息时唤出

3.1.3 常用的命令推荐

下面给出日常工作中推荐使用的命令

# 步骤1：开始新任务前，检查上下文余量
/status

# 步骤2：遇到复杂问题，提升推理强度
/reasoning   # 切换至"高"档

# 步骤3：完成代码改动后，启动审查
/review

# 步骤4：探索不确定的方案，开启侧边对话
/side

# 步骤5：上下文快满时，压缩历史
/compact

# 清理当前上下文会话
/clear

3.1.4 Codex 终端交互命令使用

在某些情况下，可以不用打开codex的会话窗口，直接执行任务，使用 codex + 任务名称即可，如下：

使用场景：

• 当你已经知道要问什么时，可以一行命令直接启动。

其他终端执行命令补充：

命令	说明
codex	启动交互式 TUI
codex "任务"	启动并执行指定任务
codex --version	显示版本信息
codex --help	显示帮助信息

3.2 Codex Skill 使用

Codex 中提供了对skills的使用，相当于是Codex自身能力的扩展，如下，打开Codex 桌面端可以看到列出了部分自带的skills

CLI中可以通过 /skills 命令查看内置的skill

进入之后，可以看到下面又弹出2个命令，第一个为列出skills

选择列出当前的skills，可以看到，codex 默认内置了一些常用的skills

3.2.1 使用内置的技能

如下，我们选择一个自带的技能使用一下，点击之后，自动跳转到一个新的对话框

接下来等待响应输出即可

如果是在CLI端，参考上面的列出skills之后，选择某一个skill，然后带上你的需求提示词即可

3.2.2 创建新技能

如果内置的技能不能满足你的个性化需求，codex 客户端界面上还提供了一个魔法技能，即基于这个魔法技能可以创造出属于你自己的技能，如下，点击右上角的New skill

来到下面的对话框，在这里可以创建属于你自己的skill

比如我这里让AI帮我创建一个工作周报文档输出的skill

我想创建一个技能，根据我提供的每周工作情况的描述，能够生成一份比较详细的工作周报总结

中间会陆续弹出需要用户手动确认的操作提示

生成完成后，可以做一下效果测试，直接在当前的会话里通过自然语言将这个技能加载进来

加载进来之后，在技能列表那里就能看到这个技能了

然后我们输入一段工作情况说明，让其生成周报总结

可以看到，很快就根据上面的技能输出了一份工作汇报

3.3 外部文件引用

在下面的这些场景中，你可能需要引用其他文件，从而给到AI作为背景参考资料：

• 参考其他现有的案例，生成类似的信息、资料

• 解读图片中的信息，如果自己写提示词难度较大

• 将其他文件作为上下文参考资料执行自己的任务

• ...

3.3.1 @引用文件

使用@命令，可以将指定的文件带入到当前的会话，如下，当我输入@+文件前缀的时候，自动会把当前目录下的文件带出来，然后按下 tab 键就能选中这个文件

• 引用具体文件，可以让Codex 工作更高效

比如下面这个需求，参考当前的文件，就能快速生成一份结构类似的文档

如果是在客户端使用@就更便捷了，输入@之后，自动会把需要引用的文件给带出来

3.3.2 引用图片

你可以直接把图片粘贴到编辑器里，这样就可以将图片作为上下文加载到prompt中去

当然，也可以在CLI终端窗口，使用 -i 或者 --image 来附加图片做处理，如下：

codex -i 图片完整路径 '提示词'

或者下面这样

codex --image 图片完整路径 '提示词'

3.4 恢复会话

3.4.1 codex 恢复会话常用命令

在codex 中恢复会话有下面几种命令：

• codex resume

  • 直接输入 codex resume ，会弹出会话选择，允许你选择要恢复的历史会话

• codex resume -last

  • 恢复最近的一次会话

• codex resume sessionId

  • 通过会话ID恢复某个特定会话，会话ID可以通过 /status命令，或者在~/.codex/sessions/ 这个目录下找到

3.4.2 codex 恢复会话操作

当你在终端CMD窗口通过codex指令打开一个窗口时就表明开启了一个会话

官方文档说明，Codex 会把会话记录保存在本地，可以通过 codex resume 重新打开之前的会话，避免重复输入上下文。

如果不小心把会话窗口关闭了，适合长期任务，比如：

1. 一个复杂重构做了几天

2. 昨天已经分析过项目架构

3. 上次已经生成过迁移方案

4. 今天想继续接着处理

执行命令后选择最近的会话继续即可。如下，当我们关闭上面的会话窗口后，此时，CMD窗口输入：

codex resume

然后会弹出下面近期打开过的会话

光标定位到某一个上面之后，就可以快速进入到上次的对话

如果是通过会话ID恢复，可以先通过 /status 找到会话ID，如下，就是会话ID

codex resmue 会话ID

3.5 Codex 配置mcp

3.5.1 Codex mcp 介绍

Codex 还有一个扩展能力的方法就是MCP （模型上下文协议）,简单的说，MCP就是 AI 大模型的标准化工具

箱，它能访问第三方文档、外部工具或共享信息。在下面的场景中可以考虑使用Codex MCP服务：

• 智能代码审查与分析：比如，对它说“分析 @src/ 目录下的代码架构，找出潜在的安全问题”。

• 自动化重构与文档生成：下指令如“使用 Codex 重构 @utils/ 下的数据处理逻辑，并生成相应的单元测试”。

• 大规模代码库理解：通过 @ 符号引用文件或整个目录，让你快速理解不熟悉的项目结构。

如下，在Codex 客户端，可以通过右下角的设置按钮点进去查看，在可视化的界面上配置更直观

如果是在CLI命令行，可以通过 /mcp 命令唤起mcp

点进去之后，如果你已经提前配置过mcp服务，可以在这里展示出来

3.5.2 配置文件位置

MCP 服务器在 ~/.codex/config.toml 的 mcp_servers 部分配置。

3.5.3 Codex 配置MCP实操

通过看文档来学习如何配置MCP是枯燥难懂的事情，可以直接让Codex 帮我们完整开发一个MCP服务并且配置进去，通过其完整的执行过程来学习Codex是如何将一个MCP加载进去的，给出如下提示词

通过上述执行过程中的日志输出可以清晰看到Codex 配置MCP的完整过程，最终将MCP服务创造出来并且配置到config.toml这个文件中，打开之后可以看到已经写入进去了

MCP 服务放在当前打开的会话所在的项目目录下

此时再在Codex 客户端页面上也能看到这个MCP服务已经加载进去

我们测试一下效果如何，选中上面创建的这个MCP

在对话框中输入一段正则表达式

如果是CLI，可以通过 /mcp 进入，可以看到展示出来了上面安装的这个MCP服务

选择这个MCP 的名称，后面加上你的提示词即可

3.5.4 Codex MCP 补充

使用过MCP服务的同学应该不陌生，MCP 是有2种主流的使用方式，stdio 和HTTP ，Codex 对这两种方式的配置都支持

stdio 类型服务器

[mcp_servers.filesystem]
# 服务器启动命令
command = "npx"

# 传递给命令的参数
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]

# 服务器工作目录
cwd = "/path/to/workdir"

# 传递环境变量
env = {
    NODE_ENV = "production"
}

HTTP 类型服务器

[mcp_servers.docs]
# MCP HTTP 服务器端点
url = "https://docs.example.com/mcp"

# 包含的 HTTP 头
http_headers = {
    Authorization = "Bearer token"
}

限制可用工具

你可以限制 MCP 服务器暴露的工具：

• 使用工具限制可以提高安全性，只暴露你需要的工具。

[mcp_servers.filesystem]
# 允许的工具列表
enabled_tools = ["read_file", "write_file", "list_directory"]

# 拒绝的工具列表（在 enabled_tools 之后应用）
disabled_tools = ["delete_file"]

超时配置

[mcp_servers.slow_server]
command = "python"
args = ["-m", "slow_server"]

# 启动超时（秒，默认 10）
startup_timeout_sec = 30

# 每个工具调用超时（秒，默认 60）
tool_timeout_sec = 120

MCP 工具权限

• 你可以为每个 MCP 服务器的工具单独设置权限：

  • ask 每次执行前询问（默认）

  • approve 自动批准

  • deny 自动拒绝

[mcp_servers.docs.tools.search]
# 权限模式：ask | approve | deny
approval_mode = "approve"

3.6 Codex 提示词编写技巧

掌握有效的提示词技巧是充分利用 Codex CLI 的关键。接下来详细介绍如何编写高效的提示词来获得最佳结果。

3.6.1 提示词工作原理

当你提交提示词时，Codex 会按以下循环工作，大致的工作流程如下：

1. 调用语言模型

2. 执行模型输出指示的操作（读取文件、编辑文件、运行工具等）

3. 重复直到任务完成或你取消

理解这个循环有助于你更好地设计提示词，因为 Codex 会在每个步骤中基于上下文做出决策。

基本示例：

# 解释代码功能
"Explain how the transform module works and how other modules use it."

# 添加新功能
"Add a new command-line option `--json` that outputs JSON."

# 修复 bug
"Fix the error in the login function"

3.6.2 编写有效提示词技巧

高质量的提示词不仅可以让Codex能够更好的理解语义，从而给出更精准的任务执行结果，而且可以减少大模型的理解成本，让任务执行效率更高。

技巧 1：包含验证步骤

Codex 在能够验证工作时会产生更高质量的输出。包含验证步骤可以帮助 Codex 确保正确性：

# 不推荐
"Write a function to sort a list"

# 推荐 - 包含验证
"Write a function to sort a list. Include test cases to verify it handles empty lists, already-sorted lists, reverse-sorted lists, and lists with duplicates. Run the tests to confirm they pass."

技巧 2：将复杂任务拆分为小步骤

Codex 处理较小的、专注的任务时表现更好。小任务更容易测试和审查：

# 不推荐 - 任务太大
"Create a complete user authentication system with login, registration, password reset, and OAuth"

# 推荐 - 拆分为小步骤
Step 1: Create a user model with email and password fields
Step 2: Add a registration endpoint
Step 3: Add a login endpoint with JWT
Step 4: Add password reset functionality
Let me know when Step 1 is done before moving to Step 2

技巧 3：提供上下文

提供 Codex 可以使用的上下文，能够让AI更好的理解问题的意图，比如引用相关文件和图像在提示词中：

# 不推荐
"Fix this bug"

# 推荐 - 包含详细信息
"Fix the bug in src/auth.py where users can't log in with special characters in their password. I've attached a screenshot of the error message and the relevant code section."

技巧 4：明确输出格式

告诉 Codex 你期望的输出格式：

# 指定代码风格
"Write a function to calculate Fibonacci numbers. Use TypeScript, include JSDoc comments, and follow functional programming principles."

# 指定输出结构
"Explain the codebase structure. Organize your answer with: 1) Overview 2) Key directories 3) Main entry points"

越具体的提示词通常会产生越好的结果。Codex 擅长理解意图，但你提供的信息越多，它的表现越好。

3.7 Codex AGENTS.md 设置

3.7.1 什么是 AGENTS.md ？

AGENTS.md，也就是你给codex设置的家法规矩。对于 Codex 而言，我们每开启一个新的对话窗口，它都会进入一个全新的上下文。它不记得之前发生了什么，对于整个项目的记忆都是空白的。

所以 Codex 提供了记忆系统来解决这样的问题：AGENTS.md 就是给 Codex 这类编码Agent看的项目说明文件，它可以描述项目结构、开发命令、测试要求、代码风格和协作边界。

通过 AGENTS.md，你可以确保 Codex 在整个代码库中遵循一致的规范。

更多内容介绍可以进入官方文档查看：AGENTS.md

3.7.2 AGENTS.md 层级与规范

AGENTS.md 的配置分为两个层级：全局级（影响所有项目）和项目级（仅影响当前文件夹）。建议先配置全局规则作为底线，再为特定项目补充专属要求。

AGENTS.md 的三层加载机制：

层级	加载规则	说明
全局层	读取 ~/.codex/AGENTS.override.md	若不存在则读取 ~/.codex/AGENTS.md，只取第一个非空文件
项目层	从 Git 根目录逐级向当前目录扫描	每层依次检查 AGENTS.override.md → AGENTS.md → project_doc_fallback_filenames 中的备选文件名
合并层	从根到叶依次拼接	越靠近当前目录的文件出现越晚，优先级越高

如果想要全局生效，有以下两种方式：

请默认用中文回答。
如果涉及代码或命令，请先用大白话解释目的，再给具体操作。
如果要修改文件、运行命令、访问外部账号，请先告诉我风险。
如果我的需求信息不完整，请先问我缺什么，不要直接编。

1. 在系统的全局 Codex 文件夹里面找到 agents.md，它是你为codex提供的全局通用的规则。

2. 在 Codex 桌面 App 里面打开设置，找到“个性化”，在其中填写“自定义指令”。这里面设置的就是全局的 agents.md 文件。

设置全局文件后，对于所有的项目都会生效。这个设好了，不管你以后开多少个新对话，他都会记得。

比如，你可以自定义指令

请默认用中文回答。
如果涉及代码或命令，请先用大白话解释目的，再给具体操作。
如果要修改文件、运行命令、访问外部账号，请先告诉我风险。
如果我的需求信息不完整，请先问我缺什么，不要直接编。

在Codex 客户端的设置中，找到个性化配置，然后将你要设置的规则粘贴进去，这里设置的就是全局级的指令，后面在每一个对话中都会全局生效。

3.7.3 AGENTS.md 编写技巧

对Claude Code 比较熟悉的同学应该还记得，CLAUDE.md文件在第一次生成的时候，可以使用 /init 命令生成，在Codex 中，针对项目级的AGENTS.md文件的生成，也可以使用同样的方式来生成，以Codex 在项目编程中的应用，有下面2种方式快速得到AGENTS.md

1）方式一：通过自然语言对话

进入项目主目录后，输入下面的提示词

认真阅读并分析当前的PDA模块的项目，然后在当前模块的根目录下创建 AGENTS.md文件，该文件算是对pda模块项目的规范文件，后续整个开发团队都将遵守这个规范进行日常编程开发，我也会与你共创并完善这个文件

输入提示词之后，等待AI的响应，最终在项目根目录下生成了AGENTS.md 文件

• 通过检查生成的文件，可以看到，AI 完整解析了当前的这个模块的代码结构、当前项目的代码规范、日志规范等，后续可以继续根据实际情况对这个文件进行持续完善

2）方式二：使用 /init命令

进入项目主目录后，以CLI方式开启一个会话，直接输入 /init 命令，等待AI生成AGENTS.md 文件

小结：

通常来说，针对于我们打开的项目，可以在项目根目录下创建一个 agents.md 的文件，它是 Codex 的记忆文件，Codex 在开始工作之前会先读取 agents.md 的内容，可以将其理解为打开会话的时候，自动将agents.md 的内容加载到上下文环境中

四、写在文末

本文通过较大的篇幅详细介绍了Codex 的一些实用高级技巧，在日常开发工作中有比较多的应用场景，并通过案例介绍了相关技巧的具体操作实践过程，希望对看到的同学有帮助，本篇到此结束，感谢观看。