常見問題

此 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 將在未來版本中保持最新。