Codex CLI v0.139의 웹 검색과 MCP 스키마 통합 구조

검색과 코딩 사이의 경계가 사라졌다

OpenAI는 2026년 6월 9일 Codex CLI v0.139을 릴리스했다. 이번 버전에서 눈에 띄는 변화는 코드 모드가 중첩 JavaScript 도구 호출을 포함한 웹 검색을 직접 다룬다는 점이다. MCP(Model Context Protocol) 입력 스키마에서는 oneOf와 allOf를 보존하도록 파서가 확장됐고, codex doctor의 환경 진단 범위도 넓어졌다.

이 변화들은 별개의 편의 기능처럼 보이지만 방향은 같다. 검색, 코드 실행, 외부 도구 호출, 환경 진단을 하나의 에이전트 실행 흐름 안에서 연결하려는 설계다.

코드 모드가 웹 검색을 직접 맡는다

기존 구조에서는 코드 실행과 웹 검색을 분리된 에이전트 레이어에서 처리해야 했다. v0.139의 코드 모드는 외부 HTTP 요청 없이 웹 검색을 직접 호출하며, 검색 결과를 플레인텍스트로 받아 후속 파이프라인에 전달한다.

중첩 JavaScript 도구 호출도 이 경로에 포함된다. 검색으로 얻은 정보를 같은 실행 컨텍스트에서 코드 생성과 수정에 사용할 수 있어 검색-코딩 결합 워크플로우가 단일 루프 안에서 끝난다.

⤢✕

이 구조에서 검색 결과는 곧바로 코드 컨텍스트로 넘어간다. 에이전트는 외부 문서나 API 레퍼런스를 찾고, 구현하고, 검증하는 순환을 이어갈 수 있다. 검색 채널은 네트워크 샌드박스 정책과 독립적으로 동작하며, 검색 결과를 캐싱하지 않고 실시간 최신 정보를 반영한다.

MCP 스키마의 의미를 호출 단계까지 보존한다

MCP 도구 입력은 단순한 필드 목록만으로 표현되지 않는다. 여러 입력 형식 가운데 하나를 선택하거나 복수 조건을 함께 만족해야 하는 스키마에서는 JSON Schema의 컴포지션 키워드가 필요하다.

oneOf는 정확히 하나의 서브스키마와 일치하는 유니온 타입을 표현하고, allOf는 모든 서브스키마를 동시에 만족하는 교차 타입을 나타낸다. v0.139은 기존 anyOf 처리 경로와 같은 방식으로 두 키워드를 파싱하며, 대형 스키마를 컴팩션할 때도 얕은 구조를 최대한 보존한다.

⤢✕

핵심은 스키마 정규화 과정에서 컴포지션 구조를 잃지 않는 것이다. 복잡한 유니온 타입과 교차 타입이 원래 의미대로 도구 호출 페이로드에 전달되므로, 서드파티 커넥터나 MCP 도구가 스키마 손실 때문에 오작동할 가능성을 줄인다. GitHub, Figma, Sentry처럼 복잡한 커넥터 스키마와의 호환성도 이 지점에 걸려 있다.

JSON Schema Draft 7 이상의 oneOf·allOf·anyOf를 완전 지원하면 OpenAPI 기반 커넥터 스키마를 변환할 때 의미론적 손실을 최소화할 수 있다. GitHub MCP Server와 Figma MCP 등 MCP 서버 구현체의 입력 계약을 Codex 내부 스키마까지 유지하는 기반이기도 하다.

진단 리포트가 실행 환경을 더 넓게 본다

codex doctor는 로컬 설치, 설정, 인증, 런타임, Git, 터미널, 앱서버, 스레드 인벤토리를 진단한다. v0.139에서는 에디터와 페이저 환경 정보가 로컬 리포트에 추가됐다.

JSON 출력에는 민감한 원시값을 자동으로 리댁션하는 처리도 들어갔다. 표준화된 진단 결과를 모니터링 시스템과 연결하면서 원시 환경값의 노출을 줄일 수 있다. CI 환경과 로컬 개발 환경 사이의 불일치를 찾거나 팀의 에디터·페이저 환경을 맞출 때도 활용할 수 있으며, 환경 차이 때문에 발생하는 디버깅 시간을 줄이는 데 초점이 맞춰져 있다.

플러그인 상태를 자동화 파이프라인에서 읽는다

codex plugin marketplace list --json은 이제 마켓플레이스 소스 정보를 함께 반환한다. 캐시된 리모트 카탈로그에서 결과를 즉시 내보낸 뒤 백그라운드에서 갱신하는 방식이다.

