vibe coding에서 agentic engineering까지 - 연습이 codex를 완벽하게 만든다
요약
Codex가 단순한 'vibe coding'을 넘어 에이전트 기반의 엔지니어링(agentic engineering) 단계로 진화하며 제공하는 핵심 기능들을 설명합니다. 명령어, 하위 에이전트, 기술(Skills), 플러그인, 메모리 및 MCP 서버 지원 등 복잡한 개발 워크플로우를 자동화하기 위한 체계적인 아키텍처를 다룹니다.
핵심 포인트
- 명령어(Commands)와 하위 에이전트(Subagents)를 통한 세션 제어 및 병렬 오케스트레이션 지원
- 재사용 가능한 지침 패키지인 기술(Skills)과 이를 결합한 플러그인(Plugins) 시스템 구축
- 사용자 단위의 세션 간 메모리(Memories) 파이프라인을 통한 컨텍스트 유지
- Model Context Protocol(MCP) 서버 지원을 통한 외부 도구와의 확장성 확보
- 코드베이스 설명부터 UI 개선까지 엔드 투 엔드 개발 워크플로우 지원
vibe coding에서 agentic engineering (agentic engineering)까지 - 연습이 codex를 완벽하게 만든다
= Agents · = Commands · = Skills
| 기능 (Feature) | 위치 (Location) | 설명 (Description) |
|---|---|---|
| Commands (명령어) | interactive session / slash popup | 세션 제어를 위한 내장 슬래시 명령어 (slash commands) — 예시: /plan, /fast, /fork, /review, /status, /mcp, /agent, /apps, /model, /permissions |
| Subagents (하위 에이전트) | .codex/agents/<name>.toml | 전용 TOML 역할 설정, 병렬 하위 에이전트 오케스트레이션 (orchestration), CSV 배치 처리를 포함하여 [agents.<name>] 아래에 등록된 커스텀 에이전트 · 글로벌 설정은 [agents] (max_threads, max_depth, job_max_runtime_seconds) 아래에 위치 · 내장 에이전트: default, worker, explorer |
| Skills (기술) | .agents/skills/<name>/SKILL.md | 필수 name + description 메타데이터와 scripts/, references/, assets/, 그리고 선택 사항인 agents/openai.yaml을 통한 단계적 공개(progressive disclosure)를 포함하는 재사용 가능한 지침 패키지 참조 · /skills 또는 $skill-name을 통해 명시적으로 호출하거나, 설명 일치를 통해 암시적으로 호출 · 내장 예시: $plan, $skill-creator, $skill-installer · 플러그인 (Plugins)을 통해 배포됨 |
| Plugins (플러그인) | .codex-plugin/plugin.json | 기술(skills) + 앱 통합 + MCP 서버를 결합한 배포 가능한 번들 — 로컬/개인 마켓플레이스 시스템 · 내장: $plugin-creator · /plugins 또는 Codex App을 통해 탐색 |
| Marketplace (마켓플레이스) | $CODEX_HOME → [marketplaces.*] | 플러그인 카탈로그 시스템 (v0.121.0+) — `codex plugin marketplace add |
| Memories (메모리) | $CODEX_HOME/memories/ | 세션 간 메모리 파이프라인 (v0.119.0+) — [features] memories = true를 통해 활성화하고 [memories] 아래에서 구성 · /memories를 통한 TUI 제어 (use · generate · reset 사용) · 스레드별 토글은 상태 DB (state DB)에 유지됨 · 범위는 프로젝트 단위가 아닌 사용자 단위임 |
| Workflows (워크플로우) | .codex/agents/weather-agent.toml |
End-to-end (엔드 투 엔드) 사용 패턴 — 코드베이스 설명, 버그 수정, 테스트 작성, 스크린샷 기반 프로토타이핑, UI 반복 개선, 클라우드 위임, 코드 리뷰, 문서 업데이트 |
MCP Servers (MCP 서버) |
config.toml → [mcp_servers.*] |
외부 도구를 위한 Model Context Protocol (MCP) — STDIO + Streamable HTTP 서버 · OAuth 지원 (codex mcp login) · codex mcp-server를 통해 MCP 서버로도 동작 ( codex() + codex-reply() 도구 노출) · MCP Apps (v0.119.0+): 리소스 읽기, 유도(elicitations), 파일 파라미터 업로드 · 병렬 호출 (v0.121.0+): 서버당 supports_parallel_tool_calls = true · CLI 관리: codex mcp add|get|list|login|logout|remove |
Config (설정) |
.codex/config.toml |
TOML 기반 계층형 설정 시스템 · 프로필 (Profiles) · 샌드박스 (Sandbox) · 승인 정책 (Approval Policy) · 고급 설정 ([features], [otel], [shell_environment_policy], [tui], 모델 제공자, 세분화된 승인) · 프로젝트 설정을 위한 신뢰 시스템 (Trust system) · developer_instructions · 커스텀 시스템 프롬프트를 위한 model_instructions_file |
Rules (규칙) |
.codex/rules/ |
prefix_rule()를 통한 Starlark 기반 명령 실행 정책 — 정확한 접두사 매칭을 통한 allow(허용), prompt(프롬프트), forbidden(금지) 결정 · codex execpolicy check를 통한 테스트 · 규칙은 세분화된 approval_policy 제어 및 사용자 관리 승인과 병행하여 작동함 |
AGENTS.md |
AGENTS.md |
Codex CLI를 위한 프로젝트 수준의 컨텍스트 — 현재 작업 디렉토리(cwd)부터 리포지토리 루트까지 계층적 탐색, 32 KiB (project_doc_max_bytes)로 제한 · 개인별 오버라이드를 위한 AGENTS.override.md |
Hooks (훅) |
.codex/hooks.json |
에이전트 루프(agentic loop)에 주입되는 사용자 정의 셸 스크립트 — 로깅, 보안 스캐닝, 검증 및 커스텀 자동화 · codex_hooks = true 기능 플래그(feature flag) 필요 |
Speed (속도) |
config.toml → service_tier |
Code Review (코드 리뷰) |
/review |
브랜치(branches), 커밋되지 않은 변경 사항(uncommitted changes), 또는 특정 커밋(specific commits)을 리뷰 — config.toml에서 설정 가능한 review_model · 사용자 정의 리뷰 지침 (Custom review instructions) |
AI 용어 (AI Terms) |
Agentic Engineering (에이전트 공학) · Context Engineering (컨텍스트 공학) · Vibe Coding (바이브 코딩) | |
Best Practices (권장 사례) |
공식 권장 사례 (Official best practices) · Prompt Engineering (프롬프트 엔지니어링) · Codex 가이드 (Codex Guides) |
Agent → Skill 패턴의 구현 세부 사항은 orchestration-workflow를 참조하세요. 에이전트(agent)는 Open-Meteo에서 온도(temperature)를 가져와 SVG 생성 스킬(skill)을 호출합니다.
codex
> Fetch the current weather for Dubai in Celsius and create the SVG weather card output using the repo.
(리포지토리를 사용하여 두바이의 현재 날씨를 섭씨로 가져오고 SVG 날씨 카드 출력을 생성하세요.)
참고: 이 워크플로우(workflow)는 Claude Code 권장 사례(Best Practice) 오케스트레이션 워크플로우와 100% 일치하지 않습니다. Codex CLI는 아직 사용자 정의 명령(custom commands, .codex/commands/)을 지원하지 않으므로, 전체 Command → Agent → Skill 패턴은 불가능합니다. Codex App Server 문서에는 실험적인 tool/requestUserInput이 있으며, codex-cli 0.115.0에는 개발 중인 기능 플래그(feature flag) 뒤에 숨겨진 내부 request_user_input 기능이 있지만, 둘 다 아직 공개적으로 사용할 수는 없습니다.
모든 주요 워크플로우는 동일한 아키텍처 패턴으로 수렴합니다: Research (조사) → Plan (계획) → Execute (실행) → Review (리뷰) → Ship (배포)
| 이름 | ★ | 워크플로우 | ||
|---|---|---|---|---|
| Superpowers | 171k | → → → → → | 5 | 14 |
| ... | ||||
| 참고: 노란색 태그는 서브 루프(sub-loops)입니다 — 상위 단계 내부에서 반복되는 단계입니다 (예: 작업(task)별, 스토리(story)별, 또는 검증 조건(verify condition)이 통과될 때까지). |
Prompting (프롬프팅) · Planning (계획) · AGENTS.md · Agents (에이전트) · Skills (스킬) · Hooks (훅) · Memories (메모리) · Workflows (워크플로우) · Advanced (고급) · Git / PR · Debugging (디버깅) · Utilities (유틸리티) · Daily (데일리)
| 팁 |
|---|
| Codex에게 도전하세요 — "이게 작동한다는 걸 증명해 봐"라고 말하고, Codex가 main 브랜치와 당신의 브랜치 사이의 차이점(diff)을 비교하게 하세요 |
| ... |
| 팁 |
| --- |
명시적인 계획을 원할 때는 /plan을 사용하세요 — Codex는 다단계 작업(multi-step tasks)을 위해 자동으로 계획을 세울 수도 있습니다 |
| ... |
| 팁 |
| --- |
AGENTS.md를 간결하게 유지하세요 — 150행(lines)이 유용한 휴리스틱(heuristic)이지만, 실제 제한은 바이트(byte) 기준(32 KiB)입니다 |
| ... |
| 팁 |
| --- |
| 일반적인 QA, 백엔드 엔지니어 대신 특정 기술(skills)을 가진 기능별 서브 에이전트(sub-agents)를 활용하세요 |
| ... |
| 팁 |
| --- |
| 자동 탐색(auto-discovery)을 위해 명확한 이름과 설명 프론트매터(frontmatter)가 포함된 기술(skills)을 사용하세요 |
| ... |
| 팁 |
| --- |
로깅(logging), 보안 스캐닝(security scanning), 검증(validation)을 위해 훅(hooks)을 사용하세요 — codex_hooks = true 기능 플래그(feature flag)가 필요합니다 |
| 코드 자동 포맷팅(auto-formatting)을 위해 훅을 사용하세요 — Codex는 잘 포맷팅된 코드를 생성하지만, 훅은 CI 실패를 방지하기 위해 마지막 10%를 처리합니다 |
source(`startup |
| 팁 |
|---|
| 메모리(memories)를 한 번 활성화하면 잊어버려도 됩니다 — 통합(consolidation)은 세션 사이에 실행되며, 대화 중간(mid-turn)에 실행되지 않습니다 |
비밀 정보나 신뢰할 수 없는 콘텐츠를 다루는 스레드(threads)의 경우 no_memories_if_mcp_or_web_search = true로 설정하세요 — 노출이 발생하면 /memories → Reset을 통해 초기화하세요 |
| 팁 |
|---|
| 순정(vanilla) Codex가 작은 작업들로 구성된 어떤 워크플로우(workflows)보다 낫습니다 |
| ... |
| 팁 |
|---|
| 병렬 팬아웃(parallel fan-out) 작업을 위해 서브 에이전트(sub-agents)를 생성하려면 멀티 에이전트(multi-agent)를 사용하세요 (GA — 기본적으로 활성화됨) |
| ... |
| 팁 |
| --- |
| 더 나은 디버깅(debugging)을 위해 항상 Codex에게 터미널을 백그라운드 작업(background task)으로 실행하도록 요청하세요 (로그를 확인해야 하므로) |
| ... |
| 팁 |
| --- |
| IDE(VS Code/Cursor) 대신 iTerm/Ghostty/tmux 터미널을 사용하세요 |
| ... |
| 팁 |
| --- |
| Codex CLI를 매일 업데이트하세요 |
| 변경 로그(changelog)를 읽는 것으로 하루를 시작하세요 |
| 기사 / 트윗 | 출처 |
|---|---|
| Codex가 구축되는 방식 — 90%가 Rust로 자체 구축됨 (Tibo, Pragmatic Engineer) | 2026년 2월 17일 |
| ... | |
| 비디오 / 팟캐스트 | 출처 |
| --- | --- |
| 파워 유저를 위한 Codex 가이드 — 워크플로 병렬화, 계획, 컨텍스트 엔지니어링 (Embiricos) | 2026년 |
| ... | |
| 출처 | 이름 |
| --- | --- |
| r/ChatGPT, r/OpenAI, r/Codex | |
| ... | |
| codex-cli-hooks · claude-code-best-practice · claude-code-hooks |
제 작업이 마음에 드신다면, doodh patti 🍵를 한 잔 사주세요.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기