常见问题

此 FAQ 突出显示了最常见的问题，并将您指向 docs/ 中的正确深入指南。

OpenAI 在 2021 年发布了一个名为 Codex 的模型 - 这与之相关吗？

在 2021 年，OpenAI 发布了 Codex，一个旨在从自然语言提示生成代码的 AI 系统。原始 Codex 模型已于 2023 年 3 月停用，与 CLI 工具分开。

支持哪些模型？

我们建议使用 Codex 与 GPT-5.1 Codex Max，我们最好的编码模型。默认推理级别是 medium，对于复杂任务，您可以使用 /model 命令升级到 high 或 xhigh（其中支持，例如 gpt-5.1-codex-max 和 gpt-5.2）。

您也可以通过使用基于 API 的身份验证并使用 --model 标志启动 codex 来使用较旧的模型。

批准和沙箱模式如何协同工作？

批准是 Codex 用于在运行具有提升权限的工具调用之前要求的机制 - 通常是离开沙箱或在没有隔离的情况下重新运行失败的命令。沙箱模式提供基线隔离（Read Only、Workspace Write 或 Danger Full Access；参见沙箱与批准）。

我可以在没有 TUI 的情况下自动化任务吗？

可以。codex exec 在非交互模式下运行 Codex，具有流日志、JSONL 输出和结构化 schema 支持。该命令遵守您在配置指南中配置的相同沙箱和批准设置。

我如何阻止 Codex 编辑我的文件？

默认情况下，Codex 可以修改当前工作目录中的文件（Auto 模式）。要防止编辑，使用 CLI 标志 --sandbox read-only 在只读模式下运行 codex。或者，您可以在对话中使用 /approvals 更改批准级别。

我如何将 Codex 连接到 MCP 服务器？

通过使用配置 -> 连接到 MCP 服务器中的示例通过您的 config.toml 配置 MCP 服务器。

我在登录时遇到问题。我应该检查什么？

通过三个步骤确认您的设置：

1. 浏览身份验证中的身份验证流程，以确保正确的凭证存在于 ~/.codex/auth.json 中。
2. 如果您在无头或远程机器上，请确保按照身份验证 -> 在"无头"机器上连接中的说明配置端口转发。

它在 Windows 上工作吗？

在 Windows 上直接运行 Codex 可能会起作用，但不受官方支持。我们建议使用 Windows Subsystem for Linux (WSL2)。

安装后我应该从哪里开始？

按照安装和构建中的快速设置，然后跳转到入门指南，获取交互式使用提示、提示示例和 AGENTS.md 指导。

brew upgrade codex 不会升级我

如果您运行的是 Codex v0.46.0 或更早版本，brew upgrade codex 不会将您移动到最新版本，因为我们从 Homebrew 公式迁移到了 cask。要升级，请卸载现有的过时公式，然后安装新的 cask：

brew uninstall --formula codex
brew install --cask codex

重新安装后，brew upgrade --cask codex 将在未来版本中保持最新。