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

身份 非官方简体中文镜像

翻译状态 AI 翻译 / AI 审校

来源版本 官方未提供

同步日期 2026-07-26

官方原文 learn.chatgpt.com

Codex CLI

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

在不离开终端的情况下检查代码、进行更改、运行命令，并自动化可重复的工作。

安装 Codex

CLI 参考

$ codex

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

开始使用时，请描述一项任务，或尝试以下命令之一：

/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 what model and reasoning effort to use
/review - review any changes and find issues

Refactor the Dashboard component to React Hooks

100% context left · ? for shortcuts

针对本地代码仓库开展工作

让 Codex 检查文件、进行编辑，并运行计算机上已安装的工具。

始终掌控全局

选择适合任务的模型、推理工作量、权限和命令。

使用脚本和 CI 组合工作流

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

快速入门

开始使用 Codex CLI

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

1. 安装 Codex

   使用适用于 macOS 和 Linux 的独立安装程序安装 Codex CLI。

   安装 Codex

   curl -fsSL https://chatgpt.com/codex/install.sh | sh

   更新 Codex：

   curl -fsSL https://chatgpt.com/codex/install.sh | sh

2. 运行 Codex 并登录

   打开项目目录并运行 codex。首次运行 Codex 时，请选择 使用 ChatGPT 登录 或其他可用的登录方式。

   查看身份验证选项

3. 开始你的第一个任务

   描述你想要完成的任务。例如，让 Codex 解释项目、进行有针对性的更改，或帮助调试问题。

   Tell me about this project

   在任务前后创建 Git 检查点，以便还原更改。请参阅最佳实践。

了解 Codex CLI 的功能

使用一个专注的终端循环完成交互式工作、自动化、审查和委派。

在终端中保持编码循环

在代码仓库中启动 Codex，探索不熟悉的代码、规划更改、编辑文件，并运行本地开发工具。引导当前回合，检查命令和差异，并在同一会话中继续后续工作。

了解更多

>\_ OpenAI Codex (v0.143.0)

model: gpt-5.6-sol medium /model to change
directory: ~/code/my-app

使用技能和插件

将可重复的指令封装为技能，然后添加插件，在不离开 CLI 的情况下将 Codex 连接到团队的工具和数据。

了解更多

zsh — plugins

Plugins

Browse plugins from available marketplaces.

Installed 17 of 1751 available plugins.

[All Plugins]  Installed (17)  OpenAI Curated  Workspace  Shared with me  openai-primary-runtime  Add Marketplace

Type to search plugins

› [-] [Beta] Workspace agents
  Installed · OpenAI Curated
  Press Enter to view plugin details.

[*] Build Web Apps
  Installed · OpenAI Curated
  Build frontend-focused web apps with browser testing

[-] Default templates
  Installed · OpenAI Curated
  Default templates for documents, spreadsheets, and slides

[*] Documents
  Installed · openai-primary-runtime
  Create and edit document artifacts

[*] GitHub
  Installed · OpenAI Curated
  Triage PRs, issues, CI, and publish flows

[*] Gmail
  Installed · OpenAI Curated
  Read and manage Gmail

[*] Google Calendar
  Installed · OpenAI Curated
  Manage Google Calendar events and schedules

[-] Google Drive
  Installed · OpenAI Curated
  Work across Drive, Docs, Sheets, and Slides

在发布前审查更改

针对未提交的更改、某个提交或基准分支运行专门的审查。Codex 会报告按优先级排序的问题，而不会修改你的工作树，让你可以在提交或创建拉取请求前处理风险。

了解更多

选择审查预设：

1. 针对基准分支进行审查（PR 风格）
2. 审查未提交的更改
3. 审查某个提交
4. 自定义审查指令

围绕 Codex 构建终端工作流

了解可用于恢复会话、添加视觉和 Web 上下文、拆分复杂工作，以及将 Codex 连接到开发工具的 CLI 功能。

01 codex resume：返回已保存的聊天

重新打开当前代码仓库中的最近聊天，或跨本地聊天搜索，以便返回较早的工作。

了解更多

02 codex --image：将视觉上下文加入提示词

在第一条提示词中附加错误截图、架构图或设计参考，或将图片粘贴到交互式编辑器中。

了解更多

03 subagents：拆分较大的调查任务

让 Codex 将专注的工作委派给专业代理，然后将它们的发现带回主终端会话。

了解更多

04 codex --search：搜索当前上下文

当任务依赖当前版本、文档或外部行为时，将运行切换为实时 Web 搜索。搜索活动会在记录中保持可见。

了解更多

05 codex cloud：将工作转移到 Codex cloud

浏览活跃和已完成的聊天，将工作提交到已配置的环境，并从终端将结果应用到本地代码仓库。

了解更多

06 codex mcp：使用 MCP 连接外部工具

添加本地或远程 MCP 服务器，在需要时进行身份验证，并检查当前会话可用的工具，然后再由 Codex 使用这些工具。

了解更多

07 /permissions：为每次运行设置边界

选择 Codex 何时可以编辑文件或运行命令而无需询问，并在继续之前检查当前的沙箱和可写根目录。

了解更多

08 codex completion：让 Codex 适配你的终端

为你的 shell 生成补全，选择语法主题，并在 VISUAL 或 EDITOR 配置的编辑器中打开较长的提示词。

了解更多

适合使用 Codex CLI 的场景……

你在终端中工作

在一个专注的循环中探索、编辑和运行代码仓库。

你需要脚本或 CI

在可重复的工作流中运行非交互式命令。

你想要本地代码审查

在提交或创建拉取请求之前检查更改。

你想将工作交给云端

启动云端聊天，稍后再返回终端。

其他 ChatGPT 和 Codex 使用界面