Codex 速查表

本附录包含命令速查表、常见问题和版本更新信息。

命令速查表

CLI 基础命令

斜杠命令

CLI 参数

Shell 命令执行

配置文件路径

配置文件位置

技能目录

快捷键

CLI 快捷键

App 快捷键

常见问题

安装与认证

Q: 如何安装 Codex CLI？

使用 npm 或 Homebrew：

npm install -g @openai/codex# 或brew install codex

Q: 首次使用如何认证？

运行 codex 命令会自动打开浏览器进行认证，使用 ChatGPT 账号或 API Key 登录。

Q: Windows 支持情况？

Windows 原生支持为实验性，推荐使用 WSL2 获得最佳体验。

使用问题

Q: 如何查看当前配置？

使用 /status 命令查看当前会话的配置和状态。

Q: 如何禁用替代屏幕？

使用 codex --no-alt-screen 或配置 alternate_screen = "never"。

Q: 命令找不到怎么办？

确保 PATH 包含 npm 全局安装目录，或使用 Homebrew 安装。

Q: 如何查看日志？

日志位于 ~/.codex/log/ 目录。

功能问题

Q: exec 和交互模式的区别？

exec 单次执行后退出，适合自动化脚本；交互模式持续对话，适合日常开发。

Q: 如何恢复历史会话？

使用 /resume 命令或 codex resume --last。

Q: GitHub Action 可以修改文件吗？

可以，设置 sandbox: workspace-write。

Q: CI/CD 中如何认证？

使用 CODEX_API_KEY 环境变量，作为 Secrets 存储。

安全问题

Q: 如何防止 Codex 删除重要文件？

使用 read-only 或 workspace-write 沙箱模式，配置 Rules 禁止危险命令。

Q: full-auto 模式安全吗？

full-auto 会自动执行所有操作，包括删除文件，请谨慎使用。

Q: 如何处理敏感数据？

使用 Secrets 存储，仅在设置脚本中可用。

版本更新

近期更新

更新 CLI

更新命令