🔥 一文搞定 GPT-5.4 开启 1M 上下文：Codex 联网搜索、多 Agents 配置全讲透 🚀🧠🌐🤖

很多人以为把模型切到 gpt-5.4 就等于自动拥有 1M 上下文，其实并不一定。尤其是使用 Codex CLI、Codex Desktop，或者走第三方 OpenAI 兼容接口时，如果没有显式配置上下文窗口、自动压缩阈值、联网搜索模式，以及多 Agent 开关，往往并不能真正发挥 GPT-5.4 的完整能力。本文结合官方配置项思路，手把手讲清楚：GPT-5.4 如何开启 1M 上下文、Codex 如何开启联网搜索、Codex 如何开启多 Agents 并发协作，并给出适合第三方兼容接口场景的通用模板。

标签：
GPT-5.4 Codex 1M上下文 OpenAI兼容接口 联网搜索 Multi-Agent AI编程 Codex CLI

---

🌟 前言：为什么这篇文章值得看？

最近不少人在折腾 GPT-5.4，但很多人都会踩同一个坑：

• 以为切到 gpt-5.4 就自动拥有 1M 上下文
• 以为 Codex 默认就能查最新网页
• 以为多 Agent 默认就是开的
• 以为第三方 OpenAI 兼容接口会完整支持所有能力

但现实往往是：

• 你模型名改了
• 不代表上下文真的跑到 1M
• 不代表联网真的是实时模式
• 也不代表多 Agents 已经启用

所以这篇文章我主要解决 3 个核心问题：

✅ 本文解决的问题

1. GPT-5.4 如何开启 1M 上下文
2. Codex 如何开启实时联网搜索
3. Codex 如何开启多 Agents 并发协作

如果你正好也是：

• 用 Codex CLI / Codex Desktop
• 用第三方 OpenAI 兼容接口
• 想让 GPT-5.4 真正发挥大上下文能力
• 想顺便开联网和多 Agent

那这篇文章你基本可以直接照着改。

---

🎯 一、先说结论：GPT-5.4 开启 1M，上来先改这几个参数

如果你只想先看结论，那核心配置就是这几项：

model = "gpt-5.4"
model_context_window = 1047576
model_auto_compact_token_limit = 105197
web_search = "live"

[features]
multi_agent = true

[agents]
max_threads = 4

---

📌 这些参数分别是什么意思？

• model = "gpt-5.4"：指定使用 GPT-5.4
• model_context_window = 1047576：让 Codex 按接近 1M 的窗口处理上下文
• model_auto_compact_token_limit = 105197：控制历史上下文自动压缩的触发阈值
• web_search = "live"：开启实时联网搜索
• multi_agent = true：开启多 Agent 协作能力
• max_threads = 4：限制最多同时打开多少个 Agent 线程

你可以简单理解成一句话：

gpt-5.4 决定你“用哪个模型”，
model_context_window 决定 Codex “按多大的上下文来跑”。

---

🤔 二、为什么只改模型名还不够？很多人就卡在这里

很多人上来就改一行：

model = "gpt-5.4"

然后就觉得大功告成了。

❌ 其实这远远不够

原因很简单：
模型能力 和 客户端配置 是两回事。

---

1、模型支持 1M，不等于客户端自动按 1M 跑

GPT-5.4 模型页会展示它支持超长上下文，但 Codex 客户端是否真的按这个上限来管理上下文，还要看你本地配置。

如果你没有显式指定：

model_context_window = 1047576

那么很多时候只是“用了 GPT-5.4”，但不代表“客户端已经按 1M 的策略在工作”。

---

2、第三方兼容接口场景更容易出现缩水

如果你用的不是官方直连，而是第三方 OpenAI 兼容接口，那么情况会更复杂：

• 模型名也许兼容
• 接口格式也许兼容
• 但实际能力未必完整兼容
• 上游可能会忽略大上下文参数
• 也可能把 1M 上下文裁成 128K、256K

所以在第三方场景里，更建议你把关键参数全部显式写出来。

---

3、联网搜索默认不一定是真实时

Codex 的联网搜索不是简单的开关，而是有模式区分：

• disabled
• cached
• live

其中：

• cached：使用缓存索引，不一定拿到最新网页
• live：实时联网抓网页，更适合查今天、刚发布、最新公告

所以如果你的诉求是“查最新”，那建议直接：

web_search = "live"

---

📚 三、GPT-5.4 开启 1M 的核心配置，到底怎么理解？

这一部分很多人最关心：
为什么是这些值？为什么不是别的值？

