Codex 2026년 5월 업데이트: 퍼시스턴트 Goal 워크플로우와 MultiAgentV2 병렬 에이전트 아키텍처
Codex CLI의 /goal 퍼시스턴트 워크플로우, 플러그인 마켓플레이스, MultiAgentV2 병렬 에이전트 실행 모델을 Claude Code 서브에이전트와 비교해 아키텍처 관점에서 정리한다
2026-08-15 · 최초 발행 2026-05-03
2026년 5월 Codex CLI 업데이트는 단순한 기능 추가를 넘어 AI 코딩 에이전트의 운영 패러다임을 전환하는 대규모 릴리스다. 앱 서버 API와 연동되는 /goal 퍼시스턴트 워크플로우, 마켓플레이스 설치·원격 번들 캐시·원격 제거를 지원하는 플러그인 시스템, 샌드박스 CLI 프로파일 선택 기능이 동시에 추가됐다. 특히 MultiAgentV2의 스레드 캡·대기 시간 제어·서브에이전트 힌트 기능 강화는 복잡한 병렬 코딩 워크플로우를 실용적인 수준으로 끌어올렸다.
세션이 끝나도 목표는 남는다: /goal 워크플로우
기존 Codex CLI 세션은 stateless에 가까웠다. 세션이 종료되면 작업 컨텍스트가 사라지고, 다음 세션에서 처음부터 다시 시작해야 했다. /goal 명령어는 이 한계를 근본적으로 해결한다.
/goal은 앱 서버 API와 연동해 워크플로우 상태를 영속화한다. 사용자가 /goal "인증 모듈 TDD로 구현" 같은 명령을 입력하면 서버에 목표가 등록되고, 이후 세션에서 동일한 goal ID로 재접속하면 이전 진행 상태, 완료된 서브태스크 목록, 에디터 컨텍스트가 그대로 복원된다.
TUI(Terminal User Interface) 컨트롤의 주요 액션은 Create·Pause·Resume·Clear다. Create는 새 goal을 등록하고 서버에 저장한다. Pause는 진행 중인 에이전트 실행을 안전하게 중단하고 현재 상태를 스냅샷으로 저장한다. Resume은 저장된 스냅샷에서 이어서 실행한다. Clear는 goal을 완료 처리하고 관련 리소스를 정리한다.
/goal 워크플로우 내에서 에이전트는 model tools를 통해 파일 시스템 접근, 셸 명령 실행, 외부 API 호출 등을 수행한다. 각 도구 호출 결과는 goal 상태에 연결되어 중단 후 재개 시 이전 도구 결과를 재활용한다. 불필요한 중복 API 호출을 방지하는 캐싱 효과다. goal ID는 팀원 간 공유도 가능하다. 동일 goal ID로 접속하면 현재 진행 상태와 에이전트가 생성한 코드, 결정 근거를 함께 볼 수 있다. 비동기 협업의 기반이 되는 기능으로, 시간대가 다른 분산 팀에서 에이전트 워크플로우를 넘겨받는 핸드오프 시나리오에 특히 유용하다.
로컬 설치에서 마켓플레이스 생태계로
이번 업데이트의 또 다른 핵심은 플러그인 생태계의 성숙이다. 단순한 로컬 플러그인 설치에서 벗어나 마켓플레이스 기반의 원격 플러그인 관리 체계가 갖춰졌다.
원격 번들 캐시는 플러그인이 원격 레지스트리에 번들로 게시되고, 설치 시 로컬 캐시에 다운로드되며, 이후 동일 버전 재설치 시 네트워크 없이 캐시에서 즉시 설치되는 구조다. 기업 내부 네트워크 환경에서 플러그인 배포 속도를 크게 향상시킨다. 플러그인 소스는 공개 마켓플레이스뿐 아니라 크로스 레포지토리 소스, 로컬 마켓플레이스도 지원한다. 기업은 내부 전용 마켓플레이스를 운영하며 검증된 플러그인만 직원들이 설치할 수 있도록 제어할 수 있다.
플러그인은 훅을 통해 Codex 에이전트의 실행 파이프라인에 개입할 수 있다. 특정 파일 유형 변경 시 자동으로 테스트를 실행하거나, 코드 생성 후 린터를 호출하는 등의 자동화가 가능하다. 훅의 활성화 상태는 TUI에서 인라인 토글로 관리한다. 플러그인별 권한 프로파일을 정의할 수 있어, 파일 시스템 접근 범위·네트워크 허용 도메인·실행 가능한 셸 명령 목록을 플러그인마다 독립적으로 제한함으로써 서드파티 플러그인으로 인한 보안 위험을 최소화한다. 플러그인 관리 TUI도 탭 방식으로 개편되어 설치된 플러그인, 마켓플레이스 검색, 업데이트 가능 목록, 설정 페이지를 각 탭으로 분리했다.
MultiAgentV2: 병렬 실행을 세밀하게 제어하다
MultiAgentV2는 단일 Codex 세션에서 여러 에이전트를 병렬로 실행하는 아키텍처다. 이번 업데이트에서 설정 체계가 크게 개선됐다.
스레드 캡(Thread Cap)은 동시 실행 서브에이전트 수의 상한선을 설정해, 리소스 집약적인 태스크에서 과도한 병렬 실행으로 인한 시스템 부하를 방지한다. 프로젝트 규모와 호스트 머신 사양에 맞게 조정 가능하다. 대기 시간 제어(Wait-Time Controls)는 서브에이전트 결과를 기다리는 최대 시간을 설정한다. 지정 시간 초과 시 타임아웃 에이전트를 자동으로 종료하고 부분 결과로 진행할지, 전체 실패로 처리할지 정책을 정의할 수 있다.
서브에이전트는 /root/agent_a, /root/agent_b 같은 경로 기반 주소를 갖는다. 읽기 쉬운 주소 체계를 통해 에이전트 간 메시지 라우팅이 명확해지고, 로그에서 어떤 에이전트가 어떤 액션을 수행했는지 추적이 용이해진다. 에이전트 설정에서 루트 에이전트와 서브에이전트 역할을 명시적으로 힌트로 제공할 수도 있다. 루트 에이전트는 태스크 분해와 결과 집계 역할에 특화되고, 서브에이전트는 특정 도메인 태스크 실행에 집중한다. 각 서브에이전트는 독립적인 샌드박스 CLI 프로파일을 사용할 수 있다. 프로파일에는 허용 명령어 목록, 파일시스템 접근 범위, 환경 변수 세트가 포함된다. 권한 프로파일은 TUI 세션, 사용자 턴, MCP 샌드박스 상태, 셸 에스컬레이션, 앱 서버 API에 걸쳐 일관되게 유지된다.
Claude Code와의 결합도 차이
Codex MultiAgentV2와 Claude Code 서브에이전트는 유사한 목표를 서로 다른 설계 철학으로 구현한다.
Claude Code의 서브에이전트는 메인 에이전트가 Task 도구를 통해 독립적인 Claude 인스턴스를 생성하는 방식이다. 각 서브에이전트는 완전히 분리된 컨텍스트 윈도우를 갖는다. 메인 에이전트는 서브에이전트에 태스크를 위임하고 텍스트 결과만 받는다. 서브에이전트의 내부 추론 과정은 메인 컨텍스트에 영향을 주지 않으므로, 메인 컨텍스트 윈도우 소진 없이 복잡한 태스크를 처리할 수 있다. Codex MultiAgentV2는 경로 기반 에이전트 주소와 구조화된 에이전트 간 메시지를 통해 더 정교한 에이전트 상호작용을 지원한다. 에이전트 간 직접 통신이 가능하며, 루트 에이전트가 서브에이전트의 진행 상황을 실시간으로 모니터링할 수 있다.
설계 철학의 핵심 차이는 결합도다. Claude Code는 서브에이전트를 완전한 독립 인스턴스로 취급해 느슨한 결합을 유지한다. Codex MultiAgentV2는 에이전트 간 메시지 채널을 통해 더 긴밀한 협력을 가능하게 하되, 샌드박스 분리로 보안을 유지한다.
대규모 마이그레이션에서의 활용
이번 업데이트 기능들이 통합적으로 활용되는 대표 시나리오는 대규모 코드베이스 마이그레이션이다. 팀은 /goal "Node.js 14에서 Node.js 22로 마이그레이션" 명령으로 목표를 등록한다. 루트 에이전트가 코드베이스를 분석해 마이그레이션 서브태스크를 생성한다. MultiAgentV2로 각 모듈을 담당하는 서브에이전트들이 병렬로 실행된다. 린터·테스트 실행 플러그인이 각 변경 후 자동으로 검증을 수행한다. 팀원이 퇴근할 때 /goal pause로 중단하고, 다음 날 /goal resume으로 이어서 진행한다. 작업 기간 동안 여러 팀원이 동일 goal ID로 접속해 진행 상황을 공유한다.
2026년 5월 Codex CLI 업데이트는 AI 코딩 에이전트를 일시적 도구에서 지속적 협업 파트너로 전환하는 이정표다. /goal 퍼시스턴트 워크플로우는 에이전트 기반 개발의 비동기성을 실용적인 수준으로 구현했고, 마켓플레이스 기반 플러그인 시스템은 기업 맞춤형 에이전트 생태계 구축의 기반을 마련했다. MultiAgentV2의 세밀한 제어 옵션 추가는 복잡한 병렬 코딩 워크플로우의 신뢰성을 높인다. 이 발전들이 결합되면서, 단일 에이전트 세션으로는 불가능했던 장기·대규모 소프트웨어 프로젝트를 AI 에이전트 주도로 처리하는 시대가 가속화되고 있다.
Sources
- Changelog – Codex | OpenAI Developers
- Codex Updates by OpenAI - May 2026 - Releasebot
- Releases · openai/codex - GitHub
- Subagents – Codex | OpenAI Developers
- Features – Codex CLI | OpenAI Developers
- Running Multiple Codex Agent Instances: Parallel Orchestration Patterns
- Inside the Agent Harness: How Codex and Claude Code Actually Work
- Use Codex with the Agents SDK | OpenAI Developers