一、OMX 是什么？GitHub 地址是什么？

OMX 的全称是 Oh My codeX，对应的 GitHub 项目地址是：

https://github.com/Yeachan-Heo/oh-my-codex

它的官方介绍是：“Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.” 简单来说，OMX 是一个基于 OpenAI Codex CLI 的增强工具，可以理解为给 Codex 加了一层更适合工程开发的工作流能力。(GitHub)

它主要可以用来做这些事情：

1. 增强 Codex 的工程协作能力；

2. 支持 agent teams，也就是多智能体协作；

3. 支持 hooks，让 Codex 在执行前后自动触发一些动作；

4. 提供 HUD、状态管理、工作流增强等功能；

5. 让 Codex 更适合处理复杂项目、长期项目和多步骤开发任务。

如果说 Codex CLI 更像是一个单独的代码助手，那么 OMX 更像是在 Codex 外面加了一套工程化调度层，让它更适合做大型项目开发、代码重构、自动化迭代和多 agent 协同任务。

---

二、安装前准备

最近在配置 Codex 相关工具时，很多教程都会提到下面这条命令：

npm install -g @openai/codex oh-my-codex

其中：

• @openai/codex 是 OpenAI Codex CLI；

• oh-my-codex 是对 Codex 使用体验进行增强的工具；

• 安装完成后，通常会得到 codex 和 omx 两个命令。

OMX 依赖 Node.js 和 npm，因此安装前需要先检查系统是否已经安装 Node.js。

在终端中执行：

node -v
npm -v

如果能够正常输出版本号，说明 Node.js 和 npm 已经安装。

例如：

v20.18.0
10.8.2

一般建议使用 Node.js 20 或以上版本。如果你的 Node.js 版本太低，建议先升级。

---

三、推荐使用 nvm 安装 Node.js

在 Linux 上不太建议直接使用系统自带的 Node.js，因为版本可能比较旧。

更推荐使用 nvm 来管理 Node.js 版本。

安装 nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

安装完成后，让配置生效：

source ~/.bashrc

如果你使用的是 zsh，则执行：

source ~/.zshrc

然后安装 Node.js 20：

nvm install 20
nvm use 20
nvm alias default 20

再次检查版本：

node -v
npm -v

---

四、安装 Codex 和 oh-my-codex

Node.js 和 npm 准备好之后，就可以安装 Codex 和 OMX 了。

执行：

npm install -g @openai/codex oh-my-codex

这条命令会全局安装两个工具：

codex
omx

安装完成后，可以检查命令是否已经加入环境变量：

which codex
which omx

如果能输出类似下面的路径，说明命令已经安装成功：

/home/你的用户名/.nvm/versions/node/v20.x.x/bin/codex
/home/你的用户名/.nvm/versions/node/v20.x.x/bin/omx

也可以查看版本：

codex --version
omx --version

---

五、初始化 OMX

安装完成后，建议先运行初始化命令：

omx setup

这个命令会帮助 OMX 生成或检查相关配置。

初始化完成后，再执行环境诊断：

omx doctor

如果环境正常，doctor 命令会输出检查结果。

如果有问题，它通常会提示缺少什么依赖、配置哪里不正确，或者 Codex 登录状态是否异常。

---

六、检查 Codex 登录状态

如果你使用的是 Codex CLI，可以先检查登录状态：

codex login status

如果你使用的是 API Key 配置方式，需要确保你的 API Key 配置正确。

注意：不要把 API Key 直接粘贴到聊天窗口、截图、公开仓库或博客中。

如果你的 API Key 已经暴露，建议立刻到对应平台后台重置。

---

七、最简安装流程

如果你已经有 Node.js 20 以上版本，最简单的安装流程如下：

node -v
npm -v
npm install -g @openai/codex oh-my-codex
omx setup
omx doctor

然后启动 OMX：

omx --madmax --high

或者使用更高推理配置：

omx --xhigh --madmax

---

八、安装完成后的测试命令

下面给出几条测试命令，用来确认 OMX 和 Codex 是否安装成功。

---

1. 检查 Node.js 和 npm

node -v
npm -v

---

2. 检查 Codex 和 OMX 路径

which codex
which omx

---

3. 检查版本号

codex --version
omx --version

---

4. 检查 OMX 环境

omx doctor

---

5. 检查 Codex 登录状态

codex login status

---

6. 运行 OMX 简单测试

在任意目录下执行：

omx exec --skip-git-repo-check -C . "Reply with exactly OMX-EXEC-OK"

如果输出结果中包含：

OMX-EXEC-OK

说明 OMX 基本可以正常调用。

---

7. 在项目目录中测试

进入你的项目目录：

cd /path/to/your/project

例如：

cd ~/Code/test

然后执行：

omx exec "请分析一下当前项目结构，并用中文总结主要文件的作用"

如果 OMX 能够正常读取项目并输出分析结果，说明基本配置完成。

---

8. 测试高推理模式

omx --madmax --high

或者：

omx --xhigh --madmax

如果能够正常进入交互界面，说明 OMX 已经可以正常使用。

---

九、总结

Linux 上安装 OMX 的核心步骤其实很简单：

npm install -g @openai/codex oh-my-codex

但正式安装前，建议先确认 Node.js 版本是否满足要求。

推荐使用下面这套流程：

nvm install 20
nvm use 20
npm install -g @openai/codex oh-my-codex
omx setup
omx doctor

安装完成后，再用下面这条命令做最终测试：

omx exec --skip-git-repo-check -C . "Reply with exactly OMX-EXEC-OK"

只要能够成功输出：

OMX-EXEC-OK

就说明 OMX 已经在 Linux 上安装并配置成功。