From be82dbe07a8580436fee41a2b653a875ee1b9b7f Mon Sep 17 00:00:00 2001 From: Alessandro Benassi Date: Mon, 28 Sep 2026 11:04:37 +0200 Subject: [PATCH] docs: declare native web search support in Codex examples --- README.md | 1 + README.zh-CN.md | 1 + docs/client-setup.md | 15 +++++++++++++++ docs/examples/codex/config.toml | 1 + 4 files changed, 18 insertions(+) diff --git a/README.md b/README.md index d26439dc27..44c647bb9c 100644 --- a/README.md +++ b/README.md @@ -72,6 +72,7 @@ name = "openai" # required — enables remote /responses/compact. Lowercase sin base_url = "http://127.0.0.1:2455/backend-api/codex" wire_api = "responses" supports_websockets = true +supports_standalone_web_search = true # requires codex-lb >= 1.22.0 requires_openai_auth = true # required for codex app ``` diff --git a/README.zh-CN.md b/README.zh-CN.md index 4f96417c4c..17573888c9 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -74,6 +74,7 @@ name = "openai" # 必填 —— 启用远程 /responses/compact。自 Codex 202 base_url = "http://127.0.0.1:2455/backend-api/codex" wire_api = "responses" supports_websockets = true +supports_standalone_web_search = true # 需要 codex-lb >= 1.22.0 requires_openai_auth = true # codex 应用需要 ``` diff --git a/docs/client-setup.md b/docs/client-setup.md index c309bf7fb0..670be7510a 100644 --- a/docs/client-setup.md +++ b/docs/client-setup.md @@ -28,9 +28,23 @@ name = "openai" # required — enables remote /responses/compact. Lowercase sin base_url = "http://127.0.0.1:2455/backend-api/codex" wire_api = "responses" supports_websockets = true +supports_standalone_web_search = true # requires codex-lb >= 1.22.0 requires_openai_auth = true # required for codex app ``` +### Native web search + +`supports_standalone_web_search = true` declares that the custom provider supports +Codex's standalone search endpoint; it requires codex-lb >= 1.22.0. +Custom providers default this capability to `false`, so `--search` alone may not +make native search available. Use `codex --search` for live search in one session, +or set `web_search = "live"` at the top level of `config.toml` for a persistent +preference. This provider capability is separate from the experimental +`[features].standalone_web_search` flag; enabling that feature flag is not part +of this setup. The Codex version and selected model must also support standalone +search. See [OpenAI's web-search documentation](https://learn.chatgpt.com/docs/web-search) +and the [standalone search proxy specification](https://github.com/Soju06/codex-lb/blob/main/openspec/specs/responses-api-compat/spec.md#requirement-standalone-codex-web-search-is-forwarded-faithfully). + ### Opting into the 872k context window GPT-5.6 ships a 272,000-token default input budget with an 872,000-token @@ -173,6 +187,7 @@ base_url = "http://127.0.0.1:2455/backend-api/codex" wire_api = "responses" env_key = "CODEX_LB_API_KEY" supports_websockets = true +supports_standalone_web_search = true # requires codex-lb >= 1.22.0 requires_openai_auth = true # required for codex app ``` diff --git a/docs/examples/codex/config.toml b/docs/examples/codex/config.toml index 67dddd5500..2da56a6d47 100644 --- a/docs/examples/codex/config.toml +++ b/docs/examples/codex/config.toml @@ -9,6 +9,7 @@ name = "openai" base_url = "http://127.0.0.1:2455/backend-api/codex" wire_api = "responses" supports_websockets = true +supports_standalone_web_search = true # requires codex-lb >= 1.22.0 requires_openai_auth = true # Opt-in only. ~/.codex/daybreak-blue.config.toml selects this provider.