Codex 的常用操作分为 CLI 命令和 Desktop 快捷入口两套CLI 适合脚本、CI 和精细控制Desktop 适合项目、文件、浏览器和长任务协作。高效使用的关键不是记住几十个参数而是先确认工作区状态再让 Codex 修改最后用测试和 Git 差异验收。本文同时覆盖两种形态CLI 参数以本机codex --help为准Desktop 快捷键以“Settings Keyboard Shortcuts”为准。常用命令总览目标命令风险查看版本和帮助codex --version、codex --help无登录codex login需鉴权启动交互会话codex可能改文件只读分析codex --sandbox read-only低自动执行codex --full-auto会改文件恢复会话codex resume取决于任务查看改动git status、git diff无CLI 与 Desktop命令对应什么操作工作目标Codex CLICodex DesktopmacOS 默认快捷键打开工作目录codex --cd /path/to/repository或codex -C /path/to/repository⌘O打开文件夹在项目菜单中添加或切换文件夹新建任务codex或会话内/new⌘N新建聊天Codex 独立聊天可用⌘⌥O选择模型配置文件或启动参数⌃⇧M打开模型选择器查看文件终端工具和仓库命令⌘P搜索文件⌘⇧E切换文件树查看代码审查codex review⌃⇧G打开 Review 标签页⌘⌥B切换 Review 面板打开终端当前 Shell⌃\ 切换内置终端⌘J 切换底部面板查看状态终端输出、codex doctor/status查看聊天 ID、上下文用量和速率限制恢复任务codex resume从侧边栏 Recent chats / 项目 Chats 重新打开Desktop 的项目可以关联一个或多个本地文件夹主文件夹决定默认工作目录和AGENTS.md、Skills、config.toml的自动发现位置。次级文件夹可读写但不会自动发现这些项目级配置。Desktop 常用命令与快捷键Desktop 没有 CLI 那样的终端子命令主要通过命令菜单、斜杠命令和快捷键完成操作。按⌘⇧P或⌘K打开命令菜单按/打开斜杠命令列表。常用斜杠命令包括/status查看聊天 ID、上下文使用量和速率限制。/model切换当前聊天模型。/reasoning调整推理力度。/plan进入多步骤计划模式。/review审查未提交改动或与基线分支比较。/project选择项目。/worktree在新的 Git worktree 中运行任务。/mcp查看 MCP 连接状态。/compact压缩当前聊天上下文。/fork从当前聊天创建新的本地聊天或 worktree。macOS 高频快捷键⌘O打开文件夹⌘P搜索文件⌘⇧E切换文件树⌃⇧G打开 Review⌘T打开内置浏览器⌘⇧B切换浏览器面板⌘⌥A跳到下一个需要处理的 Codex 聊天⌘⌥C复制会话 ID⌘⇧C复制工作目录。Windows/Linux 将⌘换成Ctrl或Super的对应组合可在“Settings Keyboard Shortcuts”搜索命令并自定义按键。--full-auto只是减少确认步骤并不代表模型更准确。真实仓库应优先使用默认确认模式或临时分支。1. 安装后先验证环境codex--versioncodex--helpcodex login进入仓库后先保存初始状态cd/path/to/your-repositorygitstatus--shortcodex/path/to/your-repository是占位路径。不要把 API Key 写入 Shell 历史、项目文件或公开日志。2. 三种启动模式只读分析适合陌生仓库和安全审计codex--sandboxread-only默认模式会在执行命令或写文件前请求确认codex批量测试或临时分支可使用全自动模式gitswitch-ccodex/task-name codex --full-auto执行高风险命令前检查pwd、目标文件和影响范围不要在生产目录直接使用--full-auto。3. 如何描述一次任务任务提示应包含目标文件、约束、验证命令和完成标准请修复 src/parser.ts 的空输入异常只修改 parser 和对应测试完成后运行 npm test -- parser并总结 git diff。要求 Codex 修改后运行最小相关测试而不是只回复“已完成”。如果任务涉及多个模块先让它输出计划再分阶段执行。4. 会话恢复与长任务终端断开或任务需要稍后继续时codex resume恢复前查看工作区gitstatus--shortgitdiff--stat恢复后先让 Codex总结已完成步骤、剩余步骤和失败命令再继续。无法恢复时把git diff、日志和剩余目标交给新会话。5. Git 差异与测试验收gitstatus--shortgitdiff--statgitdiff-- src/ tests/常见项目验证命令npmtestnpmrun lintnpmrun build这些是 Node 项目示例Python、Rust 等项目应使用仓库已有的pytest、cargo test或其他脚本。绿色测试只证明已覆盖的断言通过不代表需求完整实现。6. 配置与诊断遇到模型、Provider 或配置不生效检查常见配置文件ls-l~/.codex/config.tomlsed-n1,220p~/.codex/config.toml codex--help分享日志前脱敏 API Key。若命令失败先确认目录和运行时pwdwhichnodenode--versionwhichpython3 python3--version不要只复制最后一行错误完整上下文通常包含真正原因。7. 高频痛点的命令组合改了太多文件gitstatus--shortgitdiff--statgitdiff--name-only停止会话确认文件清单再要求只保留直接相关改动。不要直接运行git clean -fd它可能删除未跟踪文件。做到一半停止gitstatus--shortgitdiff--statcodex resume恢复后先输出状态摘要和下一步计划。测试通过但功能不对gitdiffnpmtestnpmrun lint补充能复现真实用户流程的测试并人工检查关键页面或接口。命令执行失败先用pwd、which和版本命令确认环境再把完整日志交给 Codex。不要让模型通过盲目升级依赖来“修复”环境错误。8. 推荐工作流git status --short保存初始状态。使用codex --sandbox read-only阅读仓库并给出计划。默认交互模式下限定目标文件和验证命令。修改后运行最小测试再运行完整测试或构建。用git diff --stat和git diff检查范围、敏感文件和依赖变化。人工 Review 后提交 Git长任务中断则用codex resume。9. Desktop 项目工作流用⌘O打开代码目录或在 Projects 中添加本地项目并指定主文件夹。新建 Codex 聊天先让模型只读了解目录、AGENTS.md和现有测试。需要多个仓库时在项目设置中添加次级文件夹涉及 Git 提交和 worktree 的操作仍以主仓库为准。通过/plan生成计划通过/model和/reasoning选择当前任务配置。需要浏览器、电脑操作或文件预览时从 Desktop 的工具面板打开对应能力每次授权前检查目标站点和文件。修改完成后用⌃⇧G打开 Review检查文件清单和差异再运行内置终端中的测试命令。长任务可关闭窗口后从项目 Chats 重新打开需要并行方案时使用/fork或/worktree不要让多个聊天同时改同一个工作目录。Desktop 的优势是把项目、聊天、文件、浏览器和 Review 放在同一个工作区CLI 的优势是可脚本化、可在 CI 中运行。两者可以使用同一个 Git 仓库但不要把“聊天恢复”和“Git 回滚”混为一谈恢复聊天只找回上下文不能自动撤销已经写入磁盘的改动。FAQQ1codex --full-auto可以用于生产仓库吗不建议。它适合可回滚的临时分支生产仓库应使用默认确认模式并限制目录和命令范围。Q2为什么codex resume找不到任务可能是登录身份、工作目录或 CLI 版本变化。先运行codex --help确认用户和仓库路径无法恢复时用 Git 差异和日志重建上下文。Q3修改后至少运行什么至少运行相关单元测试并检查git diff前端或构建项目再补充 lint、类型检查和 build。Q4Desktop 和 CLI 能共用一个项目吗可以共用同一个 Git 仓库和项目文件但 Desktop 通过本地项目管理文件夹CLI 以启动目录或--cd指定工作区两边同时修改时应使用不同 worktree。Q5如何避免 Codex 读取密钥不把密钥放在任务目录或提示词中使用环境变量和忽略文件并在分享日志前脱敏。结论Codex 常用命令的核心不是自动化程度越高越好而是让任务在可观察、可回滚的边界内推进。CLI 用codex --sandbox read-only、codex --full-auto和codex resume处理脚本化任务Desktop 用项目、斜杠命令、Review 和快捷键管理文件与长任务。两者都应与git status、git diff和测试命令配合最终以本机帮助和官方文档为准。