Skip to content
Codex 安装接入与使用

Codex使用教程以及功能介绍 ​

第一章:Codex 安装以及接入 Omini API ​

一、安装 Codex(已安装请直接跳过) ​

桌面版、VS Code 扩展和 CLI 三种方式选择一种即可。新版桌面入口位于 ChatGPT 应用中,打开后选择 Codex 模式进行开发工作。

方法一:安装桌面版 ​

  1. 打开 OpenAI 官方安装指南,下载与你的系统对应的桌面应用。
  2. 完成安装并启动应用。需要访问代码项目时,选择 Codex 模式。
  3. 根据后文配置 Omini API,再新建对话验证连接。

下面是原教程中的商店界面参考,软件名称与布局以当前版本为准。

桌面应用商店界面

方法二:通过 VS Code 安装 Codex 扩展 ​

前往 Visual Studio Code 官网 安装编辑器。

  • 打开 VS Code,点击左侧“扩展”,或按 Ctrl+Shift+X(Windows)/ Cmd+Shift+X(macOS)。
  • 搜索 Codex,核对发布者为 OpenAI 后安装。
  • 安装后打开 Codex 面板。需要中文界面时,可在扩展市场安装中文语言包并重启编辑器。

VS Code 扩展入口

VS Code 中文语言包

方法三:安装 Codex CLI ​

先从 Node.js 官网 安装当前 LTS 版本。安装后在新终端检查:

sh
node --version
npm --version

再安装 Codex:

sh
npm install -g @openai/codex
codex --version

安装成功后,进入自己的项目目录,运行 codex。完整的终端操作与手动配置见 Codex CLI 安装教程。

二、接入 Omini API ​

接入时要同时核对 服务地址、API Key、分组和模型。网页登录账号与调用模型的 API Key 是两种不同凭据。

1. 下载 CC Switch ​

CC Switch 可以管理 Codex、Claude Code 等客户端的服务商配置。从 官方 GitHub Releases 下载与你的系统匹配的安装包。

CC Switch 下载页面

安装完成后启动 CC Switch,在客户端列表中选择 Codex,再添加 Omini API 服务商。

CC Switch 界面示例

2. 准备控制台中的密钥 ​

  1. 登录 Omini API 控制台。
  2. 在 API 密钥页面新建或选用一把密钥,确认它绑定的分组具有目标模型权限。
  3. 复制密钥,并记录控制台提供的接入地址和模型 ID。
  4. 如果控制台提供“导入 CCS”,可以直接导入;导入后仍需检查当前客户端是 Codex。

3. 在 CC Switch 中填写配置 ​

字段填写内容
服务商名称Omini API
官网https://api.omini.cn
API Key控制台创建的 API 密钥
API Base URLhttps://api.omini.cn/v1,若导入配置给出了专用地址,使用导入值
请求协议Responses(Codex 所需的协议)
模型当前分组实际开放的完整模型 ID

保存并启用 Omini API。关闭所有正在使用旧配置的 Codex 窗口,再重新启动。桌面端如果仍留在托盘中,也应从托盘退出。

4. 发出第一条验证消息 ​

先问一句“只回复连接成功”,确认能够正常返回。然后在控制台查看刚才的请求记录,核对分组与模型是否符合预期。

连接正常后,再打开一个小项目,让 Codex 读取目录结构。第一步验证通过后再进行较长的编码任务,排查会更直接。

三、导入 CCS 提示未安装时怎么办 ​

先确认 CC Switch 已启动,浏览器允许唤起桌面应用。若自动导入仍未成功,可以按照上面的参数表手动添加服务商。

检查时按以下顺序进行:

  1. 重新复制 API Key,避免空格、换行或遗漏字符。
  2. 确认密钥绑定的分组开放了所选模型。
  3. 确认请求地址没有重复的 /v1/v1。
  4. 在 CC Switch 中启用刚添加的服务商,而不是只完成保存。
  5. 完全退出 Codex 后重新启动。

仍有 401、403 或 404 时,按 常见报错以及解决方法 对照处理。

第二章:基础功能介绍 ​

1. 启动 ​

打开安装好的桌面应用,选择 Codex 模式。应用入口、菜单名称与当前版本有关,参照官方安装说明及下方界面示例。

桌面应用入口

2.建立工作区 ​

在使用之前请确保应用是codex模式

选择 Codex 模式

首次使用先从新建对话开始,codex一大特色就是可以为每个对话绑定工作区文件夹,此后该对话任务会默认优先读取、修改该工作区内的文件

新建工作区对话

选择工作区文件夹

一个工作区可以开多个对话聊天窗口

在工作区中管理多个对话

3. 切换模型 ​

在聊天输入框附近打开模型选择器,选择当前 Omini API 分组已开放的模型。若提供了推理强度选项,可根据任务复杂度调整。

模型名称应与控制台中的完整 ID 一致。原资料中的 5.6、6、6.1 等名称属于不同版本的示例;本页不固定可用模型和价格,请以当前分组的模型列表与计费说明为准。

模型选择界面参考

4.Codex工作模式 ​

一共有三种工作模式:请求批准、帮我批准(自动审核)、完全访问权限

先明确本次任务涉及的目录和操作,再选择适合的权限模式。对需要逐步审阅的改动,可以使用请求批准模式;对范围明确的连续任务,按自己的工作方式调整权限。

自动审核功能的可用性和计费与客户端版本、服务提供方有关,启用前查看界面中的说明。

Codex 权限模式选择

若没有“完全访问权限”这个模式,就去左下角的设置-“常规”-权限里面把“完整访问权限”打开即可

5.计划模式与目标模式 ​

1.计划模式 ​

启用方法:点击聊天框左下角小加号点击计划模式即可开启

开启计划模式

功能介绍:开启之后,codex不会修改代码,只会执行只读操作,中途可能会向你提问,为你制定计划

计划模式任务分析

期间codex会向你提问,确认计划细节

确认计划细节

最后,计划模式会让codex生成一份计划文档,点击“实施此计划”的时候会自动退出计划模式,返回常规模式工作

2.目标模式 ​

开启方法:与计划模式一样,或者直接用对话的方式让codex开启

开启目标模式

目标模式用于明确目标并持续推进任务,适合工作量较大、耗时较长的工作。实际执行仍受预算、运行环境和需要你处理的事项影响,也可以由你手动暂停。

目标模式设置

可以和计划模式一起使用,在codex完成计划之后,让他创建并写入工作区的一个.md格式的文档中,然后开目标模式附带计划文档完成工作,这样的好处是长难工作不容易忘记主线任务,在压缩上下文之后依旧保持高工作效率

结合计划文档执行目标

目标执行状态

创建目标时写清完成标准与必要约束,过程中结合工作区文档检查进度。

6. 插件系统 ​

在客户端的插件页面查看已安装的插件,按实际需要添加工具。插件可能提供资料检索、文件处理或外部服务连接等能力。

插件页面参考

先安装一个与你的任务相关的插件,完成它要求的配置,再在新对话中验证。插件、MCP 与 Skills 的区别和整理方法见 Codex 干货:拓展工具与技能。

7. 定时系统 ​

客户端提供自动化功能时,可以创建需要定期执行的任务,并为它设置工作目录、执行内容与时间安排。先手动运行一次,确认任务能完成,再保存定时设置。

自动化界面参考

任务在本地运行还是云端运行,取决于使用的执行环境。本地任务应确保设备及所需程序在计划执行时可用。

参考资料 ​

Omini API · 安装、接入与使用指南