# Codex가 내 앱으로 온다 — 답변 다음은 실제 작업

> OpenAI Agents API가 공개 베타로 나왔어요. 파일을 고치고 작업을 이어가는 Codex 실행 체계를 다른 앱에 연결하는 변화예요.

- 출처 사이트: AI피셜 (https://aifficial.net/posts/openai-agents-api/)
- 발행: 2026-09-11
- 카테고리: AI 서비스 · 태그: OpenAI, Agents API, Codex, AI 에이전트

## 핵심 답변

OpenAI는 9월 10일 Agents API를 공개 베타로 출시해, 개발자가 Codex의 실행 체계를 자기 앱에 연결할 수 있게 했어요. 앱이 파일·도구·작업 환경을 연결하면 AI가 자료를 읽고 보고서 파일을 만들며 같은 세션에서 후속 수정도 이어갈 수 있어요. 공식 예제는 GitHub에 버그가 등록되면 코드를 살피고 시험을 실행한 뒤 원인과 수정 제안을 그 이슈에 돌려주는 과정을 보여줘요.

## 한 장 요약(만화)

![사용자의 보고서 요청, Agents API를 통한 Codex 실행과 파일 생성, 같은 세션의 후속 요청을 보여주는 세 장면](https://aifficial.net/images/posts/openai-agents-api/comic-v1.1.0.webp)

## 요약

- OpenAI가 9월 10일 Agents API를 공개 베타로 출시했어요. 다른 앱에서 Codex의 실행 체계를 호출해 파일·도구를 다루는 여러 단계의 일을 맡길 수 있어요.
- 예를 들어 업무 앱에 두 자료를 비교해 보고서 파일을 만들도록 맡긴 뒤, 같은 세션에서 “이번 달 표만 다시 만들어 줘”라고 이어갈 수 있어요. 자료 읽기와 결과 파일 생성까지 연결하는 활용이에요.
- 공식 GitHub 예제에서는 버그 등록이 조사 시작점이에요. AI가 저장소를 읽고 관련 시험을 실행한 뒤 원인과 수정 제안을 보고서로 만들고, 앱이 원래 이슈에 올려요.
- HN에서는 명령줄 도구를 직접 감싸던 수고를 줄인다는 기대와, 비용·작업 환경을 특정 회사에 맡긴다는 우려가 함께 나왔어요. 앱 개발자는 사용할 도구와 환경, 결과를 확인하는 방식을 설계해요.

## 핵심 사실

| 항목 | 값 |
|---|---|
| 공개 | 2026-09-10 (공개 베타) |
| 실행 환경 | OpenAI 호스팅 또는 자체 환경 |


## “이 자료로 보고서 파일까지 만들어 줘”

업무 앱에 지난달과 이번 달 자료를 넣었다고 해볼게요. 차이를 설명하는 답변을 받는 것에서 끝나지 않고, 표를 비교해 보고서 파일로 만들고 싶어요. 완성본을 본 뒤에는 “그 보고서에서 이번 달 표만 다시 만들어 줘”라고 이어서 부탁하고요. 이번 서비스의 쓰임을 떠올려 볼 수 있는 예예요.

OpenAI는 9월 10일 <strong>Codex의 실행 체계를 다른 앱에 연결하는 Agents API</strong>를 공개 베타로 출시했어요. API(application programming interface)는 프로그램끼리 기능을 주고받는 연결 창구예요. 앱 개발자가 파일·도구·작업 환경을 연결하면, 모델의 답변뿐 아니라 작업의 실행과 이어가기까지 서비스 안에 넣을 수 있어요. 

새 모델 하나의 이름은 아니에요. 일을 맡기고 도구를 쓰게 하는 실행 체계인 하네스(harness)를 관리형 서비스로 제공하는 것이에요. 사무실에 직원을 소개하는 데서 한 걸음 더 나아가, 작업 책상과 업무 진행을 관리하는 장치를 연결하는 쪽에 가까워요. 세션 관리·작업 조율·긴 문맥의 압축과 복구는 OpenAI가 맡아요. 



## 버그가 올라오면 조사 결과가 같은 자리에 돌아와요

OpenAI가 공개한 GitHub 이슈 조사 예제는 이 변화를 더 구체적으로 보여줘요. 누군가 버그를 등록하면 앱이 그 이벤트를 받아 별도의 작업 공간을 만들고, AI가 코드와 관련 시험을 살펴봐요. 결과는 조사 보고서 파일로 만들어지고 앱이 원래 이슈의 댓글에 돌려줘요. 이용자가 별도 채팅창에 버그를 다시 설명하는 단계를 줄이는 구성이에요. 

예제의 버그는 “100달러 넘는 주문에서 특급 배송비가 사라진다”예요. 공개된 결과 예시는 125달러 주문에 특급 배송을 선택했을 때 15달러여야 할 배송비가 0으로 계산됐다고 설명해요. 원인은 일반 주문의 무료 배송 조건을 먼저 검사한 순서이며, 특급 배송 여부를 먼저 확인하라는 수정 제안을 돌려줘요. 



이 예제의 AI는 코드를 직접 배포하는 대신 조사 파일을 쓰도록 구성돼 있어요. 어떤 앱이든 자동으로 모든 일을 하게 되는 것이 아니라, 개발자가 맡길 일과 결과를 돌려줄 자리를 정한다는 점이 중요해요. 

## 같은 작업을 이어가는 세션이 있어요

세션(session)은 작업 이력을 유지하는 단위예요. 첫 결과가 나온 뒤 자료를 처음부터 다시 설명하지 않고 후속 요청을 보낼 수 있고, 진행 중에도 새 지시로 방향을 바꿀 수 있어요. 앞의 보고서 예시에서 “이번 달 표만 다시”라는 말이 앞선 자료와 결과에 이어지는 이유예요. 

실제로 파일과 코드를 다루는 곳은 실행 환경인 샌드박스(sandbox)예요. 작업실에 비유할 수 있고, OpenAI 호스팅 환경이나 개발자가 준비한 환경을 연결할 수 있어요. 외부 도구는 모델 컨텍스트 프로토콜(Model Context Protocol, MCP) 같은 규약으로 붙일 수도 있어요. 작업실이라는 이름만으로 모든 접근 권한과 안전 조건이 정해지는 것은 아니에요. 

| 앱이 맡기는 일 | 연결되는 작업 | 이용자가 받는 것 |
| --- | --- | --- |
| 문서 두 개 비교 | 파일 읽기·보고서 작성 | 결과 파일과 후속 수정 |
| 데이터에서 답 찾기 | 읽기 전용 데이터베이스 조회 | 근거를 붙인 분석 |
| 버그 원인 조사 | 코드 읽기·관련 시험 실행 | 원래 이슈로 돌아오는 조사 결과 |

OpenAI는 문서 검토·데이터 분석·장애 대응을 포함한 예제들을 제공해요. 이 표는 그런 기능으로 구성할 수 있는 활용을 설명한 것이며, 실제 앱의 기능은 개발자가 연결한 도구와 흐름에 따라 달라져요. 

## HN에서 반긴 것은 또 하나의 모델이 아니었어요

HN 이용자 `colesantiago`는 명령줄 도구를 거쳐 연결하던 대신 API를 바로 쓸 수 있기를 기대했어요. 반면 `maxdo`는 샌드박스에서 SDK를 쓰는 방식보다 API를 고를 이유가 무엇인지 물었어요. SDK(software development kit)는 개발자가 프로그램에 붙여 쓰는 도구 모음이에요. 이미 직접 구성해 쓰던 실행 과정을 서비스에 맡길 만한지가 논점인 셈이에요. 

`kingstnap`은 작업 중인 파일과 진행 과정을 자기 컴퓨터에서 볼 수 있는 점을 중요하게 생각한다며, 관리형 실행 서비스가 특정 공급자에 대한 의존을 키울 수 있다고 우려했어요. 이는 이용자의 판단이에요. 공식적으로 확인되는 조건은 모델·도구·호스팅 환경의 비용이 각각 적용될 수 있고, 개발자가 환경과 도구를 구성한다는 것이에요. 편리해지는 부분과 직접 관리하고 싶은 부분을 나눠 볼 이유가 생겨요. 


<strong>제게 가장 와닿은 것은 버그를 신고한 자리에 조사 결과가 돌아온다는 예제였습니다.</strong> AI를 쓴다고 하면서도 실제로는 자료를 다른 창에 옮기고, 결과를 복사하고, 다시 원래 문서에 붙이는 일을 사람이 맡는 경우가 많습니다. 그 사이를 앱이 연결해 준다면 새 채팅창 하나가 늘어나는 것보다 일의 마무리가 달라질 수 있을 것 같습니다.

보고서를 받은 뒤 “이번 달 표만 고쳐 주세요”라고 이어가는 장면도 비슷합니다. 한 번 잘 답하는 능력은 눈에 잘 띄지만, 앞에서 무엇을 만들었는지 유지하며 작은 수정을 받아 주는 능력이 매일 쓰는 도구에는 더 중요할 때가 있습니다. 저는 이런 연속성이 살아 있어야 AI가 잠깐 도움을 주는 방문객에서 반복 업무를 맡길 도구로 바뀌지 않을까 싶습니다.

그래서 HN에서 진행 중인 파일을 직접 보고 싶다는 의견도 함께 기억하고 싶습니다. 일을 맡기는 동안 무엇을 읽고 어떤 결과를 만들고 있는지 알 수 있어야, 마지막 파일만 받아 보고 처음부터 검토하는 부담도 줄어들 테니까요. 여러분이 매일 쓰는 앱에 이런 기능이 들어온다면, 어떤 일을 처음 요청부터 마지막 수정까지 한곳에서 끝내고 싶으신가요? 



## 자주 묻는 질문

**Q. ChatGPT에 새 버튼이 생기는 건가요?**

개발자가 다른 앱이나 서비스에 연결하는 API예요. 실제 이용 화면과 할 수 있는 일은 그 앱을 만든 쪽이 정해요.

**Q. 기존 모델 사용료만 내면 되나요?**

모델 사용료 외에 이용한 OpenAI 도구와 호스팅 샌드박스의 비용이 각각 붙을 수 있어요. 정액으로 무제한 일을 맡기는 상품은 아니에요.

## 출처

1. [9월 10일 공개 베타 출시 기록](https://developers.openai.com/api/docs/changelog) (official)
2. [Agents API의 작업 방식과 과금·데이터 조건](https://developers.openai.com/api/docs/guides/agents-api/overview) (official)
3. [실제 세션 생성과 작업 실행 절차](https://developers.openai.com/api/docs/guides/agents-api/quickstart) (official)
4. [OpenAI 공식 GitHub 버그 조사 예제](https://developers.openai.com/showcase/agents-api-github-issues) (official)
5. [Agents API HN 토론: 연결 방식과 관리형 실행](https://news.ycombinator.com/item?id=49649213) (report)

_이 문서는 AI피셜 편집부가 작성했습니다. 인용 시 출처를 표기해 주세요._