Codex 고급 활용

2026-09-12 최신 변경

Codex CLI 0.154.0(9월 9일)을 기준으로 갱신했습니다. npm latest=0.154.0, alpha=0.155.0-alpha.3.10을 2026-09-12 KST에 확인했습니다.

• 세션: 실험적 --worktree·/worktree로 새 세션과 fork의 격리 checkout을 만들고 재개할 수 있습니다. 작업 중 질문에 선택지나 직접 입력으로 답하는 UI도 추가됐습니다.
• 확장·승인: 설치·업데이트한 plugin의 tools·skills·hooks가 기존 세션에 반영됩니다. MCP OAuth 갱신 실패는 재인증으로 이어지며 거절된 tool 호출을 자동 재실행하지 않습니다. resume/fork의 권한 보존과 새 사용자 지시 이후 오래된 자동 승인 폐기도 보강됐습니다.
• 호환성: codex mcp-server와 독립 codex-mcp-server는 제거됐습니다. 외부 MCP 연결용 codex mcp는 유지됩니다. 통합은 experimental codex app-server 이전을 검토하되 공식적으로 production workload를 지원하지 않는다는 경계를 확인하세요.
• 입력·출력: /copy는 서식과 status 출력을 지원하고 Vim R replace mode가 추가됐습니다. Windows는 공유 background server와 daemon 관리가 보강됐습니다.

근거: 공식 Changelog, npm dist-tags.

이전 검증 기록 (2026-09-05)

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-09-05 KST 기준)

• 현재 기준 — Codex CLI와 npm latest는 0.153.4, npm alpha는 0.154.0-alpha.3입니다. 신규 팀 표준은 latest 또는 검토한 pin에 두고 alpha는 기능 탐색에만 사용합니다.

• GPT-6 Astra 출시(2026-09-03) — gpt-6-astra가 Codex 최상위 모델이 됐습니다. CLI 0.153.0 이상이 필요하고, 0.153.4부터는 모델을 명시하지 않은 세션의 bundled 기본값입니다. 1,050,000 토큰 컨텍스트, 128K 출력, API 입력 $10·캐시 입력 $1·출력 $50/1M, 지식 기준일 2026-04-30입니다. config.toml에 model을 고정해 둔 팀은 기본값 전환의 영향을 받지 않으므로 도입 여부를 의식적으로 결정하세요.

• Astra 보안 등급 — OpenAI는 Astra를 Preparedness Framework의 사이버보안 Critical 등급에 도달한 첫 모델로 분류합니다. 고권한 자동 실행에 붙이기 전에 /permissions·샌드박스·자동 승인 범위를 먼저 좁히세요.

• CLI 0.153.0~0.153.4 — Vim undo/redo, plugin CLI의 원격 marketplace 관리, tui.auto_recap = false, 전체 patch·터미널 입력·개별 완료 명령을 보여주는 TUI history, Plus·Team의 조기 사용량 경고가 추가됐습니다. Guardian 리뷰 이력이 compaction·재시작·fork를 넘어 보존되고, Full Access는 확인만 필요한 동작에서 Guardian 리뷰를 건너뜁니다. tui.disable_paste_burst와 기본 비활성화 features.context_management.experimental_mode도 추가됐습니다.

• CLI 0.152.0 — planning tool이 기본 비활성화됐습니다(tools.update_plan.enabled = true로 활성화). MCP 서버 이름에 :·@·/·.를 쓸 수 있고, 개별 MCP tool에 output_token_limit을 둘 수 있으며, app-server의 thread/shellCommand 타임아웃을 1시간 이상으로 설정할 수 있습니다. rate-limit 배너에 사용량·credit·플랜 관리 액션이 붙었습니다.

• CLI 0.151.0 — optional MCP 서버의 tool 탐색 grace period를 설정할 수 있고, extension이 MCP tool 결과를 모델에 도달하기 전에 검사·교체할 수 있습니다. repository별 plugin catalog 구성과 nested subagent 토큰의 root goal 예산 반영도 포함합니다.

