플랫폼으로서의 Codex: 오픈 소스 에이전트 하네스로 제품 만들기

대부분의 사람은 App, 명령줄 인터페이스, IDE 확장 프로그램을 통해 Codex를 접합니다. 이들은 Codex를 사용하는 대표적인 방법이지만, 같은 기반 시스템을 활용하는 방법은 이 밖에도 많습니다.

이 모든 환경을 구동하는 것이 오픈 소스 Codex 하네스입니다. 하네스는 모델이 컨텍스트를 수집하고, 추론을 통해 작업을 풀어 나가고, 도구를 사용하고, 설정된 범위 안에서 동작하며, 승인을 요청하고 작업을 이어 가도록 돕습니다.

덕분에 개발자가 만들 수 있는 소프트웨어의 범위도 넓어집니다. 모든 팀에 업무를 범용 코딩 어시스턴트로 옮기라고 할 필요 없이, 실제 업무에 맞춰 설계한 소프트웨어에 에이전트를 통합할 수 있습니다. 엔지니어링 워크플로우, 운영 대시보드, 보안 조사 도구, 고객 지원 콘솔, 특정 팀의 전문 업무를 위한 사내 애플리케이션이 그 예입니다.

재사용할 수 있는 에이전트 루프

유능한 에이전트를 만들려면 프롬프트를 보내고 모델 응답을 받는 것만으로는 부족합니다. 에이전트는 작업을 이해하고, 작업이 이어지는 동안 컨텍스트를 유지하며, 관련 정보를 살펴보고 도구를 호출할 수 있어야 합니다. 또한 진행 상황을 보여 주고, 실패에 대처하고, 필요할 때 사람에게 승인을 요청하며, 유용한 결과를 반환해야 합니다.

이런 작업을 뒷받침하는 실행 시스템이 하네스입니다.

하네스 설계에 따라 결과는 크게 달라질 수 있습니다. ARC-AGI-3에서는 이전 추론을 유지하고 컨텍스트 압축을 적용하자 GPT-5.6 Sol의 점수가 13.3%에서 38.3%로 올랐고, 출력 토큰 수는 6분의 1로 줄었습니다.

Codex 하네스는 대화 상태를 관리하고, 실행 과정을 스트리밍하고, 도구를 사용하며, 설정된 샌드박스 및 승인 정책을 적용하고, 여러 턴에 걸쳐 작업을 이어 가도록 설계했습니다. Codex app-server는 문서화된 클라이언트 프로토콜을 통해 이 기능을 제공합니다. 애플리케이션은 이 프로토콜로 스레드를 만들고, 턴을 시작하고, 이벤트를 수신하며, 승인 요청을 처리할 수 있습니다.

에이전트가 필요한 소프트웨어를 개발한다면 런타임을 새로 만들 필요 없이 Codex에서 시작해 애플리케이션이 직접 담당할 부분을 정할 수 있습니다.

개발자가 살펴보고 제품에 맞게 조정할 수 있는 오픈 소스 하네스

하네스가 오픈 소스이므로 애플리케이션과 모델 사이의 계층을 직접 살펴볼 수 있습니다. 이 계층의 동작을 이해하고 제품에 맞게 통합 방식을 조정할 수 있습니다.

개발자는 다음 요소를 직접 제어해 에이전트를 제품에 맞출 수 있습니다.

• 인터페이스. 모든 상호작용을 범용 채팅 창에서 처리할 필요 없이 팀이 이미 사용하는 대시보드, 편집기, 대기열, 지도, 레코드, 승인 플로우를 그대로 활용할 수 있습니다.

• 컨텍스트와 도구. 애플리케이션은 자체 MCP 서비스를 비롯해 특정 워크플로우에 필요한 시스템, 문서, 데이터, 작업을 에이전트에 제공할 수 있습니다.

• 운영 범위. 호스트 애플리케이션은 에이전트를 어디에서 실행할지, 어떤 파일과 도구에 접근하도록 할지, 어떤 작업에 승인을 요구할지 결정할 수 있습니다. 작업을 모니터링하는 방법과 결과를 원본 레코드 관리 시스템에 반영하는 방법도 정할 수 있습니다.

Codex CLI, app-server, 공식 Codex SDK는 오픈 소스 구성 요소로 공개되어 있습니다. 오픈 소스 구성 요소 가이드에서 사용 가능한 구성 요소와 각각의 위치를 확인할 수 있습니다.

오픈 소스로 공개된 범위는 하네스와 통합 인터페이스입니다. 모델 액세스와 관리형 서비스는 별도로 제공됩니다.

용도에 맞는 통합 계층 선택하기

Codex를 기반으로 개발할 때는 용도에 따라 통합 방식을 선택할 수 있습니다.

• 스크립트, CI 작업, 일회성 백그라운드 작업에서는 codex exec로 정해진 범위 안에서 에이전트 워크플로우를 실행하고 구조화된 출력값을 받을 수 있습니다.

• 애플리케이션 코드에서 Codex 작업을 시작하거나 재개하거나 실행 과정을 스트리밍해야 한다면, 공식 Codex SDK가 제공하는 인터페이스를 직접 호출할 수 있습니다.

직접 실행해 볼 수 있는 예제는 Codex SDK 문서에서 확인하세요.

에이전트가 제품 자체의 일부라면 Codex app-server를 사용하세요. 애플리케이션에서 로컬 Codex 프로세스에 연결해 대화를 유지하고, 이벤트를 스트리밍하고, 작업을 중단하고, 에이전트에 도구를 제공하며, 승인 요청에 응답할 수 있습니다. SDK는 코드로 자주 실행하는 워크플로우를 간소화하고, app-server는 제품 팀이 에이전트의 수명 주기와 사용자 경험을 직접 제어할 수 있게 합니다.

