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，让它检查真实文件、运行仓库命令，并直接修改当前工作树。
始终掌握控制权
评审计划和 diff，选择审批策略与沙箱模式，并决定 Codex 执行动作前何时必须暂停。
接入脚本和 CI
需要人工协作时使用交互式 TUI；需要脚本、CI 和机器可读自动化时使用 codex exec。
快速开始
开始使用 Codex CLI
安装 Codex，在本地仓库中登录，然后用明确目标启动第一个终端任务。
-
安装 Codex
运行 curl -fsSL https://chatgpt.com/codex/install.sh | sh。Codex CLI 支持 macOS、Windows 和 Linux。
查看安装说明
看看 Codex CLI 能做什么
这些 Codex CLI 功能覆盖交互式编码与可重复自动化，让检查、编辑、运行和评审始终贴近终端与本地仓库。
使用 skills 和 plugins
通过 /skills 选择本地 skills，通过 /plugins 浏览 plugins，只启用当前任务需要的能力。
了解 skills 和 plugins围绕 Codex 构建终端工作流
使用 CLI 功能恢复聊天、添加视觉和 Web 上下文、拆分复杂工作，并把 Codex 连接到开发工具。
返回已保存的聊天
重新打开当前仓库最近的聊天；需要返回更早的工作时，也可以搜索本地聊天。
把视觉上下文加入提示词
随首个提示词传入错误截图、架构图或设计参考，也可以把图片粘贴到交互式输入框中。
拆分较大的调查任务
让 Codex 把聚焦工作委派给专门的子智能体，再把调查结果汇总回主终端会话。
搜索最新上下文
当任务依赖当前版本、文档或外部行为时，把本次运行切换到实时 Web 搜索。搜索活动会保留在记录中。
把工作移到 Codex 云端
浏览进行中和已完成的聊天，把工作提交到已配置环境，再从终端把结果应用到本地仓库。
使用 MCP 连接外部工具
添加本地或远程 MCP server，按需认证，并在 Codex 使用前检查当前会话可用的工具。
设置每次运行的边界
选择 Codex 何时可以直接编辑文件或运行命令，并在继续前检查当前沙箱和可写根目录。
让 Codex 适配你的终端
为 shell 生成补全、选择语法主题，并在 VISUAL 或 EDITOR 指定的编辑器中打开较长提示词。
这些情况适合使用 Codex CLI…
- 主要在终端中工作
- 让检查、编辑、运行和评审闭环始终贴近 shell 与本地仓库。
- 需要脚本或 CI
- 使用 codex exec、--json 和明确配置覆盖构建可重复的非交互工作流。
- 需要本地代码评审
- 直接评审工作树 diff、分支比较或指定提交。
- 想把工作交给云端
- 从终端启动云端任务、检查返回结果，并把选中的改动带回本地工作树。