中文

Codex CLI

从终端检查、编 辑和运行代码

无需离开终端即可检查代码、进行更改、运行命令并自动执行可重复的工作。

$ codex

╭──────────────────────────────────────────────────╮
│ >_ OpenAI Codex                                  │
│                                                  │
│ model:     gpt-5.6-sol medium  /model to change │
│ directory: ~/code╰──────────────────────────────────────────────────╯

  To get started, describe a task or try one of these commands:

  /init - create an AGENTS.md file with instructions for Codex
  /status - show current session configuration
  /permissions - choose what Codex is allowed to do
  /model - choose the model and reasoning effort
  /review - review changes and find issues

  Refactor the Dashboard component to React Hooks

100% context left · ? for shortcuts

01

直接处理本地仓库

让 Codex 检查文件、进行编辑,并运行电脑上已有的工具。

02

保持控制

选择适合任务的模型、推理强度、权限和命令。

03

组合脚本与 CI

交互式使用 Codex,或在可重复的工作流和流水线中调用 codex exec 。

入门

安装 Codex、登录,然后从项目目录运行第一个任务。

  1. 安装 Codex

    选择以下安装方法之一: 使用适用于 macOS 和 Linux 的独立安装程序安装 Codex CLI。 安装: 更新: 使用适用于 Windows 的独立安装程序安装 Codex CLI。 安装: 更新: 也可以使用 npm 安装 Codex CLI。 安装: 更新: 也可以使用 Homebrew 安装 Codex CLI。 安装: 更新:

    安装 Codex
  2. 运行 Codex 并登录

    打开项目目录并运行 codex 。首次运行 Codex 时,选择 Sign in with ChatGPT(使用 ChatGPT 登录)或其他可用登录方式。

    查看身份验证选项
  3. 开始第一个任务

    说明想要完成的目标。例如,让 Codex 解释项目、进行一项聚焦修改,或协助调试问题。 在任务前后创建 Git 检查点,以便回退变更。请参阅 最佳实践 。

    最佳实践

看看 Codex CLI 能做什么

在一个紧凑的终端循环中完成交互式工作、自动化、评审和委派。

01

让编码循环留在终端中

从仓库中启动 Codex,探索陌生代码、规划变更、编辑文件并运行本地开发工具。引导当前 turn ,检查出现的命令和 diff,再在同一会话中继续跟进。

让编码循环留在终端中
02

使用技能和插件

把可复用指令封装为技能,再通过插件连接团队工具和数据,全程无需离开 CLI。

使用技能和插件
03

发布前评审变更

针对未提交变更、commit 或基准分支运行独立评审。Codex 不会修改工作树,只会报告按优先级排序的发现,方便你在提交或打开 pull request 前处理风险。

发布前评审变更

围绕 Codex 构建终端工作流

使用 CLI 功能恢复聊天、添加视觉和 Web 上下文、拆分复杂工作,并把 Codex 连接到开发工具。

01 codex resume

返回已保存的聊天

重新打开当前仓库最近的聊天;需要返回更早的工作时,也可以搜索本地聊天。

03 subagents

拆分较大的调查任务

让 Codex 把聚焦工作委派给专门的子智能体,再把调查结果汇总回主终端会话。

04 codex --search

搜索最新上下文

当任务依赖当前版本、文档或外部行为时,把本次运行切换到实时 Web 搜索。搜索活动会保留在记录中。

05 codex cloud

把工作移到 Codex 云端

浏览进行中和已完成的聊天,把工作提交到已配置环境,再从终端把结果应用到本地仓库。

07 /permissions

设置每次运行的边界

选择 Codex 何时可以直接编辑文件或运行命令,并在继续前检查当前沙箱和可写根目录。

08 codex completion

让 Codex 适配你的终端

为 shell 生成补全、选择语法主题,并在 VISUAL 或 EDITOR 指定的编辑器中打开较长提示词。

适合使用 Codex CLI 的场景

习惯在终端工作
在一个集中循环中探索、编辑和运行仓库。
需要脚本或 CI
在可重复工作流中运行非交互式命令。
需要本地代码评审
在提交或打开 pull request 前检查变更。
希望把工作交给云端
启动云端聊天,稍后再回到终端。

其他 ChatGPT 与 Codex 使用界面