在 Codex 中使用 GPT-5.5：升级到最新版即可开启

GPT-5.5 已经可以在 Codex 中使用。把 Codex CLI 升级到最新版后，直接在启动时选择 gpt-5.5 即可。

GPT-5.5 是面向复杂生产工作流的新一代前沿模型。它更适合复杂编码任务、工具密集型 Agent、长上下文检索、从产品需求生成执行计划，以及对输出质量和表达稳定性要求更高的场景。

快速开启

如果你是通过 npm 安装的 Codex CLI，直接升级到最新版：

npm i -g @openai/codex@latest

升级后，可以在启动 Codex 时指定 GPT-5.5：

codex --model gpt-5.5

已经进入 Codex 会话后，也可以使用 /model 切换模型。

如果你希望用非交互模式快速验证：

codex exec --model gpt-5.5 "用一句话介绍当前模型"

如果你希望长期默认使用 GPT-5.5，可以在 ~/.codex/config.toml 中设置：

model = "gpt-5.5"
model_reasoning_effort = "medium"

medium 是 GPT-5.5 的推荐起点：它在质量、可靠性、延迟和成本之间比较均衡。只有当你的评测能证明更高推理强度确实带来收益时，再考虑切到 high 或 xhigh。

XAI Router 快速配置

如果你希望 Codex 默认通过 XAI Router 使用 GPT-5.5，可以把下面这份配置写入 ~/.codex/config.toml：

model_provider = "xai"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
model_reasoning_summary = "none"
model_context_window = 1050000
model_auto_compact_token_limit = 945000
approval_policy = "never"
sandbox_mode = "danger-full-access"
suppress_unstable_features_warning = true
cache_ttl = "30m"

[model_providers.xai]
name = "OpenAI"
base_url = "https://api.xairouter.com"
wire_api = "responses"
requires_openai_auth = false
env_key = "XAI_API_KEY"
supports_websockets = true

[features]
responses_websockets_v2 = true
multi_agent = true
remote_connections = true

如果还没有可用的 Codex 额度，可以访问 m.xairouter.com 注册账号，并在充值页面选择对应的 Codex 套餐。

然后在 shell 里设置 XAI Router 的 API Key：

export XAI_API_KEY="你的 XAI API Key"

如果希望长期生效，可以把这行写入 ~/.bashrc、~/.zshrc 或你的系统环境变量管理工具。完成后重新打开 Codex：

codex

这份配置会让 Codex 使用 xai 这个 Provider，并通过 Responses 协议把请求发送到 XAI Router。日常使用建议先保留 medium 推理强度；如果你的任务更偏复杂代码修改、长流程 Agent 或深度调试，再基于实际效果调高。

GPT-5.5 适合什么任务

GPT-5.5 更适合承担结果导向、需要持续推进的任务。

它在这些场景里更有价值：

1. 复杂代码库修改：需要先理解项目结构，再分步骤修改、运行测试、处理失败结果。
2. 工具调用密集的 Agent 任务：需要在多种工具之间选择、传参、读取结果并继续推进。
3. 长流程研发任务：例如从需求、问题报告或设计稿出发，拆解计划并落地代码。
4. 长上下文检索和归纳：需要保留大量背景信息，并在后续步骤中稳定使用。
5. 面向用户的高质量输出：需要更清晰、更直接、更稳定的表达风格。

GPT-5.5 的官方介绍强调了三点变化：更高效的推理、更强的结果导向任务执行能力，以及更精确的工具使用能力。对 Codex 来说，这些改进会直接影响日常体验：模型更容易理解目标、保留约束，并把多步任务持续推进到可验证的结果。

使用建议

给 GPT-5.5 写任务说明时，可以从更短、更清晰的提示开始，只保留真正属于产品约束的内容。例如：

目标：修复用户登录后偶发跳回登录页的问题。
成功标准：复现原因清楚，修改范围最小，相关测试通过。
限制：不要重构认证模块，不要改动无关样式。
输出：说明根因、修改文件、验证命令和结果。

如果你的任务依赖工具调用、搜索、代码修改或多轮上下文，优先使用 Responses API 对应的能力；在 Codex 中，这通常已经由 CLI 负责封装。你真正需要关注的是任务目标、验收标准、允许的副作用、输出格式，以及是否需要运行测试。

对于希望输出更短的场景，可以降低 verbosity；对于复杂工程任务，可以保留 medium 推理强度作为默认起点，再基于实际效果调整。

价格参考

OpenAI 官方价格页按每 100 万 token 计价。以标准调用为例，gpt-5.5 的短上下文价格是：

长上下文标准调用价格是：

Batch 和 Flex 的 gpt-5.5 价格低于标准调用；Priority 调用价格更高，适合对响应优先级有明确要求的任务。具体价格应以 OpenAI 官方价格页为准。

小结

现在在 Codex 中使用 GPT-5.5 的核心步骤已经很简单：

1. 升级 Codex CLI 到最新版。
2. 在 ~/.codex/config.toml 中配置 XAI Router Provider 和 model = "gpt-5.5"。
3. 设置 XAI_API_KEY 后，直接运行 codex。

GPT-5.5 更适合作为复杂 Codex 工作流的主力模型。它尤其适合需要规划、工具调用、代码修改、测试验证和长流程跟进的任务；如果只是非常短、成本敏感或低延迟的简单请求，可以继续选择更小的模型。

参考资料：

• Using GPT-5.5
• OpenAI API Pricing