2026년 트라이팟 연구회가 한단계 더 확장됩니다
Sign In
트라이팟 네트워크
Subscribe

OpenAI의 하네스 계층

Category
Empty
Participants
Activity
라이프오브파이
하네스는 군대에서 헬기 레펠할 때나 쓰던 말인데, 이젠 AI 덕에 다시 듣게 되네요.
클로드 코드 뿐만 아니라 다양한 AI 모델들의 핵심 목표는 "프로젝트의 완벽한 수행"을 위한 워크 플로우를 설계하는데 있습니다. 그 가운데 최근 각광 받는 하네스라는 개념 자체가 이러한 방식의 추상화된 실행 레이어라 볼 수 있는데 요즘은 코덱스가 또 대세인만큼 OpenAI는 어떻게 하네스 개념을 설명하고 있는지 정리해봤습니다.

OpenAI 하네스 계층

개요

OpenAI 문맥에서 하네스(harness)는 "에이전트가 일하는 실행 계층"이다. 단순한 프롬프트 묶음이 아니라, 스레드/턴 관리, 승인, 샌드박스, 파일 편집, 셸 실행, MCP, 스킬, 서브에이전트를 함께 묶는 작업 방식이다.
OpenAI는 2026-02-04 공개 글에서 Codex의 CLI, IDE, 웹, macOS 앱이 모두 같은 Codex harness 위에 있다고 설명한다.
출처:

현재 Codex에서 할 수 있는 것

현재 이 Codex에서 할 수 있는 일은 거의 그대로 그 하네스의 구성요소를 쓰는 것이다.
•
로컬 파일 읽기/수정
•
셸 명령 실행
•
승인 정책과 샌드박스 제어
•
MCP 서버 연결
•
스킬 자동/명시 호출
•
필요 시 병렬 서브에이전트 사용
•
GitHub 같은 플러그인 연동

필수 설정 파일

최소 셋업은 아래 4개 축으로 보는 게 맞다.

1. ~/.codex/config.toml 또는 프로젝트 .codex/config.toml

공식 우선순위:
1.
CLI 플래그
2.
프로필
3.
프로젝트 .codex/config.toml
4.
사용자 ~/.codex/config.toml
출처:

2. AGENTS.md / AGENTS.override.md

Codex는 작업 전에 이 파일들을 읽고, 루트에서 현재 디렉토리까지 내려오며 가까운 파일이 더 강하게 적용된다.
출처:

3. 스킬 디렉토리의 SKILL.md

스킬은 name, description 이 필수이고, 필요하면 아래를 붙인다.
•
scripts/
•
references/
•
assets/
•
agents/
출처:

4. 필요 시 서브에이전트 정의 파일

위치는 아래 둘 중 하나다.
•
~/.codex/agents/*.toml
•
프로젝트 .codex/agents/*.toml
필수 필드:
•
name
•
description
•
developer_instructions
출처:

실전 구조

가장 무난한 하네스 구성 예시는 아래와 같다.

~/.codex/config.toml

personality = "pragmatic" approval_policy = "on-request" sandbox_mode = "workspace-write" model_reasoning_effort = "medium" [features] multi_agent = true

프로젝트 루트 AGENTS.md

## Repository expectations - Run the project test command before finishing. - Keep edits narrow and avoid unrelated refactors. - Cite changed files and remaining risks in the final response.

프로젝트 스킬 .agents/skills/repo-review/SKILL.md

--- name: repo-review description: Use when reviewing this repository for bugs, regressions, and missing tests. --- Focus on concrete findings first. Use project test commands from AGENTS.md. Return file references and residual risk.

커스텀 서브에이전트 .codex/agents/reviewer.toml

name = "reviewer" description = "PR reviewer focused on correctness and test gaps." developer_instructions = """ Review code like an owner. Prioritize correctness, regressions, and missing tests. """ sandbox_mode = "read-only" model_reasoning_effort = "high"

어떻게 쓰는가

하네스 방법론으로 Codex를 쓰는 기본 순서는 보통 아래와 같다.
1.
AGENTS.md 에 팀 규칙을 넣는다.
2.
config.toml 에서 승인/샌드박스/MCP/모델 기본값을 정한다.
3.
반복 업무는 스킬로 뽑는다.
4.
병렬 가치가 큰 일만 명시적으로 서브에이전트를 쓴다.
중요한 점은 Codex가 자동으로 서브에이전트를 무제한으로 뿌리지 않는다는 점이다. 병렬 작업은 명시적으로 요청해야 한다.
출처:

예시 프롬프트

•
"이 저장소의 테스트 전략을 AGENTS 기준으로 점검해."
•
"$repo-review 스킬을 써서 현재 브랜치 리뷰해."
•
"보안/테스트/유지보수성으로 서브에이전트 3개를 병렬로 돌리고 마지막에 합쳐."

MCP와 스킬의 역할 분리

•
AGENTS.md: 팀 규칙, 작업 원칙
•
스킬: 반복 가능한 워크플로우
•
MCP: 외부 도구/문서/브라우저/Figma/GitHub 연결
•
서브에이전트: 병렬 분업
공식 MCP 설정은 config.toml 의 [mcp_servers.<name>] 아래에 둔다. CLI로는 codex mcp add ... 도 가능하다.
출처:

현재 세션 기준 권장 조치

지금 상태에서는 아래 3개를 먼저 만드는 게 맞다.
•
프로젝트 루트 AGENTS.md
•
프로젝트 .codex/config.toml
•
.agents/skills/ 아래 최소 1개 스킬

권장 최소 골격

바로 만들기 좋은 최소 골격:
•
AGENTS.md
•
.codex/config.toml
•
.agents/skills/<name>/SKILL.md

참고 링크

👍
1