OpenAI Codex 全面上手指南

MCP 工具

MCP（Model Context Protocol）是 Codex 的插件机制，可操作数据库、Excel 等。

安装 Context7 MCP

Context7 提供实时文档支持，避免幻觉。 在 config.toml 添加：

[mcp_servers.context7]
args = ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
command = "npx"

Windows/macOS 用户需注意 Node.js 路径配置。

安装 Excel MCP

让 Codex 直接处理表格文件。 配置示例：

[mcp.excel]
command = "uvx"
args = ["excel-mcp", "--stdio"]

自定义命令

在 .codex/prompts/ 文件夹创建文件定义指令。例如 gitdiff.md：

比较 {{branch1}} 与 {{branch2}} 的差异，并用自然语言总结。

重启后执行 /cmd gitdiff main dev。

IDE 插件环境

在 VS Code 搜索安装 "OpenAI Codex" 插件。支持可视化文件对比与撤销。

云端环境

支持云端开发模式。登录并绑定 GitHub 账户，上传项目仓库，输入修改指令即可自动修改代码并创建 Pull Request。支持自动 Code Review 功能。

SDK 集成

使用官方 SDK 嵌入程序。

npm init -y
npm install codex-sdk

创建 index.mjs：

import Codex from "codex-sdk";
const codex = new Codex();
const result = await codex.ask("写一个输出 Hello World 的 Python 程序");
console.log(result);