---
title: "搜索默认 cached，需要实时再 live"
summary: "日常用缓存搜索；文档刚变、CVE、版本发布用 --search 或 web_search = \"live\"。"
category: config
level: starter
surfaces: [cli, app]
tags: ["web_search", "--search", "文档"]
canonical: /tips/web-search-modes/
---

# 搜索默认 cached，需要实时再 live

日常用缓存搜索；文档刚变、CVE、版本发布用 --search 或 web_search = "live"。

```toml
web_search = "cached"   # 默认，走 OpenAI 维护的搜索缓存
# web_search = "indexed" # 只有索引放行时才出站
# web_search = "live"     # 等同 --search，拉最新网页
# web_search = "disabled"
```

一次性：

```bash
codex --search "核对官方文档里 sandbox 的当前默认值"
```

`--yolo` 或满权限沙箱下，搜索会默认改成 live。不要为了省事全程 live——更慢、更贵，还更容易把过时博客和官方文档混在一起。需要事实时，在提示里要求引用官方 URL。

`[features]` 里的 `web_search` / `web_search_cached` / `web_search_request` 已弃用，改用这个顶层键。要限制搜哪些域名或搜索上下文大小，用 `[tools.web_search]` 对象，不要和这个模式键抄成一个。

## 来源

- [OpenAI · Config basics](https://learn.chatgpt.com/docs/config-file/config-basic)