워크플로우에 맞춰 소프트웨어 설계하기

Codex App에 다른 로고를 붙여 재현하는 것보다 더 흥미로운 가능성은 특정 사용자나 팀이 이미 일하는 방식을 소프트웨어에 반영하는 데 있습니다.

보안 분석가에게는 조사 대기열, 최근 경보, 영향을 받은 서비스 목록, 조치 티켓을 만들기 전의 승인 단계가 필요할 수 있습니다. 지원 엔지니어에게는 계정 이력, 제품 로그, 내부 문서, 답변 초안이 필요할 수 있습니다. 제품 팀이라면 이슈를 준비 상태로 옮겼을 때 정해진 범위의 구현 워크플로우가 시작되는 작업 보드를 원할 수 있습니다.

각 사례에서 인터페이스는 사용자 경험의 중요한 부분입니다. 인터페이스는 사용자가 무엇을 보고 있는지 에이전트에 알려 주고 적절한 도구를 제공합니다. 사용자는 같은 화면에서 다음에 수행할 작업을 검토할 수 있습니다.

예제: Relay

Relay는 Codex app-server를 기반으로 만든 운영 애플리케이션 예제입니다. 가상의 배송 대시보드 옆에 에이전트를 배치하고 애플리케이션 자체 MCP 도구에 연결했습니다. 배송을 다시 예약하려면 먼저 사람의 승인을 받아야 합니다.

사용자는 처음부터 프롬프트를 작성할 필요가 없습니다. 배송 건을 선택한 뒤 복구 방안 비교 같은 작업을 클릭하면 됩니다. 애플리케이션이 관련 컨텍스트를 제공하면 Codex가 최신 운영 예제 데이터를 조회하고 에이전트가 가능한 선택지를 설명합니다. 운영에 중요한 영향을 미치는 모든 쓰기 작업에는 승인이 필요합니다.

Codex는 애플리케이션의 MCP 도구로 최신 데이터를 조회한 뒤 조치를 제안하거나, 승인을 받은 후 해당 조치를 실행할 수 있습니다. 도구가 원본 레코드를 변경하면 애플리케이션은 업무 화면을 갱신합니다. 하네스는 에이전트 루프, 대화 상태, 활동 내역 스트리밍, 도구와의 상호작용을 처리하고, 제품은 자체 대시보드, 레코드, 제어 기능을 계속 관리합니다.

Relay는 미리 준비한 가상 데이터를 사용하지만, 이 통합 방식은 다른 분야에도 적용할 수 있습니다. 인시던트 대응, 계정 운영, 연구 워크플로우를 비롯해 사용자가 이미 쓰는 제품 안에서 에이전트가 작업해야 하는 애플리케이션에도 같은 방식을 활용할 수 있습니다.

개발자들의 활용 사례

이미 공개된 구현 사례에서도 이 방식을 확인할 수 있습니다.

• GitHub와 JetBrains는 기존 IDE 워크플로우에 Codex를 통합했습니다.

• Cisco는 Cisco Cloud Control의 App Builder에서 Codex SDK를 사용합니다.

• Thrive Holdings와 Crete는 실무자 피드백을 반영하는 세금 신고서 작성 워크플로우에 Codex를 사용합니다. 시범 운영에서 신고서 7,000건을 처리했고 작성 시간을 약 3분의 1만큼 줄였습니다.

활용 분야는 엔지니어링을 넘어섭니다. 고객 문제를 조사하는 지원 팀, 워크플로우를 조율하는 운영 팀, 인시던트의 우선순위를 정하는 보안 팀, 고객사를 조사하는 영업 팀, 캠페인을 기획하는 마케팅 팀에도 같은 방식이 적용됩니다. 각 사례에서 애플리케이션은 컨텍스트와 도구를 제공하고 승인을 처리하며, Codex는 그 기반이 되는 에이전트 루프를 구동합니다.

익숙한 인터페이스의 가능성 넓히기

많은 업무에서 핵심 컨텍스트는 대시보드, 타임라인, 지도, 문서, 시스템 레코드에 담겨 있습니다. 이런 화면은 단순한 장식이 아닙니다. 사람들은 실제로 이 화면을 보며 상황을 파악하고 결정을 내리며 업무를 주도합니다.

이런 인터페이스를 범용 채팅 창으로 대체할 필요 없이 에이전트를 통합해 기능을 확장할 수 있습니다. 에이전트는 업무를 이해하고, 관련 컨텍스트를 조사하고, 다음 단계를 제안하며, 승인된 조치를 실행할 수 있습니다.

Codex App, CLI, IDE 확장 프로그램은 하네스로 무엇을 할 수 있는지 보여 줍니다. 하네스가 오픈 소스로 공개되어 있으므로 개발자는 그 기능을 직접 살펴보고 자신의 제품과 워크플로우에 맞게 통합하고 조정할 수 있습니다.

Codex 하네스로 개발하려면 오픈 소스 Codex 리포지터리부터 살펴본 뒤 제품에 맞는 통합 방식을 선택하세요. 비대화형 작업에는 codex exec를, 코드로 실행하는 에이전트 워크플로우에는 Codex SDK를, 대화 유지와 이벤트 스트리밍, 승인 처리가 필요한 애플리케이션에는 Codex app-server를 사용하세요.