Codex 小白入门：从安装到插件、MCP、Skills，一篇把配置讲明白

使用者痛点：新手往往卡在以下几个点：

• 装好 Codex 之后看不懂 config.tomlAGENTS.mdMCPPluginsSkillsMemory 的层层关系。
• 把所有规则塞进 Prompt，导致对话冗长且易出错。
• 一次性装太多插件或开启高权限。结果调试困难，安全隐患大。
• 不清楚哪些配置是「长期」的，哪些是「一次性」的。

下面按照「先装 → 让 Codex 认识项目 → 按需接插件/Skill/MCP → 加记忆」的顺序，逐步解决这些痛点。

你先记住一句话：Codex 不是只有一个聊天框

它更像一个可自定义的工作台。不同需求对应不同放置位置：

Pain Point: 把所有东西都塞进 Prompt，会导致每次都要重复说“请先阅读项目结构…”，老实说，正确做法是把长期规则沉淀到相应文件，让 Prompt 保持简洁。

第一步先这方面，先把 Codex 装起来

. Codex Desktop App 怎么安装

说到官方入口。

https://developers.openai.com/codex/app

程序对应下载地址：

• Codex.dmg
• Codex-latest-x64.dmg

*macOS 安装步骤*

1. 打开「关于本机」确认芯片类型。
2. 下载对应的 .dmg 文件并双击打开。

*Windows 安装步骤*

If you already have CLI installed,you can launch app from terminal:

codex app
# 若未安装，会自动跳转到下载安装页面

. Codex CLI 怎么安装 & 基础命令检查

The official installer works on macOS。Linux and Windows:

# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Windows PowerShell
irm https://chatgpt.com/codex/install.ps1 | iex

You can also use package managers:

npm install -g @openai/codex # npm
brew install --cask codex # Homebrew
# or download binaries from GitHub Releases:
# https://github.com/openai/codex/releases

The first sanity‑check commands after installation:

codex --version
codex login # 登录你的 OpenAI 帐号
codex doctor # 检查环境、认证、沙箱等状态
codex --help # 查看完整子命令列表

Pain Point: 新手常因「找不到命令」而慌张。 只记住三条基本命令即可——`codex`。`codex login`,`codex doctor`。

说到接下来，理解 AGENTS.md

`AGENTS.md` 相当于写给 AI 同事的「项目说明书」。它告诉 Codex：

• p> 示例最小版 :

  markdown

  Project overview

  This is a Next.js project. Main code lives in apps/web.

  Common commands

  • Install: pnpm install
  • Dev server: pnpm dev
  • Typecheck: pnpm typecheck
  • 从Test来看，pnpm test

  Coding rules

  • Follow existing file structure and naming style.
  • Make small,focused changes only.
  • Do NOT rewrite unrelated files or add new dependencies without review.

  Verification

  Before marking a task complete。run relevant checks: - UI changes → pnpm typecheck - Logic changes → run related tests If a check cannot be run,explain *** in response.

  The key is **precision over length** – four categories are enough for most projects:

  内容	示例
  项目结构	前端在 apps/web，后端在 services/api
  常用命令	pnpm install / pnpm dev / pnpm test
  编码约束	遵循 eslint 配置，不随意改动 package.json
  验收方式	提交前跑 typecheck 与单元测试

  Pain Point : <> 为什么不直接写进 prompt？因为 prompt 是临时的，而 AGENTS.md 是长期有效的。老实说，这样同一项目下的所有任务都会自动遵守同一套规矩。话说回来，

  ：理解 config.toml

  `config.toml` 控制 Codex 的模型选择、沙箱权限、审批策略等全局默认值。老实说，默认位置为的观点是，

  text ~/.codex/config.toml

  The most common sections for beginners are:

  配置方向	说明
  model	默认使用哪个模型，例如 "o3" 或 "gpt‑4o"
  sandbox_mode	Codex 能访问哪些文件方法，例如 "workspace-write"
  approval_policy	哪些操作需要人工确认。例如 "on-request"
  mcp_servers	外部工具通过 MCP 接口的声明

  A conservative starter config could look like this:

  toml

  model = "o3" # 选择 sandboxmode = "workspace-write" # 项目目录可读写，其他目录受限 approvalpolicy = "on-request" # 敏感操作需人工确认

  <> 刚开始不要直接开到 “danger-full-access”。其实，保守沙箱+审批可以方便你定位问题，而不会因误操作破坏代码库。

  还有如何选用

  A plugin bundles one or more Skills。optional MCP server definitions and UI resources.

  • A Skill – reusable workflow snippets.
  • MCP server – standard protocol to talk to external tools.

  You can manage plugins via CLI:

  bash codex plugin list # 查看已安装插件 codex plugin add sample@debug # 从 Marketplace 安装示例插件 codex plugin remove sample # 卸载插件

  If you prefer GUI,open Desktop App → Plugins tab → 搜索并启用所需插件。

  制作 PPT

  你的场景	推荐首选插件
  写代码 & review PR	GitHub 插件 + Browser 插件
  写文章 & 报告	Documents 插件 + Browser 插件
  Presentations 插件 + Images 插件   ​​​  ​​ ​​​ ​​ ​ ​ ​​​ ​​​ ​​​​​​​​ ​​            ​​​​​​‍‏‏‏‏‏‏‎‏‎ ‎ ‎ ‎ ‏‎‌‏‌‌‌ ‏‍ ‌‎​​‍‌   ​ ​   ​​ ​ ​​​​​​‍⁠‬⁦⁩⁠⁠⁠‍ ⁤⁩   ️   ‭‬ ‬‭⁧⁧‬\u200b ‍\u200b\u200b\ufeff\ufeff \u200b\ufeff \u200c \ufe0f \ufe0f \u2060 ‍‍

  ...

  • 上一篇： GPT5.6与Fable5，谁更胜一筹？
  • 下一篇： GPT-5.6时代，流程毒瘤如何破？