Codex

概述

Codex 是 OpenAI 官方推出的 CLI 编码智能体。它在终端中运行，能够理解你的代码库、提出修改建议、编写代码并执行命令——全部由 OpenAI 模型驱动。通过将 Codex 的请求路由到 OpenModel，你可以使用统一的 API 网关访问多家模型供应商，享受统一计费，无需为不同供应商分别管理 API Key。

本指南将引导你使用 CC-Switch（一款 CLI 编码工具的可视化配置管理器）将 Codex 配置为使用 OpenModel 作为 API 供应商。

客户端专属权益

部分模型可能向 Codex 提供专属可用范围或优惠价格。完成本指南的配置后正常使用 Codex 即可，符合条件的权益会自动应用。详情请参阅客户端专属权益。

前置条件

请确保以下条件已满足：

OpenModel API Key -- 你需要一个有效的 OpenModel API Key。如果你还没有，请参阅认证指南创建。
已安装 CC-Switch -- CC-Switch 是用于配置 Codex API 供应商的工具。如果你尚未安装，请先参阅 CC-Switch 配置指南完成安装。
Node.js -- Codex 需要 Node.js（22 或更高版本）才能运行。如果你尚未安装 Node.js，请前往 nodejs.org 下载并安装 LTS 版本。

提示

你可以打开终端并运行 node --version 来验证 Node.js 是否已正确安装。如果命令返回了版本号（如 v22.x.x），则说明 Node.js 已就绪。

在 CC-Switch 中配置 Codex

在本节中，你将在 CC-Switch 中为 Codex 添加一个 OpenModel 供应商配置。这将告诉 Codex 把 API 请求发送到 OpenModel，而不是直接发送到 OpenAI。

打开 Codex 供应商选项卡

启动 CC-Switch，查看窗口右上角区域的选项卡。点击 Codex 选项卡切换到 Codex 供应商配置视图，然后点击右上角的橙色 Add（添加） 按钮来创建一个新的供应商条目。

打开 CC-Switch，切换到 Codex 选项卡，点击添加

提示

如果你看不到 Codex 选项卡，请确保你正在使用最新版本的 CC-Switch。前往 CC-Switch 发布页面检查更新。

配置供应商设置

在 Add New Provider 页面中，向下滚动到编辑区域。按照以下说明填写各配置项：

API Key -- 输入你的 OpenModel API Key（即你在认证指南中创建的、以 om- 开头的密钥）。请勿在此处填入你的 OpenAI API Key——我们的目的是将请求路由到 OpenModel。
Default Model -- 选择你希望 Codex 默认使用的模型。你可以输入 OpenModel 支持的任何模型（例如 gpt-5.4、o3 或其他支持的模型）。完整的模型列表请参阅可用模型。

所有字段填写完成后，点击页面底部的蓝色 Save（保存） 按钮保存你的配置。

配置供应商设置并保存

提示

如果你不确定 Default Model 该选哪个，gpt-5.4 是一个不错的通用选择。你随时可以在 CC-Switch 中编辑供应商配置来更改它。

提示

请仔细检查 API Key 是否输入正确。常见的错误是在密钥前后多加了空格。建议直接从 OpenModel 控制台复制粘贴密钥，以避免拼写错误。

安装 Codex

如果你尚未安装 Codex，请按照官方安装说明操作：

访问 ChatGPT Learn 网站上的 Codex CLI 入门指南。
按照说明使用 npm 全局安装 Codex：

npm install -g @openai/codex

提示

如果在 macOS 或 Linux 上安装时遇到权限错误，可以尝试使用 sudo 运行命令：sudo npm install -g @openai/codex。在 Windows 上，请确保你的终端（CMD 或 PowerShell）以管理员身份运行。

安装完成后，运行以下命令验证 Codex 是否安装成功：

codex --version

如果命令输出了版本号，说明安装成功。

启动 Codex

CC-Switch 配置完成且 Codex 安装就绪后，你可以启动 Codex 并验证一切是否正常工作。

在项目文件夹中打开终端

导航到你想要使用 Codex 的项目文件夹。在该目录中打开命令提示符（CMD）、PowerShell 或你常用的终端。

提示

在 Windows 上，你可以在文件资源管理器中导航到目标文件夹，点击地址栏，输入 cmd，然后按回车键，即可在该文件夹中打开 CMD。

在项目文件夹中打开 CMD

运行 Codex

在终端窗口中，输入以下命令并按回车键：

codex

在命令行中输入 codex

验证配置

如果一切配置正确，Codex 将启动并显示其交互界面，准备接受你的指令。屏幕应类似于以下显示：

Codex 正在运行——配置完成

如果你看到了这个界面，说明配置已完成。Codex 现在正通过 OpenModel 路由其 API 请求。

常见问题排查

Codex 无法启动或显示认证错误

现象： Codex 无法启动，或启动时显示认证失败的错误。

解决方案：

检查 API Key -- 打开 CC-Switch，进入 Codex 选项卡，确认 API Key 是否正确。确保它以 om- 开头且没有多余的空格。
检查 CC-Switch 是否已生效 -- 在 CC-Switch 中保存配置后，确保该供应商条目处于激活（选中）状态。然后关闭并重新打开你的终端，以使环境变量生效。

提示 "command not found: codex"

现象： 在终端中运行 codex 时提示 command not found: codex。

解决方案：

确保已通过 npm 全局安装了 Codex（npm install -g @openai/codex）。
确保 Node.js 和 npm 在系统的 PATH 中。尝试运行 node --version 和 npm --version 来确认。
如果你刚刚安装了 Node.js，请关闭并重新打开终端以刷新 PATH。

Codex 启动了但使用的模型不对

现象： Codex 能够启动，但使用的模型并非你所配置的模型。

解决方案：

打开 CC-Switch，进入 Codex 选项卡，检查 Default Model 设置。将其更改为你想要的模型（例如 gpt-5.4）并保存。
在 CC-Switch 中修改配置后，需要重新启动 Codex。

Codex 显示网络或超时错误

现象： Codex 显示网络连接错误或请求超时。

解决方案：

确认你的网络可以访问 api.openmodel.ai。尝试在终端中运行 curl https://api.openmodel.ai。
如果你在公司防火墙或代理后面，请确保 api.openmodel.ai 已被允许访问。
查看 OpenModel 控制台是否有正在进行的服务中断。

下一步

可用模型 -- 浏览 OpenModel 支持的所有模型，包括来自 OpenAI、Anthropic、Google、DeepSeek 等供应商的模型。
Claude Code -- 配置 Anthropic 的 CLI 编码智能体 Claude Code 接入 OpenModel。
Gemini CLI -- 配置 Google 的 Gemini CLI 接入 OpenModel。
流式响应 -- 了解如何在编码工具中使用流式响应。
计费 -- 了解所有集成工具的用量和计费方式。

Codex

本页目录