GPT-5.4 的关键配置建议写成这样

model = "gpt-5.4"
model_context_window = 1047576
model_auto_compact_token_limit = 105197

---

1、为什么不是直接写 1050000？

因为很多人看到的是模型能力展示值，大概会写成 1050000 左右。
但在 Codex 配置思路里，更常见、更适合实际使用的值是：

model_context_window = 1047576
model_auto_compact_token_limit = 105197

这两个值更适合直接写进 config.toml。

---

2、model_auto_compact_token_limit 是干什么的？

这个参数的作用是：

当历史上下文累计到一定规模时，触发自动压缩。

也就是说，它不是“上下文上限”，而是“历史压缩阈值”。

如果你只写了大窗口，不写自动压缩阈值，那么长对话下的行为未必稳定。
所以更推荐这两个一起写。

---

3、推荐一起搭配的几个参数

如果你想整得更完整一点，可以搭配这些：

model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"
service_tier = "fast"

其中：

• model_reasoning_effort = "xhigh"：更高推理强度
• disable_response_storage = true：不保存响应存储
• preferred_auth_method = "apikey"：优先 API Key 认证
• service_tier = "fast"：更偏向快速响应

这些不是“必须项”，但经常会一起配。

---

📂 四、Codex 配置文件在哪里？先别改错文件

改配置前，先找到正确文件位置。

Windows

通常在这里：

%USERPROFILE%\.codex\config.toml

例如：

C:\Users\你的用户名\.codex\config.toml

---

macOS / Linux

一般在这里：

~/.codex/config.toml

---

⚠️ 注意：不要改错文件

很多人的 .codex 目录里不止一个配置文件，比如：

• config.toml
• config.toml.bak
• config.toml.bak-时间戳

真正生效的，通常是：

config.toml

所以你一定要改这个主配置文件。

---

💾 五、正式修改前，建议先备份配置

这一点很重要，尤其是你本来就已经有多套配置的时候。

PowerShell 备份命令

$ts=Get-Date -Format 'yyyyMMdd-HHmmss'
Copy-Item "$env:USERPROFILE\\.codex\\config.toml" "$env:USERPROFILE\\.codex\\config.toml.bak-$ts"

这样做的好处是：

• 改错后可以快速回滚
• 后续升级 Codex 时方便比对配置差异
• 不容易把原配置彻底搞乱

---

🛠️ 六、最小可用配置：只想开 1M + 联网 + 多 Agents，直接抄这份

如果你不想整太复杂，先上最小可用版就行：

model = "gpt-5.4"
model_context_window = 1047576
model_auto_compact_token_limit = 105197
web_search = "live"

[features]
multi_agent = true

[agents]
max_threads = 4

这个版本已经能覆盖大多数人的核心需求：

• GPT-5.4
• 1M 上下文
• 实时联网
• 多 Agent

---

🌐 七、第三方兼容接口怎么写？这里给你通用模板，但一定要自己替换

这部分是很多人最容易出错的地方。

🚨 先看提醒，真的很重要

下面的 your_provider 和 https://your-openai-compatible-endpoint/v1 都只是占位符。
你必须替换成你自己的 provider 名称和接口地址。
不要直接原样复制，否则大概率无法使用。

---

✅ 第三方兼容接口通用模板

model_provider = "your_provider"
model = "gpt-5.4"
model_context_window = 1047576
model_auto_compact_token_limit = 105197
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"
service_tier = "fast"
web_search = "live"

[model_providers.your_provider]
name = "your_provider"
base_url = "https://your-openai-compatible-endpoint/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
multi_agent = true

[agents]
max_threads = 4

---

✅ 带 profile 的推荐完整版

如果你平时还会切 profile，那建议直接写成这种结构：

model_provider = "your_provider"
model = "gpt-5.4"
model_context_window = 1047576
model_auto_compact_token_limit = 105197
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"
service_tier = "fast"
web_search = "live"

[model_providers.your_provider]
name = "your_provider"
base_url = "https://your-openai-compatible-endpoint/v1"
wire_api = "responses"
requires_openai_auth = true

[windows]
sandbox = "unelevated"

[features]
multi_agent = true

[agents]
max_threads = 4

[profiles.gpt54]
model = "gpt-5.4"
model_context_window = 1047576
model_auto_compact_token_limit = 105197
web_search = "live"

---

🚨 八、哪些字段必须自己替换？这里单独高亮提醒一次

很多人最容易犯的错误就是：

把文章里的模板直接原样复制，结果发现完全不能用。

