Codex 周边工具

这页不是工具大全，也不是必须安装清单。

先把 Codex 本身和 UseGoodAI 配好，再按实际需要补工具。多数用户先装 Git、Node.js / npm、ripgrep 就够了；需要经常处理 GitHub、MCP 或规范化开发流程时，再考虑后面的增强工具。

先装哪些

优先级	工具	主要解决什么
基础	Git	管理代码版本、查看差异、让 Codex 更安全地修改仓库
常用	Node.js / npm	安装 Codex CLI、npx 工具、部分 MCP 或流程插件
常用	ripgrep	快速搜索代码、配置、报错文本
按需	GitHub CLI	在终端处理 issue、PR、release、GitHub 登录和检查
进阶	MCPHub / mcphub	集中管理多个 MCP 服务，统一暴露给 AI 客户端
进阶	Superpowers for Codex	给 Codex 加一套设计、计划、调试、验证流程习惯

推荐安装顺序

1. 先装 Git，并确认 git --version 有输出。
2. 如果使用 npm 安装 Codex 或其他工具，再装 Node.js LTS，并确认 node -v、npm -v 有输出。
3. 经常让 Codex 搜索代码时，安装 ripgrep，并确认 rg --version 有输出。
4. 代码托管在 GitHub 上，再装 GitHub CLI，并用 gh auth login 登录。
5. 只有当需要接入多个外部工具、多个 MCP 服务时，再研究 MCPHub。
6. 只有当 Codex 使用频率变高、任务变复杂时，再考虑 Superpowers。

Git

项目	说明
适合解决什么问题	保存修改记录、对比改动、回退错误修改、切换分支、配合远程仓库。
什么时候需要	只要让 Codex 修改代码仓库，就优先准备 Git。
安装入口	Git 官网：git-scm.com/install
与 Codex 的配合方式	修改前后可以让 Codex 查看 git diff、整理提交说明、解释某次改动、按分支隔离任务。
注意事项	不熟悉 Git 时，先只掌握 status、diff、add、commit。不要随便执行 reset --hard、强制覆盖、强推等破坏性命令。

Git 是 Codex 工作流里最基础的安全垫。Codex 能改文件，但 Git 负责留下修改边界；一旦改错，可以更容易看清楚哪里变了。

Node.js / npm

项目	说明
适合解决什么问题	安装 Codex CLI、运行 npx、安装前端项目依赖、运行很多 JavaScript / TypeScript 工具。
什么时候需要	用 npm install -g @openai/codex 安装 Codex、运行 VitePress / Next.js / React 项目、安装 Superpowers 或部分 MCP 工具时。
安装入口	Node.js 官网：nodejs.org/en/download，npm 文档：docs.npmjs.com
与 Codex 的配合方式	Codex 可以读取 package.json，帮你安装依赖、运行脚本、排查 npm 报错、解释前端构建失败。
注意事项	新手优先安装 LTS 版本。macOS / Linux 如果遇到全局安装权限问题，优先查看 npm 官方的版本管理器建议，不要直接用 sudo npm install -g 反复尝试。

如果只是使用 Codex 官方安装脚本，可能不需要先处理 npm；如果要用 npm 安装 Codex 或周边工具，Node.js / npm 就是基础依赖。

ripgrep

项目	说明
适合解决什么问题	在大型项目里快速搜索函数名、配置项、报错文本、接口路径。
什么时候需要	项目文件多、普通编辑器搜索太慢、需要让 Codex 快速定位上下文时。
安装入口	GitHub 仓库与 release：github.com/BurntSushi/ripgrep
与 Codex 的配合方式	可以让 Codex 用 rg "关键词" 搜索代码，再根据结果决定读哪些文件，减少无关文件读取。
注意事项	ripgrep 默认会遵守 .gitignore，跳过隐藏目录和二进制文件。需要搜索隐藏文件或被忽略文件时，要明确告诉 Codex。

