Codex CLI 웹 검색 시작 방법: --search로 최신 문서 처음 확인하는 법

TL;DR

핵심 3줄 요약

이 글에서 다룰 내용

Codex CLI 웹 검색은 무엇이고 언제 쓰면 좋은가

Codex CLI 웹 검색은 현재 실행에서 최신 웹 정보를 찾도록 검색 모드를 바꾸는 기능입니다. OpenAI 공식 명령어 문서는 --search 를 live 웹 검색을 켜는 boolean 옵션으로 설명합니다. 이 옵션을 쓰지 않을 때의 기본값은 cached 입니다.

공식 CLI 개요는 현재 릴리스, 문서, 외부 동작에 의존하는 작업을 적합한 예로 듭니다. 방금 바뀐 SDK 옵션, 최신 릴리스 노트, 현재 지원되는 명령을 확인할 때 유용합니다. 이미 알고 있는 저장소 코드만 살피는 작업이라면 반드시 live 검색으로 시작할 필요는 없습니다.

검색 활동은 transcript에 표시됩니다. 무엇을 검색했는지 확인할 수 있다는 뜻이지 검색 결과가 자동으로 검증됐다는 뜻은 아닙니다. 최종 판단에는 원문 대조가 필요합니다.

시작 전에 확인할 조건과 기능 경계

공식 명령어 문서에서 --search 는 Codex의 전역 옵션으로 제시되고 선택적인 첫 PROMPT 를 함께 받을 수 있습니다. 따라서 TUI를 먼저 연 뒤 질문해도 되고 codex --search "질문" 처럼 시작 질문을 한 번에 전달해도 됩니다.

이번 공식 출처에는 --search 의 플랜, 지역, 언어, 계정별 제공 조건이 따로 적혀 있지 않습니다. 옵션이 보이지 않거나 현재 환경의 동작이 문서와 다르면 설치된 CLI의 codex --help 와 최신 공식 명령어 문서를 확인하세요. 확인되지 않은 제공 조건을 추정하지 않습니다.

웹 검색 모드와 실행 권한은 구분해야 합니다. 같은 명령어 문서에서 sandbox와 approval 옵션은 별도 항목으로 설명됩니다. --search 를 켰다고 임의의 셸 네트워크 접근, 파일 수정, 패키지 설치까지 허용되는 것은 아닙니다. Codex 클라우드 환경의 도메인 allowlist 설정과도 다른 기능입니다.

--search로 최신 공식 문서를 처음 확인하는 순서

1. 현재 CLI에서 옵션을 확인합니다

터미널에서 codex --help 를 실행하고 --search 항목이 보이는지 확인합니다. 공식 레퍼런스의 현재 설명은 live 웹 검색을 켜고 web_search = "live" 로 설정한다고 명시합니다.

옵션이 없다면 원인을 단정하지 마세요. 설치된 실행 파일과 공식 문서가 일치하는지 확인한 뒤 조직의 설치·업데이트 절차에 따라 사람이 다음 행동을 정합니다.

2. 최신성이 필요한 질문 한 개를 정합니다

첫 실습은 범위를 좁게 잡습니다. 예를 들어 특정 SDK의 현재 옵션이나 최근 릴리스 문서처럼 공식 원문 한두 건으로 확인 가능한 질문이 적합합니다.

질문에는 제품명, 확인할 기능, 기준 날짜, 허용 출처, 원하는 출력 형식을 넣습니다. 커뮤니티 추측과 날짜 없는 재작성 글을 제외하도록 적으면 검토 범위가 줄어듭니다.

3. --search와 첫 프롬프트를 함께 실행합니다

다음처럼 Codex CLI를 시작합니다.

codex --search "OpenAI 공식 문서에서 현재 Codex CLI의 웹 검색 옵션을 확인하고, 문서 제목·URL·확인 날짜·미확인 항목을 정리해줘"

첫 프롬프트는 선택 사항입니다. 질문을 생략하고 codex --search 로 TUI를 연 뒤 같은 요청을 입력해도 됩니다.

4. transcript에서 검색 활동을 확인합니다

공식 CLI 개요에 따르면 검색 활동은 transcript에 남습니다. 답변만 읽지 말고 실제로 검색이 수행됐는지, 어떤 문서를 근거로 삼았는지 확인합니다.

검색 활동이 보이지 않거나 근거가 불분명하면 사실을 확정하지 않습니다. 공식 출처 URL, 문서 제목, 확인 가능한 날짜를 다시 요청하고 답변의 미확인 항목을 분리합니다.

5. 공식 원문을 직접 열어 대조합니다

제시된 URL을 직접 열고 옵션명, 기본값, 적용 범위를 원문과 비교합니다. 이번 기능이라면 --search , live , 기본 cached , transcript 표시가 실제 문서에 있는지 확인합니다.

요약과 원문이 다르면 원문을 우선합니다. 페이지에 없는 플랜, 지역, 성능 수치, 보안 보장을 답변이 덧붙였다면 미확인으로 표시하고 결과에서 제외합니다.

6. 변경은 별도 승인으로 분리합니다

웹 검색의 완료 기준은 검증 메모까지입니다. 패키지 설치, 설정 파일 변경, 명령 실행, 커밋을 자동 완료 조건에 넣지 않습니다.

조사 결과를 사람이 읽고 적용 버전과 영향 범위를 확인한 뒤 변경을 승인합니다. 변경 후에는 diff와 테스트 결과를 다시 검토합니다.

그대로 복사해 쓸 프롬프트

이 프롬프트의 산출물은 변경안이 아니라 검증 메모입니다. 검색 결과와 공식 원문을 먼저 맞춘 뒤 실제 작업 범위를 정합니다.

실전 활용 팁

주의할 점

자주 묻는 질문

출처

마무리

Codex CLI에서 최신 문서를 확인하려면 codex --search "질문" 으로 시작합니다. 이 옵션은 기본 cached 검색을 live 로 바꾸고 검색 활동을 transcript에 남깁니다.

공식 URL과 원문을 대조해 확인된 사실과 미확인 항목을 나누세요. 코드와 설정 변경은 그 검증 메모를 사람이 승인한 뒤 별도 단계로 진행해야 안전한 기능 시작 흐름이 완성됩니다.