오픈AI가 에이전트 API를 열었습니다. 추가 요금은 0원입니다. (단, 에이전트가 쓰는 모델 토큰 비용은 그대로 듭니다 — 이 조건은 아래 4번 질문에서 자세히 짚습니다.)
2026-09-10, 오픈AI가 에이전츠 API(Agents API)를 공개 베타로 발표했습니다. 챗GPT 팀이 코덱스(Codex)를 돌리던 오케스트레이션 엔진을, 개발자가 API 하나로 그대로 쓸 수 있게 열어준 것입니다. 궁금할 만한 것부터 하나씩 풀어보겠습니다.
Q1. 에이전츠 API가 뭔가요
세 가지로 구성됩니다.
- 관리형 클라우드 샌드박스 — 에이전트가 코드를 실행하는 격리 환경
- API 하네스 — 코덱스를 움직이는 그 오케스트레이션 엔진
- 오픈소스 CLI — 터미널에서 바로 붙일 수 있는 명령줄 도구
한 줄로 요약하면, "챗GPT 팀이 코덱스로 쓰던 바로 그 엔진"을 API 콜 하나로 빌려 쓰는 것입니다. 오케스트레이션 코드를 직접 짜지 않아도 되는 게 핵심입니다.
Q2. 기존 API와 뭐가 다른가요
세 가지가 다릅니다.
- 장기 실행 세션 — 시간 단위로 이어지는 작업을 돌릴 수 있습니다.
- 자동 압축(compaction) — 컨텍스트가 한도에 다다르면 자동으로 압축해 세션이 끊기지 않습니다.
- 도구 검색(Tool Search) — 필요한 도구 정의만 그때그때 불러와 토큰을 아낍니다. 프로그래매틱 도구 호출로 병렬 실행도 됩니다.
MCP·커스텀 함수·웹검색도 지원합니다.
이런 소식, 남들보다 먼저 받으실 분?
직접 돌려보고 되는 것만 골라 매주 보내드립니다. 광고성 하이프는 거릅니다.
Q3. 서브에이전트가 뭔가요
조사·계획 같은 태스크를 하나의 트리 아래 서브에이전트에 병렬로 맡기는 기능입니다. 오픈AI가 공식으로 든 사용례는 이렇습니다.
- 하루 두 번, 대형 저장소를 크롤하고 분류
- 정기 유지관리 작업과 보안 스캔
- 온콜 대응
- PR 승인 대기 작업
⚠ Q4. 진짜 무료인가요
API 추가 요금은 없습니다. 하지만 에이전트가 쓰는 모델 토큰 비용은 그대로 듭니다. "에이전트 관리 비용 0원"이지 "운영비 0원"은 아닙니다. 그리고 지금은 공개 베타라 스펙이 바뀔 수 있습니다.
Q5. 어떻게 시작하나요
발표문 페이지가 자바스크립트로 렌더링돼서 시작 코드를 이 자리에서 그대로 인용하지는 못했습니다. 코드를 지어내지 않으려고, 대신 저희가 직접 확인한 시작 링크 세 곳을 그대로 드립니다.
| 자료 | 주소 |
|---|---|
| 발표문 | openai.com/index/introducing-the-agents-api |
| 공식 문서 | platform.openai.com/docs/agents |
| 오픈소스 코덱스 하네스 | github.com/openai/codex |
시작 코드는 위 문서에서 그대로 가져오시는 걸 권합니다.
우리 관점 — 어디까지 맡기고 어디부터 직접 굴릴까
1인 개발자가 에이전트를 만들고 싶어도 막혔던 지점은 대개 "오케스트레이션 코드가 벽"이었습니다. 이번 API는 그 벽을 관리형으로 대신 넘어줍니다. 남는 질문은 하나입니다 — 오케스트레이션을 직접 짜는 것과 관리형에 맡기는 것, 어느 쪽이 지금 내 프로젝트에 맞는가.
직접 짜면 세부 제어권을 갖는 대신 유지보수 부담을 집니다. 관리형에 맡기면 그 부담이 줄어드는 대신 오픈AI의 오케스트레이션 방식에 묶입니다. 공개 베타 단계라 스펙이 바뀔 수 있으니, 지금은 작은 태스크로 먼저 시험해보는 쪽을 권합니다.
오픈소스 에이전트 쪽 선택지가 궁금하시면 헤르메스 AI 에이전트 — 무료 자가학습 에이전트 5가지 기능도 함께 보시면 비교가 됩니다.
오늘 가져가실 것
- 오픈AI가 에이전츠 API를 공개 베타로 열었습니다. 코덱스를 돌리던 오케스트레이션 엔진 + 관리형 샌드박스 + 오픈소스 CLI 3종 구성입니다.
- 추가 요금은 0원이지만 토큰 비용은 그대로 듭니다. "관리비 0원"이지 "운영비 0원"이 아닙니다.
- 시작은 검증된 링크 세 곳에서. 발표문·공식 문서·오픈소스 코덱스 하네스입니다.
카드뉴스로도 정리했습니다
인스타그램에 올린 6장입니다.