你必须自己替换的字段包括：

model_provider = "your_provider"

[model_providers.your_provider]

name = "your_provider"

base_url = "https://your-openai-compatible-endpoint/v1"

---

它们分别代表什么？

• your_provider：你自己的 provider 名称
• https://your-openai-compatible-endpoint/v1：你自己的兼容接口地址

---

🔥 建议你把这段话直接保留在文章里

⚠️ 本文中的 your_provider 和 base_url 都只是通用占位符。
⚠️ 请根据你自己的第三方平台、中转服务、网关地址自行替换。
⚠️ 不要原样复制，否则配置不会生效。

---

🌍 九、Codex 联网搜索怎么开？两种方式最实用

很多人会问：

Codex 联网到底怎么开启？

其实就两种方式。

---

方式 1：临时开启

直接带参数启动：

codex --search

适合：

• 临时查资料
• 临时验证联网效果
• 不想改全局配置的时候

---

方式 2：常驻开启

直接在配置文件里写：

web_search = "live"

这样以后默认就是实时联网搜索模式。

---

三种模式的区别

模式	含义	是否适合查最新网页
disabled	关闭搜索	❌
cached	使用缓存索引	⚠️ 一般
live	实时联网抓取	✅

如果你想让它查今天、刚发布、最新网页，那就直接：

web_search = "live"

---

🤖 十、Codex 如何开启多 Agents？这部分很多人容易忽略

如果你想让 Codex 支持多 Agent 协作，关键配置就是这两段：

[features]
multi_agent = true

[agents]
max_threads = 4

---

1、multi_agent = true 的作用是什么？

它的作用是：

• 开启多 Agent 协作能力
• 允许使用多 Agent 工具链
• 支持多个 Agent 分工处理任务

简单理解就是：

一个主 Agent 负责统筹，多个子 Agent 分头执行任务。

这在下面这些场景里会很有用：

• 大项目代码分析
• 多文件问题排查
• 一边改代码，一边跑验证
• 一个 Agent 查资料，一个 Agent 改配置，一个 Agent 跑测试

---

2、max_threads = 4 是什么意思？

[agents]
max_threads = 4

这个配置表示：

最多允许同时打开 4 个 Agent 线程。

你可以把它理解成并发上限。

通常建议：

• 2：保守
• 4：稳妥，适合大多数人
• 6：更激进，但对环境要求更高

---

3、多 Agent 是不是越多越好？

并不是。

线程数开得太高，可能带来这些问题：

• 调度更复杂
• 输出更混乱
• 资源占用更高
• 上游接口更容易触发限速
• 第三方兼容接口更容易不稳定

所以对大部分用户来说，我更建议从：

max_threads = 4

开始。

---

4、多 Agent 开启后就一定能稳定跑吗？

也不一定。

因为这还和这些因素有关：

• 你的 Codex 客户端版本
• 你的配置是否生效
• 你的上游服务是否支持足够并发
• 第三方兼容接口的稳定性
• 账号限速 / 资源限制

所以你要把它理解成：

本地开关打开了，不代表所有链路都一定完整支持。

---

✅ 十一、怎么验证 1M、联网、多 Agents 都生效了？

配置写完后，我建议你按下面顺序检查。

---

1、先检查配置文件是否写成功

打开：

%USERPROFILE%\.codex\config.toml

确认至少包含这些关键项：

model = "gpt-5.4"
model_context_window = 1047576
model_auto_compact_token_limit = 105197
web_search = "live"

[features]
multi_agent = true

[agents]
max_threads = 4

---

2、检查 CLI 是否能正常读取配置

运行：

codex --version

如果能正常输出版本号，一般说明配置至少没有 TOML 语法错误。

---

3、改完配置后一定要重开新会话

这是非常容易忽略的一步。

因为你当前打开的 Codex 会话，很可能还是旧配置加载出来的。

正确做法是：

• 关闭当前 Codex CLI / Desktop
• 重新打开一个新会话
• 再测试效果

---

4、验证联网是否真是 live

你可以直接问它一个强时效问题，例如：

帮我查一下今天 OpenAI 官方最新发布了什么，并附上来源

如果它能返回：

• 最新内容
• 明确来源
• 明显不是旧缓存

那说明 web_search = "live" 大概率已经生效。

---

5、验证多 Agent 是否生效

如果客户端支持多 Agent 工具链，开启后通常会表现为：

• 能触发多 Agent 分工
• 能看到多个 Agent 线程协作
• Agent 数量受 max_threads 限制

---

6、验证 1M 上下文是否真的有效

