codex exec 웹 검색 켜기, --search 는 exec 앞에 써야 했다

2026.10.09 · 밥

지난 글에서 모델이 막혀서 gpt-5.6-terra 로 갈아탔다. 근데 내가 맡기려던 건 블로그 주제 조사였고, 조사는 웹 검색이 없으면 의미가 없다. 그래서 codex exec 에 웹 검색을 켜는 데서 한 번 더 헤맸다.

codex exec 에서 웹 검색을 켜려면 --search 를 exec 앞에 붙인다. codex --search exec ... 이렇게. exec 뒤에 붙이면 시작도 못 하고 오류로 끝난다. 내가 쓰는 codex-cli 0.162.0-alpha.2 기준이다.

codex exec --search 는 왜 안 될까

오늘 일부러 순서를 바꿔서 다시 돌려 봤다. 결과는 이렇다.

unexpected argument '--search' found. 모델을 부르기도 전에 인자 단계에서 막히니까 사용량은 안 든다. 그나마 다행.

이유는 도움말을 보면 바로 나온다. codex --help 에는 --search 가 있는데 codex exec --help 에는 아예 없다. --search 는 codex 본체 옵션이라는 거다.

헷갈린 데는 이유가 있었다. Codex 명령어 문서에도 --search 는 전역 옵션 표에만 있고 exec 표에는 없다. 근데 같은 문서에 전역 옵션은 대부분 하위 명령에도 넘어간다고 적혀 있고, codex exec --oss 처럼 뒤에 붙이는 예시까지 있다. 그걸 보고 --search 도 되겠지 했는데 내 버전에선 안 넘어갔다.

웹 검색 켠 codex exec 명령

조사 작업에 실제로 쓴 명령은 이거다.

codex --search exec -m gpt-5.6-terra -c model_reasoning_effort="xhigh" -

맨 끝 - 는 프롬프트를 표준 입력에서 읽으라는 뜻이다. 조사 지시문이 길어서 파일로 써 두고 넘겼다. PowerShell 명령줄에 긴 한글 문장을 따옴표로 넣는 것보다는 덜 꼬일 것 같아서.

문서를 보면 웹 검색은 원래 캐시된 결과만 쓰는 모드가 기본이고, --search 를 붙여야 실시간 검색으로 바뀐다. 설정으로 치면 web_search = "live" 랑 같다고 한다.

켜졌는지는 실행 기록에서 보인다. 짧게 하나 돌려 봤더니 중간에 web search: 줄이 네 번 찍히고, 그다음에 답이 나왔다. 질문은 GitHub 에 올라온 codex CLI 최신 버전이 뭐냐는 거였고, 답은 0.162.0 이랑 릴리스 페이지 주소였다.

두 번 돌려 본 시간과 토큰

본 작업은 추론 xhigh 에 웹 검색을 켜고 두 번 돌렸다.

2차는 새 세션으로 돌려서 1차 답을 입력에 통째로 붙여 넣었다. 입력이 꽤 길었는데도 토큰은 1차보다 적게 나왔다. 새로 찾아볼 게 적어서였을 거다.

의외였던 건 마지막 줄이다. 버전 하나 물어본 건데 2만 6천 토큰. 웹 검색을 켜면 검색 결과가 통째로 들어가니까 짧은 질문도 이 정도는 각오해야 하는 것 같다. 이건 추측이다.

솔직히 이게 ChatGPT 요금제 사용량에서 몇 퍼센트였는지는 확인 못 했다. CLI 가 알려 주는 건 토큰 수뿐이라서.

결과 파일 맨 위에 적어 둔 것

조사 답은 파일로 받아서 맨 위에 모델 이름, 추론 단계, 웹 검색 켰는지, 실행 시각, 토큰 수를 한 줄로 적어 뒀다. 하루만 지나도 이게 sol 이 낸 답인지 terra 가 낸 답인지 헷갈린다. 특히 이번처럼 모델이 막혀서 중간에 바꾼 날은 더 그렇다.

두 번 돌린 보람은 있었다. 2차 검토에서 코덱스가 정리본에서 고쳐야 할 곳을 9군데 짚었다. 다음엔 git commit 하다가 Filename too long 에 걸린 얘기를 하고, 그 9군데는 따로 한 편으로 쓰려고 한다.