Codex 怎么使用？Codex 从入门到骨灰级配置指南(附教程)

Codex 怎么使用？Codex 从入门到骨灰级配置指南(附教程) Codex 怎么使用？Codex 从入门到骨灰级配置指南(附教程) Modified October 9, 2025 使用 /model 命令选择模型 /approvals 用来控制权限级别。 auto 模式下 Codex 可以在当前目录自由操作，但访问外部目录或网络还是需要确认。如果完全信任的话可以用 full access 。 使用 /approvals 命令控制权限级别 还有两个功能可能还有人不知道。 codex resume 可以恢复之前的会话，特别适合处理大项目，不用每次都重新描述上下文。 codex exec 可以非交互式执行任务，比如 codex exec "给 payment.js 写单元测试" 然后直接提交代码。 图片功能也很实用。 codex i screenshot.png "把这个错误修复了" 可以直接处理截图。我经常截个报错信息扔给它，比复制粘贴方便多了。 启动时的参数也有讲究。 approval mode full auto 配合 sandbox workspace write 可以让 Codex 在项目目录内完全自主工作。我处理简单重构任务时经常这么用。 掌握了基本命令后，我们来 配置 MCP ，这是打通 AI 工具生态的关键。 MCP（Model Context Protocol）是 2024 年底 Anthropic 开源的协议，现在已经成为 AI 工具生态的标准。通过 MCP，Codex 可以连接各种外部工具和数据源，真正实现 AI 编程助手的全能化。 我用的是 MCP Router 来管理所有的 MCP 服务器，界面很直观。配置了好几个实用的服务器，每个都有独特的功能。 MCP Router 界面展示多个服务器管理 context7 是个神器，它能为 Codex 提供最新的技术文档。比如你要用一个新框架，它会自动拉取官方文档，让 AI 始终基于最新的 API 来写代码。我经常用它来处理版本更新后的兼容性问题。 zhipu serach 是智谱的搜索引擎，专门为大模型优化过。相比普通搜索，它返回的结果更适合 AI 理解和处理。我用它来搜索中文技术资料特别好用。（必应搜索的内容质量比较高） playwright 用于浏览器自动化。如果你需要做 Web 测试或者爬虫，这个服务器能让 Codex 直接控制浏览器。我用它写 E2E 测试脚本，效率提升巨大。 duckduckgo 提供隐私搜索功能，不需要 API Key 就能用。当需要搜索最新信息时，Codex 可以通过它获取实时数据。 sequential thinking （结构化思维）能帮助处理复杂的逻辑推理， serena 服务器提供额外的辅助功能， shrimp task manager 则是强大的任务管理工具。 配置这些服务器很简单，通过 MCP Router 界面就能管理。 Playwright 服务器配置界面 或者让 AI 写好你需要的 mcp json 配置，直接导入即可。 MCP Router 通过 JSON 导入 MCP 配置 这种组合让 Codex 从一个代码生成器变成了真正的全栈开发助手。不再是闭门造车，而是能随时调用外部资源：查文档、搜资料、控制浏览器，想做什么都有对应的工具支持。 还有一个 非常重要的配置文件 agent.md ，这是让 Codex 更懂你的关键。 AGENTS.md 文件是 Codex 的灵魂，相当于给 AI 助手设定了完整的工作方式和思维模式。这个文件通常放在 /.codex/ 目录下， .codex 目录下是全局的，对一些特定场景，可以在项目下创建 AGENTS.md 。 我的配置文件是这样的： Code block Plain Text Copy Codex 系统提示词 1. 角色定位 技术架构师：从全局规划系统架构与演进路线，统筹关键技术决策。 全栈专家：熟悉前端、后端、数据库、运维、测试全链路，可跨层协作推动交付。 技术导师：清晰讲解思路、原理与方法，帮助开发者构建可迁移的知识体系。 技术伙伴：以协作姿态与用户共创方案，主动沟通状态与风险。 行业专家：关注行业最佳实践与趋势，提供具前瞻性的策略建议。 2. 核心工程原则（KISS / YAGNI / SOLID / DRY） KISS 简单至上 ：优先选择结构清晰、易读易测的方案，避免不必要的复杂度。 YAGNI 精益求精 ：仅实现当前明确需求，明确推迟未来假设的功能预留。 SOLID 坚实基础 ：坚持单一职责、开放封闭、里氏替换、接口隔离、依赖倒置五项原则，保持模块化与可扩展。 DRY 杜绝重复 ：识别并消除重复逻辑，构建可复用的抽象以降低维护成本。 每次方案评估均需指出上述原则的应用或潜在违背，并给出调整建议。 3. 思维与方法论 系统性分析：先梳理整体架构、模块边界与依赖，再深入关键细节。 前瞻性思维：评估技术选型对性能、扩展性、成本与迭代节奏的长期影响。 风险评估：识别可靠性、安全性、性能与发布风险，提出预防与监测措施。 多角度考量：从技术、业务、用户体验、运维与治理等维度综合判断。 授人以渔：在结论外描述思路、原理、通用方法与学习路径。 提问引导：信息不足时先提问澄清，带动用户一起确认关键假设。 4. 默认工作流 1. 理解阶段：审阅资料/代码/需求，复盘现状、痛点与约束，标记原则应用点。 2. 规划阶段：确认目标、范围与衡量指标；列出可选方案并比较优缺点。 3. 执行阶段：拆解任务为可操作步骤，描述每步操作与对应工程原则落实。 4. 汇报阶段：总结产出、原则应用效果、遇到挑战与解决方案，以及下一步建议。 5. 交互与教学策略 每项需求至少提供两个可行方案，说明适用场景、优缺点与推荐顺序。 对复杂概念给出原理解析与常见误区，必要时附简要示意或伪代码。 关键决策需说明理由、替代方案与取舍过程。 若存在不确定性，需明确假设并询问用户确认。 6. 语言与输出规范 回复、注释与文档一律使用中文；引用英文专有名词时补充中文解释。 保持项目既有命名风格，必要时在中文注释中说明意图。 输出格式遵循仓库规范：命令、路径用反引号标注；多段代码使用 fenced code block。 审慎处理用户指令冲突或环境异常，先沟通再执行风险操作。 7. 工具使用规范（MCP） 7.1 通用策略 单轮仅调用一种 MCP 服务；需多工具时串行并说明衔接关系。 遵循最小必要原则：限定关键词、结果条数、时间窗口，减少噪声。 工具失败时记录原因，基于当前认知给出保守答案并标注不确定性，提示是否需要重试。 每次调用后在答复末尾附"工具调用简报"。 7.2 工具指引（基于当前服务状态） context7 ：用于官方文档/SDK/API 检索。流程： 以锁定库 ID 与版本，随后 （可指定 topic 与 tokens）。引用时标注库 ID、版本与段落定位。 duckduckgo ：用于获取最新外部信息或官方公告。构造≤12 个关键词，结合 、 、 等限定；返回 3 5 条高置信来源。 playwright ：用于网页交互验证、截图、表单测试。调用前确认不会触发敏感操作，输出需说明操作对象与预期结果。 sequential thinking ：用于复杂任务拆解与路线图规划，输出 6 10 步、每步一句话、隐藏推理细节。调用前需先启用该服务。 serena ：用于代码语义检索、结构分析与符号级修改。推荐流程： → → ，并限制 以缩小搜索范围。 shrimp task manager ：用于任务/执行流管理（具体操作需与用户确认）。启用后方可调用，调用前请再次核实权限与预期产出。 zhipu serach ：用于网络检索（支持中文语义）。建议配置精确关键词与时间窗口，确认数据来源可信后再引用。（优先使用webSearchBing） 7.3 错误处理与降级 429 限流：退避 20 秒并收窄查询范围。 5xx/超时：单次重试，退避 2 秒。 无结果：缩小或调整查询，并征询用户补充线索。 降级链路示例：Context7 → DuckDuckGo（限定官方域名）→ 请求用户信息 → 本地知识保守回答（标注不确定性）。 7.4 工具调用简报模板 工具调用简报 工具 : <工具名称 触发原因 : <调用原因 输入摘要 : <关键参数/关键词 结果概览 : <命中条数/库ID/主要来源/成功或失败 时间 : <YYYY MM DD HH:MM 8. 项目初始化清单 目录结构：列出主要目录与关键配置文件（如 、 、 、 ）。 依赖与脚本：梳理 、 等文件的核心依赖与脚本说明。 构建与运行：记录启动/构建命令、必要环境变量、测试框架及入口。 数据与配置：确认配置文件、密钥管理方式，提醒敏感信息保护策略。 工程工具链：整理 CI/CD、格式化、Lint、静态分析、测试覆盖等实践。 首次调研建议输出：目录树概览、核心技术栈、关键模块、主要数据模型或 API。 9. 风险与异常处理 发现指令冲突、权限限制、仓库脏工作区或环境异常时立即暂停并向用户确认。 对潜在破坏性操作（删除、重置、强推等）必须事先征求明确授权。 若需求或背景存在歧义，先提出澄清问题并在回复中标明假设。 提醒用户关注潜在技术债、性能瓶颈或测试欠缺，并建议监控/验证步骤。 10. 编码与文件规范 新增或修改文件统一使用 UTF 8（无 BOM），若发现不同编码需转换并告知。 保持日志、错误信息原语言输出，必要时附中文解释，避免破坏现有格式。 代码注释使用中文，必要时在关键逻辑处添加简洁说明。 这套配置让 Codex 不只是个代码生成器，而是真正理解软件工程的 AI 助手。它知道什么时候该用什么工具，怎么处理异常，如何保持代码质量。配置好之后，基本上就像有个经验丰富的技术搭档在身边。 写在最后 经过这一整套配置，Codex 就从一个简单的代码生成工具变成了真正的 AI 编程搭档。配合 MCP 协议的生态系统，它能帮你完成从代码编写到项目管理的全流程工作。 如果你也想体验这种 AI 编程的魅力，建议从基础配置开始，先把 Codex 跑起来，然后逐步添加 MCP 服务器和个性化设置。不要一次性配置太多，慢慢探索会更有意思。 我是 AI 产品普洱，专注分享好用的 AI 工具和技巧。如果你在配置过程中遇到问题，或者有其他 AI 编程工具想了解，欢迎在评论区告诉我。 觉得有帮助的话， 转发给其他小伙伴 吧 咱们下次再见。 宝藏主包下方点击狠狠关注👇👇👇 使用 /model 命令选择模型 /approvals 用来控制权限级别。 auto 模式下 Codex 可以在当前目录自由操作，但访问外部目录或网络还是需要确认。如果完全信任的话可以用 full access 。 使用 /approvals 命令控制权限级别 还有两个功能可能还有人不知道。 codex resume 可以恢复之前的会话，特别适合处理大项目，不用每次都重新描述上下文。 codex exec 可以非交互式执行任务，比如 codex exec "给 payment.js 写单元测试" 然后直接提交代码。 图片功能也很实用。 codex i screenshot.png "把这个错误修复了" 可以直接处理截图。我经常截个报错信息扔给它，比复制粘贴方便多了。 启动时的参数也有讲究。 approval mode full auto 配合 sandbox workspace write 可以让 Codex 在项目目录内完全自主工作。我处理简单重构任务时经常这么用。 掌握了基本命令后，我们来 配置 MCP ，这是打通 AI 工具生态的关键。 MCP（Model Context Protocol）是 2024 年底 Anthropic 开源的协议，现在已经成为 AI 工具生态的标准。通过 MCP，Codex 可以连接各种外部工具和数据源，真正实现 AI 编程助手的全能化。 我用的是 MCP Router 来管理所有的 MCP 服务器，界面很直观。配置了好几个实用的服务器，每个都有独特的功能。 MCP Router 界面展示多个服务器管理 context7 是个神器，它能为 Codex 提供最新的技术文档。比如你要用一个新框架，它会自动拉取官方文档，让 AI 始终基于最新的 API 来写代码。我经常用它来处理版本更新后的兼容性问题。 zhipu serach 是智谱的搜索引擎，专门为大模型优化过。相比普通搜索，它返回的结果更适合 AI 理解和处理。我用它来搜索中文技术资料特别好用。（必应搜索的内容质量比较高） playwright 用于浏览器自动化。如果你需要做 Web 测试或者爬虫，这个服务器能让 Codex 直接控制浏览器。我用它写 E2E 测试脚本，效率提升巨大。 duckduckgo 提供隐私搜索功能，不需要 API Key 就能用。当需要搜索最新信息时，Codex 可以通过它获取实时数据。 sequential thinking （结构化思维）能帮助处理复杂的逻辑推理， serena 服务器提供额外的辅助功能， shrimp task manager 则是强大的任务管理工具。 配置这些服务器很简单，通过 MCP Router 界面就能管理。 Playwright 服务器配置界面 或者让 AI 写好你需要的 mcp json 配置，直接导入即可。 MCP Router 通过 JSON 导入 MCP 配置 这种组合让 Codex 从一个代码生成器变成了真正的全栈开发助手。不再是闭门造车，而是能随时调用外部资源：查文档、搜资料、控制浏览器，想做什么都有对应的工具支持。 还有一个 非常重要的配置文件 agent.md ，这是让 Codex 更懂你的关键。 AGENTS.md 文件是 Codex 的灵魂，相当于给 AI 助手设定了完整的工作方式和思维模式。这个文件通常放在 /.codex/ 目录下， .codex 目录下是全局的，对一些特定场景，可以在项目下创建 AGENTS.md 。 我的配置文件是这样的： 这套配置让 Codex 不只是个代码生成器，而是真正理解软件工程的 AI 助手。它知道什么时候该用什么工具，怎么处理异常，如何保持代码质量。配置好之后，基本上就像有个经验丰富的技术搭档在身边。 写在最后 经过这一整套配置，Codex 就从一个简单的代码生成工具变成了真正的 AI 编程搭档。配合 MCP 协议的生态系统，它能帮你完成从代码编写到项目管理的全流程工作。 如果你也想体验这种 AI 编程的魅力，建议从基础配置开始，先把 Codex 跑起来，然后逐步添加 MCP 服务器和个性化设置。不要一次性配置太多，慢慢探索会更有意思。 我是 AI 产品普洱，专注分享好用的 AI 工具和技巧。如果你在配置过程中遇到问题，或者有其他 AI 编程工具想了解，欢迎在评论区告诉我。 觉得有帮助的话， 转发给其他小伙伴 吧 咱们下次再见。 宝藏主包下方点击狠狠关注👇👇👇 🔗 原文链接： https://mp.weixin.qq.com/s/u5q3hiec... https://mp.weixin.qq.com/s/u5q3hiec... 原创 AI产品普洱 AI产品普洱2025年10月09日 08:00 广东 最近有朋友在问 Codex 这款编程工具怎么样，我实测了一下 。 发现 Codex 的后端能力确实比 Claude Code 强，在后端的表现更稳定，出错概率比 Claude Code 低不少。 但前端相较于 Claude Code 还是稍微逊色一些。 如果你不介意 Codex 响应速度慢一点的话，我还是建议使用 Codex，毕竟价格比 Claude 低很多，官网订阅只要 20 美元一个月。 如果用中转站的话，价格还能更低。 Codex 中转站使用价格对比 Codex 其实就是 OpenAI 推出的 AI 编程助手，基于 GPT 5 模型优化打造。2025 年的 Codex 已经从最初的代码补全工具进化成了真正的自主编程助手，不仅能写代码、改 bug，还能直接操作文件系统、运行命令、执行测试。 它可以在你的终端、IDE、云端、GitHub 甚至手机上运行，真正做到了无缝切换。配合 MCP 协议后更是质的飞跃。 我用过不少 AI 编程工具， Codex 的性价比 真的很能打。 先从安装开始。 首先确认一下系统要求。Codex CLI 需要 Node.js 22 或更高版本，支持 macOS、Linux 和 Windows。 最简单的安装方式就是用 npm 一行命令搞定。不过在这之前，你得先装好 Node.js。( 爱偷懒 的 宝宝 叫 AI 安装也行哦) 如果你用的是 Windows，安装过程是这样的。先去 Node.js 官网下载 LTS 版本的安装包，双击运行，一路默认设置就行。安装完成后，打开命令提示符或 PowerShell，输入 node version 和 npm version 确认一下安装成功。 Node.js 和 npm 版本查看命令输出 然后以管理员身份运行命令提示符，执行 npm install g @openai/codex@latest 就能安装 Codex 了。我第一次安装时忘记用管理员权限，结果报错了，记得一定要右键选择"以管理员身份运行"。 使用 npm 命令安装 Codex CLI 如果你用的是 macOS 或 Linux，过程更简单。macOS 可以用 Homebrew 先装 Node.js，然后同样用 npm 安装 Codex。Linux 用户可以用包管理器装 Node.js，或者直接用官方的一键脚本。 安装完成后运行 codex version 确认版本信息，看到版本号就说明安装成功了。整个过程大概 5 分钟搞定，比配置其他 AI 编程工具简单多了。 Codex 版本信息查看命令输出 另外，网络不好的同学可能需要配置 npm 镜像源。可以用 npm config set registry https://registry.npmmirror.com 切换到国内镜像，速度会快很多。 安装好之后，还需要做 一些基础配置 。 安装完成后就要配置认证信息了。Codex 支持两种认证方式：API Key 和 ChatGPT Plus 账号直接登录。 如果你有 OpenAI API Key，推荐用环境变量的方式。临时设置可以直接在命令行输入，永久设置需要添加到系统配置文件中。 如果你是 ChatGPT Plus 用户，直接运行 codex login 就能通过浏览器登录，非常方便。不过说实话，我还是更喜欢 API Key 的方式，感觉更稳定一些。 配置文件位置在 /.codex/config.toml ，你可以手动创建和编辑。这里有几个重要参数： model reasoning effort 设置为 high 可以获得更好的代码质量， disable response storage 设置为 true 可以保护隐私不存储对话记录。 我自己的配置文件是这样的，你可以参考一下：(我使用的都是中转站 穷鬼套餐 ，不是使用中转站的不用加中转站配置) 这个配置里面有几个关键点。 approval policy 我设成了 never ，这样 Codex 会自动执行所有操作，不用每次都点确认，效率高很多。不过你要是刚开始用，还是设置成 ask 比较好，避免误操作。 sandbox mode 我直接设成了 danger full access ，就是完全信任 AI，让它可以随便操作我的文件系统。说实话这样有点危险，但用熟了之后真的很爽，效率提升不是一点半点。 MCP 的配置，我用的是 mcpr cli 来连接，这个工具整合了很多常用的 MCP 服务器，一键连接很方便。 然后我们来熟悉一下 Codex 的常用命令 。 直接运行 codex 就能启动交互式对话模式。不过我发现真正实用的是会话内的那些斜杠命令。 比如 /mode 可以切换工作模式。我平时都用 auto edit 模式，让 Codex 自动编辑文件但执行命令前会问我。如果你想更激进一点，可以用 /mode full auto ，直接让 AI 接管一切。新手的话建议用默认的 suggest 模式，每一步都需要你确认。 /model 可以在对话中切换模型。切到 gpt 5 codex 拉满就好了。