ripgrep 的命令名是 rg。它不是必须安装，但对中大型仓库很有价值，尤其适合让 Codex 先定位再修改。

GitHub CLI

项目	说明
适合解决什么问题	在终端查看 issue、PR、release、GitHub Actions 状态，创建 PR 或切换 PR 分支。
什么时候需要	项目托管在 GitHub，且经常需要 Codex 帮你看 PR、整理提交、检查 CI 或处理 issue。
安装入口	GitHub CLI 官网：cli.github.com，手册：cli.github.com/manual
与 Codex 的配合方式	Codex 可以调用 gh pr view、gh pr diff、gh issue view、gh run list 等命令，减少在浏览器和终端之间切换。
注意事项	安装后需要 gh auth login 登录。企业 GitHub 或私有仓库要注意权限范围，避免把 token 暴露到日志或文档里。

如果只是本地写小项目，GitHub CLI 可以暂时不装。它的价值主要出现在 PR、issue、CI 和远程协作场景。

MCPHub / mcphub

项目	说明
适合解决什么问题	集中管理多个 MCP 服务，把不同工具按统一端点、分组或单服务暴露给 AI 客户端。
什么时候需要	已经在使用多个 MCP 服务，例如搜索、数据库、文件系统、浏览器、内部工具，并且手动管理配置开始变乱。
安装入口	官网文档：docs.mcphub.app，GitHub 仓库：github.com/samanhappy/mcphub
与 Codex 的配合方式	可以把常用 MCP 服务集中起来，再让支持 MCP 的客户端连接统一地址，减少每个客户端重复配置工具。
注意事项	这属于进阶配置，不是 Codex 入门必需。MCP 端点涉及外部工具调用，必须注意鉴权、网络暴露和敏感数据权限。

MCP 的目标是让大模型应用以标准方式连接外部数据和工具。MCPHub 适合“工具已经多起来”的阶段；如果目前只用 Codex 写代码，先不用急着搭。

Superpowers for Codex

项目	说明
适合解决什么问题	给 Codex 增加更明确的工作流程，例如先讨论需求、再写计划、再实现、再验证。
什么时候需要	已经频繁让 Codex 做中等复杂度开发任务，发现它容易跳过设计、测试或验证步骤。
安装入口	进入 Codex 的 /plugins 搜索 superpowers；或按插件作者提供的 Codex marketplace 说明安装
与 Codex 的配合方式	CLI 里用 /brainstorming、/writing-plans、/systematic-debugging 等命令触发；Codex App 和 VS Code 插件里用 $brainstorming、$writing-plans 等 Skill 触发；也可以用中文说“用 Superpowers 的方法解决当前问题”。
注意事项	Superpowers 是流程约束工具，不是模型能力开关。第一次配置 Codex 时不建议同时安装，避免把简单任务变复杂。

Superpowers 更像一套工作纪律，不是模型能力开关。它适合已经知道自己需要“流程约束”的用户；如果只是让 Codex 改小文件、写简单脚本，先不用装。

怎么判断要不要继续加工具

真实情况	处理方式
只是第一次跑通 Codex	不要加工具，先完成 快速开始。
经常让 Codex 改仓库	优先准备 Git，ripgrep 很值得装。
经常处理 GitHub PR / issue	加 GitHub CLI。
经常接外部系统或多个 MCP 服务	再看 MCPHub。
经常做复杂功能、排 bug、写测试	再考虑 Superpowers。

判断标准很简单：只有当某个工具能减少当前真实重复成本时，再安装它。不要为了“看起来更完整”一次性把所有周边工具都装上。

延伸阅读

• Git 安装：git-scm.com/install
• Node.js 下载：nodejs.org/en/download
• ripgrep：github.com/BurntSushi/ripgrep
• GitHub CLI：cli.github.com
• MCPHub：docs.mcphub.app
• Superpowers for Codex：github.com/realsanjaysharma/superpowers-codex