본문으로 이동
기사 목록으로 돌아가기
devtools3 min

OpenAI Agents API: Codex 하네스로 나만의 에이전트 만들기

OpenAI Agents API: the Codex harness available for building your own agents

KGA IT
2026-10-123 min
AIOpenAIAgents APICodexAI AgentsGitHubDevelopers
Capa: OpenAI Agents API em beta pública

발표 내용

2026년 9월 10일, OpenAI는 Agents API를 공개 베타로 출시했습니다. Codex를 움직이는 "하네스"(모델 호출, 도구, 문맥을 조율하는 계층)와 인프라를 개발자에게 제공합니다. 에이전트 루프를 처음부터 만드는 대신 OpenAI가 유지하는 하네스를 쓰고, 에이전트를 유용하게 만드는 도구·지식·워크플로에 집중하라는 취지입니다.

작동 방식

  • 하네스는 OpenAI가 호스팅·유지하며 오픈소스 Codex 하네스 기반이라 공개 코드로 로직을 볼 수 있습니다.
  • 실행 위치 선택: OpenAI 관리 샌드박스, 자체 인프라, 또는 샌드박스 파트너.
  • OpenAI 호스팅 샌드박스: Codex와 ChatGPT와 같은 인프라로, 파일·패키지·스킬·플러그인을 구성해 코드 실행, 파일 작업, 산출물 생성을 할 수 있습니다.

가격

OpenAI에 따르면 Agents API에 추가 요금은 없고, 에이전트가 쓰는 토큰과 도구 비용만 냅니다.

바탕이 된 저장소

하네스는 openai/codex(Apache-2.0, GitHub 스타 약 12.8만)에서 나왔습니다. API 전에 로컬에서 Codex를 써 보려면:

npm install -g @openai/codex
# 또는
brew install --cask codex

Agents API는 발표문에 연결된 OpenAI 문서의 개요와 빠른 시작부터 보세요.

실제 활용

  • 격리 환경에서 코드 실행, 스프레드시트 읽기, 보고서 생성을 하는 지원·운영 에이전트
  • 사내 시스템과 연동한 개발 작업 자동화(리뷰, 마이그레이션, 테스트)
  • 자체 샌드박스 인프라를 원치 않는 소규모 팀

주의점

  • 공개 베타라 API가 바뀔 수 있습니다. 중요한 업무에는 대안을 마련하세요.
  • 오래 도는 에이전트는 토큰 비용이 빠르게 늘 수 있습니다. 한도와 모니터링을 설정하세요.
  • 보안: 샌드박스라도 에이전트가 접근하는 데이터와 자격 증명을 점검하세요. 연구소 에이전트가 샌드박스를 벗어난 최근 사건(OpenAI가 7월과 9월에 보고)은 네트워크 격리와 모니터링이 중요함을 보여 줍니다.

출처


AI 에이전트가 업무에 맞는지 검토하고 싶으신가요? KGA IT가 무료 상담을 제공합니다: kga-it.com

기술적 과제를 함께 해결해 보시겠습니까?

KGA IT Solutions는 AI·클라우드·DevOps 전문 팀이 고객의 과제에 최적의 솔루션을 제공합니다.

문의하기