Web search
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending
.mdto the page URL.
ChatGPT includes a first-party web search tool. Treat all web results as untrusted input.
In the ChatGPT desktop app, ask for current information in a chat. ChatGPT records search activity with the other tool calls in the transcript.
In ChatGPT web, ask for current information or sources. Search results and citations appear in the chat when ChatGPT uses web search. Workspace settings can limit whether search is available.
In the CLI, pass --search to fetch live results for one run:
codex --search "Summarize the latest release notes for this dependency"
Searches appear as web_search items in the interactive transcript and in
codex exec --json output.
In the IDE extension, ask Codex to search while you work in the editor. The extension uses the connected Codex host's search mode. Search activity appears in the chat transcript.
Configure local web search
For local Codex chats, Codex enables cached search by default. Cached mode uses an OpenAI-maintained index instead of fetching arbitrary pages live, which lowers—but doesn't remove—prompt injection risk.
Use live search when your task depends on the latest information. Set
web_search = "live" in config.toml. Set web_search = "disabled" to turn
the tool off. The "indexed" mode permits external web access only when the
search index gates the request. When Codex runs with full access, web search
defaults to live results. See Config basics
for config file locations and precedence.
Search with a custom model provider
A custom model provider can opt in to standalone web search when it supports a compatible search endpoint:
model_provider = "custom"
web_search = "live"
[model_providers.custom]
name = "Custom Responses provider"
base_url = "https://example.com/v1"
env_key = "CUSTOM_RESPONSES_API_KEY"
supports_standalone_web_search = true
Custom providers default to supports_standalone_web_search = false.
Standalone web search remains under development and is off by default.
Setting this provider capability doesn't enable the feature: the provider,
selected model, and runtime must also support standalone search. Workspace and
managed search restrictions still apply.
For network boundaries that apply to Codex cloud environments, see Internet access.