JSON에는 pluginId, name, marketplaceName, version, installed, enabled, source, installPolicy, authPolicy, marketplaceSource가 포함된다.

⤢✕

CI/CD 파이프라인은 이 출력을 이용해 플러그인의 설치 여부와 활성화 상태를 프로그래매틱하게 점검할 수 있다. installPolicy와 authPolicy는 플러그인 보안 정책을 선언적으로 관리하는 데 쓰인다. 마켓플레이스 출처까지 함께 노출되므로 자동화된 상태 점검의 신뢰성도 높아진다.

명령 인수 처리와 관련된 수정도 포함됐다. codex resume --last "..."와 codex fork --last "..."에서 후행 인수를 세션 ID가 아니라 초기 프롬프트로 올바르게 처리한다.

Codex를 외부 에이전트의 워커로 연결한다

Codex는 MCP 서버를 통해 외부 서비스를 에이전트 도구로 받아들인다. 반대로 Codex CLI 자체를 MCP 서버로 노출해 Agents SDK에서 오케스트레이션할 수도 있다.

이때 codex() 도구는 새 대화를 시작하고, codex-reply() 도구는 기존 대화를 이어간다. 멀티 에이전트 파이프라인에서는 Codex를 워커 에이전트로 배치할 수 있다. 오케스트레이터-워커 패턴에 따라 병렬 에이전트를 최대 8개까지 동시에 실행하는 구조와 연결된다.

이 상호운용 모델은 JSON-RPC 2.0 기반 MCP를 도구 통합 계층으로 삼고, JSON Schema Draft 7+의 컴포지션 키워드로 유연한 입력 타입을 정의한다. 에이전트 내부에서는 ReAct(Reasoning+Acting) 패턴에 따른 도구 호출 루프가 검색, 파일 시스템 접근, 셸 실행을 이어 붙인다.

생태계 규모와 기반 모델

Codex CLI의 공개 지표는 다음과 같다.

지표	수치	기준 시점
주간 활성 개발자	400만+	2026년 4월
GitHub 스타	82,900+	2026년 6월
릴리스 횟수	789+	2026년 6월
라이선스	Apache-2.0	-

기반 모델은 2026년 4월 23일 출시된 GPT-5.5다. 에이전틱 작업에 특화해 재훈련됐으며 멀티 에이전트 워크플로우에 맞춰 최적화됐다.

Claude Code·Gemini CLI와 갈리는 지점

세 도구의 역량 비교는 오픈소스 여부, 터미널 최적화, 추론 깊이, 컨텍스트 길이, 멀티 에이전트, MCP 지원을 기준으로 볼 수 있다.

⤢✕

구현과 통합 방식을 나란히 놓으면 차이가 더 분명하다.

특성	Codex CLI	Claude Code	Gemini CLI
오픈소스	Apache-2.0	비공개	비공개
기반 구현	Rust 네이티브	Node.js	Go
컨텍스트 관리	샌드박스 독립	CLAUDE.md 지속	장문 컨텍스트
MCP 지원	완전 (oneOf/allOf)	지원	제한적
웹 검색 통합	코드 모드 내장	별도 도구	Grounding API
SWE-bench	77.3% (터미널)	80.8% (Opus 4.6)	미공개

Codex CLI의 차별점은 기술 표준 준수와 개방형 생태계에 놓여 있다. Apache-2.0 라이선스, MCP 컴포지션 스키마 지원, 코드 모드 웹 검색, 플러그인 마켓플레이스가 같은 방향을 가리킨다.

2026년의 흐름도 이 축을 따른다. 코딩 에이전트의 도구 통합은 MCP 생태계를 중심으로 수렴하고, 검색-코딩-검증을 단일 에이전트 루프에서 끝내는 방향으로 나아간다. 플러그인 마켓플레이스를 통한 서드파티 확장과 Agents SDK를 이용한 멀티 에이전트 오케스트레이션도 더 깊게 연결될 전망이다.

Codex CLI v0.139은 웹 검색 기능 하나를 추가한 릴리스라기보다 도구 호출 경계를 다시 정리한 버전으로 볼 수 있다. 코드 모드가 검색까지 맡고, MCP 입력 계약을 손실 없이 전달하며, 진단과 플러그인 상태를 자동화 가능한 형태로 내보낸다. 주간 활성 개발자 400만+ 규모의 오픈소스 도구가 이 구조를 채택했다는 점에서, 엔터프라이즈 AI 개발 도구를 설계할 때 참고할 수 있는 에이전트 상호운용 사례가 된다.