OpenAI Codex 开发环境配置与实战指南

免费接入国产模型方案

如果没有开通 Plus 会员，可以通过国产开放模型 API 接入，实现低成本使用。以智谱大模型为例：

1. 注册账号并创建 API Key。
2. 在模型库筛选支持推理 API 的模型（如 glm-4.6）。
3. 复制 base_url 与 api_key。

编辑配置文件：

• Windows: C:\Users\<用户名>\.codex\config.toml
• macOS/Linux: ~/.codex/config.toml

示例配置：

model_name = "glm-4.6"
base_url = "https://api.xxx.com/v1"
api_key_env = "BIGMODEL_KEY"

⚠️ 注意： 不要在配置文件中直接写入 API Key。请在系统环境变量中新增变量 BIGMODEL_KEY 存储密钥，保存后重启 Codex 即可生效。

常见问题处理

自定义模型偶尔会调用系统默认编辑器，导致效率降低。建议在提示词中加入「请使用 Codex 内置编辑接口修改文件」，可降低触发外部调用的概率。

常用命令一览

扩展能力：MCP 工具

MCP（Model Context Protocol）允许 Codex 操作数据库、Excel 或浏览器。以下是两个典型扩展案例。

1. 集成 Context7 获取实时文档

Context7 能让 AI 访问最新的框架文档和 API 用法，避免生成过时代码。例如生成 Next.js 15 路由时，它能即时获取真实写法而非依赖训练语料。

配置方法

在 config.toml 中添加：

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

首次运行会自动加载并显示 ✔ Loaded MCP server: context7。

Windows 用户注意： 若遇超时错误，建议使用完整路径配置 Node.js：

[mcp_servers.context7]
command = "C:\\Program Files\\nodejs\\node.exe"
args = [
  "C:\\Users\\yourname\\AppData\\Roaming\\npm\\node_modules\\@upstash\\context7-mcp\\dist\\index.js",
  "--transport", "stdio",
  "--api-key", "YOUR_API_KEY"
]
startup_timeout_sec = 20.0
[mcp_servers.context7.env]
SystemRoot = 'C:\\Windows'

macOS 用户注意： 显式指定 Node.js 全路径：

[mcp_servers.context7]
command = "/Users/yourname/.nvm/versions/node/v22.14.0/bin/node"
args = [
  "/Users/yourname/.nvm/versions/node/v22.14.0/lib/node_modules/@upstash/context7-mcp/dist/index.js",
  "--transport", "stdio",
  "--api-key", "YOUR_API_KEY"
]

2. 集成 Excel MCP 自动化表格

Excel MCP 让 Codex 能直接创建、读取和修改表格文件，适用于批量报表生成或数据清洗。

配置方法

使用 Python uvx 运行：

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

保存重启后执行 /mcp 应能看到 excel 已加载。

Windows 用户注意： 确保已安装 Python/UV，必要时使用 CMD 启动：

[mcp_servers.excel]
command = "cmd"
args = ["/c", "uvx", "excel-mcp-server", "stdio"]
startup_timeout_sec = 20.0
[mcp_servers.excel.env]
SystemRoot = 'C:\\Windows'

macOS 用户注意： 显式写全路径：

[mcp.excel]
command = "/opt/homebrew/bin/uvx"
args = ["excel-mcp", "--stdio"]

自定义命令与 Prompt

你可以在 .codex/prompts/ 目录下创建文件来自定义指令。例如新建 gitdiff.md：

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

重启 Codex 后执行 /cmd gitdiff main dev，即可自动对比分支并输出结果。这种方式非常适合建立个性化的开发指令库。

IDE 插件与云端模式

VS Code 插件

在 Extensions 搜索 OpenAI Codex 安装。插件支持可视化文件对比、一键撤销及图片识别，与 CLI 共用配置和历史记录。

云端开发

访问网页端可直接上传项目仓库，输入修改指令后 Codex 会自动修改代码并创建 Pull Request。开启自动代码审核功能后，它能对 PR 进行质量检查，例如提示协议变更风险，非常适合团队协作。

SDK 集成

若想在自己的项目中调用 Codex，可使用官方 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);

运行 node index.mjs 即可看到结果。AI 编程的未来在于放大创造力，掌握 Codex 相当于拥有了一个随时待命的超级搭档。