Codex 하네스 활용하기: OpenAI가 App Server를 구축한 방법 - OpenAI

[메인 콘텐츠로 건너뛰기](https://openai.com/ko-KR/index/unlocking-the-codex-harness/#main) [](https://openai.com/ko-KR/) * [리서치](https://openai.com/ko-KR/research/index/) * 제품 * [비즈니스](https://openai.com/ko-KR/business/) * [개발자](https://openai.com/ko-KR/api/) * [회사](https://openai.com/ko-KR/about/) * [재단(새 창에서 열기)](https://openaifoundation.org) [ChatGPT 사용하기(새 창에서 열기)](https://chatgpt.com/?openaicom-did=457e4b27-f3b6-4689-9b75-e2afa93b7d7e&openaicom_referred=true) * 리서치 * 제품 * 비즈니스 * 개발자 * 회사 * [재단(새 창에서 열기)](https://openaifoundation.org) Codex 하네스 활용하기: OpenAI가 App Server를 구축한 방법 | OpenAI 목차 * [App Server의 기본 배경](https://openai.com/ko-KR/index/unlocking-the-codex-harness/#app-serveryi-gibon-baegyeong) * [Codex 하네스 내부](https://openai.com/ko-KR/index/unlocking-the-codex-harness/#codex-haneseu-naebu) * [대화 프리미티브](https://openai.com/ko-KR/index/unlocking-the-codex-harness/#daehwa-peurimitibeu) * [클라이언트와의 통합](https://openai.com/ko-KR/index/unlocking-the-codex-harness/#keulraieonteuwayi-tonghab) * [올바른 프로토콜 선택하기](https://openai.com/ko-KR/index/unlocking-the-codex-harness/#olbareun-peurotokol-seontaeghagi) * [향후 계획](https://openai.com/ko-KR/index/unlocking-the-codex-harness/#hyanghu-gyehoeg) 2026년 2월 4일 [엔지니어링](https://openai.com/news/engineering/) # Codex 하네스 활용하기: OpenAI가 App Server를 구축한 방법 기술 스태프 멤버 Celia Chen 작성 로딩 중... OpenAI의 코딩 에이전트 Codex는 [웹 앱⁠(새 창에서 열기)](https://chatgpt.com/codex?openaicom-did=457e4b27-f3b6-4689-9b75-e2afa93b7d7e&openaicom_referred=true), [CLI⁠(새 창에서 열기)](https://github.com/openai/codex), [IDE 확장 프로그램⁠(새 창에서 열기)](https://developers.openai.com/codex/ide/), [새로운 Codex macOS 앱](https://openai.com/ko-KR/index/introducing-the-codex-app/) 등 다양한 서피스에서 사용할 수 있습니다. 내부적으로는 모두 동일한 Codex 하네스로 구동됩니다. 이는 모든 Codex 경험의 기반이 되는 에이전트 루프와 로직입니다. 이들 사이의 중요한 연결 고리는 무엇일까요? [Codex App Server⁠(새 창에서 열기)](https://developers.openai.com/codex/app-server)는 클라이언트 친화적인 양방향 JSON-RPC[1](https://openai.com/ko-KR/index/unlocking-the-codex-harness/#citation-bottom-1) API입니다. 이 게시글에서는 Codex App Server를 소개하며, Codex의 기능을 제품에 가장 효과적으로 통합하여 사용자가 워크플로를 한층 더 강화할 수 있도록 하는 방법에 대한 지금까지의 학습 내용을 공유합니다. App Server의 아키텍처와 프로토콜, 다양한 Codex 서피스에서의 통합 방법, Codex를 코드 리뷰어, SRE 에이전트 또는 코딩 어시스턴트로 활용하는 팁에 대해 설명합니다. ## App Server의 기본 배경 아키텍처에 대해 자세히 알아보기 전에 App Server의 배경을 알아두면 도움이 됩니다. 초기에는 App Server가 여러 제품에서 Codex 하네스를 재사용할 수 있는 실용적인 방법이었지만 점차 표준 프로토콜로 발전했습니다. Codex CLI는 TUI(터미널 사용자 인터페이스)로 시작했으며, 이는 Codex가 터미널을 통해 접근된다는 의미입니다. Codex 에이전트와 상호작용할 수 있는 IDE 친화적인 방식인 VS Code 확장 프로그램을 구축할 때, 동일한 하네스를 사용하여 IDE UI에서 동일한 에이전트 루프를 다시 구현하지 않고도 구동할 수 있는 방법이 필요했습니다. 즉, 워크스페이스를 탐색하고 에이전트가 추론하는 동안 진행 상황을 스트리밍하며 차이를 출력하는 등 요청/응답을 넘어 다양한 상호작용 패턴을 지원해야 했습니다. 처음에는 [Codex를 MCP 서버⁠(새 창에서 열기)](https://github.com/openai/codex/pull/2264)로 노출하는 시도를 했지만, VS Code에 적합한 방식으로 MCP 시맨틱을 유지하는 것이 어려웠습니다. 그 대신, TUI 루프를 반영한 JSON-RPC 프로토콜을 도입하여 App Server의 [비공식적인 첫 번째 버전⁠(새 창에서 열기)](https://github.com/openai/codex/pull/4471)이 되었습니다. 당시에는 다른 클라이언트가 App Server에 의존할 것이라고 예상하지 못했기 때문에 안정적인 API로 설계되지 않았습니다. Codex 도입이 몇 달 동안 확대되면서, 내부 팀과 외부 파트너는 사용자의 소프트웨어 개발 워크플로를 가속화하기 위해 동일한 하네스를 자체 제품에 임베드할 수 있는 기능이 필요했습니다. 예를 들어, JetBrains와 Xcode는 IDE 수준의 에이전트 경험을 원했지만 Codex 데스크톱 앱은 여러 Codex 에이전트를 병렬로 조정해야 했습니다. 이러한 필요성으로 인해 제품과 파트너 통합이 시간이 지나도 안전하게 의존할 수 있는 플랫폼 서피스를 설계하게 되었습니다. 기존 클라이언트를 손상시키지 않고 프로토콜을 발전시킬 수 있도록 손쉬운 통합과 이전 버전과의 호환성이 필요했습니다. 이제, 서로 다른 클라이언트가 동일한 하네스를 사용할 수 있도록 아키텍처와 프로토콜을 어떻게 설계했는지 단계별로 설명하겠습니다. ## Codex 하네스 내부 먼저, Codex 하네스 내부에 무엇이 있는지 살펴보고 Codex App Server가 이를 클라이언트에게 어떻게 노출하는지 알아보겠습니다. 지난 Codex [블로그](https://openai.com/ko-KR/index/unrolling-the-codex-agent-loop/)에서는 사용자, 모델, 도구 간의 상호작용을 조율하는 핵심 에이전트 루프를 자세히 살펴봤습니다. 이는 Codex 하네스의 핵심 로직이지만 전체 에이전트 경험에는 더 많은 것이 있습니다. **1. 스레드 라이프사이클 및 지속성**. 스레드는 사용자와 에이전트 간의 Codex 대화입니다. Codex는 클라이언트가 다시 연결하여 일관된 타임라인을 렌더링할 수 있도록 스레드를 생성하고, 재개하고, 포크하고, 보관하며, 이벤트 기록을 유지합니다. **2. 설정 및 인증**. Codex는 구성을 로드하고, 기본값을 관리하며, 자격 증명 상태를 비롯하여 “ChatGPT로 로그인”과 같은 인증 흐름을 실행합니다. **3. 도구 실행 및 확장**. Codex는 샌드박스에서 셸/파일 도구를 실행하고 MCP 서버 및 스킬과 같은 통합을 연결하여 일관된 정책 모델 하에서 에이전트 루프에 참여할 수 있도록 합니다. 여기서 언급한 모든 에이전트 로직(핵심 에이전트 루프 포함)은 Codex CLI 코드베이스의 "[Codex 코어⁠(새 창에서 열기)](https://github.com/openai/codex/tree/main/codex-rs/core)"라는 부분에 포함되어 있습니다. Codex 코어는 모든 에이전트 코드가 포함된 라이브러리이자, 에이전트 루프를 실행하고 하나의 Codex 스레드(대화)의 지속성을 관리할 수 있는 런타임입니다. Codex 하네스를 유용하게 사용하려면 클라이언트가 여기에 액세스할 수 있어야 합니다. 이때가 바로 App Server의 역할이 필요합니다.  App Server는 클라이언트와 서버 간의 JSON-RPC 프로토콜이며 Codex 코어 스레드를 호스팅하는 장기 실행 프로세스입니다. 위의 다이어그램에서 볼 수 있듯이, App Server 프로세스에는 stdio 리더, Codex 메시지 프로세서, 스레드 관리자, 코어 스레드 네 가지 주요 구성요소가 있습니다. 스레드 관리자가 각 스레드마다 하나의 코어 세션을 시작하면 Codex 메시지 프로세서는 각 코어 세션과 직접 통신하여 클라이언트 요청을 제출하고 업데이트를 받습니다. 클라이언트 요청 하나로 인해 많은 이벤트 업데이트가 발생할