OmX 首次安装后如何依次运行 omx doctor、codex login status 和 omx exec 冒烟测试确认可以真实执行【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex刚用npm install -g oh-my-codex装好 Oh My codeXOMX后还不能直接开始跑工作流。官方文档把安装成功和真实可执行分成两道边界omx doctor只验证 OMX 的本地安装面prompts、skills、AGENTS 脚手架、config 文件、hooks 和运行时前置条件而当前 Codex profile 能否完成一次带认证的模型请求必须用codex login status加一次真实的omx exec冒烟测试来证明。本文按安装 → setup →omx doctor→codex login status→omx exec冒烟测试的顺序走一遍首次使用时的完整确认可执行路径适用于 macOS/Linux 下 Codex CLI 的默认推荐路径。准备条件装好 Codex CLI 和 OMX 并完成 setup文档明确的最低要求是Node.js 20 和 npmOpenAI Codex CLI 已安装、能用codex --version验证且已完成认证Homebrew 或 npm 安装都可以如需跑omx teammacOS/Linux 还需要tmux。如果 Codex CLI 已经存在安装 OMX 的路径是codex --version npm install -g oh-my-codex如果还没有 Codex CLI 并希望由 npm 管理它先单独安装 Codexnpm install -g openai/codex npm install -g oh-my-codex文档特别警告不要在已有 Homebrew 管理的codex二进制例如/opt/homebrew/bin/codex上直接跑合并的npm install -g openai/codex oh-my-codexopenai/codex尝试创建同名二进制时 npm 可能报EEXIST。OMX 只需要PATH上有一个可用、已认证的codex命令并不要求 Codex 必须通过 npm 安装。安装完成后还要选择 setup 作用域这是omx doctor之前必须走的一步# 在希望 OMX 操作的 git 项目里仓库需要持有持久的 AGENTS.md 指导时 omx setup --scope project --merge-agents # 或者做用户级 Codex setup当前目录不作为 OMX 项目准备时 omx setup --scope user两点注意不要用宽泛的 home 目录跑 project 级 setup除非该目录确实是被审查的项目本身真实版本升级后全局 npm 安装只会打印提醒而不会自动拉起 setup需要自行重跑上面的 scoped setup 命令或用omx update先检查 npm 再走同一套 setup 刷新路径。--merge-agents保留现有项目AGENTS.md的指导内容并在生成段落中插入/刷新 OMX 区段bare 形式不要写value是唯一的合法选择器。第一步运行 omx doctor 验证安装形态在目标 shell 中执行omx doctoromx doctor检查的是 OMX 本地安装面是否完整文件是否存在、hooks 与 AGENTS 脚手架是否就位、运行前置条件是否满足。如果怀疑安装有问题还可以用文档给出的变体omx doctor --team # 额外包含 Team runtime 检查 omx doctor --verbose # 输出更详细的检查证据 omx doctor --force # 修复符合条件的 repo 工件属主问题 omx doctor --dry-run --force # 预览属主修复不落盘结果判读以 doctor 报告为准HEALTHY表示必需路径、hook/config 检查、AGENTS 标记、插件缓存状态以及请求时的 Team 检查全部通过ISSUES FOUND会列出具体失败的证据和最小修复建议。关键边界要记住omx doctor变绿只说明安装和本地运行时接线看起来正常它不能证明当前 Codex profile 能完成一次带认证的模型调用。文档在 codex native hook 映射 中也重复了这一点doctor 确认文件存在且形状正确但同一 shell/profile 能否完成带认证的 Codex 请求这一边界要靠后两步验证。第二步用 codex login status 检查登录态在准备启动 OMX 的同一个 shell 里执行codex login status这一步验证的是当前生效的 Codex profile 能看到登录状态。它必须与后续冒烟测试、以及真正启动 OMX 使用同一个 shell/profile、HOME 和项目目录否则结果不可比。第三步用 omx exec 做一次真实执行冒烟测试仍然是同一个 shell执行文档给定的冒烟命令omx exec --skip-git-repo-check -C . Reply with exactly OMX-EXEC-OK成功条件是命令返回OMX-EXEC-OK。按 troubleshooting 的说法这条命令一旦返回OMX-EXEC-OK说明真实执行、认证、provider 路由和当前工作目录假设是协同工作的。--skip-git-repo-check让这条测试不依赖当前目录必须是 git 仓库-C .表示以当前目录为工作目录提示词Reply with exactly OMX-EXEC-OK用于让模型给出一个可精确核对的固定回复。至此三个检查各覆盖一层检查证明的边界omx doctor绿色安装与本地运行时接线看起来正常codex login status正常当前 Codex profile 能看到登录状态omx exec ...返回OMX-EXEC-OK真实执行、认证、provider 路由与当前工作目录假设共同生效doctor 变绿但 omx exec 失败时怎么查这是文档专门列出的典型场景Troubleshooting execution readinessdoctor 和 setup 看起来都正常但真实执行报认证错误。常见失败字符串包括401 Unauthorized、Missing bearer or basic authentication in header、Incorrect API key provided。排查顺序是在准备启动 OMX 的 shell 里打印HOME和CODEX_HOME确认当前生效的~/.codex或CODEX_HOME里包含预期的 auth 和config.toml。自定义 HOME、容器、profile shell、CI 和服务用户环境经常与主用户看到不同的~/.codex一个 home 里能用的 Codex 不会自动让另一个 home 就绪从同一个 shell 重跑codex login status。如果部署依赖本地 OpenAI 兼容代理或网关再检查当前生效的~/.codex/config.toml是否包含匹配的 base URL文档示例格式为openai_base_url http://localhost:8317/v1这里要换成你自己的代理地址。如果 profile 级~/.codex/config.toml缺了openai_base_urlCodex 可能把代理签发的 key 发往默认端点表现为 setup 和 doctor 都正常、真实执行却报 401 类认证错误。另外如果omx doctor --team报出resume_blocker之类的陈旧 team 状态先确认该 team 已确定死亡或被有意放弃再执行omx team shutdown team-name --force --confirm-issues、omx cancel然后重跑omx doctor --team不确定时先omx team status team-name和tmux ls。确认可执行之后的启动方式三层检查都通过再从 git 项目启动 OMX。推荐方式是用具名 worktreeomx --worktreefeat/task --madmax --xhighfeat/task替换成任务风格的分支名--madmax等价于 Codex 的--dangerously-bypass-approvals-and-sandbox会移除常规审批与沙箱护栏只在受信任的仓库和环境中使用--xhigh是-c model_reasoning_effortxhigh的简写。非 git 目录启动时省略--worktree。并发跑多个--madmax会话时每个会话要用不同的具名 worktree不要共用同一个 checkout。如果omx doctor或冒烟测试始终无法变绿回到 Getting Started 的 Troubleshooting 表按现象定位omx命令未找到、prompts 缺失、skills 未加载等更细的排障路径见 troubleshooting 文档doctor 自身的检查项与报告契约见 doctor skill 说明。【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
OmX 首次安装后如何依次运行 omx doctor、codex login status 和 omx exec 冒烟测试确认可以真实执行
OmX 首次安装后如何依次运行 omx doctor、codex login status 和 omx exec 冒烟测试确认可以真实执行【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex刚用npm install -g oh-my-codex装好 Oh My codeXOMX后还不能直接开始跑工作流。官方文档把安装成功和真实可执行分成两道边界omx doctor只验证 OMX 的本地安装面prompts、skills、AGENTS 脚手架、config 文件、hooks 和运行时前置条件而当前 Codex profile 能否完成一次带认证的模型请求必须用codex login status加一次真实的omx exec冒烟测试来证明。本文按安装 → setup →omx doctor→codex login status→omx exec冒烟测试的顺序走一遍首次使用时的完整确认可执行路径适用于 macOS/Linux 下 Codex CLI 的默认推荐路径。准备条件装好 Codex CLI 和 OMX 并完成 setup文档明确的最低要求是Node.js 20 和 npmOpenAI Codex CLI 已安装、能用codex --version验证且已完成认证Homebrew 或 npm 安装都可以如需跑omx teammacOS/Linux 还需要tmux。如果 Codex CLI 已经存在安装 OMX 的路径是codex --version npm install -g oh-my-codex如果还没有 Codex CLI 并希望由 npm 管理它先单独安装 Codexnpm install -g openai/codex npm install -g oh-my-codex文档特别警告不要在已有 Homebrew 管理的codex二进制例如/opt/homebrew/bin/codex上直接跑合并的npm install -g openai/codex oh-my-codexopenai/codex尝试创建同名二进制时 npm 可能报EEXIST。OMX 只需要PATH上有一个可用、已认证的codex命令并不要求 Codex 必须通过 npm 安装。安装完成后还要选择 setup 作用域这是omx doctor之前必须走的一步# 在希望 OMX 操作的 git 项目里仓库需要持有持久的 AGENTS.md 指导时 omx setup --scope project --merge-agents # 或者做用户级 Codex setup当前目录不作为 OMX 项目准备时 omx setup --scope user两点注意不要用宽泛的 home 目录跑 project 级 setup除非该目录确实是被审查的项目本身真实版本升级后全局 npm 安装只会打印提醒而不会自动拉起 setup需要自行重跑上面的 scoped setup 命令或用omx update先检查 npm 再走同一套 setup 刷新路径。--merge-agents保留现有项目AGENTS.md的指导内容并在生成段落中插入/刷新 OMX 区段bare 形式不要写value是唯一的合法选择器。第一步运行 omx doctor 验证安装形态在目标 shell 中执行omx doctoromx doctor检查的是 OMX 本地安装面是否完整文件是否存在、hooks 与 AGENTS 脚手架是否就位、运行前置条件是否满足。如果怀疑安装有问题还可以用文档给出的变体omx doctor --team # 额外包含 Team runtime 检查 omx doctor --verbose # 输出更详细的检查证据 omx doctor --force # 修复符合条件的 repo 工件属主问题 omx doctor --dry-run --force # 预览属主修复不落盘结果判读以 doctor 报告为准HEALTHY表示必需路径、hook/config 检查、AGENTS 标记、插件缓存状态以及请求时的 Team 检查全部通过ISSUES FOUND会列出具体失败的证据和最小修复建议。关键边界要记住omx doctor变绿只说明安装和本地运行时接线看起来正常它不能证明当前 Codex profile 能完成一次带认证的模型调用。文档在 codex native hook 映射 中也重复了这一点doctor 确认文件存在且形状正确但同一 shell/profile 能否完成带认证的 Codex 请求这一边界要靠后两步验证。第二步用 codex login status 检查登录态在准备启动 OMX 的同一个 shell 里执行codex login status这一步验证的是当前生效的 Codex profile 能看到登录状态。它必须与后续冒烟测试、以及真正启动 OMX 使用同一个 shell/profile、HOME 和项目目录否则结果不可比。第三步用 omx exec 做一次真实执行冒烟测试仍然是同一个 shell执行文档给定的冒烟命令omx exec --skip-git-repo-check -C . Reply with exactly OMX-EXEC-OK成功条件是命令返回OMX-EXEC-OK。按 troubleshooting 的说法这条命令一旦返回OMX-EXEC-OK说明真实执行、认证、provider 路由和当前工作目录假设是协同工作的。--skip-git-repo-check让这条测试不依赖当前目录必须是 git 仓库-C .表示以当前目录为工作目录提示词Reply with exactly OMX-EXEC-OK用于让模型给出一个可精确核对的固定回复。至此三个检查各覆盖一层检查证明的边界omx doctor绿色安装与本地运行时接线看起来正常codex login status正常当前 Codex profile 能看到登录状态omx exec ...返回OMX-EXEC-OK真实执行、认证、provider 路由与当前工作目录假设共同生效doctor 变绿但 omx exec 失败时怎么查这是文档专门列出的典型场景Troubleshooting execution readinessdoctor 和 setup 看起来都正常但真实执行报认证错误。常见失败字符串包括401 Unauthorized、Missing bearer or basic authentication in header、Incorrect API key provided。排查顺序是在准备启动 OMX 的 shell 里打印HOME和CODEX_HOME确认当前生效的~/.codex或CODEX_HOME里包含预期的 auth 和config.toml。自定义 HOME、容器、profile shell、CI 和服务用户环境经常与主用户看到不同的~/.codex一个 home 里能用的 Codex 不会自动让另一个 home 就绪从同一个 shell 重跑codex login status。如果部署依赖本地 OpenAI 兼容代理或网关再检查当前生效的~/.codex/config.toml是否包含匹配的 base URL文档示例格式为openai_base_url http://localhost:8317/v1这里要换成你自己的代理地址。如果 profile 级~/.codex/config.toml缺了openai_base_urlCodex 可能把代理签发的 key 发往默认端点表现为 setup 和 doctor 都正常、真实执行却报 401 类认证错误。另外如果omx doctor --team报出resume_blocker之类的陈旧 team 状态先确认该 team 已确定死亡或被有意放弃再执行omx team shutdown team-name --force --confirm-issues、omx cancel然后重跑omx doctor --team不确定时先omx team status team-name和tmux ls。确认可执行之后的启动方式三层检查都通过再从 git 项目启动 OMX。推荐方式是用具名 worktreeomx --worktreefeat/task --madmax --xhighfeat/task替换成任务风格的分支名--madmax等价于 Codex 的--dangerously-bypass-approvals-and-sandbox会移除常规审批与沙箱护栏只在受信任的仓库和环境中使用--xhigh是-c model_reasoning_effortxhigh的简写。非 git 目录启动时省略--worktree。并发跑多个--madmax会话时每个会话要用不同的具名 worktree不要共用同一个 checkout。如果omx doctor或冒烟测试始终无法变绿回到 Getting Started 的 Troubleshooting 表按现象定位omx命令未找到、prompts 缺失、skills 未加载等更细的排障路径见 troubleshooting 文档doctor 自身的检查项与报告契约见 doctor skill 说明。【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
