垦荒学园
  • 中文

      • Codex 速查表

      一页速览常用命令、斜杠、配置与权限。详细说明见各专章链接。

      安装与认证

      # 安装 CLI
curl -fsSL https://chatgpt.com/codex/install.sh | sh   # macOS/Linux
npm install -g @openai/codex                            # npm
brew install --cask codex                               # macOS

codex --version        # 版本
codex update           # 更新
codex doctor           # 诊断
codex login / logout   # 登录 / 登出
codex app              # 打开桌面应用

      CLI 子命令

      命令用途
      codex交互式 TUI
      codex exec "..."非交互单次任务（别名 e）
      codex resume [id]继续会话
      codex fork分叉会话
      codex cloud [list]浏览/执行云端任务
      codex apply应用云端任务的 diff（别名 a）
      codex mcp管理 MCP 服务器
      codex plugin管理插件
      codex features [list|enable|disable]功能开关
      codex sandbox <os> -- <cmd>在沙箱中测试命令
      codex execpolicy check -- <cmd>校验规则命中

      常用标志

      标志说明
      -s, --sandboxread-only / workspace-write / danger-full-access
      -a, --ask-for-approvaluntrusted / on-request / never
      -m, --model指定模型，如 gpt-5.5
      -C, --cd启动工作目录
      -c key=value临时覆盖配置
      -i, --image附加图片
      -p, --profile使用某个 Profile
      --searchlive Web 搜索
      --json / --output-last-messageCI 友好输出
      --add-dir额外可写目录
      --dangerously-bypass-approvals-and-sandboxYOLO（仅隔离环境）

      斜杠命令

      命令作用
      /status线程 ID、上下文、额度
      /model切换模型与推理强度
      /approvals /permissions调整审批/权限
      /review审查未提交改动
      /skills查看 Skills
      /init生成 AGENTS.md 脚手架
      /diff /new /compact看改动 / 新线程 / 压缩历史
      /local /cloud /cloud-environment本地/云端切换
      /goal设定持续目标（需启用 goals）
      /auto-context自动上下文（IDE）
      /feedback提交反馈

      输入符：/ 控制 Codex · $name 调 Skill · @ 提及文件/应用。

      权限预设

      App 预设沙箱审批
      Read-onlyread-only询问
      Default / Auto（推荐）workspace-writeon-request
      Full access（危险）danger-full-accessnever

      模型（2026）

      模型适合
      gpt-5.5复杂编码 / 电脑操控（多数首选）
      gpt-5.4通用旗舰
      gpt-5.4-mini快/省、子代理
      gpt-5.3-codex-spark实时迭代（Pro）

      推理强度：low / medium / high / xhigh。

      config.toml 关键字段

      model = "gpt-5.5"
model_reasoning_effort = "high"
sandbox_mode = "workspace-write"
approval_policy = "on-request"
project_doc_max_bytes = 32768
project_doc_fallback_filenames = ["TEAM_GUIDE.md"]

[features]
goals = true

[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
enabled = true

      关键路径

      路径含义
      ~/.codex/config.toml用户配置
      ~/.codex/AGENTS.md全局指令
      ~/.codex/rules/*.rules命令规则
      ~/.codex/hooks.json钩子
      .agents/skills/<name>/SKILL.md仓库 Skill
      CODEX_HOME覆盖主目录

      常用一行流

      # 安全本地开发
codex --sandbox workspace-write --ask-for-approval on-request

# 只读规划
codex --sandbox read-only "分析架构并给重构方案，不改文件"

# CI 生成 changelog
codex exec --sandbox read-only -a never --output-last-message "生成 changelog" > NOTES.md

      更多细节见 命令行工具 与 斜杠命令。