Codex 高级功能实战：斜杠命令、技能配置与提示词技巧

1 阅读

Codex 不只是代码补全工具

Codex 并非简单的聊天机器人或行内代码建议插件。它能理解多步骤任务，在本地执行终端命令，修改项目文件，甚至根据错误日志自动修复问题。这种能力让它更像一个可协作的开发伙伴，而不是被动响应的助手。要发挥它的全部潜力，需要掌握一系列高级功能，而不仅仅是输入自然语言描述。

文章配图

本文整理了在日常开发中验证有效的进阶技巧，重点围绕命令系统、技能扩展、上下文管理等核心机制展开，帮助你把 Codex 从“能用”变成“好用”。

斜杠命令：直接调用内置动作

Codex 支持以 / 开头的命令，用于快速触发特定行为。这些命令绕过自然语言解析，直接调用预设功能，效率更高，也更可靠。

命令分类与常用示例

命令大致分为几类：

  • 会话控制：如 /new 开启新对话，/clear 清空当前上下文。
  • 文件操作：/open <文件路径> 打开指定文件，/save 保存当前编辑内容。
  • 终端交互：/run <命令> 在集成终端中执行 shell 指令，比如 /run npm test。
  • 调试辅助：/explain 让 Codex 解释选中的代码段，/test 自动生成单元测试。

其中 /run 和 /open 使用频率最高。例如，当你让 Codex 修改某个组件后，可以直接输入 /run pnpm dev 启动本地服务验证效果，无需切换窗口。

终端交互的实际限制

虽然 /run 能执行命令，但它并非万能。某些需要交互式输入的操作（如 git rebase -i）可能无法正常工作。此外，长时间运行的任务（如构建大型项目）可能导致超时。建议将复杂流程拆解为多个短命令，或通过脚本封装后再调用。

技能（Skill）：扩展 Codex 的能力边界

技能是 Codex 的核心扩展机制。你可以使用官方提供的内置技能，也可以编写自己的技能来处理特定任务。

使用内置技能

Codex 默认集成了若干实用技能，比如：

  • 文件搜索：通过自然语言查找项目中的相关代码。
  • 依赖分析：自动识别并建议更新过时的 npm 包。
  • 格式化：统一代码风格，支持 Prettier 或 ESLint 规则。

启用方式通常是在提示词中明确提及，例如：“使用依赖分析技能检查 package.json 中是否有安全漏洞”。

创建自定义技能

当内置功能无法满足需求时，可以编写自定义技能。一个技能本质上是一个 JSON 配置文件，定义了：

  1. 触发条件：什么关键词或上下文会激活该技能。
  2. 执行逻辑：调用哪些 API、脚本或内部函数。
  3. 输出格式：结果如何呈现给用户。

例如，你可以创建一个“部署预检”技能，在用户提到“上线”或“deploy”时，自动运行 lint、test 和构建检查，并汇总结果。技能文件通常放在项目根目录的 .codex/skills/ 下。

外部上下文引用：让 AI 看懂你的项目

Codex 的回答质量高度依赖上下文。仅靠聊天历史远远不够，必须主动引入相关文件。

@ 引用文件

在对话中输入 @文件名（如 @src/utils/api.ts），Codex 会将该文件内容作为上下文加载。这对于跨文件修改尤其重要。比如你要重构一个 API 客户端，先 @ 引用旧实现，再说明新需求，AI 才能准确生成兼容代码。

注意：引用过多文件会消耗大量 token，可能导致截断。建议只引入直接相关的文件，必要时分批引用。

图片引用的局限性

目前 Codex 对图片的理解能力有限。虽然可以上传截图，但仅能识别基础 UI 元素或简单图表，无法解析复杂架构图或手写笔记。对于设计稿，最好辅以文字说明关键交互逻辑。

会话恢复：中断后继续工作

开发过程中难免被打断。Codex 提供了会话恢复机制，避免重复描述上下文。

恢复命令与操作

使用 /session list 可查看历史会话 ID。通过 /session load <ID> 即可恢复指定会话，包括之前的文件引用、终端输出和对话记录。恢复后，Codex 能接着上次的进度继续执行任务。

实际使用中，建议在开始重要任务前手动创建命名会话（如 /session save feature-login），方便后续精准定位。

MCP 配置：连接外部服务

MCP（Model Connection Protocol）允许 Codex 安全地访问外部 API 或数据库。

配置流程

  1. 找到配置文件：通常位于 ~/.codex/mcp.json。
  2. 添加服务定义：指定服务名称、认证方式（如 API Key）、基础 URL 和可用方法。
  3. 授权使用：在提示词中声明“使用 [服务名] 查询数据”。

例如，配置 Jira MCP 后，你可以直接让 Codex “查询 PROJ-123 的当前状态”，它会自动调用 Jira API 并返回结果。

安全注意事项

MCP 配置文件包含敏感凭证，务必：

  • 不要提交到版本控制系统。
  • 使用环境变量替代硬编码密钥。
  • 限制每个 MCP 的权限范围，遵循最小权限原则。

提示词编写：少说废话，多给约束

好的提示词不是越长越好，而是精准提供约束条件。

有效提示的关键要素

  • 明确目标：不要说“优化代码”，要说“将时间复杂度从 O(n²) 降到 O(n log n)”。
  • 指定技术栈：注明使用的框架、语言版本和依赖库。
  • 给出输入输出示例：尤其是数据处理类任务，示例比文字描述更有效。
  • 限制范围：强调“不要修改 X 文件”或“仅使用标准库”。

例如，与其说“写一个用户登录功能”，不如说：“用 Next.js 14 App Router 实现登录页，调用 /api/auth 接口，使用 React Hook Form 验证邮箱格式，错误信息显示在输入框下方。”

AGENTS.md：定义团队协作规则

在多人项目中，AGENTS.md 文件用于统一 Codex 的行为规范。

文件结构与作用

该文件通常放在项目根目录，内容包括：

  • 角色定义：如“前端 Agent 负责 UI 实现，不修改后端逻辑”。
  • 代码风格：缩进、命名约定、注释要求。
  • 禁止行为：如“不得删除未被引用的导出”或“禁止使用 any 类型”。

当团队成员都遵循同一份 AGENTS.md，Codex 生成的代码风格和逻辑会更一致，减少后期整合成本。

编写建议

  • 保持简洁，用 bullet points 列出关键规则。
  • 优先写“必须做”和“禁止做”，少写“建议”。
  • 定期根据项目演进更新文件内容。

掌握这些进阶技巧后，Codex 就不再只是一个代码生成器，而真正成为你开发流程中的自动化协作者。关键在于主动管理上下文、精确控制行为，并通过配置将其深度融入现有工具链。