这个不能只靠一句短对话判断，建议这样测试：

• 输入大段代码
• 连续多轮塞入长文档
• 让它在后续回忆很前面的细节
• 看是否能较稳定保持长上下文一致性

但这里一定要记住一句话：

本地配置好了，不代表上游服务一定真的给你 1M。

---

⚠️ 十二、第三方兼容接口最容易踩的坑，真的要注意

这部分建议每个用第三方接口的人都认真看一遍。

---

1、本地配置只是“客户端请求”

你本地写了：

model_context_window = 1047576

本质上是在告诉 Codex：

请按 GPT-5.4 的超长窗口来工作。

但最终能不能真的拿到这么大的窗口，还是取决于你的上游服务。

---

2、第三方兼容接口最常见的问题

常见坑包括：

• 表面上支持 gpt-5.4，实际映射成别的模型
• 大上下文被裁成 128K 或 256K
• 接口形式兼容，但能力不完整兼容
• web_search = "live" 被静默忽略
• 多 Agent 并发支持一般
• 并发高了之后超时、限速、返回不稳定
• model_context_window 被服务端忽略

---

3、一句话总结这个坑

本地配置决定你“请求什么”，上游服务决定你“最终拿到什么”。

这句话一定要记住。

---

❓ 十三、FAQ 高频问题汇总

Q1：GPT-5.4 的上下文到底是 1050000 还是 1047576？

都对，但含义不同：

• 1,050,000：模型能力展示值
• 1047576：更适合写进 Codex 配置的具体值

所以建议直接写：

model_context_window = 1047576

---

Q2：model_auto_compact_token_limit 是干什么的？

它是自动压缩历史上下文的触发阈值。

建议配合 1M 上下文一起写：

model_auto_compact_token_limit = 105197

---

Q3：联网到底用 cached 还是 live？

看你的需求：

• cached：适合不追求绝对实时
• live：适合查今天、刚刚、最新网页内容

如果你想查最新资料，建议直接：

web_search = "live"

---

Q4：多 Agent 是不是越多越好？

不是。

更高的线程数意味着：

• 更高的资源占用
• 更高的上游并发压力
• 更高的限速风险
• 更复杂的调度和输出

大多数用户从 4 开始就够了。

---

Q5：如果我是官方直连，还需要配置 provider 吗？

一般不需要。

如果你是官方直连，通常主要关注这些就够了：

model = "gpt-5.4"
model_context_window = 1047576
model_auto_compact_token_limit = 105197
web_search = "live"

[features]
multi_agent = true

[agents]
max_threads = 4

而如果你是第三方兼容接口，才需要自己配置：

• model_provider
• [model_providers.xxx]
• base_url

---

🎉 十四、总结：真正把 GPT-5.4 跑满 1M，再加联网和多 Agents，记住这 6 句话

✅ 1）切到 gpt-5.4 不等于自动 1M

你还需要显式加上：

model_context_window = 1047576
model_auto_compact_token_limit = 105197

---

✅ 2）想查最新网页，就直接用 live

web_search = "live"

---

✅ 3）如果你用第三方兼容接口，provider 和 base_url 必须自己替换

文章里的：

your_provider
https://your-openai-compatible-endpoint/v1

都只是占位符。

---

✅ 4）想开多 Agents，核心配置就是这两段

[features]
multi_agent = true

[agents]
max_threads = 4

---

✅ 5）改完配置后一定要重开新会话

否则你看到的效果很可能还是旧配置。

---

✅ 6）本地配好了，不代表上游一定完整支持

尤其是第三方兼容接口场景，最终还得看上游是否真支持：

• GPT-5.4
• 1M 上下文
• 实时联网
• 多 Agent 并发

---

❤️ 结语：这篇文章真正想帮你避开的坑

如果你最近也在折腾：

• GPT-5.4 的超长上下文
• Codex CLI / Desktop 配置
• 第三方 OpenAI 兼容接口
• 联网搜索
• 多 Agent 协作

---

🔗 参考资料

• Codex Config Reference

• Codex Advanced Config

• GPT-5.4 Model Page

• Introducing GPT-5.4

那你大概率已经发现：
很多问题不是“模型不行”，而是“配置没到位”。

所以我更建议你记住这件事：

真正决定体验的，不只是模型名，
还有上下文窗口、自动压缩、联网模式、并发能力，以及你的上游服务是否真的支持这些能力。

如果这篇文章对你有帮助，欢迎：

• 👍 点赞
• ⭐ 收藏
• 💬 评论交流