Codex / 使用 Codex

Codex 命令行

CLI 适合本地仓库、真实命令和可复现验证。

CLI 基本用法

Codex CLI 是本地仓库工作最直接的入口。进入项目根目录启动，让 Codex 可以读取真实文件、运行真实命令并受本地 sandbox 控制。

cd your-project
codex
codex "先解释项目结构，不要改文件"

关键参数

CLI 常见关键参数包括 --sandbox、--ask-for-approval、--cd、--search、模型/推理设置和非交互 exec。权限相关参数应显式写清。

codex --sandbox workspace-write --ask-for-approval on-request
codex --sandbox read-only --ask-for-approval on-request
codex exec --sandbox workspace-write "运行测试并修复失败"

常用 slash 命令

会话中用 /permissions 调整权限，用 /status 查看状态，用 /resume 恢复，用 /compact 管理上下文，用 /help 找命令。

/permissions：切换可执行能力。
/status：查看模型、sandbox、审批、上下文等。
/resume：恢复会话。
/compact：压缩长上下文。

完整使用要点

补充官方文档中容易被压缩遗漏的核心概念、操作顺序、权限边界和验证要求，方便中文学习者按页面完整学习。

CLI 使用细节

Codex CLI 是最接近真实工程环境的入口。它在当前工作目录中运行，可以读取文件、编辑文件、执行命令，并受 sandbox 和 approval policy 限制。启动前先确认当前目录、Git 状态和分支。

只读探索：使用较保守权限，让 Codex 解释项目和计划。
工作区编辑：允许 workspace-write，但生产、密钥、部署、删除仍要审批。
非交互执行：提前指定输出格式、超时和失败策略。
会话管理：用 status、resume、compact、permissions 等命令控制状态。

CLI 的强大来自真实命令，也意味着风险来自真实命令。任何删除、重置、迁移、联网安装、push、deploy 都应先理解影响。

学习检查清单

把本页内容落到真实任务中，用入口、上下文、权限、验证和团队规则五个维度检查是否真正掌握。

学习检查清单

读完本页后，不要只记住概念名。你应该能把“Codex 命令行”放回 Codex 的真实工程流程里：任务从哪里发起，系统会加载什么上下文，哪些动作需要审批，结果如何验证，失败时如何回退。

如果这是入口或平台页面，要特别确认本入口能访问哪些上下文：本地文件、云端仓库、浏览器登录态、团队消息、外部工具，以及这些上下文是否足以完成验证。

能用自己的话说明本页解决的具体问题，而不是只复述标题。
能写出一个最小示例任务，并标明目标、范围、禁止事项和验收标准。
能判断哪些信息应该放进当前提示，哪些应该沉淀到项目规则或配置里。
能说明哪些长期规则应该写进 AGENTS.md，哪些运行行为应该交给 config.toml、permission profile、skills 和 MCP。
能在任务完成后检查 diff、命令输出、测试结果、截图或 PR 说明，而不是只相信自然语言总结。

如果要把本页用于团队培训，可以让学员用 Codex 完成一个小任务：先只读解释，再提交计划，再执行最小改动，最后用真实验证命令和人工 diff 审查收尾。

Codex 实操注意事项

围绕本地环境、权限升级、远程入口、自动化失败和回滚补齐 Codex 使用中最容易被忽略的执行细节。

Codex 实操注意事项

这一页属于 Codex 的使用入口。落地时要确认任务是在本地、云端还是协作工具中执行，并检查该入口是否能访问真实仓库、依赖、网络、浏览器状态和验证命令。

处理“Codex 命令行”相关任务时，建议始终先确认当前 Git 状态和工作目录。Codex 可以很快完成修改，但它不会自动知道哪些未提交改动来自用户、哪些文件不能碰、哪些命令会影响生产环境。

本地任务优先使用低风险分支或工作树，完成后用 git diff 审查。
涉及安装依赖、联网、数据库、部署、push、删除、reset 时，先要求 Codex 解释影响再批准。
远程或协作入口生成的结果，也要回到 PR、CI、构建日志和测试证据中确认。
自动化任务要提前定义失败输出和退出条件，避免 Codex 在错误方向上反复尝试。

把 Codex 当成能执行命令的工程队友，而不是只会写文本的助手。越靠近真实系统，越需要明确边界、证据和回滚。