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
处理本地仓库
让 Codex 检查文件、进行编辑，并运行计算机上已安装的工具。
掌控整个过程
选择适合任务的模型、推理力度、权限和命令。
与脚本和 CI 组合使用
以交互方式使用 Codex，或在可重复的工作流和流水线中调用 codex exec。
快速开始
开始使用
安装 Codex、登录，然后从项目目录运行你的第一个任务。
-
安装 Codex
选择以下任一安装方式：
使用适用于 macOS 和 Linux 的独立安装程序安装 Codex CLI。
安装：
curl -fsSL https://chatgpt.com/codex/install.sh | sh更新：
curl -fsSL https://chatgpt.com/codex/install.sh | sh使用适用于 Windows 的独立安装程序安装 Codex CLI。
安装：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"更新：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"你也可以使用 npm 安装 Codex CLI。
安装：
npm install -g @openai/codex更新：
npm install -g @openai/codex你也可以使用 Homebrew 安装 Codex CLI。
安装：
brew install --cask codex更新：
brew upgrade --cask codex -
运行 Codex 并登录
打开一个项目目录并运行
codex。首次运行 Codex 时，选择使用 ChatGPT 登录 或其他可用的登录方式。 -
开始第一个任务
描述你想完成的工作。例如，让 Codex 解释项目、进行一项针对性更改，或协助调试问题。
Tell me about this project在任务前后创建 Git 检查点，以便还原更改。请参阅最佳实践。
了解 Codex CLI 的功能
通过一个专注的终端循环完成交互式工作、自动化、审查和委派。
在终端中完成编码循环
在仓库中启动 Codex，以探索陌生代码、规划更改、编辑文件并运行本地开发工具。在当前轮次中引导 Codex，检查随时显示的命令和差异，并在同一会话中继续后续工作。
在终端中完成编码循环围绕 Codex 构建终端工作流
了解可用于恢复会话、添加视觉和 Web 上下文、拆分复杂工作，以及将 Codex 连接到开发工具的 CLI 功能。
返回已保存的聊天
重新打开当前仓库中的近期聊天；需要返回较早的工作时，也可以搜索所有本地聊天。
将视觉上下文加入提示词
在第一条提示词中附上错误截图、架构图或设计参考，也可以将图片粘贴到交互式编辑器中。
拆分较大型的调查工作
让 Codex 将针对性工作委派给专门的智能体，然后把它们的发现汇总回主终端会话。
搜索最新上下文
当任务依赖最新版本、文档或外部行为时，将运行切换为实时 Web 搜索。搜索活动会保留在对话记录中。
将工作移至 Codex 云端
浏览进行中和已完成的聊天，将工作提交到已配置的环境，并从终端把结果应用到本地仓库。
使用 MCP 连接外部工具
添加本地或远程 MCP 服务器，在需要时进行身份验证，并在 Codex 使用工具前检查当前会话可用的工具。
设置每次运行的边界
选择 Codex 何时无需询问即可编辑文件或运行命令，并在继续前检查当前沙箱和可写根目录。
让 Codex 适配你的终端
为 shell 生成自动补全、选择语法主题，并在 VISUAL 或 EDITOR 配置的编辑器中打开较长的提示词。
在以下情况使用 Codex CLI……
- 你通过终端工作
- 在一个专注的循环中探索、编辑和运行仓库。
- 你需要编写脚本或使用 CI
- 在可重复的工作流中运行非交互式命令。
- 你希望进行本地代码审查
- 在提交或创建拉取请求前检查更改。
- 你希望将工作交给云端
- 启动云端聊天，稍后再返回终端。