跳转到内容

搜索

Codex:快速上手

拾知 6 min read

按基础篇、进阶篇和扩展篇梳理 Annotate、安全模式、模型配置、Git/Fork、Side Chat、Steer、Plugin/Skill、Automations 与 Codex Mobile 等核心能力。

基础篇

  1. Annotate:在 Codex 内置浏览器中直接选中需要修改的元素,并用自然语言说明希望如何修改。
    • 原理是:Codex 对页面进行截图、标注,再结合你的文字说明进行推理与修改。
  2. 安全模式:auto-review 模式下,会有一个专门的审查 agent 把关,只有在少数拿不准的情况下才停下来,等待你人工审核。
  3. 模型配置:faststandard 输出更快,大约是 1.5 倍,但 token 消耗更多(例如 5.5 模型在 fast 下的消耗大约是 standard 的 2 倍)。

进阶篇

  1. 内置终端:可通过快捷键 CMD + J 切换底部面板显示,用于在 Codex 中直接操作命令行。
  2. 内置 Git 功能:支持在应用内完成常见 Git 操作,并提供本地“评论”能力,类似于在 PR 中对代码做行级评论。
  3. 编辑最后一条消息:将上一轮会话从上下文中清除。如果需要回到更早的分支,则使用 fork 功能。
  4. Fork:从会话历史中的指定位置开始,创建一个新的会话分支。代码不会被自动回滚,如需回滚需手动执行 git reset --hard <commitid>
    • fork into local:工作目录不变,只是会话从该历史节点分叉。
    • fork into new worktree:在当前项目的基础上创建一个新的 worktree,将代码复制到新目录中,作为当前会话的工作目录。
  5. 会话归档:可将会话暂时隐藏而不是删除。已归档的会话可以在控制面板(CMD + ,)中查看,并选择恢复或彻底删除。
  6. 自动执行 git commit:每次执行完代码修改后,Codex 都会自动执行一次 git commit,只提交与当前需求相关的改动。
    • 当前会话:可以直接在对话中告诉 Codex 需要启用这一策略。
    • AGENTS.md:也可以在该文件中写明自动提交的要求,作为全局约定。
  7. Side Chat:通过输入 /side 打开。这里的会话不会影响左侧主 Codex 任务的执行,一般用于轻量级提问或零散讨论。
  8. Steer:在任务执行过程中,可以通过追加指令对当前计划“纠偏”或微调,而无需完全中断任务。

扩展篇

  1. Plugin / Skill 概述:可以理解为一套 MCP 与 Skill 的组合能力。既可以通过 @ 显式指定,也可以让 Codex 根据会话内容自动推断是否调用。
    • chrome plugin,可执行类似「打开 Product Hunt 首页,找到今天最热门的三个产品,总结它们各自的特点,并附上对应访问链接」这类浏览器任务。
    • computer use plugin,可执行类似「在我的苹果日历中创建一个 xx 日程」的操作。Codex 使用独立的虚拟鼠标,与用户的真实鼠标互不干扰,可在后台静默执行,你可以继续正常使用电脑。
    • Image Gen skill,用于执行类似「给这个笔记软件生成一张宣传海报,注意使用我给你的真实软件截图」的任务。
      • 截图并传给 Codex:点击对话框中的「+」按钮,选择「附加应用快照」即可。
    • 自定义 Skill:可以为当前项目快速创建专用 skill,只需在会话中用自然语言描述该 skill 的输入、输出和预期用途。
  2. Automations:用于配置定时或周期性任务。
    • 支持三种运行上下文:local(绑定某个项目目录)、worktree(基于现有项目目录新建一个独立 worktree)、chat(不与任何项目目录绑定,仅保留对话)。
    • 每次 Automation 触发执行时,都会创建一个全新的会话,方便审计与回溯。
    • 「run now」:可立即触发一次执行,常用于测试或试运行。
  3. Codex Mobile:通过手机远程操控电脑上的 Codex,会话与自动化能力保持一致,让电脑在你离开桌面时也能持续工作。

Reference