Codex의 웹 검색 작동 방식
Codex에는 내장된 검색 도구가 있습니다. OpenAI 문서는 이에 대해 다음과 같은 경고를 덧붙입니다: "ChatGPT에는 퍼스트 파티 웹 검색 도구가 포함되어 있습니다. 모든 웹 결과는 신뢰할 수 없는 입력으로 취급하십시오."
Codex가 언제 검색했는지 확인할 수 있습니다. 문서에 따르면: "검색은 대화형 트랜스크립트와 codex exec --json 출력에서 web_search 항목으로 나타납니다." IDE 확장 프로그램에서도 검색 활동이 채팅 트랜스크립트에 표시되며, 문서에는 다음과 같이 명시되어 있습니다: "확장 프로그램은 연결된 Codex 호스트의 검색 모드를 사용합니다."
핵심 질문은 결과가 어디서 오느냐는 것입니다. 이는 검색 모드에 따라 달라집니다.
캐시된 검색이란 무엇인가
Codex 구성 문서에는 기본 설정에 대해 더 자세히 설명되어 있습니다: "캐시는 OpenAI가 유지 관리하는 웹 결과 인덱스이므로, 캐시 모드는 실시간 페이지를 가져오는 대신 사전 인덱싱된 결과를 반환합니다. 이는 임의의 실시간 콘텐츠로부터의 프롬프트 주입 노출을 줄여줍니다."
따라서 캐시 모드에서 Codex는 당신이 질문하는 순간에 해당 페이지를 방문하는 것이 아닙니다. 인덱스에서 결과를 읽는 것입니다. 이것이 서두의 예시가 발생한 이유입니다. 아주 최근에 게시되거나 업데이트된 페이지는 아직 반영되지 않았을 수 있습니다.
이러한 절충안은 의도된 것입니다. 실시간 페이지에는 에이전트를 조작하기 위해 작성된 지침이 포함될 수 있습니다. 인덱스는 그러한 노출을 줄여주지만, 문서는 위험을 제거하는 것이 아니라 낮추는 것이라고 주의 깊게 명시하고 있습니다.
네 가지 검색 모드
Codex의 구성 참조에는 web_search 설정에 대한 네 가지 값이 나열되어 있습니다. 문서는 각 값을 다음과 같이 설명합니다:
- Cached는 기본값입니다. 웹 검색 캐시의 결과를 제공합니다.
- Indexed는 검색 인덱스가 요청을 게이트할 때만 외부 웹 액세스를 허용합니다.
- Live는 웹에서 가장 최신 데이터를 가져옵니다. 문서는 이것이
--search플래그와 동일하다고 설명합니다. - Disabled는 웹 검색 도구를 끕니다.
기본 설정에는 한 가지 예외가 있습니다. 문서에 따르면: "Codex가 전체 액세스 권한으로 실행될 때, 웹 검색은 기본적으로 실시간(live) 결과로 설정됩니다." 따라서 전체 액세스 권한으로 Codex를 실행 중이라면 별도의 설정 없이도 이미 실시간 결과를 받고 있을 수 있습니다.
캐시된 결과로 충분한 경우
많은 일상적인 작업에는 인덱스로도 충분합니다:
- 잘 확립된 라이브러리 함수의 작동 방식 조회.
- 자주 변경되지 않는 문서 페이지 찾기.
- 설계 결정을 위한 배경 조사.
- 한동안 다루어져 온 접근 방식 비교.
이러한 경우 인덱스에 필요한 정보가 있을 가능성이 높으며, 실시간 콘텐츠에 대한 노출을 낮게 유지할 수 있습니다.
실시간 결과로 전환해야 할 때
문서의 지침은 간결합니다: "작업이 최신 정보에 의존할 때 실시간 검색을 사용하십시오."
이는 다음과 같은 작업들을 포함합니다:
- 오늘 게시된 릴리스 확인.
- 상태 페이지나 장애 보고서의 현재 상태 읽기.
- 자주 업데이트되는 변경 로그(changelog) 조회.
- 수정 사항이나 지원 중단(deprecation)이 반영되었는지 확인.
단일 실행의 경우 CLI 플래그가 있습니다. 문서에 따르면: "CLI에서 한 번의 실행에 대해 실시간 결과를 가져오려면 --search를 전달하십시오." 이렇게 하면 기본 설정은 변경되지 않습니다.
영구적인 변경을 원하면 구성 파일에서 모드를 설정하십시오. 문서에 따르면 config.toml에서 web_search 값을 live로 설정하거나, 도구를 끄려면 disabled로 설정하라고 되어 있습니다.
모드 변경 방법
설정은 Codex 구성 파일에 들어갑니다. Codex 구성 문서는 우선순위가 높은 순서대로 값이 결정되는 순서를 나열합니다:
- CLI 플래그 및
--config재정의. - 신뢰할 수 있는 프로젝트에 한해, 작업 디렉토리에 가장 가까운
.codex/config.toml프로젝트 구성 파일. --profile로 선택된 프로필 파일.~/.codex/config.toml에 있는 사용자 구성.- 워크스페이스에 제공된 클라우드 관리 기본값.
- 시스템 구성(있는 경우).
- 내장 기본값.
따라서 프로젝트별로 자체 검색 모드를 설정할 수 있고, 프로필을 통해 특정 작업 유형에 대해 모드를 전환할 수 있으며, 단일 명령으로 두 설정을 모두 재정의할 수 있습니다. 프로젝트가 신뢰할 수 없는 것으로 표시된 경우, 문서는 Codex가 프로젝트 로컬 구성을 포함한 프로젝트 범위의 .codex/ 레이어를 건너뛴다고 명시합니다.
Codex를 오랫동안 사용해 왔다면 이전 설정을 확인해 보십시오. 구성 참조에는 [features] 아래의 web_search_cached 및 web_search_request와 같은 레거시 토글이 더 이상 사용되지 않음(deprecated)으로 나열되어 있습니다. 최상위 web_search 설정이 지정되지 않은 경우 이러한 설정이 여전히 캐시 또는 실시간으로 매핑되지만, web_search를 직접 설정하는 것이 모드를 명확하게 만듭니다.
웹 검색이 따르지 않는 네트워크 규칙
이것은 제목에 언급된 세부 사항이며, Codex에 대한 네트워크 제한을 구성한 경우 중요합니다.
문서에 따르면: "웹 검색은 샌드박스 처리된 로컬 명령 네트워킹과 분리된 호스팅 도구입니다. 권한 프로필의 네트워크 프록시나 도메인 허용 목록을 사용하지 않으며, 명령 네트워크 액세스가 비활성화된 경우에도 계속 사용할 수 있습니다."
즉, 두 개의 별개 시스템이 존재합니다:
- 명령 네트워킹(Command networking): 패키지 설치나
curl과 같이 Codex가 실행하는 명령이 네트워크에 도달할 수 있는지, 어떤 프록시를 통하는지, 어떤 도메인으로 가는지 결정하는 샌드박스 규칙입니다. - 웹 검색(Web search): 자체 설정을 가진 호스팅 도구입니다.
명령에 대한 네트워크 액세스를 차단해도 웹 검색은 차단되지 않습니다. 명령에 대한 도메인 허용 목록은 검색이 반환할 수 있는 사이트를 제한하지 않습니다.
웹 검색은 자체 도메인 필터를 가지고 있습니다. 구성 참조는 "검색 컨텍스트 크기, 허용된 검색 도메인 및 대략적인 사용자 위치를 설정할 수 있는" tools.web_search 객체 형태를 설명합니다. 또한 이러한 필터는 "샌드박스 명령 네트워크 도메인 규칙과 분리되어 있으며 커넥터나 MCP 서버를 제한하지 않는다"고 덧붙입니다.
웹 검색 페이지에서도 반대 입장에서 동일하게 설명합니다: "검색 도메인 필터는 로컬 명령 트래픽, 앱, 커넥터 또는 MCP 서버를 제한하지 않습니다."
두 가지를 모두 제한하려면 두 설정이 모두 필요합니다. Codex가 샌드박스 외부에서 실행할 수 있는 명령을 결정하는 방식은 Codex 규칙 가이드에서 다루었습니다.
관리자가 검색 모드를 제한하는 방법
관리형 환경의 경우, OpenAI 문서는 allowed_web_search_modes라는 요구 사항을 언급합니다. 구성 참조는 이를 web_search에 허용되는 값으로 설명하며 다음과 같이 덧붙입니다: "disabled는 항상 허용됩니다. 빈 목록은 사실상 disabled만 허용하는 것과 같습니다."
따라서 조직은 예를 들어 캐시 및 비활성화는 허용하되 실시간은 허용하지 않을 수 있습니다. 문서는 명령 네트워크 정책을 allowed_web_search_modes, 승인된 MCP 서버, 그리고 앱, 플러그인, 브라우저 또는 Computer Use에 대한 기능 요구 사항과 결합할 것을 권장합니다.
웹용 ChatGPT의 경우, 문서에는 "워크스페이스 설정에서 검색 사용 가능 여부를 제한할 수 있습니다"라고 명시되어 있습니다.
웹 검색이 Codex memory와 상호작용하는 방식
Codex는 이전 채팅의 유용한 컨텍스트를 로컬 memory로 전환할 수 있습니다. 구성 참조에는 memory와 검색을 연결하는 설정이 포함되어 있습니다.
memory 문서는 memories.disable_on_external_context를 다음과 같이 설명합니다: "true일 경우, MCP 도구 호출, 웹 검색 또는 도구 검색과 같은 외부 컨텍스트를 사용한 채팅을 memory 생성에서 제외합니다." 구성 참조에 따르면 이 값의 기본값은 false입니다.
따라서 기본적으로 웹 검색을 사용한 채팅도 다른 적격한 채팅과 마찬가지로 memory 생성에 기여할 수 있습니다. 외부 콘텐츠를 가져온 채팅이 Codex가 기억하는 내용에 영향을 주지 않도록 하려면 이 옵션을 true로 설정하십시오. 문서에는 이전 키 이름인 memories.no_memories_if_mcp_or_web_search도 여전히 별칭으로 허용된다고 명시되어 있습니다.
이는 검색 결과가 신뢰할 수 없는 입력일 때 더 중요해집니다. 웹 페이지를 읽은 채팅은 그 내용의 일부가 프로젝트 외부에서 온 채팅이기 때문입니다.
프롬프트 주입에 관한 참고 사항
구성 문서는 검색 섹션의 끝에서 다음과 같은 주의 사항을 전달합니다: "Codex에서 네트워크 액세스나 웹 검색을 활성화할 때는 주의하십시오. 프롬프트 주입으로 인해 에이전트가 신뢰할 수 없는 지침을 가져오고 따르게 될 수 있습니다."
캐시 모드가 기본값인 이유는 이러한 노출을 줄여주기 때문입니다. 실시간 모드는 최신성이 더 중요할 때 사용됩니다. 어떤 모드도 웹 콘텐츠를 신뢰할 수 있게 만들어주지는 않으므로, Codex가 결과를 가지고 무엇을 하는지, 특히 결과를 바탕으로 명령을 실행하기 전에 반드시 검토하십시오.
사람들이 처음에 시도하는 것들
검색 결과가 오늘의 변경 사항을 반영할 것이라고 기대함. 로컬 채팅은 기본적으로 캐시된 인덱스를 사용합니다.
검색을 중단하기 위해 명령 네트워크 액세스를 차단함. 웹 검색은 별개이며 계속 사용 가능할 수 있습니다.
검색을 제한하기 위해 명령 도메인 허용 목록을 사용함. 검색은 tools.web_search에 자체 도메인 필터가 있습니다.
오래된 기능 토글을 그대로 둠. 대신 최상위 web_search 값을 설정하십시오.
검색이 memory에 영향을 주지 않을 것이라고 가정함. 기본적으로 웹 검색을 사용한 채팅도 memory 생성에 기여할 수 있습니다.
해결책: 작업별로 검색 모드 선택하기
1단계: 캐시를 기본값으로 유지
배경 조사 및 안정적인 문서 확인에는 인덱스를 사용하십시오.
2단계: 시간에 민감한 확인에는 실시간 사용
단일 실행에는 --search를 전달하거나, 해당 유형의 작업에 사용하는 프로필에서 live를 설정하십시오.
3단계: 검색 제한과 네트워크 제한을 별도로 설정
검색 도메인에는 tools.web_search를 사용하고, 명령 트래픽에는 샌드박스 설정을 사용하십시오.
4단계: 확인된 내용 기록
실시간 검색으로 버전, 수정 사항 또는 지원 중단을 확인했다면 결과와 날짜를 기록해 두십시오.
MemoryLake에서 설정하기
웹 검색은 특정 시점의 질문에 답해줍니다. 어떤 버전에서 수정 사항이 도입되었는지, 어떤 API가 지원 중단되었는지, 팀이 어떤 종속성 소스를 신뢰하는지 등 검색을 통해 배운 내용은 검색이 끝난 후에도 오랫동안 유용한 프로젝트 컨텍스트가 됩니다.
MemoryLake는 확인된 사실, 결정 사항 및 그 이면의 소스와 같은 프로젝트 컨텍스트를 위한 memory 레이어입니다. 이 모든 정보를 당신이 관리하는 한 곳에 보관하고 ChatGPT, Claude Code, Codex 등 연결된 어시스턴트가 사용할 수 있도록 합니다.
항목은 당신이 직접 자신의 언어로 작성합니다. Codex 채팅, 검색 결과, config.toml, Codex memory 또는 어떤 벤더의 저장소에서도 내용을 읽거나 쓰거나 삭제하지 않습니다. Codex 웹 검색은 OpenAI가 설명하는 방식 그대로 작동합니다.
1단계: API 키 생성
로그인 후 대시보드에서 키를 생성합니다. 다른 자격 증명과 마찬가지로 리포지토리 외부에 저장하십시오.