• CLI 0.150.0~0.150.1 — task @ 멘션과 agent의 task 생성·조회·메시징, /copy 선택기, 자동 task 이름과 /rename 제안, clickable Markdown 링크, Interrupt hooks가 추가됐습니다. untrusted project의 AGENTS.md 무시, managed deny-read 지속, remote compaction image budget, MCP·Windows·shutdown·Bedrock 안정화도 반영합니다.

• CLI 0.149.0 — codex agents 대시보드, 기존 세션에 지시를 넣는 codex queue, /cd·/pwd·/cwd, 확장된 codex doctor, resume/fork permission profile 복원을 추가했습니다.

• MCP 전환 — 공식 Changelog는 2026-08-24부터 codex mcp-server를 deprecated로 분류합니다. 새 통합은 codex app-server를 사용하고 기존 호출은 단계적으로 이전합니다.

• CLI 0.148.0 — TUI 대화를 Markdown으로 내보내는 /export, 비대화형 fork인 codex exec fork, resume picker의 archive/restore, 시작 중 prompt 작성, /status·status line·terminal title의 예상 credit/cost, built-in Amazon Bedrock Runtime provider, async/MCP hook invocation을 반영했습니다. resume cwd·approval·transcript, OAuth/reconnect, CRLF/URL/rendering, sandbox fail-closed 수정도 포함합니다.

• CLI 0.147.0 — portable Agent Plugins와 다중 catalog 검색, 수동 정렬 transcript section, --approve-for-me, Cursor skill import와 Claude/Cursor 대화 sync, opt-in MCP 2026-07-28 protocol을 추가했습니다. deprecated codex exec --full-auto는 제거됐으므로 --sandbox workspace-write로 마이그레이션합니다.

• 모델 기준 전환 — 최상위는 GPT-6 Astra이고, GPT-5.6 계열은 Sol(최상위)·Terra(일상)·Luna(반복 작업)로 유지합니다. GPT-5.4·GPT-5.4 mini는 ChatGPT 로그인 Codex에서 2026-08-31에 종료됐습니다.

• CLI 0.146.0 — /new [name]·/clear [name]으로 새 thread를 곧바로 이름 붙이고, 중요한 thread pinning과 side conversation 전환을 지원합니다. paginated history 기반 fork, ephemeral fork 비노출, Agent Plugins manifest/workspace publish, Bedrock·Claude Code marketplace, remote Code Mode WebSocket host, custom provider standalone web search, executor-provided skills, 전 경로 proxy 처리와 MCP/App tool refresh도 반영했습니다. (2026-07-29)

• CLI 0.145.0 — paginated thread history와 이름/검색/메모리·sub-agent 지원, Cursor·Claude Code 설정/MCP/plugins/sessions/commands/project memories까지 확장된 /import, Amazon Bedrock login/custom endpoint, audio input/tool output, Multi-agent V2 역할·모델·reasoning·동시성 안정화, 안전한 inline visualization link를 반영했습니다. (2026-07-21)

• CLI 0.143.0~0.144.0 — 2026-07-08~09 당시 npm latest와 GitHub latest release는 0.144.0이었습니다. Remote plugin이 기본 활성화됐고 npm marketplace source·local/remote version 표시가 보강됐으며, macOS/Windows system proxy(PAC/WPAD), codex remote-control pair, MCP tool search 기본화·session auth·interactive auth, app approval writes 모드, reset-credit 유형/만료/선택, Ultra+고동시성 사용량 경고가 추가됐습니다. compaction의 retired model 복구, Windows sandbox writable-root 삭제, terminal control sequence sanitization, connector auth refresh도 반영합니다.

• CLI 0.142.5 — 2026-07-01 당시 npm @openai/codex의 latest와 GitHub latest release는 0.142.5였습니다. 0.142.5는 Responses WebSocket request payload 전체가 trace log에 남지 않도록 막는 보안/프라이버시 성격의 bug fix입니다. 당시 명령 inventory나 팀 운영 기능 기준은 0.142.0을 유지했고 npm alpha는 0.143.0-alpha.31이었습니다.

• 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 당시 모델 정리 — 2026-04 당시 gpt-5.5가 기본 추천으로 올라온 이력입니다. 현재 신규 기본값은 GPT-5.6 Sol/Terra/Luna이며 GPT-5.5는 회귀 비교용 이전 세대로만 유지합니다.

• 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 (영어)