Skip to content
AI Blog

Codex安装与使用：新手快速上手

最后更新：2026-08-12· 15 分钟阅读

🚀 快速通道

  • ChatGPT 国内版：点击直达↗
  • 稳定镜像站：打开镜像↗
  • 官方 ChatGPT：chatgpt.com ↗

Codex安装与使用：新手快速上手

更新时间：2026-08-12

导读

本文假设你已完成 Codex 下载与基础配置，目标是把 Agent 编程从「试玩」变成日常习惯。

Codex 是 OpenAI 的编码 Agent，可在 CLI、IDE 扩展 或 Codex Web 中使用。下文以 CLI 为主，提示词在 IDE 中同样适用。命令与子命令以 Codex CLI 参考 与 ChatGPT 当前版本为准。

新手第一周：建议节奏

天数任务类型目标
第 1 天只读让 Codex 解释一个陌生模块，不写文件
第 2–3 天单测修复修一个 failing test，人工 review diff
第 4–5 天小范围重构限定目录，保持行为不变
第 6–7 天真实 bugfix记录首次通过率与人工修改行数

不要一上来就「重写认证模块」——30 分钟内可验证的小任务，才是建立信任的方式。

会话开头：写一份可执行的 brief

Agent 输出质量取决于任务边界是否清晰。每次会话尽量交代四件事：

要素写法要点
目标一句话说明要达成什么，附失败栈或文件路径
环境语言版本、包管理器、测试框架
约束禁止改动的目录、禁止新增依赖
验收具体测试命令或 lint 规则

工作流一：修一个 failing test

测试 `tests/checkout.test.ts` 中 `coupon discount` 用例失败。
请：1) 读完整失败栈与相关源码；2) 定位根因；3) 提出最小 patch；
4) 说明如何在本地用 `pnpm test checkout` 验证。
不要修改与 coupon 无关的文件；不要猜测未提供的环境变量值。

操作节奏：

  1. 在项目根目录启动 codex。
  2. 保持默认审批策略，逐条确认文件修改与测试命令。
  3. 模型给出 patch 后本地亲自跑测试；失败时把完整 stderr贴回，要求「只基于日志修正」。

工作流二：小范围重构

重构的前提是行为不变。先确认相关测试已绿，再动结构。

将 `src/orders/` 下所有日期格式化调用统一为 ISO8601 字符串。
要求：
1) 仅修改 `src/orders/` 内文件；
2) 保持对外导出函数签名不变；
3) 列出受影响测试并给出 `pnpm test orders` 命令；
4) 每次只提交一个逻辑改动，便于 review。
阶段你要做的
改前确认相关测试已绿
改中限制目录范围，拒绝无关 diff
改后跑测试 + lint + typecheck；人工 diff review

工作流三：读懂陌生模块

我是新加入的开发者。请用约 400 字解释 `packages/auth/` 的职责、
入口文件、对外 API 与主要依赖；并指出我应该先读的 3 个文件。
不要修改任何文件；不确定处标注「待核实」。

输出可当 onboarding 笔记，再针对单个文件深入追问。配合 DeepSeek 编程实战 中的「证据—假设—验证」结构，读代码效率会更高。

CLI、IDE 与云端：形态怎么选

形态适合场景注意
CLI习惯终端、codex exec 脚本化CI 集成时限制权限
IDE 扩展边写边改、需要可视化 diff与 CLI 共用 config.toml
Codex Web无本地环境、轻量任务仓库访问与沙箱策略可能与本地不同

日常开发常见组合：IDE 内联补全写单函数，Codex 跑跨文件任务与测试。与 Claude Code 类似，Codex 强项在「读仓库 + 执行命令」闭环。

非交互模式：codex exec

需要把 Codex 嵌入脚本或 CI 时，可使用非交互模式（详见 非交互文档）。原则：

  • CI 中使用只读或最小写入沙箱。
  • 禁止在无人工审查的流水线里自动合入 main。
  • API Key 与 ChatGPT 登录分开管理，密钥走环境变量或密钥服务。

提示词习惯：让 Agent 可审计

坏习惯更好写法
「修好 bug」附失败栈、复现步骤、预期/实际结果
「重构一下」指定目录、禁止项、验收测试命令
「你看着办」列出必须满足与必须避免的清单

要求模型在不确定时明确标注，并要求「先列计划再执行」，可显著减少 silent wrong fix。

与 Claude Code / Copilot 如何配合

  • Copilot / Cursor 内联补全：单文件、单行级速度更快。
  • Codex：跨文件、跑测试、解释架构更系统。
  • Claude Code：Anthropic 生态下的同类 Agent，工作流可对照 Claude Code 指南。

不必只选一个——用内联补全写函数，用 Codex 跑集成测试与文档更新，是常见高效组合。

国内环境与模型后端

默认 Codex 走 OpenAI 模型与 ChatGPT 账户。若希望改用 DeepSeek 作为后端以降低成本或改善中文代码注释体验，见 Codex 配置 DeepSeek 模型详细教程。

网页侧可先体验 DeepSeek V4 国内入口 或 AI Chat Studio 镜像，但 Agent 工作流仍需在本地完成 API 与 config 配置。

常见问题

第一次任务应该从什么规模开始？

优先选 30 分钟内可验证 的任务：单个 failing test、单文件 bug、只读模块说明。

Codex 改了很多无关文件怎么办？

立即 git checkout -- 回滚，收紧提示词中的目录约束，并检查是否误将 approval_policy 设为 never。必要时改用 sandbox_mode = "read-only" 先探索。

命令执行失败如何排障？

把完整终端输出（含退出码）贴回；要求「不要猜测 PATH 或 env，只根据日志推断」。本地手动复现同一命令，确认是环境问题还是 patch 问题。

可以用 Codex 处理含密钥的仓库吗？

仅在确认 .env 等敏感文件不会被索引或上传的前提下使用；公司仓库先查内部 AI 政策。永远不要把 API Key 写进提示词或提交到 Git。

和 ChatGPT 网页写代码有何本质区别？

网页 ChatGPT 无法直接对你的仓库执行测试与多文件 patch；Codex 的设计目标就是 repo-grounded 的开发闭环。复杂架构问题仍建议人工 review 后再合并。

官方资源

下一步阅读

行动路径

今天：在练习仓库完成「读懂模块」只读任务。本周：用真实 bugfix 记录「首次通过率」与人工修改行数。长期：把三条工作流提示词写入团队 Wiki，并为 Codex 设定命令白名单与审批策略。

相关内容