2단계: 첫 번째 memory 업로드
해결책의 4단계에서 작성한 내용, 즉 확인된 사실과 시점부터 시작하십시오. 항목당 하나의 사실과 출처를 포함합니다.

3단계: AI 및 에이전트 연결
Codex, Claude Code 및 사용하는 다른 어시스턴트를 연결합니다. 각 어시스턴트는 다시 검색할 필요 없이 동일하게 확인된 사실을 활용할 수 있습니다.

실제적인 변화
첫 번째 차이점은 반복적인 검색이 줄어든다는 것입니다. 한 번 확인한 사실은 다음번에도 바로 사용할 수 있습니다.
두 번째는 명확한 출처입니다. 각 항목은 사실이 어디서 언제 왔는지 알려줍니다.
세 번째는 도구 간의 일관성입니다. Codex와 다른 어시스턴트에서 동일하게 확인된 사실을 공유합니다.
Codex 웹 검색 모범 사례
캐시를 기본값으로 유지하십시오. 실시간 콘텐츠에 대한 노출을 줄여줍니다.
일회성 최신 정보 확인에는 --search를 사용하십시오. 기본 설정은 변경되지 않습니다.
반복적인 실시간 작업에는 프로필을 사용하십시오. 해당되는 곳에 모드를 설정하십시오.
검색 도메인을 별도로 제한하십시오. 명령 네트워크 규칙은 검색에 적용되지 않습니다.
레거시 토글을 확인하십시오. 최상위 web_search 설정을 사용하는 것이 좋습니다.
memory 생성 여부를 결정하십시오. 검색된 채팅을 제외하려면 memories.disable_on_external_context를 사용하십시오.
결과를 신뢰할 수 없는 것으로 취급하십시오. 결과를 바탕으로 행동하기 전에 검토하십시오.
결론
Codex 웹 검색은 로컬 채팅에서 기본적으로 OpenAI가 유지 관리하는 캐시된 인덱스를 사용합니다. 이는 프롬프트 주입 노출을 낮추지만 아주 최근의 페이지는 반영되지 않을 수 있음을 의미합니다. config.toml의 web_search 또는 일회성 --search 플래그로 설정하는 실시간 모드는 최신 데이터를 가져오며, 전체 액세스 세션은 기본적으로 실시간으로 설정됩니다.
웹 검색은 샌드박스의 명령 네트워킹과 분리된 호스팅 도구이므로 네트워크 프록시나 명령 도메인 허용 목록을 사용하지 않으며, 명령 네트워크 액세스가 꺼져 있어도 사용 가능할 수 있습니다. 자체 도메인 필터가 있고 관리자가 허용 모드를 제한할 수 있으며, 기본적으로 검색을 사용한 채팅도 memories.disable_on_external_context를 true로 설정하지 않는 한 memory 생성에 기여할 수 있습니다.