Codex 고급 활용

Codex는 터미널·데스크톱 앱·IDE에서 동작하는 OpenAI의 코딩 에이전트입니다. 이 핸드북은 시니어 개발자를 대상으로, 운영 안정성·자동화·확장에 집중한 고급 팁을 제공합니다.

이 핸드북이 다루는 것

• 팀 표준화: config 레이어/프로필, Team Config, 관리자 강제 정책(requirements.toml)
• 안전장치: 승인(approvals)과 샌드박스(sandbox)를 "기본값"으로 고정하는 운영 패턴
• 자동화: codex exec 기반의 스크립트/CI 통합, GitHub Action
• 멀티에이전트: sub-agent 역할 분리, spawn_agents_on_csv 배치 처리
• 확장: Codex App/IDE 워크플로우, MCP 연동, Skills 체계
• 변경 관리: Changelog/Feature Maturity 기반의 업그레이드·릴리즈 운영

최근 업데이트 하이라이트 (2026-05-10 KST 기준)

• CLI 0.130.0 — plugin details에서 bundled hooks를 바로 볼 수 있고, plugin sharing은 link metadata와 discoverability controls를 노출합니다. codex remote-control이 headless app-server 시작 진입점으로 추가됐고, app-server clients는 큰 thread를 unloaded/summary/full turn item view로 page 처리할 수 있습니다. multi-environment session에서 view_image가 선택된 environment를 기준으로 파일을 해석하고, live app-server thread가 restart 없이 config 변경을 반영합니다 (2026-05-08)
• Codex for Chrome — 새 Chrome 확장으로 Codex가 로그인된 브라우저 상태가 필요한 웹사이트를 병렬 탭 그룹에서 다룰 수 있습니다. localhost/file preview/public page는 여전히 in-app browser를 먼저 쓰고, Chrome은 Salesforce/Gmail/internal tools처럼 로그인 상태가 필요한 작업에 제한적으로 쓰는 운영 기준이 필요합니다 (2026-05-07)
• CLI 0.129.0 — TUI composer에 modal Vim editing과 /vim 흐름이 들어왔고, /keymap으로 shortcut context를 점검/저장할 수 있습니다. /diff는 workspace-aware하게 바뀌고, /hooks browser는 lifecycle hooks를 탐색/토글하며, plugin management는 workspace sharing·share access controls·source filtering·remote bundle sync까지 확장됐습니다 (2026-05-07)
• CLI 0.128.0 — persisted /goal workflow가 app-server API, model tools, runtime continuation, TUI create/pause/resume/clear controls와 함께 추가됐습니다. codex update, configurable TUI keymaps, plan-mode nudges, action-required terminal title, active-turn /statusline·/title editing도 들어왔습니다. permission profiles는 built-in defaults, sandbox CLI profile selection, cwd controls, active-profile metadata로 확장됐습니다 (2026-04-30)
• CLI 0.125.0 — app-server integrations가 Unix sockets를 지원하고, thread/resume/fork가 cursor-based pagination으로 1,000개 이상 task도 다룰 수 있습니다. app-server plugin management는 remote plugin 설치와 marketplace upgrade를 지원하며, codex exec --json은 reasoning token usage를 포함합니다 (2026-04-24)
• CLI 0.124.0 — Alt+,로 reasoning level을 빠르게 순환할 수 있고, approvals는 사용자에게 묻기 전에 변경안을 검토하는 subagent review를 자동 실행할 수 있습니다. hooks가 stable로 승격됐고, remote plugin marketplace list/read, Amazon Bedrock support, /permissions side-conversation 유지, /statusline·/title normalization도 반영됐습니다 (2026-04-23)
• CLI 0.123.0 — gpt-5.5가 Codex에 추가됐고, /mcp verbose, built-in browser use, current/archived thread를 구분하는 resume hinting, plain # heading-only context lookup이 들어왔습니다 (2026-04-22)
• GPT-5.5 모델 정리 — Codex는 대부분의 작업에 gpt-5.5를 기본 추천합니다. ChatGPT 로그인 시 Codex에서 사용할 수 있고, API-key 인증에서는 아직 사용할 수 없으므로 rollout 중에는 gpt-5.4를 fallback으로 둡니다. gpt-5.4-mini는 가벼운 coding/subagent 작업, gpt-5.3-codex-spark는 Pro 사용자의 빠른 반복 작업용 research preview로 둡니다.
• Codex App 26.423 — diff reviewer comments, in-app browser cookie 유지, browser use, thread로 직접 이미지 첨부, notification에서 현재 task 계속하기, slides 생성/편집, Figma integration, popout window browser 지원이 추가됐습니다 (2026-04-23)
• CLI 0.122.0 — standalone install이 더 self-contained하게 정리됐고, codex app이 Windows와 Intel Mac에서 Desktop을 더 정확히 열거나 설치합니다. 실행 중인 작업에 queued input을 넣을 때 slash command와 ! shell prompt를 함께 쓸 수 있고, Plan Mode는 새 컨텍스트에서 구현을 시작할 수 있습니다. 또한 deny-read glob 정책, 관리형 deny-read requirements, 격리 codex exec용 --ignore-user-config/--ignore-rules, 기본 활성화된 tool discovery·image generation이 추가됐습니다 (2026-04-20)
• CLI 0.121.0 — codex marketplace add가 GitHub/git URL/로컬 디렉토리/직접 marketplace.json URL을 지원하고, TUI composer는 Ctrl+R reverse search와 accepted slash command local recall을 갖게 됐습니다. memory mode/reset/deletion과 memory-extension cleanup도 TUI/app-server 차원에서 정리됐습니다 (2026-04-15)
• Codex App 26.415 — in-app browser, 프로젝트 폴더 없이 시작하는 chats, thread automations, task sidebar, context-aware suggestions, PR sidebar review, artifact viewer, memories, SSH 원격 연결 alpha, multiple terminals, multi-window, Intel Mac support, new plugins가 한 번에 들어왔습니다 (2026-04-16)
• CLI 0.120.0 — Realtime V2가 백그라운드 에이전트 진행률을 스트리밍하고, follow-up 응답을 큐잉하며, TUI 훅 출력과 커스텀 status line이 더 읽기 쉬워졌습니다. SessionStart 훅은 /clear로 시작된 세션을 별도로 식별할 수 있습니다 (2026-04-11)
• CLI 0.119.0 — Realtime 음성 세션이 v2 WebRTC를 기본 경로로 사용하고, MCP Apps/custom MCP servers가 resource read, tool-call metadata, custom-server tool search, server-driven elicitation, file upload를 더 잘 지원합니다. 실험적 codex exec-server, /resume의 session ID/name 직접 점프, Ctrl+O 최신 응답 복사도 추가됐습니다 (2026-04-10)
• 플러그인 워크플로우 1급화 — 제품 범위 플러그인 sync, /plugins 브라우저, 더 명확한 설치/제거 흐름이 추가됐습니다 (0.117)
• /title + app-server TUI 기본화 — app-server-backed TUI가 기본값이 되었고, /title terminal-title picker가 classic/app-server TUI 모두에서 동작합니다 (0.117)
• view_image 풀해상도 이미지 검사 — 모델이 view_image 도구와 codex.emitImage(..., detail: 'original')로 원본 해상도 이미지를 요청할 수 있습니다 (0.115)
• App-server filesystem RPCs + Python SDK — 파일 읽기/쓰기/복사 RPC와 새 Python SDK가 추가됐습니다 (0.115)
• Smart Approvals guardian subagent — 스마트 승인이 guardian 서브에이전트를 통해 라우팅되어 다중 인터페이스에서 일관된 승인 경험을 제공합니다 (0.115)
• Codex Windows 앱 출시 — Windows 네이티브 앱이 출시됐습니다. 네이티브 에이전트 샌드박스, PowerShell 지원, 크로스 플랫폼 세션 동기화를 포함합니다 (2026-03-04)
• Codex Security 리서치 프리뷰 — GPT-5.4 기반 보안 스캐닝 기능이 Enterprise/Business/Edu 고객에게 제공됩니다 (2026-03-06)
• Codex App 26.312 — 테마 & 자동화 개편 — 앱 외관 커스터마이징과 자동화가 대폭 개선됐습니다 (2026-03-12)
• request_permissions 내장 툴 — 에이전트가 런타임에 추가 권한을 요청하고 TUI에서 직접 승인할 수 있습니다 (0.113)
• 플러그인 마켓플레이스 확장 — 마켓플레이스 검색, 인증 검증, 삭제 엔드포인트가 추가됐습니다 (0.113)
• 실험적 Code 모드 — 격리된 코딩 워크플로우를 위한 전용 모드가 도입됐습니다 (0.114)
• 실험적 Hooks 엔진 — SessionStart, Stop 이벤트에 반응하는 훅 시스템이 추가됐습니다 (0.114)

핸드북 구성

목차

참고 문서

• Codex 문서 홈: https://developers.openai.com/codex (영어)
• Codex CLI: https://developers.openai.com/codex/cli (영어)
• Codex App: https://developers.openai.com/codex/app (영어)
• Changelog: https://developers.openai.com/codex/changelog (영어)
• Models: https://developers.openai.com/codex/models (영어)