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-06-25 KST 기준)

• CLI 0.142.0 — /usage가 token activity와 earned rate-limit reset action을 제공하고, rollout token budgets, indexed web-search mode, scheduled UTC reminders/current-time handling, multi-agent delegation modes, app-server/exec/MCP disconnect 복구가 반영됐습니다. 장시간 /goal·multi-agent 작업 전 /usage weekly와 rollout budget을 확인하세요 (2026-06-22)
• CLI 0.141.0 — TUI/app-server 안정성 중심 릴리스로, Linux Ctrl+Z suspend/resume 후 foreground 복귀와 장시간 app-server 연결 복구를 검증 루틴에 추가했습니다 (2026-06-18)
• CLI 0.140.0 — /delete, /import가 공식 slash command로 추가됐습니다. /delete는 current transcript와 spawned descendant session을 영구 삭제하므로 /archive와 보존 정책을 분리하고, /import는 Claude Code setup/project files/recent chats를 가져온 뒤 /diff·/debug-config로 검토합니다 (2026-06-16)
• CLI 0.139.0 — code mode standalone web search, MCP schema oneOf/allOf 보존, codex doctor editor/pager diagnostics, plugin marketplace source/cached catalog, image referenced-path edit, sandbox proxy/approval 보존, OpenAI Codex cloud exec provider, send-message-v2 복구까지 반영했습니다 (2026-06-09)
• CLI 0.138.0 — /app으로 현재 CLI thread를 Codex Desktop(macOS/네이티브 Windows)으로 handoff할 수 있고, 로컬 이미지 첨부·생성 결과의 파일 path가 모델에 노출됩니다. reasoning effort fallback shortcuts, 모델이 광고한 effort 순서 반영, app-server account token usage, ChatGPT v2 personal access token, plugin add/remove/marketplace --json, codex plugin list --available --json, marketplace source JSON도 추가됐습니다 (2026-06-08)
• Codex App 26.608 — mobile input cursor 이동, unsupported language 처리, titlebar cancel button, setup/onboarding, mobile startup memory, remote connection 지원(codex remote-control), Composer thinking mode selector, active MCP server 표시, Computer Use rendering/responsiveness가 개선됐습니다. App 26.423 이후의 브라우저/리뷰 워크벤치 운영 기준에 원격 연결과 MCP 가시성까지 포함하세요 (2026-06-09~2026-06-11)
• CLI 0.137.0 — TUI keymap이 F13-F24와 searchable menu paste를 지원하고, status/title에는 reasoning-only compact item을 둘 수 있습니다. Enterprise/admin 흐름은 월간 credit limit 표시와 cloud-managed config bundle 적용(EDU 포함)을 보강했고, remote-control client는 app-server v2 RPC로 pairing 시작, controller grant 조회/폐기를 다룰 수 있습니다. codex plugin list --json, cached remote catalog suggestions, code-mode hosted web/image tools, Multi-agent v2 runtime metadata도 추가됐습니다 (2026-06-04)
• CLI 0.136.0 — /archive와 codex archive/codex unarchive로 세션을 archive/unarchive할 수 있고, archived session은 복원 전 resume/fork 대상에서 보호됩니다. TUI Markdown 링크는 OSC 8 metadata로 clickable하게 유지되고, codex app-server --stdio, richer MCP server status, remote execution용 CODEX_API_KEY 등록, remote-control short-lived server token, Windows sandbox setup alpha도 추가됐습니다 (2026-06-01)
• CLI 0.135.0 — codex doctor가 environment/Git/terminal/app-server/thread inventory diagnostics를 더 자세히 보고하고, remote TUI의 /status는 connection/server version을 표시합니다. /permissions는 named permission profiles와 custom profile 표시를 이해하고, Vim mode는 text-object editing과 interrupt-turn binding을 보강했습니다 (2026-05-28)
• CLI 0.134.0 — local conversation history search, --profile 파일 기반 selector 전환, MCP per-server environment targeting/OAuth options, connector tool schema 안정화, readOnlyHint MCP tool 병렬 실행, extension/hook context 확장을 반영했습니다 (2026-05-26)
• CLI 0.133.0 — /goal이 기본 활성화되고 전용 저장소로 active turn progress를 추적합니다. permission profiles는 list API, inheritance, managed requirements.toml, runtime refresh, Windows sandbox integration을 얻었고, plugin discovery는 marketplace-aware list, installed versions, visible marketplace roots, remote collection support를 보강했습니다 (2026-05-21)
• CLI 0.132.0 — Python SDK가 API key·ChatGPT browser/device-code login, account inspection, logout API를 1급으로 지원하고, text-only turn API는 plain string input과 풍부한 TurnResult를 반환합니다. codex exec resume은 --output-schema를 받아 기존 세션 맥락과 구조화 JSON 계약을 함께 유지할 수 있습니다. app-server는 original-resolution image fidelity를 보존하고, /goal continuation은 usage limit·반복 blocker에서 멈추도록 보강됐습니다 (2026-05-20)
• CLI 0.131.0 — TUI가 data-driven service-tier commands, blended token usage, approval mode, effective workspace roots, responsive Markdown table 표시를 보강했습니다. @ mention picker는 files/directories/plugins/skills를 한 곳에서 검색하고, plugin workflow는 marketplace CLI commands, version-aware sharing, share checkout, default-enabled plugin hooks를 얻었습니다. codex doctor diagnostics와 remote-control daemon/runtime APIs도 추가됐습니다 (2026-05-18)
• Work with Codex from anywhere — ChatGPT mobile app에서 Mac의 Codex app에 연결해 같은 projects/files/credentials/plugins/skills/configuration을 사용할 수 있습니다. 이 공지와 함께 Hooks GA, Codex access tokens, Enterprise admin setup 문서가 보강됐습니다 (2026-05-14)
• Slash commands 재검증 — /approve, /ide, /memories, /raw, /skills, /theme, /vim이 현재 공식 slash commands 표에 포함되어 있습니다. 이전에 preview로 추적하던 /vim은 정식 명령으로 승격하고, command-master에 개별 페이지를 추가했습니다.
• 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를 기본 추천합니다. 현재 공식 Models 문서 기준으로 ChatGPT 로그인과 API-key 인증 모두에서 Codex CLI/SDK·App/IDE에 지원됩니다. gpt-5.4-mini는 가벼운 coding/subagent 작업, gpt-5.3-codex-spark는 Pro 사용자의 빠른 반복 작업용 research preview로 둡니다. gpt-5.3-codex는 ChatGPT 로그인 기준 deprecated이므로 신규 설정에서 제거하세요.
• 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 (영어)