Codex CLI

Codex CLI 让你在终端中使用 Codex，适合自动化脚本、批量处理和 CI/CD 集成。

安装

macOS 或 Linux

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

Windows

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

使用 npm 或 Homebrew

npm install -g @openai/codex
brew install --cask codex  # macOS

启动

运行 codex 启动交互式终端会话，按提示登录即可。

常用命令

codex                     # 启动交互式会话
codex exec "描述任务"      # 执行一次性任务
codex cloud               # 在云端运行
codex mcp list            # 列出 MCP 服务器

斜杠命令

在交互式会话中，输入 / 查看所有可用命令：

命令	用途
/plan	切换到计划模式
/review	审查代码变更
/init	生成初始 AGENTS.md
/status	查看当前会话状态
/agent	管理并行 Agent 线程
/resume	恢复已保存的对话
/fork	创建新线程，保留原对话记录
/compact	当线程变长时获取早期上下文的摘要
/experimental	切换实验性功能
/theme	选择语法高亮主题

认证

Codex CLI 支持两种认证方式：ChatGPT 账户登录和 OpenAI API Key。

配置

CLI 与桌面应用共享相同的配置层次。个人配置位于 ~/.codex/config.toml，项目级配置位于 .codex/config.toml。