[Codex 입문 6/6] Automations·Subagents·Hooks - 안전한 Codex 하네스
Codex 하네스 엔지니어링
AI가 혼자서도 일관되게 일하도록 만드는 자동화, 역할 분담, 안전장치
- 하네스는 AI가 일하는 환경 전체다
- Automations는 반복 일을 맡기는 장치
- Subagents는 역할 분담이다
- Hooks는 자동 안전벨트다
- Codex로 갈아타는 현실적인 순서
하네스는 AI가 일하는 환경 전체다
Claude 입문 마지막 편에서 말한 하네스 엔지니어링은 Codex에서도 가장 중요한 개념입니다. 프롬프트 하나를 잘 쓰는 수준을 넘어, AI가 안전하게 일하는 환경을 설계하는 단계입니다.
Codex의 하네스는 sandbox, approvals, worktree, AGENTS.md, Skills, MCP, hooks, automations, subagents가 함께 이루는 운영 구조입니다.
핵심은 자동화의 속도를 올리되, 되돌릴 수 있고 확인할 수 있게 만드는 것입니다.
Automations는 반복 일을 맡기는 장치
Automations는 정해진 주기나 조건에 따라 Codex가 일을 시작하게 만드는 기능입니다. 예를 들어 매주 블로그 초안 점검, 오래된 문서 정리, 새 이슈 요약 같은 작업에 맞습니다.
다만 자동화는 권한을 좁게 주는 것이 좋습니다. 처음에는 읽기 중심 작업으로 시작하고, 쓰기나 발행이 들어가면 승인 단계를 둡니다.
Tistory 자동 발행처럼 실제 외부 서비스에 영향을 주는 일은 검증 절차와 실패 시 멈추는 조건을 함께 설계해야 합니다.
Subagents는 역할 분담이다
Subagents는 큰 작업을 여러 역할로 나눌 때 유용합니다. 한 에이전트는 원문을 분석하고, 다른 에이전트는 검수하고, 또 다른 에이전트는 링크나 이미지 순서를 확인하는 식입니다.
Codex에서는 사용자가 명시적으로 요청했을 때 subagent를 쓰는 방식이 안전합니다. 읽을 자료가 많거나 서로 독립적인 조사 작업이 많을 때 효과가 큽니다.
다만 최종 판단은 하나의 흐름에서 모아야 합니다. 역할 분담은 빠르게 보기 위한 도구이지, 책임을 흩뜨리기 위한 도구가 아닙니다.
Hooks는 자동 안전벨트다
Hooks는 특정 순간에 자동으로 실행되는 규칙입니다. 명령 실행 전, 파일 수정 후, 맥락 압축 전후처럼 작업 흐름의 특정 지점에 붙일 수 있습니다.
예를 들어 발행 전 HTML 검사를 실행하거나, 위험한 명령을 막거나, 작업이 길어질 때 상태 기록을 남기는 식으로 사용할 수 있습니다.
Hooks는 강력하지만 신뢰할 수 있는 프로젝트에서만 조심스럽게 쓰는 것이 좋습니다. 자동으로 실행되는 장치는 편리한 만큼 설계가 중요합니다.
Codex로 갈아타는 현실적인 순서
첫째, 기존 Claude 글에서 쓰던 프롬프트 습관을 그대로 가져옵니다. 맥락, 결과, 제약 조건을 분명히 적습니다.
둘째, 프로젝트마다 AGENTS.md를 만들어 반복 설명을 줄입니다. 셋째, 자주 하는 작업은 Skill로 정리합니다. 넷째, 외부 도구가 필요할 때 MCP를 붙입니다.
마지막으로 충분히 검증된 반복 작업만 Automations로 넘깁니다. 이 순서라면 Codex가 강해져도 작업의 주도권은 계속 내가 쥘 수 있습니다.
| 하네스 요소 | 역할 |
|---|---|
| Sandbox | AI가 접근할 수 있는 범위 제한 |
| Approvals | 중요 행동 전 사람 확인 |
| Worktree | 원본을 지키는 실험 공간 |
| Subagents | 조사와 검토의 역할 분담 |
| Hooks | 작업 흐름 중 자동 안전장치 |
| Automations | 반복 작업을 정해진 조건에 따라 실행 |
바로 써볼 프롬프트
이 반복 작업을 자동화하고 싶어.
자동화해도 되는 단계와 사람이 승인해야 하는 단계를 나눠주고,
Sandbox, Worktree, Hooks, Subagents를 어떻게 써야 안전한지 설계해줘.